Files
KArtSell.Aegis/docs/v16_0/02_FRONTEND_ADAPTER_CRUD_STANDARD.md
T
kjh2064 dcd1322d41
ci / backend (push) Failing after 12s
ci / frontend (push) Failing after 19s
ci / static (push) Failing after 45s
Initial commit: Add project files
2026-08-02 05:15:36 +09:00

1.1 KiB

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회 이상 반복된 경우만 승격한다.