refactor: Reorganize docs folder structure for clarity and version management (PR 3c)
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>
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
ID,Component,Layer,Props_or_Type,Events_or_Slots,Accessibility,Required_Tests,Vendor_Boundary
|
||||
C-001,AppShellLayout,Layout,product/environment/automation boundary,navigation/header/footer,skip-link/landmarks,route/auth E2E,Adapter-neutral
|
||||
C-002,PageLayout,Layout,title/status/asOf/version,actions/summary/filters/aside/footer,h1/meta landmarks,responsive/state,Adapter-neutral
|
||||
C-003,ReviewWorkbenchLayout,Layout,queue/detail/decision,slots,named regions/keyboard order,maker-checker E2E,Adapter-neutral
|
||||
C-004,FormPageLayout,Layout,form/preview,submit,label/focus order,dirty/validation,Adapter-neutral
|
||||
C-005,DashboardLayout,Layout,kpi/primary/secondary/alerts,slots,table alternative required,no-data/partial,Adapter-neutral
|
||||
C-010,KsButton,Standard,label/severity/type/loading,click,button semantics,disabled/loading,Button port
|
||||
C-011,KsTextField,Standard,label/error/help/model,update/blur,label/describedby/invalid,422/a11y,TextField port
|
||||
C-012,KsSelect,Standard,label/options/error/model,update/blur,label/options/invalid,boundary/a11y,Select port
|
||||
C-013,KsDataGrid,Standard,rows/columns/loading/selection,rowSelected,grid keyboard contract,large rows/filter,DataGrid port
|
||||
C-014,KsDialog,Standard,visible/title/modal,update visible,focus trap/vendor contract,escape/modal,Dialog port
|
||||
C-015,KsStatusTag,Standard,value/severity/iconLabel,-,text+icon not color only,severity matrix,StatusTag port
|
||||
C-020,StandardStatePanel,Standard,11-state/title/message/trace,retry,aria-busy/status,state matrix,Adapter-neutral
|
||||
T-01,CrudListPage,ScreenType,T01,slots,list semantics,filter URL/empty/auth,Layout composition
|
||||
T-02,CrudDetailPage,ScreenType,T02,slots,version/as-of landmarks,published/expired/auth,Layout composition
|
||||
T-03,CrudFormPage,ScreenType,T03,submit/slots,form error focus,dirty/conflict/idempotency,Layout composition
|
||||
T-05,CrudReviewPage,ScreenType,T05,queue/detail/decision,keyboard review order,segregation/expiry/conflict,Layout composition
|
||||
T-08,BatchOperationsPage,ScreenType,T08,timeline/records/reprocess/runbook,progress/status,retry/replay/duplicate,Layout composition
|
||||
V14-C-001,KsDateField,Standard Component,modelValue/label/min/max/error,update/blur,label-describedby/date keyboard,adapter parity/form,Provider port
|
||||
V14-C-002,KsNumberField,Standard Component,modelValue/min/max/fraction/error,update/blur,label/error/value semantics,decimal/boundary/form,Provider port
|
||||
V14-C-003,NativeUiAdapter,Reference Provider,10 capabilities,provider install,HTML native keyboard baseline,contract/browser/a11y,Adapter implementation only
|
||||
V14-C-004,UiProviderResolver,Bootstrap,VITE_UI_ADAPTER,install,fail-fast unsupported provider,configuration/contract,Composition root only
|
||||
V14-C-005,SearchListCrudPage,Screen Type,T01,named slots,검색·목록 CRUD landmarks/state,T01 state/E2E,Adapter-neutral
|
||||
V14-C-006,DetailReadPage,Screen Type,T02,named slots,상세·증거 조회 landmarks/state,T02 state/E2E,Adapter-neutral
|
||||
V14-C-007,EditFormPage,Screen Type,T03,named slots,등록·편집 Form landmarks/state,T03 state/E2E,Adapter-neutral
|
||||
V14-C-008,MasterDetailCrudPage,Screen Type,T04,named slots,Master-Detail landmarks/state,T04 state/E2E,Adapter-neutral
|
||||
V14-C-009,ApprovalWorkbenchPage,Screen Type,T05,named slots,maker-checker 검토 landmarks/state,T05 state/E2E,Adapter-neutral
|
||||
V14-C-010,StepWizardPage,Screen Type,T06,named slots,단계 Wizard landmarks/state,T06 state/E2E,Adapter-neutral
|
||||
V14-C-011,ScorecardDashboardPage,Screen Type,T07,named slots,Dashboard/Scorecard landmarks/state,T07 state/E2E,Adapter-neutral
|
||||
V14-C-012,BatchOperationsPageV2,Screen Type,T08,named slots,Batch/Data Ops landmarks/state,T08 state/E2E,Adapter-neutral
|
||||
V14-C-013,ReconciliationExceptionPage,Screen Type,T09,named slots,대사·예외 landmarks/state,T09 state/E2E,Adapter-neutral
|
||||
V14-C-014,VersionGovernancePage,Screen Type,T10,named slots,버전·거버넌스 landmarks/state,T10 state/E2E,Adapter-neutral
|
||||
C-032,KsMultiSelect,Adapter facade,modelValue/options/label/disabled,update:modelValue,label/multiple selection,contract/a11y,Provider v3
|
||||
C-033,KsInlineMessage,Adapter facade,severity/title/message/dismissible,dismiss,alert/status semantics,contract/a11y,Provider v3
|
||||
C-034,KsPaginator,Adapter facade,page/pageSize/total/pageSizes,pageChange,nav label/buttons,paging tests,Provider v3
|
||||
C-035,KsTabs,Adapter facade,modelValue/items/ariaLabel,update:modelValue/default slot,tablist/tab/tabpanel,keyboard/a11y,Provider v3
|
||||
C-036,CrudWorkspaceLayout,Layout,asideWidth/dense,toolbar/aside/actions,task order/landmarks,responsive,Adapter-neutral
|
||||
C-037,OperationsConsoleLayout,Layout,title/runStatus/watermark/owner,runs/actions/footer,operations context,responsive/E2E,Adapter-neutral
|
||||
C-038,StandardCrudListPage,Screen facade,rows/columns/page/evidence/state,rowSelected/pageChange/retry,state/grid/pager,Vitest/Playwright,Adapter-neutral
|
||||
C-039,StandardCrudFormPage,Screen facade,state/dirty/readonly/version,submit/cancel/retry,form/status,Vitest/Playwright,Adapter-neutral
|
||||
C-040,CrudResourceContract,Contract,query/form/parser/permissions,-,N/A,type/contract,Adapter-neutral
|
||||
C-041,useCrudListState,Composable,query/selected/dirty,replace/page/search/reset,N/A,unit,Adapter-neutral
|
||||
C-042,QueryStateBoundary v3,Boundary,13 states/correlation,retry,alert/status/focus,state matrix,Ks facade
|
||||
C-043,UiAdapterContract v3,Contract,14 capabilities/provider metadata,fail-fast,WCAG target,conformance,Provider boundary
|
||||
C-044,FieldShell,Standard Component,label/inputId/required/error/help,scoped input slot,label/describedby/alert,Vitest+a11y,No vendor
|
||||
C-045,KsDataContextHeader,Standard Component,asOf/VersionSet/projection/watermark,header slots,landmark/stale text,Vitest+Playwright,No vendor
|
||||
C-046,KsCommandBar,Standard Component,actions/ariaLabel,execute,nav/disabled,Vitest+a11y,KsButton only
|
||||
C-047,UiAdapterCompatibility,Contract,adapter/capabilities/production,report/assert,fail-fast,Vitest,Provider boundary
|
||||
C-048,CrudResourceDefinition,CRUD Contract,Zod/columns/sensitive/permissions,assert,schema semantics,Vitest,No vendor
|
||||
C-049,useOptimisticCommand,CRUD Composable,payload/etag,run/conflict,status exposed,Vitest,Axios boundary
|
||||
C-050,ProjectionHealthBadge,Proposed Component,health/watermark/builtAt,-,text+icon,Vitest,No vendor
|
||||
C-051,LeaseStatusPanel,Proposed Screen Part,owner/token/heartbeat/expiry,recovery slot,table semantics,Playwright,No vendor
|
||||
C-052,EvaluationReconciliationPanel,Proposed Screen Part,window/action/reason/version,review slot,status text,Playwright,No vendor
|
||||
C-053,AdapterDiagnosticsPage,Proposed Page,provider/report/evidence,rerun/export,heading/table,Playwright,Adapter only
|
||||
C-054,T01 CrudList v2,Screen Contract,CrudResourceDefinition,select/open,keyboard/grid,E2E,Ks components
|
||||
C-055,T05 Review v2,Screen Contract,maker/checker/evidence,approve/hold/reject,focus/warning,E2E,Ks components
|
||||
C-056,T08 BatchOps v2,Screen Contract,JobRun/lease/watermark,reprocess/hold,table/alert,E2E,Ks components
|
||||
C-057,T10 Governance v2,Screen Contract,version/evidence/decision,review/retire,table/dialog,E2E,Ks components
|
||||
C-058,UiAdapterContract v4,Contract,14 capabilities/8 evidence,fail-fast/report,WCAG target,conformance,Provider boundary
|
||||
|
Reference in New Issue
Block a user