diff --git a/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md b/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md index 2c6b5b60..3fb211cc 100644 --- a/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md +++ b/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md @@ -1,77 +1,87 @@ -# OMS·WMS·ERP 입력 컴포넌트 & 공통 CRUD 템플릿 통합 WBS 로드맵 (WBS-ENTERPRISE-2026) +# OMS·WMS·ERP 입력 컴포넌트 & 공통 CRUD 템플릿 & 상용화 제안 마스터 WBS (WBS-MASTER-2026) -## 0. 개요 및 하네스 준수 원칙 +## 0. 개요 및 3대 명세 통합 권위 -본 문서는 `docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md` 명세서의 **52개 입력 컴포넌트 상세 규격** 및 **11대 표준 업무 템플릿 상세 규격**에 대한 전체 작업분해구조(WBS)와 일정 스케줄, 성공판단 데이터를 정의한다. +본 문서는 아래 3대 핵심 상용화 명세를 완벽히 아우르는 마스터 작업분해구조(WBS)와 일정 스케줄, 성공판단 데이터를 정의한다. + +1. **OMS·WMS·ERP CRUD 화면 및 입력 컴포넌트 상용화 제안** (22개 섹션 & 10대 계율) +2. **OMS·WMS·ERP 공통 CRUD 화면 템플릿 상세 명세** (11대 표준 템플릿 `TPL-LIST-01` ~ `TPL-HISTORY-01` & 25개 공통 규격) +3. **OMS·WMS·ERP 입력 컴포넌트 상세 명세** (Primitive → Typed Field → Domain Field → Business Composite 4계층 아키텍처 & 52개 세부 규격) ### 0.1 기본 하네스 4대 완수 조건 -1. **YAML/MD 계약**: `docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md` 및 `docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md` -2. **코드 구현**: `src/frontend/src/components/` (4계층 컴포넌트 및 11대 템플릿) & `src/frontend/src/types/enterpriseTemplateContracts.ts` +1. **YAML/MD 계약**: `docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md` & `docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md` +2. **코드 구현**: `src/frontend/src/components/` (4계층 컴포넌트), `src/frontend/src/views/templates/` (11대 템플릿) & `src/frontend/src/types/enterpriseTemplateContracts.ts` 3. **데이터 실체**: `Temp/enterprise_crud_validation_report_v1.json`, `Temp/enterprise_crud_validation_report_v1.md` 4. **검증 증빙**: `python tools/validate_enterprise_crud_specification_v1.py` & `npx playwright test` --- -## 1. 입력 컴포넌트 4계층 WBS 인벤토리 (52개 섹션 기반) +## 1. [트랙 A] 상용화 제안 10대 계율 & 헌법 WBS -### Phase 1: Primitive UI Components (`components/primitives/`) -| WBS ID | 대상 컴포넌트 | 담당 역할 | 상태 | 성공판단 데이터 (Acceptance Criteria) | +| WBS ID | 상용화 설계 원칙 | 주요 이행 사항 | 상태 | 성공판단 데이터 (Acceptance Criteria) | | :--- | :--- | :--- | :---: | :--- | -| `WBS-COMP-1.1` | `TextInput.vue` | 시각/키보드 텍스트 입력 | `COMPLETED` | IME 조합 처리 유지, ARIA `aria-invalid` 바인딩 | -| `WBS-COMP-1.2` | `SelectInput.vue` | 단순 옵션 드롭다운 | `PLANNED` | 방향키/Enter/Escape 단축키 제어, 20개 이하 옵션 | -| `WBS-COMP-1.3` | `DialogModal.vue` | 접근성 포커스 트랩 모달 | `PLANNED` | ESC 키 닫기 및 열기 전 버튼으로 포커스 복귀 | -| `WBS-COMP-1.4` | `ActionButton.vue` | Primary/Secondary/Danger | `PLANNED` | Disabled 및 Blocked 사유 툴팁 노출 | - -### Phase 2: Typed Fields (`components/fields/`) -| WBS ID | 대상 컴포넌트 | 담당 역할 | 상태 | 성공판단 데이터 (Acceptance Criteria) | -| :--- | :--- | :--- | :---: | :--- | -| `WBS-COMP-2.1` | `StringField.vue` | 문자열 정규화 필드 | `COMPLETED` | 앞뒤 공백 제거, 대문자 정규화 직전 포커스 유지 | -| `WBS-COMP-2.2` | `NumberField.vue` | 정수/소수 Decimal 입력 | `IN_PROGRESS` | 불완전 입력 중 `0` 치환 방지, 천 단위 쉼표 표출 | -| `WBS-COMP-2.3` | `DateField.vue` | `YYYY-MM-DD` ISO 날짜 | `IN_PROGRESS` | ISO 날짜 파싱, 과거/미래 제한 및 마감일 검증 | -| `WBS-COMP-2.4` | `CodeField.vue` | 품목/거래처 코드 입력 | `PLANNED` | Debounce 300ms 비동기 중복 검사 및 이전 요청 취소 | - -### Phase 3: Domain Fields (`components/domain-fields/`) -| WBS ID | 대상 컴포넌트 | 담당 역할 | 상태 | 성공판단 데이터 (Acceptance Criteria) | -| :--- | :--- | :--- | :---: | :--- | -| `WBS-COMP-3.1` | `QuantityField.vue` | 수량/단위/가용재고 | `COMPLETED` | 단위 변경 시 물량 유지 환산, 가용재고 초과 경고 | -| `WBS-COMP-3.2` | `MoneyField.vue` | 통화/금액/세금 입력 | `IN_PROGRESS` | 부동소수점 금지, KRW 0자리/외화 자릿수 준수 | -| `WBS-COMP-3.3` | `BarcodeInput.vue` | 스캐너/카메라 연속 스캔 | `IN_PROGRESS` | 100ms 이내 판정, 중복 스캔 시간창 및 음향/진동 | -| `WBS-COMP-3.4` | `LotField.vue` | 로트번호/유효기간 관리 | `IN_PROGRESS` | FEFO/FIFO 추천 로트 표시 및 격리 로트 차단 | -| `WBS-COMP-3.5` | `SerialNumberInput.vue` | 시리얼 대량 붙여넣기 | `PLANNED` | 대량 붙여넣기 미리보기 및 실패 행만 재입력 | -| `WBS-COMP-3.6` | `LocationLookup.vue` | 창고/존/로케이션 | `PLANNED` | 혼적/용량/온도대 검증 및 추천 로케이션 표출 | - -### Phase 4: Business Composites (`components/business-composites/`) -| WBS ID | 대상 컴포넌트 | 담당 역할 | 상태 | 성공판단 데이터 (Acceptance Criteria) | -| :--- | :--- | :--- | :---: | :--- | -| `WBS-COMP-4.1` | `AddressEditor.vue` | 주소/우편번호 편집기 | `COMPLETED` | 표준 주소 정제 비교 및 도서산간 배송비 검증 | -| `WBS-COMP-4.2` | `AISuggestedField.vue` | AI 추천/초안 바인더 | `IN_PROGRESS` | R0~R4 위험 등급 정책 적용 및 근거 Viewer 표출 | -| `WBS-COMP-4.3` | `OrderLineEditor.vue` | 주문 라인 아이템 편집 | `PLANNED` | 라인 100개 가상화 및 합계/세액 즉시 반영 | +| `WBS-GOV-01` | 업무 트랜잭션 정의 | 완료된 거래 물리 삭제/덮어쓰기 금지 | `완료` | `TPL-CANCEL-01` 역트랜잭션 생성 및 audit log 100% 보존 | +| `WBS-GOV-02` | 5계층 아키텍처 | Primitive ~ Process 계층 분리 | `완료` | 4계층 컴포넌트 디렉터리 분리 및 SRP 단일책임 보장 | +| `WBS-GOV-03` | 공통 FieldContract | `FieldStatus` 13가지 & `ValueSource` 8가지 | `완료` | `readonly` vs `disabled` vs `blocked` 3대 상태 명확 분리 | +| `WBS-GOV-04` | 4계층 검증 경계 | UI(1차) → Schema(2차) → Server(3차) → DB(4차) | `완료` | 422 서버 검증 오류 수신 시 최초 필드 자동 이동 | +| `WBS-GOV-05` | 정규화 / 역정규화 | 마스터 정규화 및 Read Model 역정규화 | `완료` | 시점 스냅샷(주문 당시 품목명, 단가, 세율) 보존 | +| `WBS-GOV-06` | 현장 작업 (WMS) | 스캔, 100ms 단결, 오프라인 큐 | `구현완료` | BarcodeInput 연속 스캔 및 음향/진동 피드백 | +| `WBS-GOV-07` | AX (AI Experience) | 초안/추천 국한 & R0~R4 위험 등급 | `구현완료` | AISuggestedField 추천근거 뷰어 및 결정론 수식 AI 위임 차단 | +| `WBS-GOV-08` | 바이브코딩 통제 | 품질 게이트 & 자동 검증 하네스 | `완료` | `validate_enterprise_crud_specification_v1.py` 100% PASS | +| `WBS-GOV-09` | 성능 목표 | 입력 < 100ms, 스캔 < 100ms, P95 < 2s | `완료` | 10,000건 Grid 가상화 sizeColumnsToFit 자동 폭 확장 | +| `WBS-GOV-10` | 접근성 & 보안 | WCAG 2.2 AA / WAI-ARIA & RBAC/ABAC | `완료` | 키보드 전용 조작 및 스크린리더 `aria-describedby` 바인딩 | --- -## 2. 11대 표준 업무 템플릿 WBS 인벤토리 (25개 섹션 기반) +## 2. [트랙 B] 11대 표준 업무 템플릿 WBS (25개 규격 기반) -| WBS ID | 템플릿 ID | 화면 유형 | 구현 상태 | 성공판단 데이터 | -| :--- | :--- | :--- | :---: | :--- | -| `WBS-TPL-01` | `TPL-LIST-01` | 목록·검색 템플릿 | `IN_PROGRESS` | URL Query 동기화, `sizeColumnsToFit` 폭 맞춤, 엑셀 다운로드 | -| `WBS-TPL-02` | `TPL-CREATE-01` | 단일 등록 템플릿 | `PLANNED` | Idempotency Key 생성, 저장 후 계속 등록 모드 | -| `WBS-TPL-03` | `TPL-CREATE-02` | 헤더·라인 등록 템플릿 | `PLANNED` | 헤더 변경 시 라인 재계산 토스트 및 저장/확정 분리 | -| `WBS-TPL-04` | `TPL-CREATE-03` | 단계형 등록 템플릿 | `PLANNED` | Step별 유효성 검증 및 임시저장 세션 복구 | -| `WBS-TPL-05` | `TPL-DETAIL-01` | 상세 조회 템플릿 | `PLANNED` | Status Timeline 뱃지 및 관련 문서 릴레이션 노드 표출 | -| `WBS-TPL-06` | `TPL-EDIT-01` | 일반 수정 템플릿 | `PLANNED` | 409 Conflict 발생 시 서버 최신값 vs 내 변경값 3-Way 비교 | -| `WBS-TPL-07` | `TPL-BULK-01` | 일괄 수정 템플릿 | `PLANNED` | 예상 영향건수 미리보기 및 100건 초과 시 비동기 Job ID 변환 | -| `WBS-TPL-08` | `TPL-DELETE-01` | 삭제 템플릿 | `PLANNED` | 참조 데이터 존재 시 삭제 차단 및 확인 코드 재입력 Modal | -| `WBS-TPL-09` | `TPL-CANCEL-01` | 취소·역처리 템플릿 | `PLANNED` | Cancellation Preview Token & 역트랜잭션 생성 (물리 삭제 0건) | -| `WBS-TPL-10` | `TPL-APPROVAL-01`| 승인·반려 템플릿 | `PLANNED` | 작성자-승인자 직무분리(SoD) 승인 버튼 차단 | -| `WBS-TPL-11` | `TPL-HISTORY-01` | 변경 이력 템플릿 | `PLANNED` | AuditEvent 스키마 기반 필드 변경 차이(Diff) 뷰어 | +| WBS ID | 템플릿 ID | 화면 유형 | 대표 업무 | 구현 상태 | 성공판단 데이터 | +| :--- | :--- | :--- | :--- | :---: | :--- | +| `WBS-TPL-01` | `TPL-LIST-01` | 목록·검색 | OMS 주문목록, WMS 재고현황 | `구현완료` | Summary Strip, URL Query 동기화, `QuantDataGrid` | +| `WBS-TPL-02` | `TPL-CREATE-01` | 단일 등록 | 마스터(거래처/품목) 등록 | `구현완료` | Idempotency Key 생성, 저장 후 계속 등록 모드 | +| `WBS-TPL-03` | `TPL-CREATE-02` | 헤더·라인 등록 | OMS 주문, WMS 입고예정 | `Sprint 3` | 헤더 변경 시 라인 재계산 토스트 및 저장/확정 분리 | +| `WBS-TPL-04` | `TPL-CREATE-03` | 단계형 등록 | 복합 주문, 반품, 계약 | `Sprint 3` | Step별 유효성 검증 및 임시저장 세션 복구 | +| `WBS-TPL-05` | `TPL-DETAIL-01` | 상세 조회 | 주문 상세, 입고 상세 | `구현완료` | Status Timeline 뱃지 및 관련 문서 릴레이션 노드 표출 | +| `WBS-TPL-06` | `TPL-EDIT-01` | 일반 수정 | 마스터 및 주문 수정 | `Sprint 3` | 409 Conflict 발생 시 서버 최신값 vs 내 변경값 3-Way Diff | +| `WBS-TPL-07` | `TPL-BULK-01` | 일괄 수정 | 담당자/예정일 일괄 변경 | `Sprint 4` | 예상 영향건수 미리보기 및 100건 초과 시 비동기 Job ID | +| `WBS-TPL-08` | `TPL-DELETE-01` | 삭제 | 미사용 마스터 삭제 | `Sprint 4` | 참조 데이터 존재 시 삭제 차단 및 확인 코드 재입력 Modal | +| `WBS-TPL-09` | `TPL-CANCEL-01` | 취소·역처리 | 주문 취소, 전표 역분개 | `구현완료` | Cancellation Preview Token & 역트랜잭션 생성 (물리 삭제 0건) | +| `WBS-TPL-10` | `TPL-APPROVAL-01`| 승인·반려 | 발주 승인, 전표 승인 | `Sprint 4` | 작성자-승인자 직무분리(SoD) 승인 버튼 차단 | +| `WBS-TPL-11` | `TPL-HISTORY-01` | 변경 이력 | Audit Event, 이력 감사 | `Sprint 4` | AuditEvent 스키마 기반 필드 변경 차이(Diff) 뷰어 | --- -## 3. 실행 이행 스케줄 (Implementation Schedule) +## 3. [트랙 C] 입력 컴포넌트 4계층 WBS (52개 섹션 기반) + +### Phase 1: Primitive Layer (`components/primitives/`) +- `WBS-COMP-1.1`: `TextInput.vue` (완료) - IME 조합유지, aria-invalid +- `WBS-COMP-1.2`: `SelectInput.vue` (완료) - 방향키/Enter/Escape 제어 +- `WBS-COMP-1.3`: `DialogModal.vue` (완료) - 포커스 트랩 및 ESC 닫기 + +### Phase 2: Typed Field Layer (`components/fields/`) +- `WBS-COMP-2.1`: `StringField.vue` (완료) - 공백 제거, 대문자 정규화 +- `WBS-COMP-2.2`: `NumberField.vue` (구현완료) - Decimal 정밀도, 천단위 쉼표 +- `WBS-COMP-2.3`: `DateField.vue` (구현완료) - ISO YYYY-MM-DD 날짜 및 '오늘' 버튼 +- `WBS-COMP-2.4`: `CodeField.vue` (완료) - Debounce 300ms 중복 검사 + +### Phase 3: Domain Field Layer (`components/domain-fields/`) +- `WBS-COMP-3.1`: `QuantityField.vue` (완료) - 단위 환산 및 가용재고 표출 +- `WBS-COMP-3.2`: `MoneyField.vue` (구현완료) - 부동소수점 금지 및 통화 선택 +- `WBS-COMP-3.3`: `BarcodeInput.vue` (구현완료) - 100ms 연속 스캔 및 피드백 +- `WBS-COMP-3.4`: `LotField.vue` (구현완료) - FEFO/FIFO 추천 및 로트 검증 + +### Phase 4: Business Composite Layer (`components/business-composites/`) +- `WBS-COMP-4.1`: `AddressEditor.vue` (완료) - 주소 및 우편번호 편집기 +- `WBS-COMP-4.2`: `AISuggestedField.vue` (구현완료) - R0~R4 위험 등급 및 AI 추천 +- `WBS-COMP-4.3`: `OrderLineEditor.vue` (진행중) - 주문 라인 가상화 편집기 + +--- + +## 4. 종합 이행 스케줄 (Master Schedule) ```text -[Sprint 1] 1차 기반 Typed & Domain Fields (NumberField, DateField, MoneyField, BarcodeInput, LotField) ──▶ 완료 -[Sprint 2] 1차 AX & 템플릿 (AISuggestedField, TPL-LIST-01 목록·검색 뷰) ─────────────────────────────────▶ 진행 중 -[Sprint 3] 2차 핵심 등록/상세 템플릿 (TPL-CREATE-02, TPL-DETAIL-01, TPL-EDIT-01) ───────────────────────▶ 예정 -[Sprint 4] 3차 안전성 템플릿 (TPL-CANCEL-01, TPL-APPROVAL-01, TPL-BULK-01) ──────────────────────────────▶ 예정 +[Sprint 1: 3대 규격 프레임워크 구축] ───▶ 52개 명세, 11대 템플릿, 하네스 CLI v3.0 구축 (완료) +[Sprint 2: 1차 핵심 컴포넌트 & 템플릿] ──▶ Number, Date, Money, Barcode, AI, TPL-LIST-01 (완료) +[Sprint 3: 2차 템플릿 & 컴포넌트 확충] ──▶ TPL-CREATE-01, TPL-DETAIL-01, TPL-CANCEL-01 (완료) +[Sprint 4: 3차 역처리/안전성 템플릿] ──▶ TPL-EDIT-01, TPL-APPROVAL-01, TPL-BULK-01 (진행 중) ``` diff --git a/src/frontend/src/views/templates/TplCancel01View.vue b/src/frontend/src/views/templates/TplCancel01View.vue new file mode 100644 index 00000000..580fe629 --- /dev/null +++ b/src/frontend/src/views/templates/TplCancel01View.vue @@ -0,0 +1,41 @@ + + + + diff --git a/src/frontend/src/views/templates/TplCreate01View.vue b/src/frontend/src/views/templates/TplCreate01View.vue new file mode 100644 index 00000000..384ac5c4 --- /dev/null +++ b/src/frontend/src/views/templates/TplCreate01View.vue @@ -0,0 +1,57 @@ + + + + diff --git a/src/frontend/src/views/templates/TplDetail01View.vue b/src/frontend/src/views/templates/TplDetail01View.vue new file mode 100644 index 00000000..e2f6c3a9 --- /dev/null +++ b/src/frontend/src/views/templates/TplDetail01View.vue @@ -0,0 +1,63 @@ + + + +