sam-docs/projects/mes

MES/ERP 프로젝트 문서

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

---

📋 현재 상태

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

---

🗂️ 핵심 문서

진행 추적

• 진행 상황 추적 - 현재 진행도 및 작업 내역
• 프로젝트 로드맵 - 전체 개발 계획 (Phase 0~4)

Phase 0 분석 결과

• Phase 0 최종 보고서 - 베이스라인 분석 종합
• 백엔드 개발 로드맵 V2 - 백엔드 개발 계획
• 아키텍처 옵션 상세 - 기술 스택 및 아키텍처 선택지

문서 분석 (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 - 문서 교차 참조 맵

마이그레이션 가이드

• 품목 관리 마이그레이션 가이드 - 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
• 현재 작업: ../../CURRENT_WORKS.md
• 빠른 참조: ../../SAM_QUICK_REFERENCE.md

---

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