- 사이드바/Description 패널 접기/펼치기 기능 추가 - 캔버스 폭 자동 확장 (1100→1400px) 반영 - 이미지 블록 더블클릭 업로드 변경 반영 - 파일 줄 수 4,300→4,430줄 갱신 - 버전 v1.1 → v1.2 갱신
11 KiB
프로젝트 문서 인덱스
SAM 시스템 개발 프로젝트별 문서 모음 최종 업데이트: 2026-03-08
프로젝트 현황 요약
| 프로젝트 | 상태 | 설명 |
|---|---|---|
| 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) |
| org-chart | 🟢 v1.0 구현 완료 | 트리형 조직도 관리 (드래그앤드롭, 숨기기) |
| planning-design | 🟢 v1.2 운영 중 | 브라우저 블록 에디터 (Notion/Figma 스타일) |
프로젝트 상세
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- 스토리보드 설정
org-chart - 조직도 관리
경로: docs/projects/org-chart/
상태: 🟢 v1.0 구현 완료 (2026-03-06)
목표: 테넌트별 조직 구조를 시각적으로 관리하는 트리형 조직도
핵심 문서:
- README.md - 기술 문서 (아키텍처, API, DB, 프론트엔드 상세)
구현 범위:
| 영역 | 수량 |
|---|---|
| MNG 컨트롤러 메서드 | 7개 (RdController) |
| API 엔드포인트 | 6개 (조회, 배치, 해제, 순서변경, 숨기기) |
| DB 마이그레이션 | 1개 (departments.options JSON 추가) |
| 뷰 | 1개 (Alpine.js + SortableJS) |
기술 스택: Alpine.js + SortableJS + 수동 DOM 렌더링 (x-for 미사용)
planning-design - 기획디자인 스토리보드 에디터
경로: docs/projects/planning-design/
상태: 🟢 v1.2 운영 중 (고도화 진행중)
목표: 브라우저 내 Notion/Figma 스타일 블록 에디터로 ERP 화면 기획서 작성
핵심 문서:
- README.md - 프로젝트 개요 및 구현 이력
구현 범위:
| 영역 | 수량 |
|---|---|
| 블록 유형 | 15종 (텍스트/레이아웃/UI모형/미디어/체크리스트) |
| 편집 기능 | 올가미 선택, Undo/Redo, 복사/잘라내기, 서식 |
| 서식 시스템 | 글자색/배경색/크기/굵기/기울임/정렬/z-index |
| 작업 영역 | 사이드바/Description 접기/펼치기, 캔버스 폭 자동 확장 |
| 출력 | HTML 내보내기 + A4 인쇄 (좌표 기반 WYSIWYG) |
기술 스택: Alpine.js + localStorage (서버 API 없음)
기술 스펙: features/rd/planning-design.md
디렉토리 구조
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)
├── org-chart/ # 조직도 관리
└── planning-design/ # 기획디자인 스토리보드 에디터
관련 문서
- docs/INDEX.md - 전체 문서 인덱스
- docs/plans/index_plans.md - 기획 문서 인덱스
- docs/guides/PROJECT_DEVELOPMENT_POLICY.md - 공통 개발 정책
- CURRENT_WORKS.md - 현재 작업
범례:
- 🟢 완료
- 🟡 진행중
- ⚪ 대기
- 📚 참조용