feat(templates): implement 11 standard CRUD template contracts and WBS roadmap with harness CLI v2.0 verification

2026-07-26 01:36:43 +09:00
parent 827d4f5aba
commit 1e37e715e9
5 changed files with 406 additions and 1151 deletions
@@ -0,0 +1,58 @@
+# OMS·WMS·ERP 공통 CRUD 화면 템플릿 상용화 WBS & 로드맵 (WBS-TPL-2026)
+
+## 0. 개요 및 하네스 완수 기준
+본 문서는 `docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md` 명세에 정의된 11대 표준 화면 템플릿(`TPL-LIST-01` ~ `TPL-HISTORY-01`) 및 25개 시스템 공통 규격의 단계별 구현 WBS와 검증 성공판단 데이터 계약을 기술한다.
+
+### 0.1 기본 하네스 4대 완수 조건
+1. **YAML/MD 계약**: `docs/ENTERPRISE_CRUD_DESIGN_SPECIFICATION.md` 및 `docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md`
+2. **코드 구현**: `src/frontend/src/types/enterpriseTemplateContracts.ts`, `tools/validate_enterprise_crud_specification_v1.py`
+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. 표준 템플릿 ID 매핑 인벤토리
+
+| 템플릿 ID | 화면 유형 | 주요 적용 도메인 | 상태 | 성공판단 데이터 |
+| :--- | :--- | :--- | :---: | :--- |
+| `TPL-LIST-01` | 목록·검색 | OMS 주문 목록, WMS 재고 현황, ERP 전표 목록 | `IN_PROGRESS` | URL Query 동기화, 서버 기반 정렬/페이징, 컬럼 자동맞춤 |
+| `TPL-CREATE-01` | 단일 등록 | 마스터(거래처/품목), 단순 코드 | `PLANNED` | Idempotency Key 부여, 최초 오류 필드 자동 포커스 |
+| `TPL-CREATE-02` | 헤더·라인 등록 | OMS 주문 등록, WMS 입고예정, ERP 전표 | `IN_PROGRESS` | 헤더 변경 시 라인 재계산 토스트, Decimal 정밀도 |
+| `TPL-CREATE-03` | 단계형 등록 | 복합 주문, 반품 처리, 계약 | `PLANNED` | Step별 유효성 검증, 임시저장 세션 복구 |
+| `TPL-DETAIL-01` | 상세 조회 | 주문 상세, 입고 상세, 전표 상세 | `IN_PROGRESS` | Status Timeline 표시, 관련 문서 Tree 내비게이션 |
+| `TPL-EDIT-01` | 일반 수정 | 마스터 및 주문 수정 | `IN_PROGRESS` | Version Conflict(409) 3-Way Diff 비교창 |
+| `TPL-BULK-01` | 일괄 수정 | 담당자/예정일/상태 일괄 변경 | `PLANNED` | 예상 영향건수 미리보기 및 비동기 Job ID 연동 |
+| `TPL-DELETE-01` | 삭제 | 임시/미사용 마스터 삭제 | `PLANNED` | 참조 관계 존재 시 삭제 차단 및 식별코드 재입력 Modal |
+| `TPL-CANCEL-01` | 취소·역처리 | 주문 취소, 출고 취소, 전표 역분개 | `PLANNED` | Cancellation Preview Token & 역트랜잭션 생성을 통한 물리 삭제 차단 |
+| `TPL-APPROVAL-01`| 승인·반려 | 발주 승인, 전표 승인 | `PLANNED` | 직무분리(SoD) 검증, 위험 경고 Chip 표출 |
+| `TPL-HISTORY-01` | 변경 이력 | Audit Event, 이력 감사 | `IN_PROGRESS` | AuditEvent 표준 스키마 기반 필드 차이(Diff) 뷰어 |
+
+---
+
+## 2. 단계별 WBS 작업 분해 및 성공판단 데이터
+
+### Phase 1: 1차 공통 기반 (Base Framework)
+- **WBS-TPL-1.1**: 공통 Layout & Navigation (`Global Header`, `Breadcrumb`, `Page Header`, `Sticky Action Bar`)
+  - *성공판단 데이터*: 200% Zoom 상에서 헤더/액션바 레이아웃 손실 없음 및 Keyboard Tab 이동 순서 일치
+- **WBS-TPL-1.2**: 16가지 공통 화면 상태 (`Initial Loading`, `Record Locked`, `Version Conflict`, `Offline` 등)
+  - *성공판단 데이터*: `FieldStatus` 12가지 및 Screen State 16가지 상태 전환 시 사용자 알림 토스트/경고표지 100% 동작
+- **WBS-TPL-1.3**: 4계층 검증 및 표준 오류 모델 (`FieldError`, `ApiErrorResponse`)
+  - *성공판단 데이터*: 422 Unprocessable Entity 수신 시 최초 오류 필드 포커스 및 `aria-describedby` 바인딩
+
+### Phase 2: 2차 핵심 템플릿 구현 (Core Templates)
+- **WBS-TPL-2.1**: `TPL-LIST-01` 목록·검색 템플릿 (`Summary Strip`, Lens Filter, AgGrid Header)
+  - *성공판단 데이터*: 10,000건 대용량 데이터 로딩 시 P95 1초 이내 렌더링 및 `sizeColumnsToFit` 자동 폭 맞춤
+- **WBS-TPL-2.2**: `TPL-CREATE-02` 헤더·라인 등록 템플릿
+  - *성공판단 데이터*: 라인 항목 100개 추가 시 Decimal 손실 없이 공급가액/세액/합계 100ms 이내 재계산
+- **WBS-TPL-2.3**: `TPL-DETAIL-01` 상세 조회 & `Status Timeline`
+  - *성공판단 데이터*: 주문접수 → 결제완료 → 재고할당 → 출고대기 Timeline 뱃지 및 관련 문서 릴레이션 노드 렌더링
+- **WBS-TPL-2.4**: `TPL-EDIT-01` 일반 수정 및 `Version Conflict` 충돌 해결 모달
+  - *성공판단 데이터*: 409 Conflict 발생 시 서버값 vs 내변경값 3-Way 비교 UI 표출 및 선택 적용 통과
+
+### Phase 3: 3차 역처리/안전성 템플릿 (Safety & Governance)
+- **WBS-TPL-3.1**: `TPL-CANCEL-01` 취소·역처리 템플릿 (Preview & Execute)
+  - *성공판단 데이터*: Preview Token 발행 후 역트랜잭션 생성 및 물리적 삭제 0건 보장
+- **WBS-TPL-3.2**: `TPL-APPROVAL-01` 승인·반려 템플릿 및 직무분리(SoD)
+  - *성공판단 데이터*: 작성자와 승인자 동일인 시 승인 버튼 비활성화(`blocked`) 및 경고 문구 표출
+- **WBS-TPL-3.3**: 하네스 자동 검증 CLI (`tools/validate_enterprise_crud_specification_v1.py`)
+  - *성공판단 데이터*: 25개 명세 섹션 및 11대 템플릿 파싱 100% `PASS` 및 `Temp/enterprise_crud_validation_report_v1.json` 갱신