Files
sam-docs/projects/mes/README.md

122 lines
4.2 KiB
Markdown
Raw Permalink Normal View History

# 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 (코드 분석)