1.2 KiB
1.2 KiB
FE 표준 컴포넌트·Provider Adapter v2
의존 방향
Feature → Ks Component → UiAdapter contract → Provider implementation
Feature가 허용받는 import 경계:
@/shared/ui/components@/shared/ui/layouts@/shared/ui/screen-types
금지: Feature의 primevue/*, ag-grid-* 직접 import.
Adapter v2
필수 capability는 Button, TextField, TextArea, Select, Checkbox, DateField, NumberField, Dialog, StatusTag, DataGrid 10종이다. 공급자는 contractVersion 2.0과 capability set을 제공하며 bootstrap에서 누락을 fail-fast한다.
primevue-aggrid: 생산 후보native-accessible: 교체 가능성·계약 검증용 reference, 생산 비적격
교체는 환경변수 VITE_UI_ADAPTER와 provider resolver에서 수행한다. Feature 수정은 허용하지 않는다.
승격 규칙
공통 컴포넌트는 3회 반복만으로 승격하지 않는다. 의미, 실패 상태, 접근성, 변경축이 같아야 한다. 단순히 markup이 비슷하다는 이유로 공통화하지 않는다.
공급자 교체 Gate
- Adapter contract test
- 키보드·landmark·label 접근성
- 화면 상태별 visual regression
- T01~T10 상태 matrix
- 대량목록 성능
- 보안·라이선스 검토