Initial commit: Add project files

2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,17 @@
+# 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회 이상 반복된 경우만 승격한다.