36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# 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
|
|
|
|
1. Adapter contract test
|
|
2. 키보드·landmark·label 접근성
|
|
3. 화면 상태별 visual regression
|
|
4. T01~T10 상태 matrix
|
|
5. 대량목록 성능
|
|
6. 보안·라이선스 검토
|