diff --git a/INDEX.md b/INDEX.md index 81fde56..e8f6b14 100644 --- a/INDEX.md +++ b/INDEX.md @@ -159,6 +159,7 @@ docs/ | [integrated-phase-0-1.md](plans/integrated-phase-0-1.md) | 통합 Phase 0-1: 사전 조사 + product_code 전파 수정 | | [integrated-phase-2.md](plans/integrated-phase-2.md) | 통합 Phase 2: 절곡 검사 분석/설계 + 견적/품질 개선 | | [integrated-phase-3.md](plans/integrated-phase-3.md) | 통합 Phase 3: 절곡 검사 동적 구현 | +| [integrated-test-scenarios.md](plans/integrated-test-scenarios.md) | 통합 계획 기능 단위 테스트 시나리오 (11개 FU) | | [product-code-traceability-plan.md](plans/product-code-traceability-plan.md) | 제품코드 추적성 계획 (아카이브 — 통합 계획 참조) | | [document-system-improvement-plan.md](plans/document-system-improvement-plan.md) | 검사 단위 구조 정비 계획 (아카이브 — 통합 계획 참조) | diff --git a/plans/integrated-master-plan.md b/plans/integrated-master-plan.md index 857cbdf..6a766d0 100644 --- a/plans/integrated-master-plan.md +++ b/plans/integrated-master-plan.md @@ -7,6 +7,7 @@ > - [`product-code-traceability-plan.md`](./product-code-traceability-plan.md) (아카이브 참조) > - [`document-system-improvement-plan.md`](./document-system-improvement-plan.md) (아카이브 참조) > - [`document-system-improvement-review.md`](./document-system-improvement-review.md) (정책 결정 16건) +> **테스트**: [`integrated-test-scenarios.md`](./integrated-test-scenarios.md) (기능 단위 11개 FU) --- diff --git a/plans/integrated-test-scenarios.md b/plans/integrated-test-scenarios.md new file mode 100644 index 0000000..ac9d539 --- /dev/null +++ b/plans/integrated-test-scenarios.md @@ -0,0 +1,552 @@ +# 통합 개선 계획 — 기능 단위 테스트 시나리오 + +> **통합 계획**: [`integrated-master-plan.md`](./integrated-master-plan.md) +> **목적**: 각 작업 완료 후 즉시 검증할 수 있는 기능 단위(FU) 테스트 시나리오 +> **작성일**: 2026-02-27 + +--- + +## 테스트 환경 + +| 항목 | 값 | +|------|------| +| 프론트 | `dev.sam.kr` (Next.js) | +| API | `api.sam.kr` (Laravel) | +| 관리자 | `mng.sam.kr` / `admin.sam.kr` | +| DB | Docker `sam-mysql-1` | + +--- + +## FU-1: 수주 → 작업지시 생성 시 product_code 전달 + +> **작업**: `OrderService::createProductionOrder` options 복사에 product_code 추가 +> **Phase**: 1 (작업 1.1) +> **수정 파일**: `api/app/Services/OrderService.php` (L1410) + +### 선행 조건 +- product_code가 있는 수주 데이터 1건 이상 존재 +- 해당 수주의 `order_nodes.options.product_code`에 값이 있어야 함 + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **수주관리** (`/sales/order-management-sales`) | product_code가 있는 수주 1건 클릭 → 상세 페이지 진입 | 수주 상세 정상 표시 | +| 2 | 수주 상세 | "작업지시 생성" 버튼 클릭 | 작업지시 생성 성공 메시지 | +| 3 | **작업지시 관리** (`/production/work-orders`) | 방금 생성한 작업지시 찾기 → 행 클릭 | 상세 정보 표시 | + +### 기대 결과 — DB 확인 + +```sql +-- 방금 생성한 작업지시의 품목에서 product_code 확인 +SELECT woi.id, + JSON_EXTRACT(woi.options, '$.product_code') as product_code, + JSON_EXTRACT(woi.options, '$.product_name') as product_name +FROM work_order_items woi +JOIN work_orders wo ON woi.work_order_id = wo.id +WHERE wo.id = {새로_생성된_작업지시_ID} + AND woi.deleted_at IS NULL; +``` + +**정상**: `product_code`에 값이 있음 (예: `FG-KQTS01-측면형-SUS`) +**비정상**: `product_code`가 NULL + +### 엣지 케이스 + +| 케이스 | 조작 | 기대 결과 | +|--------|------|----------| +| product_code가 없는 수주 | 해당 수주로 작업지시 생성 | 오류 없이 생성, product_code는 NULL | +| product_code가 빈 문자열("") | 해당 수주로 작업지시 생성 | product_code가 options에 포함되지 않음 (empty 필터링) | + +--- + +## FU-2: 작업지시 관리에서 수주 연동 등록 시 product_code 전달 + +> **작업**: `WorkOrderService::store` 수주복사 로직에 product_code 추가 +> **Phase**: 1 (작업 1.2) +> **수정 파일**: `api/app/Services/WorkOrderService.php` (L287-296) + +### 선행 조건 +- FU-1과 동일 (product_code 있는 수주) + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **작업지시 관리** (`/production/work-orders`) | 우측 상단 "등록" 또는 `?mode=new` | 등록 폼 표시 | +| 2 | 등록 폼 | "수주 연동 등록" 라디오 선택 | 수주 선택 모달 활성화 | +| 3 | 수주 선택 모달 | product_code가 있는 수주 선택 | 기본 정보 자동 채움 | +| 4 | 등록 폼 | 공정 선택 → 출고예정일 입력 → "등록" 버튼 | 작업지시 생성 성공 | + +### 기대 결과 — DB 확인 + +```sql +-- FU-1과 동일 쿼리, 새 작업지시 ID로 실행 +SELECT woi.id, + JSON_EXTRACT(woi.options, '$.product_code') as product_code, + JSON_EXTRACT(woi.options, '$.product_name') as product_name +FROM work_order_items woi +WHERE woi.work_order_id = {새_작업지시_ID} + AND woi.deleted_at IS NULL; +``` + +**정상**: `product_code` 값 존재 +**FU-1과 차이**: 이 경로는 `WorkOrderService::store`를 통과 (OrderService 아님) + +--- + +## FU-3: 작업지시 품목 수정 시 product_code 보존 + +> **작업**: `WorkOrderService::update` 품목 수정 시 기존 options 보존 확인 +> **Phase**: 1 (작업 1.4) +> **수정 파일**: `api/app/Services/WorkOrderService.php` (L416-438) + +### 선행 조건 +- FU-1 또는 FU-2로 생성된 작업지시 (product_code 있는 것) + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **작업지시 상세** | product_code가 있는 작업지시 진입 | 상세 정보 표시 | +| 2 | 상세 → 수정 | 품목명 또는 수량 변경 → 저장 | 수정 성공 | + +### 기대 결과 — DB 확인 + +```sql +-- 수정 후 product_code가 사라지지 않았는지 확인 +SELECT woi.id, + JSON_EXTRACT(woi.options, '$.product_code') as product_code, + JSON_EXTRACT(woi.options, '$.floor') as floor, + JSON_EXTRACT(woi.options, '$.width') as width +FROM work_order_items woi +WHERE woi.work_order_id = {수정한_작업지시_ID} + AND woi.deleted_at IS NULL; +``` + +**정상**: product_code, floor, width 등 기존 options 값이 모두 유지 +**비정상**: product_code가 NULL로 변경됨 (덮어쓰기 발생) + +--- + +## FU-4: 기존 데이터 보정 마이그레이션 + +> **작업**: 기존 work_order_items에 product_code 역추적 보정 +> **Phase**: 1 (작업 1.5) +> **실행**: 마이그레이션 (스냅샷 백업 후) + +### 선행 조건 +- FU-1, FU-2 백엔드 수정 배포 완료 +- Phase 0 사전 조사로 영향 범위 파악 완료 + +### 테스트 순서 + +| # | 조작 | 기대 결과 | +|---|------|----------| +| 1 | 마이그레이션 실행 전 — 백업 테이블 존재 확인 | `work_order_items_backup_product_code` 생성됨 | +| 2 | 마이그레이션 실행 | 로그에 `product_code 보정 완료: N/M (X%)` 출력 | +| 3 | 보정 결과 확인 | 아래 SQL로 확인 | + +### 기대 결과 — DB 확인 + +```sql +-- 보정 후 전체 현황 +SELECT COUNT(*) as total, + COUNT(CASE WHEN JSON_EXTRACT(options, '$.product_code') IS NOT NULL THEN 1 END) as with_code, + ROUND(COUNT(CASE WHEN JSON_EXTRACT(options, '$.product_code') IS NOT NULL THEN 1 END) * 100.0 / COUNT(*), 1) as pct +FROM work_order_items WHERE deleted_at IS NULL; + +-- 보정 정확도 (원본 대조) +SELECT COUNT(*) as total_checked, + SUM(CASE WHEN JSON_EXTRACT(woi.options, '$.product_code') = JSON_EXTRACT(onode.options, '$.product_code') + THEN 1 ELSE 0 END) as match_count +FROM work_order_items woi +JOIN order_items oi ON woi.source_order_item_id = oi.id +JOIN order_nodes onode ON oi.order_node_id = onode.id +WHERE woi.deleted_at IS NULL + AND JSON_EXTRACT(woi.options, '$.product_code') IS NOT NULL; +``` + +**정상**: 보정율 90% 이상, 정확도 MATCH 100% +**비정상**: 보정율 50% 미만 → Phase 0 데이터 재확인 필요 + +--- + +## FU-5: WorkerScreen에 제품코드 표시 + +> **작업**: WorkerScreen actions.ts + index.tsx에 productCode 매핑/표시 +> **Phase**: 1 (작업 1.6) +> **수정 파일**: `react/src/components/production/WorkerScreen/actions.ts`, `index.tsx` + +### 선행 조건 +- FU-1 또는 FU-2 완료 (product_code가 있는 작업지시 존재) +- 또는 FU-4 완료 (기존 데이터 보정됨) + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **작업자 화면** (`/production/worker-screen`) | 접속 | 공정 탭(스크린/슬랫/절곡) + 작업 카드 표시 | +| 2 | 작업 카드 | product_code가 있는 작업지시의 카드 확인 | **제품코드가 카드에 표시됨** | +| 3 | 작업 카드 | product_code가 없는 작업지시의 카드 확인 | 기존처럼 품목명만 표시 (오류 없음) | + +### 기대 화면 + +**product_code 있는 경우:** +``` +┌──────────────────────────────────┐ +│ FG-KQTS01-측면형-SUS - 슬랫 방화 │ ← "제품코드 - 품목명" 형태 +│ FSS-01 | 3층 │ +│ [작업시작] [검사] [자재투입] │ +└──────────────────────────────────┘ +``` + +**product_code 없는 경우:** +``` +┌──────────────────────────────────┐ +│ 슬랫 방화 │ ← 품목명만 (기존과 동일) +│ FSS-01 | 3층 │ +│ [작업시작] [검사] [자재투입] │ +└──────────────────────────────────┘ +``` + +--- + +## FU-6: ProductionDashboard에 제품코드 표시 + +> **작업**: ProductionDashboard actions.ts에 productCode 매핑 +> **Phase**: 1 (작업 1.7) +> **수정 파일**: `react/src/components/production/ProductionDashboard/actions.ts` + +### 선행 조건 +- FU-5와 동일 + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **생산 현황판** (`/production/dashboard`) | 접속 | 공정 탭 + 통계 + 카드 표시 | +| 2 | 긴급/지연/최근완료 카드 | product_code 있는 작업지시 확인 | 제품코드 표시 | + +### 기대 화면 + +FU-5와 동일한 패턴. 카드에 `제품코드 - 품목명` 형태로 표시. + +--- + +## FU-7: 견적 저장 시 quotes.product_code 저장 + +> **작업**: QuoteService에서 견적 저장 시 quotes.product_code 컬럼에 대표 코드 저장 +> **Phase**: 2B (작업 2B.1) +> **수정 파일**: `api/app/Services/Quote/QuoteService.php` + +### 선행 조건 +- Phase 1 완료 + +### 테스트 순서 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **견적 관리** (`/sales/quote-management`) | "신규 견적" 버튼 | 견적 등록 폼 | +| 2 | 견적 등록 | 제품코드가 포함된 견적 데이터 입력 → 저장 | 저장 성공 | + +### 기대 결과 — DB 확인 + +```sql +-- 방금 저장한 견적의 product_code 확인 +SELECT id, product_code, product_name, + JSON_EXTRACT(calculation_inputs, '$.items[0].productCode') as first_item_code +FROM quotes +WHERE id = {새_견적_ID}; +``` + +**정상**: `product_code` = 첫 번째 개소의 productCode 값 +**다중 개소**: 첫 번째 개소 코드가 대표값으로 저장됨 + +### 엣지 케이스 + +| 케이스 | 기대 결과 | +|--------|----------| +| 개소 1개 견적 | product_code = 해당 개소 코드 | +| 개소 3개 견적 | product_code = 첫 번째 개소 코드 | +| productCode 없는 견적 | product_code = NULL (오류 없음) | + +--- + +## FU-8: 품질검사 ↔ 작업지시 FK 연결 + +> **작업**: inspections 테이블에 work_order_id FK 추가 + 보정 +> **Phase**: 2B (작업 2B.4~2B.7) +> **수정 파일**: 마이그레이션 + `api/app/Services/InspectionService.php` + +### 선행 조건 +- Phase 1 완료 +- Phase 0에서 lot_no 중복 건수 파악 완료 + +### 테스트 — 마이그레이션 + +```sql +-- FK 컬럼 추가 확인 +SHOW COLUMNS FROM inspections LIKE 'work_order_id'; +-- 결과: work_order_id | int | YES | NULL + +-- 기존 inspections 정상 조회 (회귀 테스트) +SELECT COUNT(*) FROM inspections WHERE deleted_at IS NULL; +``` + +### 테스트 — 신규 검사 생성 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **작업자 화면** | 작업 카드 → "중간검사" 버튼 | InspectionInputModal 열림 | +| 2 | 검사 입력 모달 | 검사 데이터 입력 → 저장 | 저장 성공 | + +```sql +-- 새로 생성된 inspection에 work_order_id가 있는지 확인 +SELECT id, work_order_id, lot_no +FROM inspections +ORDER BY id DESC LIMIT 5; +``` + +**정상**: `work_order_id` 값 존재 (해당 작업지시 ID) +**비정상**: `work_order_id` NULL + +### 테스트 — 기존 데이터 보정 + +```sql +-- lot_no 기반 역추적 보정 결과 +SELECT COUNT(*) as total, + COUNT(work_order_id) as with_wo_id, + ROUND(COUNT(work_order_id) * 100.0 / COUNT(*), 1) as pct +FROM inspections WHERE deleted_at IS NULL; +``` + +**정상**: 보정율 95% 이상 + +--- + +## FU-9: inspection-config API 동작 확인 + +> **작업**: `GET /api/v1/work-orders/{id}/inspection-config` 구현 +> **Phase**: 3 (작업 3.1) +> **수정 파일**: API Controller + Route + +### 선행 조건 +- Phase 1 완료 (product_code 전달) +- Phase 2A 완료 (API 설계) + +### 테스트 — API 직접 호출 + +```bash +# 절곡 공정 작업지시 +curl -s "https://api.sam.kr/api/v1/work-orders/{절곡_작업지시_ID}/inspection-config" \ + -H "Authorization: Bearer {token}" | jq . +``` + +### 기대 응답 — 절곡 공정 + +```json +{ + "success": true, + "data": { + "work_order_id": 123, + "process_type": "bending", + "product_code": "KWE01", + "template_id": 45, + "items": [ + { + "id": "guide-rail-wall", + "category": "KWE01", + "product_name": "가이드레일", + "product_type": "벽면형", + "gap_points": [...] + } + ] + } +} +``` + +### 기대 응답 — 스크린/슬랫 공정 + +```json +{ + "success": true, + "data": { + "work_order_id": 456, + "process_type": "screen", + "product_code": "FG-KQTS01", + "template_id": 12, + "items": [] + } +} +``` + +### 엣지 케이스 + +| 케이스 | API 호출 | 기대 응답 | +|--------|---------|----------| +| 절곡 + KWE01 | work_order_id=절곡KWE01 | items에 KWE01 구성품 목록 | +| 절곡 + KSS01 | work_order_id=절곡KSS01 | items에 **KSS01 전용** 구성품 (KWE01과 다름) | +| 스크린 공정 | work_order_id=스크린 | process_type="screen", items=[] | +| product_code 없는 작업지시 | work_order_id=수동생성 | product_code=null, items=[] | +| 존재하지 않는 ID | work_order_id=999999 | 404 에러 | +| 응답 시간 | 모든 케이스 | **< 200ms** | + +--- + +## FU-10: 절곡 검사 성적서 동적 구성품 표시 + +> **작업**: TemplateInspectionContent에서 API 기반 구성품 로딩 +> **Phase**: 3 (작업 3.2) +> **수정 파일**: `react/.../documents/TemplateInspectionContent.tsx` + +### 선행 조건 +- FU-9 완료 (inspection-config API 동작) + +### 테스트 순서 — KWE01 제품 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | **작업자 화면** | 절곡 탭 선택 → KWE01 작업 카드 클릭 | 작업 상세 | +| 2 | 작업 상세 | "중간검사" 버튼 | 검사 모달 열림 | +| 3 | 검사 모달 | 검사 성적서 탭 (또는 TemplateInspectionContent 영역) | **동적 구성품 목록 표시** | + +### 기대 화면 — KWE01 + +``` +┌─────────────────────────────────────────────────────┐ +│ 절곡 중간검사 성적서 │ +├─────────────────────────────────────────────────────┤ +│ │ +│ ▼ 개소 1 (1층 FSS-01) │ +│ ┌─────────────┬──────┬────────┬─────────────────┐ │ +│ │ 구성품 │ OK/NG│ 길이 │ 간격 포인트 │ │ +│ ├─────────────┼──────┼────────┼─────────────────┤ │ +│ │ 가이드레일벽면│ ○ │ [ ] │ ① ② ③ ④ ⑤ │ │ +│ │ 가이드레일측면│ ○ │ [ ] │ ① ② ③ ④ ⑤ │ │ +│ │ 케이스 │ ○ │ [ ] │ ① ② ③ ④ │ │ +│ │ 하단마감재 │ ○ │ [ ] │ ① ② │ │ +│ │ 하단L-BAR │ ○ │ [ ] │ ① │ │ +│ │ 연기차단재W50 │ ○ │ [ ] │ ① ② │ │ +│ │ 연기차단재W80 │ ○ │ [ ] │ ① ② │ │ +│ └─────────────┴──────┴────────┴─────────────────┘ │ +│ │ +│ ▼ 개소 2 (2층 FSS-02) │ +│ (동일 구조) │ +└─────────────────────────────────────────────────────┘ +``` + +### 테스트 순서 — KSS01 제품 (다른 구성품) + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | 작업자 화면 | KSS01 절곡 작업 카드 → 중간검사 | 검사 모달 | +| 2 | 검사 성적서 | 구성품 목록 확인 | **KWE01과 다른 구성품** 표시 | + +**정상**: KSS01 전용 구성품이 표시됨 (KWE01의 7개와 다른 항목) +**비정상**: KWE01과 동일한 7개 항목 표시 (하드코딩 그대로) + +### 테스트 — 저장/복원 사이클 + +| # | 조작 | 기대 결과 | +|---|------|----------| +| 1 | 검사 데이터 입력 (OK/NG, 측정값, 간격) | 입력값 반영 | +| 2 | 저장 버튼 | 저장 성공 메시지 | +| 3 | 검사 모달 닫기 → 다시 열기 | **입력했던 데이터 그대로 복원** | +| 4 | 다른 개소 선택 | 해당 개소 데이터 표시 (개소 간 데이터 독립) | + +### 테스트 — Fallback + +| 케이스 | 조작 | 기대 결과 | +|--------|------|----------| +| API 응답 items=[] (BOM 미등록) | 해당 작업지시 검사 열기 | `DEFAULT_GAP_PROFILES` 기본값 사용, 기존과 동일 표시 | +| API 타임아웃 | (네트워크 지연 시뮬레이션) | `buildBendingProducts()` fallback 동작, 에러 없음 | + +--- + +## FU-11: createInspectionDocument 트랜잭션 보강 + +> **작업**: lockForUpdate + DB::transaction 추가 +> **Phase**: 3 (작업 3.5) +> **수정 파일**: `api/app/Services/WorkOrderService.php` + +### 선행 조건 +- FU-10 완료 + +### 테스트 순서 + +| # | 조작 | 기대 결과 | +|---|------|----------| +| 1 | 작업자 화면 → 중간검사 → 검사 문서 생성 | 정상 생성 | +| 2 | 같은 작업지시에 대해 다시 검사 문서 생성 시도 | **기존 문서 반환** (중복 생성 안 됨) | + +### DB 확인 + +```sql +-- 동일 작업지시에 검사 문서가 1개만 있는지 확인 +SELECT linkable_id, template_id, COUNT(*) as cnt +FROM documents +WHERE linkable_type = 'App\\Models\\Production\\WorkOrder' + AND deleted_at IS NULL +GROUP BY linkable_id, template_id +HAVING COUNT(*) > 1; +``` + +**정상**: 결과 0건 (중복 없음) +**비정상**: 결과 있음 (중복 문서 존재) + +--- + +## 기능별 스크린/슬랫 회귀 테스트 + +> **대상**: 모든 FU 완료 후 +> **목적**: 기존 스크린/슬랫 검사가 영향받지 않았는지 확인 + +| # | 화면 | 조작 | 기대 결과 | +|---|------|------|----------| +| 1 | 작업자 화면 → 스크린 탭 | 스크린 작업 카드 → 중간검사 | 기존과 동일하게 검사 입력 가능 | +| 2 | 스크린 검사 | 데이터 입력 → 저장 → 재조회 | 저장/복원 정상 | +| 3 | 작업자 화면 → 슬랫 탭 | 슬랫 작업 카드 → 중간검사 | 기존과 동일 | +| 4 | 슬랫 검사 | 데이터 입력 → 저장 → 재조회 | 저장/복원 정상 | +| 5 | 작업지시 목록 API | `/api/v1/work-orders` 호출 | 정상 응답, 에러 0건 | +| 6 | 작업지시 상세 API | `/api/v1/work-orders/{id}` 호출 | 정상 응답 | + +--- + +## FU 실행 순서 체크리스트 + +``` +Phase 0: 사전 조사 (SQL만, FU 없음) + ↓ +Phase 1: + □ FU-1: 수주→작업지시 product_code 전달 (OrderService) + □ FU-2: 작업지시 수주연동 등록 product_code (WorkOrderService.store) + □ FU-3: 작업지시 수정 시 options 보존 (WorkOrderService.update) + □ FU-4: 기존 데이터 보정 마이그레이션 + □ FU-5: WorkerScreen 제품코드 표시 + □ FU-6: ProductionDashboard 제품코드 표시 + □ 회귀: 스크린/슬랫 검사 정상 동작 확인 + ↓ +Phase 2A: 분석/설계 (FU 없음, 문서 산출물) +Phase 2B: + □ FU-7: 견적 저장 시 product_code 저장 + □ FU-8: 품질검사 work_order_id FK 연결 + ↓ +Phase 3: + □ FU-9: inspection-config API 동작 + □ FU-10: 절곡 검사 성적서 동적 구성품 + □ FU-11: 트랜잭션 보강 (중복 생성 방지) + □ 회귀: 스크린/슬랫 + 기존 절곡(레거시) 정상 +``` + +--- + +## 변경 이력 + +| 날짜 | 항목 | 변경 내용 | +|------|------|----------| +| 2026-02-27 | 문서 작성 | 11개 FU 테스트 시나리오 + 회귀 테스트 작성 | + +--- + +*이 문서는 [`integrated-master-plan.md`](./integrated-master-plan.md)의 기능 단위 테스트 시나리오입니다.* \ No newline at end of file