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>
18 lines
1.1 KiB
Markdown
18 lines
1.1 KiB
Markdown
# FE Adapter v4·표준 레이아웃·CRUD v2
|
|
|
|
## 의존 방향
|
|
`Feature → Standard Screen/CRUD → Ks Facade → UiAdapter v4 → PrimeVue/AG Grid 또는 Native Reference`
|
|
|
|
## 새 표준
|
|
- `FieldShell`: label, required, help/error, aria-describedby, alert semantics의 단일 기준.
|
|
- `KsDataContextHeader`: as-of, Dataset/Model/Config/Code/Contract, ProjectionVersion, Watermark, Correlation.
|
|
- `KsCommandBar`: 페이지 행동의 순서와 disabled/busy 의미 표준.
|
|
- `CrudResourceDefinition`: Zod Query/Row/Form, 민감필드, permission, If-Match, Idempotency-Key.
|
|
- `useOptimisticCommand`: 중복 클릭 방지와 409/412 conflict 표면화.
|
|
|
|
## 교체 Gate
|
|
Contract conformance, keyboard/focus, T01~T10 상태 회귀, visual regression, performance budget, SBOM/license, rollback rehearsal가 모두 필요하다. 공급자 변경은 startup 선택이며 runtime global mutation을 금지한다.
|
|
|
|
## 과유불급
|
|
Vendor prop 전체를 wrapper에 노출하지 않는다. 두 화면에서만 우연히 비슷한 컴포넌트를 성급하게 공통화하지 않는다. 동일 의미와 변경축이 3회 이상 반복된 경우만 승격한다.
|