Files
crank/_bmad-output/implementation-artifacts/spec-2-11-security-mapping-ui.md
T

20 KiB
Raw Blame History

title, type, created, status, baseline_revision, review_loop_iteration, followup_review_recommended, context, warnings, deferred
title type created status baseline_revision review_loop_iteration followup_review_recommended context warnings deferred
2.11 — Выбирать security mappings в OpenAPI UI feature 2026-10-03 done b18a84b2c5 0 false
_bmad-output/implementation-artifacts/epic-2-context.md
oversized

Intent

Problem: OpenAPI UI игнорирует security requirements и safe profile choices API Story 2.10, поэтому администратор не может разрешить authentication перед созданием ImportPlan.

Approach: Показать effective OR alternatives, выбрать совместимый workspace Auth Profile и передать typed reference в существующий plan API. Показывать authoritative результат проверки и безопасные RU/EN состояния.

Boundaries & Constraints

Always: Выполнить три AC Story 2.11 через пользовательский UI. API остаётся authority для OR/AND, compatibility, workspace isolation, доступности Secrets и redaction. Использовать только preview security_profile_choices с метаданными id/name/kind. Сохранять abort/controller/revision guards, keyboard labels, visible focus и screen-reader status. Для unavailable binding использовать существующее определение Story 2.10: отсутствующий профиль либо недоступный необходимый Secret; отдельный lifecycle профиля не вводить.

Never: Вводить или загружать raw credentials в mapping state; вычислять resolved по локальному выбору без ответа API; менять backend security semantics; реализовывать соседние Stories 2.12–2.15. sprint-status.yaml не записывать и не откатывать независимо от его статуса.

I/O & Edge-Case Matrix

Scenario Input / State Expected Output / Behavior Error Handling
Required OR Поддерживаемые alternatives и safe workspace profiles Явный выбор alternative/profile; plan decisions несут только index/id; resolved приходит из актуального API ответа До ответа unresolved/revalidation
Anonymous / no-auth Empty alternative либо отсутствие requirement Явное отсутствие обязательного profile; no-auth выбор сохраняет index без profile Не добавлять несовместимый binding
Unsupported AND/OAuth Unsupported alternative и findings Видимые blocker/manual guidance, без автоматического выбора иной OR alternative Нельзя объявить resolved
Empty / unavailable Нет compatible profiles либо API отклоняет выбранный profile Safe empty/blocker guidance и повторная проверка, прежний resolved снят Не показывать произвольные error payload/credentials
Selection changed Смена alternative/profile после проверки Старые plan/resolved немедленно недействительны; profile очищается при смене alternative Новый ответ проверяет текущий выбор
Stale context Задержанный preview/plan после replacement, workspace/language change или закрытия Ответ не меняет current mapping/authority Abort плюс identity/revision guards
RU/EN and safety Loading/error/empty/resolved/blocker Переведённые labels/status/findings; safe textContent, keyboard controls; нет secret canaries в DOM/payload/storage Без raw error details

Code Map

  • apps/ui/js/openapi-import.js — IIFE state, decisionFor, renderDecisionControls, renderPreview, clearPreview/invalidate, createImportPlan, renderImportPlan, submitApply и context guards. Currently security fields отсутствуют. Payload decisions пропускает create; security binding требует включить такие decisions. Для skip security fields запрещены.
  • apps/ui/js/api.js:412 — previewOpenApiImport/createOpenApiImportPlan/applyOpenApiImportPlan уже принимают payload и signal; read-only reuse, новый endpoint не нужен.
  • apps/admin-api/src/dto.rs:544 — preview response имеет security_profile_choices [{operation_key,alternative_index,schemes,profiles:[{id,name,kind}]}]. Plan decision имеет auth_profile_id/security_alternative_index; candidate state actionable/blocked/excluded и reason. Read-only contract.
  • apps/admin-api/src/service/imports.rs:249 — choices только для supported single-scheme с доступными Secrets. imports/import_plan.rs::resolve_security_binding — authoritative validation, auth_profile_required blocker, unavailable/incompatible errors. Read-only.
  • crates/crank-import/src/rest/model.rs — requirements {source,alternatives:[{schemes,supported,findings}]}; OR между alternatives, AND внутри schemes, empty alternative anonymous. Read-only.
  • apps/ui/js/i18n.js — TRANSLATIONS en/ru и openapi.*; findingMessage использует safe whitelist/fallback.
  • apps/ui/css/openapi-import.css — decision controls/finding/plan styles; reuse.
  • apps/ui/tests/e2e/openapi-import-plan.spec.js — существующий mock plan browser harness. apps/ui/tests/e2e/operations.spec.js, apps/ui/scripts/playwright-stack.sh — real API upload/preview/plan/apply и lifecycle stack.
  • docs/openapi-import.md:16 — устаревшее утверждение о недоступности mapping UI.

Tasks & Acceptance

Execution:

  • apps/ui/tests/e2e/openapi-security-mapping.spec.js, _bmad-output/test-artifacts/atdd-checklist-2-11-security-mapping-ui.md — ATDD сценарии каждой строки матрицы и трёх AC; reuse harness, actual RED/GREEN, real API evidence для ключевого выбора.
  • apps/ui/js/openapi-import.js — читать safe choices; operation controls и mapping state; index/id в decisions create/rename/new_version, без security fields у skip; API-authoritative status, invalidate и recovery.
  • apps/ui/js/i18n.js, apps/ui/css/openapi-import.css — RU/EN labels, status, safe findings/error guidance и доступные controls в existing conventions.
  • docs/openapi-import.md — описать реализованный mapping flow, ограничения и revalidation без обещаний будущей qualification.

Acceptance Criteria:

  • Given preview сохраняет OR alternatives и required authentication, when администратор выбирает alternative либо совместимый Auth Profile текущего workspace, then UI передаёт выбор существующему import API и показывает authoritative resolved/unresolved/blocker status; raw credentials не вводятся в mapping state и не копируются в IR/plan.
  • Given смена alternative, удалённый/недоступный profile либо stale preview response, when API повторно валидирует binding, then UI показывает safe blocker/revalidation guidance и не выдаёт предыдущий resolved state за текущий; OR/AND semantics, workspace validation и redaction остаются в API Story 2.10.
  • Given security-mapping UI на RU и EN, when пользователь выбирает profile, меняет alternative или получает unsupported scheme, then UI показывает required/unresolved/resolved status, safe profile metadata и blocker findings; loading, empty, error и stale-response states не раскрывают secrets.

Spec Change Log

Review Triage Log

2026-10-03 — Review pass

  • verdicts: 19 findings — high 0, medium 7, low 2, false 10, maybe-false 0
  • findings:
    • [false] [reject] Intent auditor: обычное выполнение Story 2.11 — diff реализует UI story; финализация следует после review, промежуточный in-review не является дефектом.
    • [false] [reject] Intent auditor: условный awaiting-operator — AC не требуют внешних действий HUMAN; условная ветка не применяется.
    • [false] [reject] Intent auditor: защита sprint-status — файл отсутствует в diff и не записывался/не откатывался.
    • [false] [reject] Intent auditor: преимущественно mock UI evidence — это UI story поверх существующей API authority, реальный bearer round-trip и полный backend gate дополнительно выполнены.
    • [false] [reject] Intent auditor: финальный workflow результат отсутствует в review diff — ожидаемая стадия in-review; commit и Auto Run Result создаются после triage, не являются продуктовым дефектом.
    • [false] [reject] Blind 1: смена mapping во время plan запроса — createImportPlan вызывает lockPlanEditing(true), finally оставляет lock при state.plan; пользователь не может редактировать controls в этом состоянии.
    • [medium] [patch] Blind 2: operation key ломает CSS selector — parser сохраняет произвольный path key; securityOperationNode должен сравнивать dataset через постоянный selector. Исправлено сравнением dataset; quoted-key regression PASS.
    • [false] [reject] Blind 3: auth_profile_id отсутствует в реальном candidate — DTO OpenApiImportPlanCandidateView содержит поле, render plan получает его, real bearer test подтвердил resolved.
    • [medium] [patch] Blind 4: изменение статуса строки не объявляется при неизменном summary — Добавлены role=status/aria-live=polite к строке; assertions PASS.
    • [low] [patch] Blind 5: selectOption не проверяет клавиатурный выбор — В accessibility leaf использован ArrowDown, выбранные значения и focus проверены, PASS.
    • [medium] [patch] Blind 6: нет явных RU/EN assertions для findings и empty guidance — Добавлены точные assertions обеих локалей, PASS; общий root cause с verification-gap finding.
    • [medium] [patch] Blind 7: security stale fixtures покрывают только cancel — Добавлены security-specific assertions workspace/language, PASS; replacement preview уже покрыт operations.spec.js:494, plan replacement недоступен из-за lockPlanEditing. Guards сохранены.
    • [false] [reject] Blind 8: canary под произвольным ключом остаётся незамеченным — payload уже целиком сериализуется и проверяется на canary; structural helper является дополнительной ограниченной проверкой, backend redaction отдельно проверяется существующим gate.
    • [low] [patch] Blind 9: empty test не проверяет disabled и guidance — Добавлены прямые assertions disabled control/guidance, PASS; verification branch объединён с localized assertions, собственный verdict сохранён.
    • [false] [reject] Blind 10: generated AC IDs опровергают approved snapshot — text snapshot соответствует frozen spec, idSource=generated и источник явно задокументированы; ID не является доказательством/заявлением отдельного approval.
    • [medium] [patch] Verification gap: unsupported alternative лишена проверки локализованного объяснения — pre-verified evidence принято, Добавлены RU/EN finding assertions, PASS; общий root cause с Blind 6.
    • [false] [reject] Edge 1: resolved summary скрывает обязательную unresolved auth — в реальном API actionable protected candidate имеет binding либо anonymous index; unresolved остаётся у excluded/skip, который не требует новой auth binding. Blocked/required/unverified имеют приоритет. Reachable unresolved requiring auth alongside resolved в текущем API не показан.
    • [medium] [patch] Edge 2: operation key с кавычкой ломает lookup — подтверждён тот же root cause, что Blind 2; Исправлено постоянным selector и dataset comparison, regression PASS.
    • [medium] [patch] Lead: реальные blocked candidate reason auth_profile_required получают generic guidance, empty mock использовал несуществующий error — Добавлен safe known finding mapping, удалён вымышленный error mapping; настоящий 200 blocked candidate контракт проверен, PASS.

Design Notes

Локальный выбор — pending/unresolved, actionable candidate от актуального plan API — authoritative resolved, но не гарантия будущего Apply. После возврата к редактированию/ошибки Apply предыдущая проверка снимается. Unsupported OR siblings показываются без collapse; пользователь явно выбирает поддерживаемый вариант или anonymous alternative. Не загружать listAuthProfiles с конфигурацией: preview уже предоставляет совместимые safe choices.

Исполнитель не один в codebase: не откатывать чужие изменения. Разрешены только перечисленные UI/test/docs/checklist paths и необходимые минимальные sibling helpers при code-health limits; архитектуру и расширение scope вернуть ведущему. ATDD без production code, затем отдельный implementation этап. Context7 Playwright docs подтверждают locator.selectOption (native input/change), page.route/route.fulfill и web-first assertions.

Verification

  • cd apps/ui && npm run build — build PASS.
  • cd apps/ui && npx playwright test tests/e2e/openapi-security-mapping.spec.js tests/e2e/openapi-import-plan.spec.js tests/e2e/operations.spec.js --workers=1 — mandatory matrix/AC и existing import regressions PASS без skipped mandatory cases; включить реальный API flow.
  • just verify — полный обязательный gate PASS.

Auto Run Result

Status: done

Реализован security mapping в OpenAPI UI: явный OR alternative и совместимый workspace Auth Profile по safe metadata, typed index/id в plan decisions, отдельные API-authoritative статусы операций. Anonymous и skip не несут profile binding. Смена выбора, ошибки Apply и stale context снимают прежнюю проверку. Unsupported/empty/blocker guidance переведены на RU/EN; native controls доступны с клавиатуры и объявляют статусы screen reader.

Изменённые файлы

  • apps/ui/js/openapi-import.js — mapping controls/state, typed payload, per-operation authority, invalidation и safe findings.
  • apps/ui/js/i18n.js — RU/EN labels, states и guidance.
  • apps/ui/css/openapi-import.css — стили security controls, statuses и guidance.
  • apps/ui/tests/e2e/openapi-security-mapping.spec.js — 19 активных AC/matrix/regression сценариев, включая real API bearer round-trip.
  • docs/openapi-import.md — описание реализованного flow и ограничений.
  • _bmad-output/test-artifacts/atdd-checklist-2-11-security-mapping-ui.md — frozen AC snapshot и фактические RED/GREEN evidence.
  • Эта спецификация — intent, execution checklist, triage и итоговый результат.

Review

Четыре независимых слоя завершены. Все 19 observations перечислены в Review Triage Log: medium 7, low 2, false 10. После группировки применены 7 patch entries: medium 5, low 2, high 0. Исправлены selector lookup, объявления статусов строк, real API blocker reason и пробелы verification (keyboard, localized unsupported/empty guidance, stale language/workspace). Deferred: 0. Все 10 rejected observations имеют отдельную refutation в triage; ни один finding не пропущен.

Follow-up review recommended: false. Формальный порог нескольких medium patches достигнут, но все конкретные изменённые ветки проверены выполненными тестами и общим gate; оставшегося специфического непроверенного риска для follow-up не выявлено.

Verification

  • cd apps/ui && npm run build — PASS, exit 0, повторно после review fixes.
  • cd apps/ui && npx playwright test tests/e2e/openapi-security-mapping.spec.js tests/e2e/openapi-import-plan.spec.js tests/e2e/operations.spec.js --workers=1 — 30 passed, exit 0; 19 security + 11 existing regressions, mandatory skipped: 0.
  • just verify — PASS, exit 0, повторно после review fixes: tooling 152 tests; Rust 945 passed, 0 failed, 1 existing ignored production-size test; contracts, boundaries, fmt, clippy и configured dependency gates пройдены.
  • Матрица: Required OR — AC-1 и real API; anonymous — anonymous/index-only; unsupported — disabled alternatives и RU/EN finding assertions; empty/unavailable — real-shaped blocked candidate и typed unavailable; selection — alternative reset/skip/edit; stale — preview/plan cancel, workspace/language и existing replacement regression; safety/accessibility — canary, keyboard, live regions, localized guidance. Все покрывающие тесты выполнены и прошли.
  • RED: первоначальные 3 leaves failed до feature; целевой pre-fix index прогон 8 failed / 8 passed подтвердил реальные lifecycle gaps. GREEN результаты не заменяют RED claims.

Ограничения

Backend API не расширялся: отдельного lifecycle/delete endpoint Auth Profile нет, referenced Secret удаление запрещено 409. Real API подтверждает bearer happy path; отрицательные UI revalidation сценарии используют public API contract mocks, а authority/redaction/workspace/Secret semantics проверяются существующим backend gate. Configured npm audit сообщает существующую moderate advisory js-yaml; dependency не менялась, gate exit 0. Действий HUMAN вне репозитория AC не требуют. sprint-status.yaml не записывался и не откатывался.

Очистка ресурсов

Связанные browser stack и OpenCode процессы остановлены; metrics-порты свободны. docker volume prune -f завершился exit 0, reclaimed 5.849 GB; осталось 2 active volumes. После очистки df -h /: 107 GB available; Btrfs Metadata DUP 1.17/7.01 GiB (16.69%), Global reserve used 0. Ресурсов достаточно для следующей story.