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:
639
guides/project-launch-roadmap.md
Normal file
639
guides/project-launch-roadmap.md
Normal 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 (주간 체크)
|
||||
1150
plans/SAM_ERP_Storyboard_D1.4.md
Normal file
1150
plans/SAM_ERP_Storyboard_D1.4.md
Normal file
File diff suppressed because it is too large
Load Diff
1288
plans/SAM_ERP_회계관리_Storyboard_D1.6.md
Normal file
1288
plans/SAM_ERP_회계관리_Storyboard_D1.6.md
Normal file
File diff suppressed because it is too large
Load Diff
382
plans/integrated-master-plan.md
Normal file
382
plans/integrated-master-plan.md
Normal 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`를 통합한 마스터 계획입니다.*
|
||||
1099
plans/production-deployment-plan.md
Normal file
1099
plans/production-deployment-plan.md
Normal file
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user