kjh2064
5dfb8f3e12
Reorganize documentation following AGENTS.md v16.0 governance (traceability, reproducibility): Structure changes: - CURRENT/ (new) ├─ 00~08.md (v16.0 standards, renamed for clarity) └─ CATALOGS/ (9 CSV files: WBS, decision log, debt register, matrices, catalogs) - LEGACY/ (new, read-only archives) ├─ v11/ (original baseline + hardening analysis) ├─ v12~v15/ (.gitkeep + README for future archiving) - DECISIONS/ (new, ready for ADR usage) - TEMPLATES/ (existing, unchanged) Deletions (consolidated into CURRENT/): - v16_0/ folder (files migrated) - hardening/ folder (contents → LEGACY/v11/) - Root-level v11 files (00~07.md, CSV) Renames (for clarity): - 00_EXECUTIVE_REFERENCE_IMPLEMENTATION.md → 00_EXECUTIVE.md - 01_BRUTAL_ROLE_AUDIT.md → 01_ROLE_AUDIT.md - 02_FRONTEND_ADAPTER_CRUD_STANDARD.md → 02_FE_ADAPTER.md - 03_BACKEND_DATA_SCHEDULER_STANDARD.md → 03_BE_DATA.md - 04_ALGORITHM_MODEL_GOVERNANCE.md → 04_ALGORITHM.md - 05_PROCESS_VIBE_DEBT_CONTROL.md → 05_PROCESS_VIBE_DEBT.md - 06_VALIDATION_TRUTH.md → 06_VALIDATION.md - 07_PACKAGE_ATTACHMENT_POLICY.md → 07_PACKAGE_POLICY.md Updates: - docs/INDEX.md (complete rewrite with navigation) - LEGACY/ folders with README + .gitkeep Benefits: ✅ Clear version management (v16.0 is active, v11~v15 read-only) ✅ No version mixing in root ✅ CURRENT/ as single point of reference for active docs ✅ CATALOGS/ consolidates all data matrices ✅ LEGACY/ preserves history without clutter ✅ Traceability: decision log, tech debt, WBS all linked ✅ DECISIONS/ ready for ADR pattern (future use) Sync with root: - CLAUDE.md references: docs/CURRENT/, docs/INDEX.md ✅ - AGENTS.md references: docs/CURRENT/, traceability ✅ - README.md: Document guide links updated ✅ Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
7.0 KiB
7.0 KiB
| 1 | ID | Component | Layer | Props_or_Type | Events_or_Slots | Accessibility | Required_Tests | Vendor_Boundary |
|---|---|---|---|---|---|---|---|---|
| 2 | C-001 | AppShellLayout | Layout | product/environment/automation boundary | navigation/header/footer | skip-link/landmarks | route/auth E2E | Adapter-neutral |
| 3 | C-002 | PageLayout | Layout | title/status/asOf/version | actions/summary/filters/aside/footer | h1/meta landmarks | responsive/state | Adapter-neutral |
| 4 | C-003 | ReviewWorkbenchLayout | Layout | queue/detail/decision | slots | named regions/keyboard order | maker-checker E2E | Adapter-neutral |
| 5 | C-004 | FormPageLayout | Layout | form/preview | submit | label/focus order | dirty/validation | Adapter-neutral |
| 6 | C-005 | DashboardLayout | Layout | kpi/primary/secondary/alerts | slots | table alternative required | no-data/partial | Adapter-neutral |
| 7 | C-010 | KsButton | Standard | label/severity/type/loading | click | button semantics | disabled/loading | Button port |
| 8 | C-011 | KsTextField | Standard | label/error/help/model | update/blur | label/describedby/invalid | 422/a11y | TextField port |
| 9 | C-012 | KsSelect | Standard | label/options/error/model | update/blur | label/options/invalid | boundary/a11y | Select port |
| 10 | C-013 | KsDataGrid | Standard | rows/columns/loading/selection | rowSelected | grid keyboard contract | large rows/filter | DataGrid port |
| 11 | C-014 | KsDialog | Standard | visible/title/modal | update visible | focus trap/vendor contract | escape/modal | Dialog port |
| 12 | C-015 | KsStatusTag | Standard | value/severity/iconLabel | - | text+icon not color only | severity matrix | StatusTag port |
| 13 | C-020 | StandardStatePanel | Standard | 11-state/title/message/trace | retry | aria-busy/status | state matrix | Adapter-neutral |
| 14 | T-01 | CrudListPage | ScreenType | T01 | slots | list semantics | filter URL/empty/auth | Layout composition |
| 15 | T-02 | CrudDetailPage | ScreenType | T02 | slots | version/as-of landmarks | published/expired/auth | Layout composition |
| 16 | T-03 | CrudFormPage | ScreenType | T03 | submit/slots | form error focus | dirty/conflict/idempotency | Layout composition |
| 17 | T-05 | CrudReviewPage | ScreenType | T05 | queue/detail/decision | keyboard review order | segregation/expiry/conflict | Layout composition |
| 18 | T-08 | BatchOperationsPage | ScreenType | T08 | timeline/records/reprocess/runbook | progress/status | retry/replay/duplicate | Layout composition |
| 19 | V14-C-001 | KsDateField | Standard Component | modelValue/label/min/max/error | update/blur | label-describedby/date keyboard | adapter parity/form | Provider port |
| 20 | V14-C-002 | KsNumberField | Standard Component | modelValue/min/max/fraction/error | update/blur | label/error/value semantics | decimal/boundary/form | Provider port |
| 21 | V14-C-003 | NativeUiAdapter | Reference Provider | 10 capabilities | provider install | HTML native keyboard baseline | contract/browser/a11y | Adapter implementation only |
| 22 | V14-C-004 | UiProviderResolver | Bootstrap | VITE_UI_ADAPTER | install | fail-fast unsupported provider | configuration/contract | Composition root only |
| 23 | V14-C-005 | SearchListCrudPage | Screen Type | T01 | named slots | 검색·목록 CRUD landmarks/state | T01 state/E2E | Adapter-neutral |
| 24 | V14-C-006 | DetailReadPage | Screen Type | T02 | named slots | 상세·증거 조회 landmarks/state | T02 state/E2E | Adapter-neutral |
| 25 | V14-C-007 | EditFormPage | Screen Type | T03 | named slots | 등록·편집 Form landmarks/state | T03 state/E2E | Adapter-neutral |
| 26 | V14-C-008 | MasterDetailCrudPage | Screen Type | T04 | named slots | Master-Detail landmarks/state | T04 state/E2E | Adapter-neutral |
| 27 | V14-C-009 | ApprovalWorkbenchPage | Screen Type | T05 | named slots | maker-checker 검토 landmarks/state | T05 state/E2E | Adapter-neutral |
| 28 | V14-C-010 | StepWizardPage | Screen Type | T06 | named slots | 단계 Wizard landmarks/state | T06 state/E2E | Adapter-neutral |
| 29 | V14-C-011 | ScorecardDashboardPage | Screen Type | T07 | named slots | Dashboard/Scorecard landmarks/state | T07 state/E2E | Adapter-neutral |
| 30 | V14-C-012 | BatchOperationsPageV2 | Screen Type | T08 | named slots | Batch/Data Ops landmarks/state | T08 state/E2E | Adapter-neutral |
| 31 | V14-C-013 | ReconciliationExceptionPage | Screen Type | T09 | named slots | 대사·예외 landmarks/state | T09 state/E2E | Adapter-neutral |
| 32 | V14-C-014 | VersionGovernancePage | Screen Type | T10 | named slots | 버전·거버넌스 landmarks/state | T10 state/E2E | Adapter-neutral |
| 33 | C-032 | KsMultiSelect | Adapter facade | modelValue/options/label/disabled | update:modelValue | label/multiple selection | contract/a11y | Provider v3 |
| 34 | C-033 | KsInlineMessage | Adapter facade | severity/title/message/dismissible | dismiss | alert/status semantics | contract/a11y | Provider v3 |
| 35 | C-034 | KsPaginator | Adapter facade | page/pageSize/total/pageSizes | pageChange | nav label/buttons | paging tests | Provider v3 |
| 36 | C-035 | KsTabs | Adapter facade | modelValue/items/ariaLabel | update:modelValue/default slot | tablist/tab/tabpanel | keyboard/a11y | Provider v3 |
| 37 | C-036 | CrudWorkspaceLayout | Layout | asideWidth/dense | toolbar/aside/actions | task order/landmarks | responsive | Adapter-neutral |
| 38 | C-037 | OperationsConsoleLayout | Layout | title/runStatus/watermark/owner | runs/actions/footer | operations context | responsive/E2E | Adapter-neutral |
| 39 | C-038 | StandardCrudListPage | Screen facade | rows/columns/page/evidence/state | rowSelected/pageChange/retry | state/grid/pager | Vitest/Playwright | Adapter-neutral |
| 40 | C-039 | StandardCrudFormPage | Screen facade | state/dirty/readonly/version | submit/cancel/retry | form/status | Vitest/Playwright | Adapter-neutral |
| 41 | C-040 | CrudResourceContract | Contract | query/form/parser/permissions | - | N/A | type/contract | Adapter-neutral |
| 42 | C-041 | useCrudListState | Composable | query/selected/dirty | replace/page/search/reset | N/A | unit | Adapter-neutral |
| 43 | C-042 | QueryStateBoundary v3 | Boundary | 13 states/correlation | retry | alert/status/focus | state matrix | Ks facade |
| 44 | C-043 | UiAdapterContract v3 | Contract | 14 capabilities/provider metadata | fail-fast | WCAG target | conformance | Provider boundary |
| 45 | C-044 | FieldShell | Standard Component | label/inputId/required/error/help | scoped input slot | label/describedby/alert | Vitest+a11y | No vendor |
| 46 | C-045 | KsDataContextHeader | Standard Component | asOf/VersionSet/projection/watermark | header slots | landmark/stale text | Vitest+Playwright | No vendor |
| 47 | C-046 | KsCommandBar | Standard Component | actions/ariaLabel | execute | nav/disabled | Vitest+a11y | KsButton only |
| 48 | C-047 | UiAdapterCompatibility | Contract | adapter/capabilities/production | report/assert | fail-fast | Vitest | Provider boundary |
| 49 | C-048 | CrudResourceDefinition | CRUD Contract | Zod/columns/sensitive/permissions | assert | schema semantics | Vitest | No vendor |
| 50 | C-049 | useOptimisticCommand | CRUD Composable | payload/etag | run/conflict | status exposed | Vitest | Axios boundary |
| 51 | C-050 | ProjectionHealthBadge | Proposed Component | health/watermark/builtAt | - | text+icon | Vitest | No vendor |
| 52 | C-051 | LeaseStatusPanel | Proposed Screen Part | owner/token/heartbeat/expiry | recovery slot | table semantics | Playwright | No vendor |
| 53 | C-052 | EvaluationReconciliationPanel | Proposed Screen Part | window/action/reason/version | review slot | status text | Playwright | No vendor |
| 54 | C-053 | AdapterDiagnosticsPage | Proposed Page | provider/report/evidence | rerun/export | heading/table | Playwright | Adapter only |
| 55 | C-054 | T01 CrudList v2 | Screen Contract | CrudResourceDefinition | select/open | keyboard/grid | E2E | Ks components |
| 56 | C-055 | T05 Review v2 | Screen Contract | maker/checker/evidence | approve/hold/reject | focus/warning | E2E | Ks components |
| 57 | C-056 | T08 BatchOps v2 | Screen Contract | JobRun/lease/watermark | reprocess/hold | table/alert | E2E | Ks components |
| 58 | C-057 | T10 Governance v2 | Screen Contract | version/evidence/decision | review/retire | table/dialog | E2E | Ks components |
| 59 | C-058 | UiAdapterContract v4 | Contract | 14 capabilities/8 evidence | fail-fast/report | WCAG target | conformance | Provider boundary |