sam-docs/guides/project-launch-roadmap.md

# 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 (주간 체크)