QuantEngineByItz/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md

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 갱신