# MES/ERP 프로젝트 문서

SAM 시스템의 차세대 MES/ERP 기능 개발을 위한 분석 및 로드맵 문서입니다.

---

## 📋 현재 상태

**Phase:** Phase 0 (베이스라인 분석)
**진행률:** 30% 완료
**다음 단계:** Phase B (코드 분석) 대기

---

## 🗂️ 핵심 문서

### 진행 추적
- **[진행 상황 추적](./MES_PROGRESS_TRACKER.md)** - 현재 진행도 및 작업 내역
- **[프로젝트 로드맵](./MES_PROJECT_ROADMAP.md)** - 전체 개발 계획 (Phase 0~4)

### Phase 0 분석 결과
- **[Phase 0 최종 보고서](./00_baseline/PHASE_0_FINAL_REPORT.md)** - 베이스라인 분석 종합
- **[백엔드 개발 로드맵 V2](./00_baseline/BACKEND_DEVELOPMENT_ROADMAP_V2.md)** - 백엔드 개발 계획
- **[아키텍처 옵션 상세](./00_baseline/ARCHITECTURE_OPTIONS_DETAILED.md)** - 기술 스택 및 아키텍처 선택지

### 문서 분석 (Phase A 완료)
`00_baseline/docs_breakdown/` 디렉토리:
- `api_item_analysis_summary.md` - API 품목 분석
- `react_atomic_design_summary.md` - React 아토믹 디자인
- `react_dev_guidelines_summary.md` - React 개발 가이드라인
- `react_screen_spec_summary.md` - React 화면 명세
- `business_quotation_guide_summary.md` - 견적 가이드
- `business_user_story_summary.md` - 유저 스토리
- `document_cross_reference_map.md` - 문서 교차 참조 맵

### 마이그레이션 가이드
- **[품목 관리 마이그레이션 가이드](./ITEM_MANAGEMENT_MIGRATION_GUIDE.md)** - Next.js 15 전환 가이드

---

## 📂 디렉토리 구조

```
claudedocs/mes/
├── README.md                          # 이 파일
├── MES_PROGRESS_TRACKER.md            # 진행 상황 추적
├── MES_PROJECT_ROADMAP.md             # 프로젝트 로드맵
├── ITEM_MANAGEMENT_MIGRATION_GUIDE.md # 마이그레이션 가이드
│
└── 00_baseline/                       # Phase 0 분석
    ├── PHASE_0_FINAL_REPORT.md        # 최종 보고서
    ├── BACKEND_DEVELOPMENT_ROADMAP_V2.md
    ├── ARCHITECTURE_OPTIONS_DETAILED.md
    ├── COST_BENEFIT_ANALYSIS.md
    ├── MIGRATION_STRATEGY.md
    ├── PHASE_0_DISCOVERY_SUMMARY.md
    ├── TECHNICAL_DEBT_ASSESSMENT.md
    ├── docs_breakdown/                # 문서 분석 (Phase A)
    │   ├── api_item_analysis_summary.md
    │   ├── react_atomic_design_summary.md
    │   ├── react_dev_guidelines_summary.md
    │   ├── react_screen_spec_summary.md
    │   ├── business_quotation_guide_summary.md
    │   ├── business_user_story_summary.md
    │   └── document_cross_reference_map.md
    └── (기타 분석 문서 13개)
```

---

## 🚀 Phase 0 주요 성과

### Phase A: 문서 분석 (✅ 완료)
- ✅ 핵심 문서 6개 분석 (총 7,065줄)
- ✅ Gap Analysis 17개 발견
  - Critical: 7개
  - Important: 7개
  - Nice to Have: 3개

### 핵심 발견사항

**✅ 완성된 기능:**
1. **가격 시스템** (백엔드 90%)
   - price_histories 테이블 완성
   - Pricing API 5개 엔드포인트
   - 다형성 가격, 고객별 차별화, 시계열 이력

**❌ 구현 필요:**
1. **통합 품목 조회 API** (Critical Gap #1)
2. **치수 연결 매핑 시스템** (Critical Gap #2)
3. **실시간 견적 계산 API** (Critical Gap #3)

---

## 📖 언제 읽어야 할까?

### MES 프로젝트 시작 시
1. `MES_PROGRESS_TRACKER.md` - 현재 상태 확인
2. `MES_PROJECT_ROADMAP.md` - 전체 계획 파악
3. `00_baseline/PHASE_0_FINAL_REPORT.md` - 분석 결과 이해

### 기술 아키텍처 이해 필요 시
1. `00_baseline/ARCHITECTURE_OPTIONS_DETAILED.md` - 기술 스택 선택지
2. `00_baseline/BACKEND_DEVELOPMENT_ROADMAP_V2.md` - 백엔드 개발 계획
3. `00_baseline/MIGRATION_STRATEGY.md` - 마이그레이션 전략

### 문서 분석 상세 검토 시
- `00_baseline/docs_breakdown/` 디렉토리 탐색
- `document_cross_reference_map.md` - 문서 간 관계 파악

---

## 🔗 관련 링크

- **SAM 프로젝트 개요**: [`../../CLAUDE.md`](../../CLAUDE.md)
- **현재 작업**: [`../../CURRENT_WORKS.md`](../../CURRENT_WORKS.md)
- **빠른 참조**: [`../../SAM_QUICK_REFERENCE.md`](../../SAM_QUICK_REFERENCE.md)

---

**최종 업데이트**: 2025-11-18
**다음 Phase**: Phase B (코드 분석)