122 lines
4.2 KiB
Markdown
122 lines
4.2 KiB
Markdown
|
|
# 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 (코드 분석)
|