8.9 KiB
프로젝트 문서 인덱스
SAM 시스템 개발 프로젝트별 문서 모음 최종 업데이트: 2026-02-12
프로젝트 현황 요약
| 프로젝트 | 상태 | 설명 |
|---|---|---|
| mes | 🟡 진행중 | 차세대 MES/ERP 기능 개발 |
| quotation | 🟢 Phase 3 완료 | 5130 견적 → SAM 이관 |
| api-integration | 🟡 진행중 | React ↔ API 연동 |
| 5130-migration | 🟡 Phase 1 진행중 | 5130 품목 데이터 마이그레이션 |
| legacy-5130 | 📚 참조용 | 5130 레거시 모듈 분석 |
| mng-mobile-responsive | 🟡 진행중 | mng 모바일 반응형 개선 |
| auto-login | ⚪ 대기 | 자동 로그인 기능 |
| migration-5130-mng | 🟡 진행중 | 5130 → mng 통합 마이그레이션 |
| e-sign | 🟢 v1.0 구현 완료 | 전자계약 서명 솔루션 (SAM E-Sign) |
프로젝트 상세
mes - MES/ERP 프로젝트
경로: docs/projects/mes/
상태: 🟡 Phase 0 (베이스라인 분석) 30% 완료
목표: SAM 시스템의 차세대 MES/ERP 기능 개발
핵심 문서:
- README.md - 프로젝트 개요 및 문서 안내
- MES_PROGRESS_TRACKER.md - 진행 상황 추적
- MES_PROJECT_ROADMAP.md - 전체 로드맵
분석 결과:
00_baseline/- Phase 0 분석 결과- PHASE_0_FINAL_REPORT.md
- BACKEND_DEVELOPMENT_ROADMAP_V2.md
docs_breakdown/- 문서 분석 (7개)
v2 분석:
v2-analysis/- MES v2 화면 분석quote-analysis/- 견적 분석order-analysis/- 주문 분석production-analysis/- 생산 분석customer-analysis/- 거래처 분석site-analysis/- 현장 분석price-analysis/- 단가 분석master-data-analysis/- 기준정보 분석production-userflow/- 생산 유저플로우
quotation - 견적 기능
경로: docs/projects/quotation/
상태: 🟢 Phase 3 완료 (2025-12-19)
목표: 5130 레거시 견적 기능을 SAM 시스템으로 이관
핵심 문서:
- MASTER_PLAN.md - 마스터 플랜
- PROGRESS.md - 진행 현황
Phase 문서:
| Phase | 상태 | 경로 |
|---|---|---|
| 1. 5130 분석 | ✅ 완료 | phase-1-5130-analysis/ |
| 2. mng 분석 | ✅ 완료 | phase-2-mng-analysis/ |
| 3. 구현 | ✅ 완료 | phase-3-implementation/ |
| 4. API 개발 | ⚪ 대기 | phase-4-api/ |
참조 자료:
screenshots/- MES 프로토타입 화면 캡쳐 (7개)
api-integration - React ↔ API 연동
경로: docs/projects/api-integration/
상태: 🟡 Phase 4 진행중
목표: React(dev.sam.kr)와 API(api.sam.kr) 완벽 연동
핵심 문서:
- MASTER_PLAN.md - 마스터 플랜
- PROGRESS.md - 진행 현황
- WORKFLOW.md - 작업 프로세스
Phase 문서:
| Phase | 상태 | 경로 |
|---|---|---|
| 1. 테이블 통합 | 🟢 완료(스킵) | phase-1-table-migration/ |
| 2. 메뉴 추출 | 🟡 진행중 | phase-2-menu-extraction/ |
| 3. API 매핑 | 🟡 진행중 | phase-3-api-mapping/ |
| 4. 연동+검증 | 🟡 진행중 | phase-4-integration/ |
TC 파일: phase-4-integration/tc/ - 기능별 테스트 케이스 JSON (17개)
5130-migration - 품목 마이그레이션
경로: docs/projects/5130-migration/
상태: 🟡 Phase 1 진행중
목표: 5130 품목(부품, 자재, BOM) 데이터를 SAM DB로 이전
핵심 문서:
- MASTER_PLAN.md - 마스터 플랜
- PROGRESS.md - 진행 현황
Phase 문서:
| Phase | 상태 | 경로 |
|---|---|---|
| 1. 소스 분석 | 🟡 진행중 | phase-1-source-analysis/ |
| 2. 타겟 분석 | ⚪ 대기 | phase-2-target-analysis/ |
| 3. 매핑 설계 | ⚪ 대기 | phase-3-mapping/ |
legacy-5130 - 레거시 분석
경로: docs/projects/legacy-5130/
상태: 📚 참조용 문서
용도: 5130 레거시 시스템 모듈별 분석
모듈별 분석 문서:
| 문서 | 내용 |
|---|---|
| 00_OVERVIEW.md | 시스템 개요 |
| 01_MATERIAL.md | 자재 관리 |
| 02_PRODUCT.md | 제품 관리 |
| 03_ESTIMATE.md | 견적 관리 |
| 04_PRODUCTION.md | 생산 관리 |
| 05_SHIPPING.md | 출하 관리 |
| 06_QUALITY.md | 품질 관리 |
| 07_ACCOUNTING.md | 회계 관리 |
| 08_SAM_COMPARISON.md | SAM 비교 분석 |
| draw-module.md | 도면 모듈 |
mng-mobile-responsive - 모바일 반응형
경로: docs/projects/mng-mobile-responsive/
상태: 🟡 진행중
목표: mng 관리자 패널 모바일 반응형 개선
문서:
- 01-analysis.md - 분석
- 02-implementation-plan.md - 구현 계획
- 06-excluded-menus.md - 제외 메뉴
- PROGRESS.md - 진행 현황
auto-login - 자동 로그인
경로: docs/projects/auto-login/
상태: ⚪ 대기
목표: 자동 로그인 기능 구현
문서:
- PROGRESS.md - 진행 현황
migration-5130-mng - 5130 → mng 마이그레이션
경로: docs/projects/migration-5130-mng/
상태: 🟡 진행중
목표: 5130 기능을 mng로 통합 마이그레이션
문서:
- MIGRATION_TRACKER.md - 마이그레이션 추적
e-sign - 전자계약 서명
경로: docs/projects/e-sign/
상태: 🟢 v1.0 구현 완료 (2026-02-12)
목표: 모두싸인과 유사한 간편 전자계약 서명 솔루션 자체 구축
핵심 문서:
- technical-design.md - 기술 설계 문서
- implementation-guide.md - 구현 가이드
구현 범위:
| 영역 | 수량 |
|---|---|
| DB 마이그레이션 | 4개 (esign_contracts, esign_signers, esign_sign_fields, esign_audit_logs) |
| API 모델 | 4개 |
| API 서비스 | 4개 |
| API 컨트롤러 | 2개 (16 엔드포인트) |
| MNG 컨트롤러 | 2개 (8 화면) |
| MNG 뷰 | 8개 (React 하이브리드) |
기술 스택: Laravel 11 + React 18 + SignaturePad + PDF.js
참고 자료:
esign-storyboard.pptx- 화면 스토리보드storyboard-config.json- 스토리보드 설정
디렉토리 구조
docs/projects/
├── INDEX.md # 이 파일
├── mes/ # MES/ERP 프로젝트 (핵심)
│ ├── 00_baseline/ # Phase 0 분석
│ ├── v1-analysis/ # v1 분석
│ ├── v2-analysis/ # v2 화면 분석
│ └── phases/ # Phase별 진행
├── quotation/ # 견적 기능
│ ├── phase-1-5130-analysis/
│ ├── phase-2-mng-analysis/
│ ├── phase-3-implementation/
│ └── screenshots/
├── api-integration/ # React ↔ API 연동
│ ├── phase-1-table-migration/
│ ├── phase-2-menu-extraction/
│ ├── phase-3-api-mapping/
│ └── phase-4-integration/tc/
├── 5130-migration/ # 품목 마이그레이션
│ ├── phase-1-source-analysis/
│ ├── phase-2-target-analysis/
│ └── phase-3-mapping/
├── legacy-5130/ # 레거시 분석 (참조용)
├── mng-mobile-responsive/ # 모바일 반응형
├── auto-login/ # 자동 로그인
├── migration-5130-mng/ # 5130→mng 마이그레이션
└── e-sign/ # 전자계약 서명 (SAM E-Sign)
관련 문서
- docs/INDEX.md - 전체 문서 인덱스
- docs/plans/index_plans.md - 기획 문서 인덱스
- docs/guides/PROJECT_DEVELOPMENT_POLICY.md - 공통 개발 정책
- CURRENT_WORKS.md - 현재 작업
범례:
- 🟢 완료
- 🟡 진행중
- ⚪ 대기
- 📚 참조용