docs: 개발서버 sam-docs 폴더에서 누락 문서 5건 복구

- guides/project-launch-roadmap.md
- plans/SAM_ERP_Storyboard_D1.4.md
- plans/SAM_ERP_회계관리_Storyboard_D1.6.md
- plans/integrated-master-plan.md
- plans/production-deployment-plan.md
This commit is contained in:
김보곤
2026-03-10 09:28:07 +09:00
parent ee1aaf183d
commit 13a5a56146
5 changed files with 4558 additions and 0 deletions

View File

@@ -0,0 +1,639 @@
# SAM 프로젝트 런칭 로드맵
**작성일**: 2025-11-24
**최종 수정**: 2025-12-02
**목적**: 프로젝트 전체 방향성 관리 및 런칭 준비 현황 추적
**대상**: 프로젝트 관리 및 의사결정용
---
## 1. 프로젝트 현황 개요
### 전체 시스템 구성
```
SAM (Smart Application Management)
├── api/ - Laravel 12 REST API (독립 모델)
├── mng/ - Plain Laravel 관리자 패널 (독립 모델, 운영 주력)
├── react/ - Next.js 15 사용자 프론트엔드
├── docs/ - 기술 문서
├── design/ - 디자인 시스템 (Storybook)
├── planning/ - 기획 문서
└── docker/ - Docker 개발 환경
```
### 프로젝트 구분
| 구분 | 대상 | 설명 | 담당 |
|------|------|------|------|
| **MES (경동기업)** | 경동기업 | 메인 프로젝트, 디자인 시스템 기준 | 디자이너 (기획+디자인) |
| **MES (주일기업)** | 주일기업 | 경동기업 디자인 기반 커스터마이징 | 기획자 |
| **ERP** | SAM 공통 | 공통 모듈 (인사, 회계, 결재 등) | 기획자 |
### MVP 범위 정의
| 구분 | 범위 | 설명 |
|------|------|------|
| **코어 MVP** | MES 핵심 기능 | 견적 → 수주 → 생산 → 출하 흐름 |
| **1차 MVP** | 코어 MVP + 추가 기능 | 품질, 자재, 단가, 회계 등 확장 |
### 각 시스템 역할
- **api**: 모든 비즈니스 로직과 데이터 처리의 중심
- **mng**: Pure Blade + Tailwind 관리자 패널 (운영 환경 주력)
- **react**: 최종 사용자용 인터페이스
- **design**: 디자인 시스템 및 컴포넌트 문서
### 현재 개발 완료율
- **백엔드 (API)**: 약 70% 완료
- ✅ 인증/권한, 멀티테넌트, 기준정보
- ✅ 제품/BOM, 견적/수주, 자재입고/검사
- 🔄 공정/생산, 단가/원가, 재고관리
- **프론트엔드**: 약 50% 완료
- ✅ Admin 패널 27개 Resources
- 🔄 React 사용자 포털 개발 중
---
## 2. 팀 구성 및 역할
### 팀 역할 분담
| 역할 | 담당자 | 주요 업무 | 비고 |
|------|--------|----------|------|
| **디자이너** | 재웅 정 | MES(경동기업) 기획 + 디자인 | 디자인 시스템 기준 |
| **기획자** | 이태화 | ERP 스토리보드, MES(주일기업) 기획, 운영, QA | 기획 완료 시 MES 합류 |
| **Frontend** | - | React 개발 | MES(경동) 우선 |
| **Backend** | hso be | API 서포트, mng 개발, 인프라, 정책/운영 | 전체 기술 지원 |
### 작업 우선순위
**Frontend 우선순위:**
1. **MES (경동기업)** - 디자이너 결과물 즉시 개발
2. **ERP + MES (주일기업)** - MES 짬/대기 시 병행
**Backend 역할:**
- Frontend API 서포트
- mng (운영 관리자 패널) 개발
- 인프라 셋팅
- 정책/운영 관련 일정 체크
---
## 3. 주요 마일스톤 개요
### 📅 마일스톤 타임라인
```
2025년 12월 2026년 1월 2026년 2월 2026년 3월
| | | |
MS1 MS2 MS3 MS4
코어 MVP 완료 1차 MVP + 베타 정식 런칭 안정화 완료
(단위테스트) (통합테스트)
```
### 마일스톤 요약
| 마일스톤 | 목표 | 기한 | 주요 내용 |
|---------|------|------|----------|
| **MS1** | 코어 MVP 개발 완료 | 2025-12-31 | MES 핵심 기능 + 단위테스트 |
| **MS2** | 1차 MVP + 베타 오픈 | 2026-01-31 | 통합테스트 + 베타 서비스 오픈 |
| **MS3** | 정식 런칭 | 2026-02-28 | 운영 서버 오픈 |
| **MS4** | 안정화 완료 | 2026-03-31 | 고객 성공 사례 확보 |
---
## 4. 기획 및 디자인 일정
### 4.1 MES (경동기업) - 디자이너 일정
**기간**: 2025-11-26 ~ 2025-12-26 (약 21일)
#### Phase 1: 견적 (11/27 ~ 11/28)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| S2 | 견적 리스트 | LIST | 0.25 | 11-27(목) | 11-27(목) |
| S2-1 | 견적 등록 | FORM | 0.5 | 11-27(목) | 11-27(목) |
| S2-2 | 견적 수정 | FORM | 0.25 | 11-27(목) | 11-28(금) |
| S2-3 | 견적 상세+탭 | DETAIL | 0.5 | 11-28(금) | 11-28(금) |
| S2-4 | 견적서 출력 | PRINT | 0.25 | 11-28(금) | 11-28(금) |
#### Phase 2: 기준-수식 (11/28 ~ 12/01)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| M12 | 견적수식 리스트 | LIST | 0.1 | 11-28(금) | 11-28(금) |
| M12-1 | 견적수식 등록 | FORM | 0.2 | 12-01(월) | 12-01(월) |
#### Phase 3: 수주 (12/01 ~ 12/04)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| S3-1 | 수주 리스트 | LIST | 0.25 | 12-01(월) | 12-01(월) |
| S3-2 | 수주 등록 | FORM | 0.5 | 12-01(월) | 12-02(화) |
| S4-3 | 수주 수정 | FORM | 1 | 12-02(화) | 12-03(수) |
| S4-4 | 수주 상세+탭 | DETAIL | 1 | 12-03(수) | 12-04(목) |
| S4-5 | 수주서 발송 | PRINT | 0.5 | 12-04(목) | 12-04(목) |
#### Phase 4: 생산 (12/04 ~ 12/08)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| P1-3-3 | 작업지시 리스트 | LIST | 0.25 | 12-04(목) | 12-05(금) |
| P1-3-4 | 작업지시 등록 | FORM | 0.5 | 12-05(금) | 12-05(금) |
| P1-3-5 | 작업지시 수정 | FORM | 0.2 | 12-05(금) | 12-05(금) |
| P1-3-6 | 작업지시 상세 | DETAIL | 0.25 | 12-05(금) | 12-08(월) |
| P1-3-7 | 작업실적 입력 | FORM | 0.5 | 12-08(월) | 12-08(월) |
| P1-3-8 | 작업실적 조회 | DETAIL | 0.25 | 12-08(월) | 12-08(월) |
#### Phase 5: 기준-공정 (12/08 ~ 12/10)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| M5 | 공정 리스트 | LIST | 0.25 | 12-08(월) | 12-08(월) |
| M5-1 | 공정 등록 | FORM | 0.5 | 12-09(화) | 12-09(화) |
| M5-2 | 공정 수정 | FORM | 0.2 | 12-09(화) | 12-09(화) |
| M5-3 | 공정 상세 | DETAIL | 0.5 | 12-10(수) | 12-10(수) |
#### Phase 6: 출하 (12/10 ~ 12/12)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| S4 | 출하 리스트 | LIST | 0.25 | 12-10(수) | 12-10(수) |
| S4-1 | 출하 등록 | FORM | 0.5 | 12-10(수) | 12-11(목) |
| S4-2 | 배송 조율/관리 | FORM | 0.5 | 12-11(목) | 12-11(목) |
| S4-3 | 상차 체크리스트 | FORM | 0.5 | 12-11(목) | 12-12(금) |
| S4-4 | 출하 수정+탭 | FORM | 0.5 | 12-12(금) | 12-12(금) |
#### Phase 7: 거래처 (12/15 ~ 12/16)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| S1-1 | 거래처 리스트 | LIST | 0.25 | 12-15(월) | 12-15(월) |
| S1-1 | 거래처 등록 | FORM | 0.5 | 12-15(월) | 12-15(월) |
| S1-2 | 거래처 수정 | FORM | 0.1 | 12-15(월) | 12-16(화) |
| S1-3 | 거래처 상세+탭 | DETAIL | 0.25 | 12-16(화) | 12-16(화) |
#### Phase 8: 품질 (12/16 ~ 12/19)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| M9 | 검사기준 리스트 | LIST | 0.5 | 12-16(화) | 12-16(화) |
| M9-1 | 검사기준 등록 | FORM | 1 | 12-17(수) | 12-17(수) |
| Q1 | 검사관리 리스트 | LIST | 0.5 | 12-18(목) | 12-18(목) |
| Q1-1 | 검사관리 등록 | FORM | 1 | 12-18(목) | 12-19(금) |
| Q1-2 | 검사관리 상세 | DETAIL | 0.5 | 12-19(금) | 12-19(금) |
#### Phase 9: 자재 (12/19 ~ 12/24)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| I1 | 재고현황 리스트 | LIST | 0.5 | 12-19(금) | 12-22(월) |
| I1-1 | 재고 상세+탭 | DETAIL | 1 | 12-22(월) | 12-23(화) |
| I2 | 입고 리스트 | LIST | 0.5 | 12-23(화) | 12-23(화) |
| I2-1 | 입고 등록 | FORM | 0.8 | 12-23(화) | 12-24(수) |
| I2-3 | 입고 상세+탭 | DETAIL | 0.5 | 12-24(수) | 12-24(수) |
#### Phase 10: 단가 (12/24)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| S6 | 단가 리스트 | LIST | 0.25 | 12-24(수) | 12-24(수) |
| S6-1 | 단가 등록 | FORM | 0.25 | 12-24(수) | 12-24(수) |
| S6-2 | 단가 수정 | FORM | 0.25 | 12-24(수) | 12-24(수) |
| S6-3 | 단가 상세+탭 | DETAIL | 0.25 | 12-24(수) | 12-24(수) |
#### Phase 11: 회계 (12/26)
| 화면ID | 화면명 | 유형 | 공수 | 시작일 | 종료일 |
|--------|--------|------|------|--------|--------|
| A1 | 판매조회 리스트 | LIST | 0.5 | 12-26(금) | 12-26(금) |
| A4 | 수금 리스트 3탭 | LIST | 0.25 | 12-26(금) | 12-26(금) |
| A4-1 | 수금 등록 | FORM | 0.25 | 12-26(금) | 12-26(금) |
### 4.2 기획자 일정 (ERP + 운영)
#### 기획 (이태화)
| 구분 | 업무 | 기간 | 일수 | 대상 |
|------|------|------|------|------|
| 스토리보드 | 공통, ERP | 11/26 ~ 12/12 | 13 | SAM |
| 가입 및 로그인 | 스토리보드 | 11/27 | 1 | SAM |
| 인사관리, 전자결재 | 스토리보드 | 11/28 ~ 12/01 | 4 | SAM |
| 회계, 보고서 | 스토리보드 | 12/02 ~ 12/09 | 6 | SAM |
| 고객센터, 게시판 | 스토리보드 | 12/10 ~ 12/12 | 3 | SAM |
| 주일기업 요구사항 정리 | 요구사항 | 12/02 ~ 12/12 | 9 | 주일기업 |
| 스토리보드 - 주일기업 MES | 기획 | 12/15 ~ 12/30 | 12 | 주일기업 |
| 스토리보드 - ERP 2차 | 기획 | 12/31 ~ 01/13 | 12 | SAM |
| 스토리보드 - MES 2차 | 기획 | 01/14 ~ 01/27 | 12 | SAM |
#### 운영 (hso be)
| 구분 | 업무 | 기간 | 일수 | 대상 |
|------|------|------|------|------|
| 보고서 지표 검토 | 운영 | 11/27 ~ 11/28 | 2 | SAM |
| 주일기업 자료 정리 및 취합 | 운영 | 11/26 ~ 11/28 | 3 | 주일기업 |
| 주일기업 업무 프로세스 인터뷰 | 운영 | 12/01 ~ 12/05 | 5 | 주일기업 |
| 법률 및 정책 검토 | 운영 | 12/08 ~ 12/19 | 10 | SAM |
---
## 5. MS1: 코어 MVP 개발 완료 (2025-12-31)
**목표**: MES 핵심 기능 개발 완료 + 단위테스트 통과
### 코어 MVP 범위
- **핵심 흐름**: 견적 → 수주 → 생산(작업지시/실적) → 출하
- **기준정보**: 거래처, 공정, 견적수식
- **단위테스트**: 커버리지 60% 이상
### 완료 기준
- ✅ 코어 MVP 기능 100% 구현
- ✅ 단위테스트 커버리지 60% 이상
- ✅ Swagger 문서화 (코어 MVP 범위)
- ✅ Critical/High 버그 0건
- ✅ API 평균 응답 속도 < 500ms
### 주요 산출물
- [ ] 코어 MVP 소스코드 (api, react)
- [ ] API 문서 (Swagger)
- [ ] 단위테스트 보고서
### Week별 작업
**Week 1 (12/02-12/08)**
| | 작업 내용 |
|----|----------|
| 📋 기획 | 회계/보고서 스토리보드 |
| 📋 운영 | 주일기업 업무 프로세스 인터뷰 |
| 🎨 디자인 | 생산, 기준-공정 화면 |
| 🔧 Backend | 공정/단가 체계 완성 |
| 💻 Frontend | React 개발 시작 (12/08~) |
**Week 2 (12/09-12/15)**
| | 작업 내용 |
|----|----------|
| 📋 기획 | 고객센터/게시판 스토리보드, 주일기업 MES 스토리보드 시작 |
| 📋 운영 | 법률 정책 검토 시작 |
| 🎨 디자인 | 출하, 거래처 화면 |
| 🔧 Backend | 견적서 PDF, 재고 트랜잭션 |
| 💻 Frontend | 견적/수주 화면 개발 |
| 🧪 QA | 단위테스트 시작 (12/10~) |
**Week 3 (12/16-12/22)**
| | 작업 내용 |
|----|----------|
| 📋 기획 | 주일기업 MES 스토리보드 진행 |
| 🎨 디자인 | 품질, 자재 화면 |
| 🔧 Backend | API 안정화, 버그 수정 |
| 💻 Frontend | 생산/출하 화면 개발 |
| 🧪 QA | 단위테스트 진행 |
**Week 4 (12/23-12/31)**
| | 작업 내용 |
|----|----------|
| 🎨 디자인 | 단가, 회계 화면 (완료) |
| 🔧 Backend | 코어 MVP 마무리 |
| 💻 Frontend | 코어 MVP 화면 완료 |
| 🧪 QA | 단위테스트 완료 |
### 체크포인트
- 12/15: 개발 70% 완료, 단위테스트 시작
- 12/22: 개발 90% 완료
- 12/29: 코어 MVP 개발 완료
- 12/31: **MS1 완료** - 단위테스트 통과
---
## 6. MS2: 1차 MVP + 베타 오픈 (2026-01-31)
**목표**: 통합테스트 완료 + 1차 MVP 완료 + 베타 서비스 오픈
### 1차 MVP 범위 (추가 예정)
- **확장 기능**: 품질, 자재, 단가, 회계
- **추가 기능**: (1차 MVP 일정에서 별도 정의)
### 완료 기준
- 통합테스트 통과
- 베타 서버 구축 완료
- 파일럿 고객 온보딩 완료
- 주요 시나리오 실전 테스트 완료
### 주요 산출물
- [ ] 1차 MVP 소스코드
- [ ] 통합테스트 보고서
- [ ] 베타 서버 환경
### Week별 작업
**Week 1 (01/01-01/05)**
| | 작업 내용 |
|----|----------|
| 🧪 QA | 통합테스트 시작 |
| 🔧 Backend | 베타 서버 구축, 도메인/SSL 설정 |
| 📋 기획 | ERP 2차 스토리보드 진행 |
**Week 2 (01/06-01/12)**
| | 작업 내용 |
|----|----------|
| 🧪 QA | 통합테스트 진행 |
| 🔧 Backend | 파일럿 고객 데이터 준비 |
| 💻 Frontend | 버그 수정, UI 개선 |
| 📋 기획 | ERP 2차 스토리보드 완료 (01/13) |
**Week 3 (01/13-01/19)**
| | 작업 내용 |
|----|----------|
| 🧪 QA | 통합테스트 완료 |
| 운영 | 파일럿 고객 온보딩 (1차) |
| 📋 기획 | MES 2차 스토리보드 시작 (01/14) |
**Week 4 (01/20-01/31)**
| | 작업 내용 |
|----|----------|
| 전체 | 실전 테스트, 피드백 수집 |
| 🔧 Backend | 긴급 버그 수정 |
| 📋 기획 | MES 2차 스토리보드 진행 |
### 베타 고객 프로필
| 고객사 | 업종 | 주요 사용 기능 | 기대 효과 |
|--------|------|----------------|----------|
| 경동기업 | 제조 | 견적/수주/BOM/생산 | MES 전체 검증 |
| 주일기업 | 제조 | MES 커스터마이징 | 확장성 검증 |
### 체크포인트
- 01/05: 베타 서버 오픈
- 01/13: 통합테스트 완료
- 01/20: 파일럿 고객 온보딩 완료
- 01/31: **MS2 완료** - 베타 서비스 오픈
---
## 7. MS3: 정식 런칭 (2026-02-28)
**목표**: 운영 서버 오픈 본격적인 서비스 시작
### 완료 기준
- 운영 서버 구축 완료 (이중화)
- 베타 피드백 반영 완료
- 보안 감사 통과
- 법적 문서 완비
### 주요 산출물
- [ ] 운영 서버 환경
- [ ] 보안 감사 보고서
- [ ] 마케팅 자료
### Week별 작업
**Week 1-2 (02/01-02/14): 운영 준비**
| 작업 | 내용 |
|------|------|
| 베타 피드백 반영 | UI/UX 개선, 성능 최적화 |
| 운영 서버 구축 | 이중화, 모니터링, 백업 |
| 보안 감사 | 취약점 점검 수정 |
| 📋 기획 | MES 2차 스토리보드 완료 (01/27) |
**Week 3-4 (02/15-02/28): 런칭**
| 작업 | 내용 |
|------|------|
| 정식 오픈 | 운영 서버 오픈 |
| 고객 온보딩 | 초기 고객 온보딩 시작 |
### 체크포인트
- 02/14: 운영 준비 완료
- 02/28: **MS3 완료** - 정식 런칭
---
## 8. MS4: 안정화 완료 (2026-03-31)
**목표**: 서비스 안정화 초기 고객 성공 사례 확보
### 완료 기준
- 시스템 가용성 99.5% 이상
- 고객 만족도 4.0/5.0 이상
- 성공 사례 3건 이상 확보
### 주요 작업
- 런칭 긴급 이슈 대응
- 모니터링 강화
- 고객 피드백 수집 반영
- 성능 최적화
- 고객 성공 사례 수집
- Q2 로드맵 수립
### 체크포인트
- 03/15: 초기 안정화 완료
- 03/31: **MS4 완료** - 안정화 완료
---
## 9. 개발 방향성
### 기술 아키텍처 방향
- **Backend**: Laravel 12 + PHP 8.4+
- **Frontend**: Next.js 15 + React 18
- **Database**: MySQL 8.0 (멀티테넌트 구조)
- **Auth**: Laravel Sanctum
- **API**: RESTful + Swagger 문서화
- **Deployment**: Docker + Docker Compose
### 핵심 개발 원칙
1. **Service-First**: 모든 비즈니스 로직은 Service 클래스에
2. **Multi-tenancy**: BelongsToTenant 스코프 필수 적용
3. **FormRequest**: Controller에서 직접 검증 금지
4. **API-First**: Backend 완성 Frontend 연동
5. **문서화**: Swagger 100% 완성 목표
### 디자인 시스템 전략
- **MES (경동기업)** 기준으로 디자인 시스템 구성
- **ERP** 경동기업 디자인 시스템 기반으로 Frontend가 직접 개발
- **MES (주일기업)** 경동기업 디자인 기반 커스터마이징
### 품질 기준
- API Rules 100% 준수
- Swagger 문서화 완성도 100%
- 테스트 커버리지 60% 이상
- Pint 코드 포맷팅 통과
- i18n 메시지 사용
---
## 10. 개발 작업 현황
### ✅ 백엔드 완료 항목
#### API 공통 기반
- [x] Exception Handler
- [x] Swagger 설정 (l5-swagger v1)
- [x] API Key 인증
- [x] Rate Limit, CORS
- [x] 권한 체크 미들웨어
#### 인증/보안
- [x] API Key 모델 인증
- [x] Role-Permission 시스템
- [x] 멀티테넌트 권한 구조
- [x] 권한 오버라이드 시스템
#### 테넌트 관리
- [x] BelongsToTenant 글로벌 스코프
- [x] TenantBootstrap 서비스
- [x] 테넌트 컨텍스트 주입
- [x] 테넌트 옵션/설정 관리
#### 기준정보/코드 관리
- [x] Category (3단계 트리)
- [x] CategoryField (동적 필드)
- [x] CategoryTemplate
- [x] Classification (공통 코드)
- [x] CommonCode 관리
#### 제품/부품/자재 도메인
- [x] Product 모델 (67개 모델)
- [x] Part 관리
- [x] Material 관리
- [x] ProductComponent (BOM 연결)
- [x] PriceHistory (단가 이력)
#### BOM (Bill of Materials)
- [x] BomTemplate 관리
- [x] BomTemplateItem CRUD
- [x] BomCalculationService (가격 계산)
- [x] ModelVersion (버전 관리)
- [x] 재귀 BOM 구조
#### 영업 흐름
- [x] Estimate (견적) - 기본 CRUD
- [x] EstimateItem (견적 라인)
- [x] Order (수주) - 5개 모델
- [x] OrderItem, OrderHistory
- [x] OrderItemComponent
#### 자재입고/수입검사
- [x] MaterialReceipt (자재입고)
- [x] MaterialInspection (수입검사)
- [x] MaterialInspectionItem (검사 항목)
#### 파일/로그 시스템
- [x] FileService, FileStorageService
- [x] AuditLogger, AuditLogService
- [x] File 모델 (Polymorphic)
### 🔄 백엔드 진행 중 (코어 MVP)
#### 공정/생산 계획
- [ ] Process Routing (공정 라우팅)
- [ ] Work Order (작업지시)
- [ ] Production Record (생산실적)
#### 견적서 출력
- [ ] 견적서 HTML 템플릿
- [ ] PDF 생성 (DomPDF/Snappy)
- [ ] 견적서 미리보기 API
### ⏳ 백엔드 예정 (1차 MVP)
#### 품질/자재/단가/회계
- [ ] 검사기준, 검사관리
- [ ] 재고현황, 입고 관리
- [ ] 단가 정책 로직
- [ ] 회계 조회/수금
### ✅ 프론트엔드 완료 항목
#### MNG 패널 (Pure Blade + Tailwind)
- [x] 주요 관리 화면 구현
- [x] Product, BOM, Material
- [x] Category, Role, Permission
- [x] Department, User, Tenant
- [x] Client, File 관리
### 🔄 프론트엔드 진행 중
#### React 사용자 포털
- [ ] 공통 레이아웃 최종 정리
- [ ] 견적/수주 화면
- [ ] 생산/출하 화면
- [ ] 기준정보 관리 UI
---
## 11. 리스크 관리
### High Risk
| 리스크 | 영향도 | 완화 방안 | 담당 |
|--------|--------|-----------|------|
| 개발 일정 지연 | High | 주간 진행률 체크, 우선순위 조정 | PM |
| 디자인-개발 병목 | High | Frontend 버퍼 확보, ERP 병행 | Frontend |
| 단가 계산 로직 복잡도 | High | 전문가 리뷰, Week 1 집중 | Backend |
### Medium Risk
| 리스크 | 영향도 | 완화 방안 | 담당 |
|--------|--------|-----------|------|
| 기획-개발 동기화 | Medium | 주간 싱크업, 스토리보드 우선 리뷰 | PM |
| 통합 테스트 시간 부족 | Medium | 자동화 테스트 확대 | QA |
---
## 12. 핵심 성공 지표 (KPI)
### 기술 지표
- [ ] 코어 MVP API 엔드포인트 구현
- [ ] Swagger 문서 100% 완성 (MVP 범위)
- [ ] 테스트 커버리지 60% 이상
- [ ] API 평균 응답 속도 < 500ms
- [ ] Critical/High 버그 0건
### 품질 지표
- [ ] Service-First 아키텍처 100% 준수
- [ ] FormRequest 검증 100% 적용
- [ ] BelongsToTenant 스코프 100% 적용
- [ ] Pint 코드 포맷팅 100% 통과
### 비즈니스 지표
- [ ] 베타 고객 2개사 확보
- [ ] 정식 고객 확보 (런칭 )
- [ ] 고객 만족도 4.0/5.0 이상
---
## 13. 담당자 및 연락처
| 역할 | 담당자 | 주요 업무 | 비고 |
|------|--------|----------|------|
| 프로젝트 관리 | - | 전체 일정 방향성 관리 | PM |
| 디자이너 | 재웅 | MES(경동기업) 기획 + 디자인 | 디자인 시스템 기준 |
| 기획자 | 이태화 | ERP/MES 스토리보드, 운영, QA | 기획 완료 MES 합류 |
| 백엔드 개발 | hso be | API/mng/인프라/정책 | 기술 총괄 |
| 프론트엔드 개발 | - | React 개발 | MES(경동) 우선 |
| QA | - | 테스트 | 단위/통합 테스트 |
---
## 14. 작업 추적 및 관리
### 진행 상황 업데이트
- **매일**: 저장소별 CURRENT_WORKS.md 업데이트
- **매주**: 주차별 로드맵 진행률 체크
- ** 2주**: 전체 로드맵 리뷰 조정
### 관련 문서
- **개발 세부 계획**: `/claudedocs/SAM_DECEMBER_ROADMAP.md`
- **MES 프로젝트**: `/claudedocs/mes/MES_PROJECT_ROADMAP.md`
- **프로젝트 가이드**: `/CLAUDE.md`
- **빠른 참조**: `/SAM_QUICK_REFERENCE.md`
---
## 15. 다음 단계 (1차 MVP 이후)
### 1차 MVP 추가 기능 (별도 일정)
- 품질 관리 (검사기준/검사관리)
- 자재 관리 (재고현황/입고)
- 단가 관리
- 회계 (판매조회/수금)
### Phase 2: 프론트엔드 고도화
- React Admin 패널 완전 재구축
- 사용자 포털 (고객 견적 요청)
- 모바일 대응
- 실시간 대시보드
### Phase 3: 고급 기능
- 실시간 생산 모니터링
- IoT 센서 연동
- AI 기반 수요 예측
---
**작성**: Claude Code
**최종 업데이트**: 2025-12-02
**다음 리뷰**: 2025-12-09 (주간 체크)

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,382 @@
# 통합 개선 계획 — 제품코드 추적성 + 검사 단위 구조 정비
> **작성일**: 2026-02-27
> **목적**: 두 개선 계획(제품코드 추적성, 검사 단위 구조)을 하나의 순차적 실행 계획으로 통합
> **상태**: 🔄 Phase 0~3 완료, Phase 4 이후 대기
> **원본 문서**:
> - [`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)
---
## 📍 현재 진행 상태
| 항목 | 내용 |
|------|------|
| **마지막 완료 작업** | Phase 3 - 절곡 검사 동적 구현 (inspection-config API + 트랜잭션 보강) |
| **다음 작업** | Phase 4 (절곡 재공품 + 결재 워크플로우) — 후순위 |
| **진행률** | 5/7 Phase (Phase 0+1+2A+2B+3 완료) |
| **마지막 업데이트** | 2026-02-27 |
---
## 1. 왜 통합이 필요한가
두 계획은 **의존성이 교차**한다:
- 검사 단위 구조 정비(절곡 동적화)는 `work_order_items.options``product_code`가 있어야 동작
- `product_code` 전파 버그를 먼저 수정하지 않으면 검사 API(`inspection-config`)가 불완전
- 별도로 작업하면 순서 혼선, 중복 작업, 회귀 위험 발생
**통합 효과**:
- 의존성 순서를 강제하여 작업 꼬임 방지
- 병렬 가능 작업 식별으로 효율 극대화
- 진행 상태를 한 곳에서 관리
---
## 2. 통합 Phase 총괄
| Phase | 명칭 | 원본 | 의존성 | 상태 | 상세 |
|:-----:|------|------|--------|:----:|------|
| **0** | 사전 데이터 조사 | product-code P0 | 없음 | ✅ | [Phase 0-1 상세](./integrated-phase-0-1.md) |
| **1** | product_code 전파 버그 수정 | product-code P1 | Phase 0 | ✅ | [Phase 0-1 상세](./integrated-phase-0-1.md) |
| **2A** | 절곡 검사 분석/설계 | document-system P1 | 없음 (**Phase 1과 병렬**) | ✅ | [Phase 2 상세](./integrated-phase-2.md) |
| **2B** | 견적/수주 정합성 + 품질 FK | product-code P2+P3 | Phase 1 | ✅ | [Phase 2 상세](./integrated-phase-2.md) |
| **3** | 절곡 검사 동적 구현 | document-system P2 | Phase 1 + 2A | ✅ | [Phase 3 상세](./integrated-phase-3.md) |
| **4** | 절곡 재공품 + 결재 워크플로우 | document-system P3 | Phase 3 | ⏭️ | 마스터 요약만 |
| **5** | 완제품 마스터 + 출하 연결 | product-code P4 | Phase 2B | ⏭️ | 마스터 요약만 |
| **6** | 3관점 검사 + 수주별 뷰 | document-system P4 | Phase 3 + 기획자 | ⏭️ | 마스터 요약만 |
---
## 3. 의존성 다이어그램
```
┌─────────────────────────────────────────────┐
│ 실행 타임라인 │
└─────────────────────────────────────────────┘
Phase 0 ─── Phase 1 ──┬── Phase 2B ──── Phase 5
(조사) (P/C 수정) │ (견적/품질) (FG 마스터)
Phase 2A ──────────────┼── Phase 3 ──── Phase 4 ──── Phase 6
(절곡 분석) │ (절곡 구현) (재공품) (3관점)
※ Phase 1 + 2A 병렬 가능
※ Phase 2B + 3 준비 부분 병렬 가능
※ Phase 4 + 5 독립 (부분 병렬 가능)
크리티컬 패스: Phase 0 → 1 → 3 → 4 → 6
```
### 병렬 실행 가능 조합
| 조합 | 설명 | 조건 |
|------|------|------|
| Phase 1 + 2A | product_code 수정 + 절곡 분석 동시 진행 | 2A는 코드 변경 없음 (분석만) |
| Phase 2B + 3 시작 | 견적/품질 + 절곡 구현 | Phase 1 완료 필수 |
| Phase 4 + 5 | 절곡 재공품 + FG 마스터 | 각각 Phase 3, 2B 완료 |
---
## 4. 공통 원칙
```
┌─────────────────────────────────────────────────────────────────┐
│ 🎯 통합 핵심 원칙 │
├─────────────────────────────────────────────────────────────────┤
│ 1. 컬럼 추가 정책: FK/조인키만 컬럼, 나머지는 options JSON │
│ 2. 기존 데이터 보존: 파괴적 변경 없이 점진적 개선 │
│ 3. 역추적 가능: 어떤 단계에서든 원래 제품코드로 돌아갈 수 있어야 함│
│ 4. 네이밍 통일: Backend JSON=snake_case, Frontend=camelCase │
│ 5. 기존 동작 보존: 스크린/슬랫/조인트바 검사는 건드리지 않음 │
│ 6. TemplateInspectionContent 통합: 신규 개발은 여기서 (C3) │
│ 7. BendingInspectionContent 레거시 동결: 유지만, 신규 기능 X │
│ 8. row_index = 개소 통일: 구성품은 field_key 인코딩 (C1) │
│ 9. EAV + options 병행: 두 데이터 경로 독립 운용 (C2) │
│ 10. 롤백 = 템플릿 유무: document_template_id NULL → 레거시 (I4) │
└─────────────────────────────────────────────────────────────────┘
```
### 변경 승인 정책
| 분류 | 예시 | 승인 |
|------|------|------|
| ✅ 즉시 가능 | options JSON 필드 추가, React 컴포넌트 내부 리팩토링, 프론트 표시 변경 | 불필요 |
| ⚠️ 컨펌 필요 | 서비스 로직 변경, 마이그레이션, API 엔드포인트 추가, 양식 시더 수정 | **필수** |
| 🔴 금지 | 기존 테이블 컬럼 삭제, 기존 스크린/슬랫 검사 로직 변경 | 별도 협의 |
---
## 5. 핵심 데이터 흐름 (통합 TO-BE)
```
견적(quotes)
└─ product_code 컬럼 ✅ (Phase 2B)
└─ calculation_inputs → items[].productCode
▼ (createFromQuote)
수주(orders)
└─ order_nodes.options → ✅ product_code, product_name
▼ (createProductionOrder)
작업지시(work_orders)
├─ work_order_items.options → ✅ product_code (Phase 1 수정)
├─ inspection-config API → ✅ 공정 자동 판별 + BOM 기반 구성품 (Phase 3)
├─ TemplateInspectionContent → ✅ 동적 절곡 검사 (Phase 3)
└─ document_data EAV → ✅ C1 field_key 인코딩
품질검사(inspections)
└─ ✅ work_order_id FK (Phase 2B)
출하(shipments)
└─ ✅ product_code 포함 (Phase 5)
```
---
## 6. Phase별 요약
### Phase 0: 사전 데이터 조사 ⏳
**목표**: 마이그레이션 영향 범위 파악 (읽기 전용, 위험 없음)
- SQL 4개 실행: order_nodes product_code 보유율, work_order_items source 비율, soft delete 건수, lot_no 중복
- 결과에 따라 Phase 1 보정 전략 조정
→ [상세: integrated-phase-0-1.md](./integrated-phase-0-1.md)
---
### Phase 1: product_code 전파 버그 수정 ⏳
**목표**: 모든 work_order_items 생성/수정 경로에서 product_code, product_name 전달
- 백엔드 5개 코드 경로 수정 (OrderService, WorkOrderService)
- 기존 데이터 보정 마이그레이션 (스냅샷 백업 후)
- 프론트 WorkerScreen/ProductionDashboard에 제품코드 표시
- **배포 순서**: 백엔드 → 마이그레이션 → 프론트
→ [상세: integrated-phase-0-1.md](./integrated-phase-0-1.md)
---
### Phase 2A: 절곡 검사 분석/설계 ⏳ (**Phase 1과 병렬 가능**)
**목표**: 절곡 구성품(검사 항목) 정보를 API에서 제공하는 구조 설계
- items/BOM 테이블에서 KWE01/KSS01/KSS02 구성품 확인
- 마감유형(S1/S2/S3)별 차이 분석
- DEFAULT_GAP_PROFILES 기준치 5130 대조
- inspection-config 범용 API 설계
→ [상세: integrated-phase-2.md](./integrated-phase-2.md)
---
### Phase 2B: 견적/수주 정합성 + 품질 FK ⏳
**목표**: quotes.product_code 활용 + inspections ↔ work_orders FK 연결
- 견적 저장 시 quotes.product_code 저장
- inspections 테이블에 work_order_id FK 마이그레이션
- 기존 데이터 보정 (lot_no 기반 역추적)
- **Phase 2B 내부에서 견적/품질 작업은 병렬 가능** (독립 경로)
→ [상세: integrated-phase-2.md](./integrated-phase-2.md)
---
### Phase 3: 절곡 검사 동적 구현 ✅
**목표**: API 기반 동적 구성품 로딩으로 고정 로직 대체
- inspection-config API 구현 (BelongsToTenant 필수)
- TemplateInspectionContent buildBendingProducts → API 연동
- document_data EAV 저장/복원 검증 (C1 field_key)
- createInspectionDocument 트랜잭션 보강 (I2)
- 레거시(Path A) + 신규(Path B) 독립 동작 확인
→ [상세: integrated-phase-3.md](./integrated-phase-3.md)
---
### Phase 4: 절곡 재공품 + 결재 워크플로우 ⏭️
**목표**: BendingWip 양식 추가 + 결재 프론트 연동
| # | 작업 항목 | 비고 |
|---|----------|------|
| 4.1 | 절곡 재공품 mng 양식 시더 추가 | BendingWipInspectionContent 대응 |
| 4.2 | 결재 워크플로우 프론트 연동 | 작성→검토→승인 3단계 |
| 4.3 | React 기존 하드코딩 컴포넌트 전환 결정 | 프론트 담당자 협의 |
> 실행 시점에 상세 문서 별도 작성
---
### Phase 5: 완제품 마스터 + 출하 연결 ⏭️
**목표**: FG 품목 등록 + 출하 시 제품코드 포함 + orders.item_id
| # | 작업 항목 | 비고 |
|---|----------|------|
| 5.1 | 완제품(FG) 품목 자동 등록 방안 설계 | 견적 확정 시 or 수주 확정 시 |
| 5.2 | orders.item_id 설정 | FG 품목 등록 후 가능 |
| 5.3 | shipment_items에 product_code 포함 | 부분 출하 시 개소별 매핑 고려 |
| 5.4 | work_order_items.product_code 컬럼 승격 검토 | 통계 쿼리 성능용 |
| 5.5 | E2E 추적 검증 | 견적→출하→품질 전 구간 |
> 실행 시점에 상세 문서 별도 작성
---
### Phase 6: 3관점 검사 + 수주별 뷰 ⏭️
**목표**: 구성품별/개소별/수주별 3관점 검사 구조 + 수주별 읽기 전용 뷰
| # | 작업 항목 | 비고 |
|---|----------|------|
| 6.1 | 기획자와 3관점 화면 설계 협의 (I3) | 화면 구성·데이터 매핑·UI 설계 |
| 6.2 | 수주별 읽기 전용 뷰 구현 (I7) | 입력=개소별, 출력=수주별 |
| 6.3 | 개소별↔구성품별↔수주별 데이터 매핑 | |
| 6.4 | 5130 recordscreen JSON → EAV 변환 | 이관 설계 |
> 기획자 협의 후 상세 문서 별도 작성
---
## 7. 통합 성공 기준
### Phase 0-1 (product_code)
| 기준 | 수치 목표 |
|------|----------|
| WorkerScreen 제품코드 표시 | 100% |
| 신규 작업지시 product_code 포함 | NOT NULL |
| 기존 데이터 보정율 (source_order_item_id 있는 건) | 90% 이상 |
| 기존 기능 회귀 | 에러 0건 |
| API 성능 영향 | 5% 미만 |
### Phase 2A-2B (분석/견적/품질)
| 기준 | 수치 목표 |
|------|----------|
| KWE01/KSS01/KSS02 구성품 분석 완료 | 3종 이상 |
| DEFAULT_GAP_PROFILES 5130 대조 | 완료 |
| quotes.product_code 저장 | 정상 동작 |
| inspections.work_order_id FK 보정 정확도 | 95% 이상 |
### Phase 3 (절곡 동적 구현)
| 기준 | 수치 목표 |
|------|----------|
| 제품코드별 다른 구성품 표시 | 3종 이상 지원 |
| 마감유형별 구성품 변경 | 정상 동작 |
| 기존 절곡 데이터 호환 (Path A + B) | 100% |
| inspection-config API 응답 시간 | < 200ms |
| 스크린/슬랫 회귀 | 에러 0건 |
| document_data 저장 정합성 | 100% |
---
## 8. 통합 컨펌 대기 목록
| # | Phase | 항목 | 변경 내용 | 상태 |
|---|:-----:|------|----------|:----:|
| 1 | 0 | 사전 조사 실행 | SQL 4개 (읽기 전용) | 대기 |
| 2 | 1 | product_code 전파 수정 | 5개 코드 경로 options 복사 변경 | 대기 |
| 3 | 1 | 데이터 보정 마이그레이션 | 기존 work_order_items 역추적 보정 | 대기 |
| 4 | 2A | inspection-config API 설계 | 범용 API 엔드포인트 추가 | 대기 |
| 5 | 2B | inspections.work_order_id FK | 마이그레이션 + 로직 수정 | 대기 |
| 6 | 3 | inspection-config API 구현 | 공정 자동 판별 + BOM 구성품 | 대기 |
| 7 | 5 | 완제품 마스터 자동 등록 | items 테이블에 FG 품목 생성 | 대기 |
| 8 | 6 | 3관점 검사 화면 설계 | 기획자 협의 필요 | |
---
## 9. 롤백 전략 (통합)
| Phase | 위험도 | 롤백 방법 |
|:-----:|:------:|----------|
| 0 | 없음 | 읽기 전용 |
| 1 (options 추가) | 낮음 | options에서 `product_code`, `product_name` 제거 스크립트 |
| 1 (데이터 보정) | 중간 | `work_order_items_backup_product_code` 백업 테이블에서 복원 |
| 2B (inspections FK) | 중간 | `work_order_id` 컬럼 drop 마이그레이션 (down 메서드) |
| 3 (절곡 동적화) | 낮음 | document_template_id NULL 레거시 컴포넌트 자동 복귀 (I4) |
| 5 (FG 품목) | 높음 | `auto_generated` 플래그 기반 식별 삭제 |
---
## 10. 참고 파일 (통합)
### 백엔드
| 파일 | 역할 | 관련 Phase |
|------|------|:----------:|
| `api/app/Services/OrderService.php` | 수주작업지시 변환 (L1410) | 1 |
| `api/app/Services/WorkOrderService.php` | 작업지시 서비스 (L287, L311, L416) | 1, 3 |
| `api/app/Services/Quote/QuoteService.php` | 견적 서비스 | 2B |
| `api/app/Services/InspectionService.php` | 품질검사 서비스 | 2B |
| `api/app/Services/DocumentService.php` | 문서 CRUD | 3 |
### 프론트엔드
| 파일 | 역할 | 관련 Phase |
|------|------|:----------:|
| `react/.../WorkerScreen/actions.ts` | 작업자 화면 서버 액션 | 1 |
| `react/.../WorkerScreen/index.tsx` | 작업자 화면 메인 | 1 |
| `react/.../documents/TemplateInspectionContent.tsx` | 양식 기반 동적 렌더링 (**통합 방향**) | 3 |
| `react/.../documents/BendingInspectionContent.tsx` | 절곡 레거시 (**동결**) | |
| `react/.../documents/InspectionReportModal.tsx` | 검사 모달 래퍼 | 3 |
### 참고 문서
| 문서 | 경로 | 용도 |
|------|------|------|
| 원본: 제품코드 추적성 | `docs/plans/product-code-traceability-plan.md` | 상세 코드/쿼리 참조 |
| 원본: 검사 단위 구조 | `docs/plans/document-system-improvement-plan.md` | 상세 설계/정책 참조 |
| 리뷰 정책 결정 | `docs/plans/document-system-improvement-review.md` | 16건 정책 결정 |
| 문서 시스템 마스터 | `docs/plans/document-system-master.md` | 전체 Phase 관리 |
| API 규칙 | `API_RULES.md` | Service-First, FormRequest |
| DB 스키마 | `docs/specs/database-schema.md` | 테이블 구조 |
---
## 11. 변경 이력
| 날짜 | 항목 | 변경 내용 |
|------|------|----------|
| 2026-02-27 | 통합 문서 작성 | product-code + document-system 2개 계획을 7 Phase 통합 계획으로 병합 |
| 2026-02-27 | Phase 2A 완료 | 절곡 검사 분석/설계 완료. dynamic_bom 발견, 5130 대조 완료, inspection-config API 재설계 |
| 2026-02-27 | Phase 2B 완료 | 견적 product_code 자동추출, inspections.work_order_id FK, 데이터 보정 25건 |
| 2026-02-27 | Phase 3 완료 | inspection-config API(3.1), TemplateInspectionContent API 연동(3.2), EAV 호환 확인(3.3+3.4), 트랜잭션 보강(3.5) |
---
## 12. 세션 관리 정책
### 세션 시작 시
```
1. 이 문서(integrated-master-plan.md) 읽기
2. 진행 상태 테이블 확인 → 마지막 완료 작업 파악
3. 해당 Phase 상세 문서 읽기
4. 다음 작업 시작
```
### 작업 중 관리
- Phase 완료 문서의 진행 상태 테이블 업데이트
- 해당 Phase 상세 문서도 업데이트
- 컨펌 필요 사항 발생 컨펌 대기 목록에 추가
### 세션 종료 시
- 변경 이력 섹션에 최종 업데이트 기록
---
* 문서는 `product-code-traceability-plan.md` `document-system-improvement-plan.md` 통합한 마스터 계획입니다.*

File diff suppressed because it is too large Load Diff