# 프로젝트 문서 인덱스

> SAM 시스템 개발 프로젝트별 문서 모음
> **최종 업데이트**: 2026-03-08

---

## 프로젝트 현황 요약

| 프로젝트 | 상태 | 설명 |
|---------|------|------|
| [mes](#mes---meserp-프로젝트) | 🟡 진행중 | 차세대 MES/ERP 기능 개발 |
| [quotation](#quotation---견적-기능) | 🟢 Phase 3 완료 | 5130 견적 → SAM 이관 |
| [api-integration](#api-integration---react--api-연동) | 🟡 진행중 | React ↔ API 연동 |
| [5130-migration](#5130-migration---품목-마이그레이션) | 🟡 Phase 1 진행중 | 5130 품목 데이터 마이그레이션 |
| [legacy-5130](#legacy-5130---레거시-분석) | 📚 참조용 | 5130 레거시 모듈 분석 |
| [mng-mobile-responsive](#mng-mobile-responsive---모바일-반응형) | 🟡 진행중 | mng 모바일 반응형 개선 |
| [auto-login](#auto-login---자동-로그인) | ⚪ 대기 | 자동 로그인 기능 |
| [migration-5130-mng](#migration-5130-mng---5130--mng-마이그레이션) | 🟡 진행중 | 5130 → mng 통합 마이그레이션 |
| [e-sign](#e-sign---전자계약-서명) | 🟢 v1.0 구현 완료 | 전자계약 서명 솔루션 (SAM E-Sign) |
| [org-chart](#org-chart---조직도-관리) | 🟢 v1.0 구현 완료 | 트리형 조직도 관리 (드래그앤드롭, 숨기기) |
| [planning-design](#planning-design---기획디자인-스토리보드-에디터) | 🟢 v1.2 운영 중 | 브라우저 블록 에디터 (Notion/Figma 스타일) |

---

## 프로젝트 상세

### mes - MES/ERP 프로젝트

**경로**: `docs/projects/mes/`
**상태**: 🟡 Phase 0 (베이스라인 분석) 30% 완료
**목표**: SAM 시스템의 차세대 MES/ERP 기능 개발

**핵심 문서**:
- [README.md](./mes/README.md) - 프로젝트 개요 및 문서 안내
- [MES_PROGRESS_TRACKER.md](./mes/MES_PROGRESS_TRACKER.md) - 진행 상황 추적
- [MES_PROJECT_ROADMAP.md](./mes/MES_PROJECT_ROADMAP.md) - 전체 로드맵

**분석 결과**:
- `00_baseline/` - Phase 0 분석 결과
  - [PHASE_0_FINAL_REPORT.md](./mes/00_baseline/PHASE_0_FINAL_REPORT.md)
  - [BACKEND_DEVELOPMENT_ROADMAP_V2.md](./mes/00_baseline/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](./quotation/MASTER_PLAN.md) - 마스터 플랜
- [PROGRESS.md](./quotation/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](./api-integration/MASTER_PLAN.md) - 마스터 플랜
- [PROGRESS.md](./api-integration/PROGRESS.md) - 진행 현황
- [WORKFLOW.md](./api-integration/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](./5130-migration/MASTER_PLAN.md) - 마스터 플랜
- [PROGRESS.md](./5130-migration/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](./legacy-5130/00_OVERVIEW.md) | 시스템 개요 |
| [01_MATERIAL.md](./legacy-5130/01_MATERIAL.md) | 자재 관리 |
| [02_PRODUCT.md](./legacy-5130/02_PRODUCT.md) | 제품 관리 |
| [03_ESTIMATE.md](./legacy-5130/03_ESTIMATE.md) | 견적 관리 |
| [04_PRODUCTION.md](./legacy-5130/04_PRODUCTION.md) | 생산 관리 |
| [05_SHIPPING.md](./legacy-5130/05_SHIPPING.md) | 출하 관리 |
| [06_QUALITY.md](./legacy-5130/06_QUALITY.md) | 품질 관리 |
| [07_ACCOUNTING.md](./legacy-5130/07_ACCOUNTING.md) | 회계 관리 |
| [08_SAM_COMPARISON.md](./legacy-5130/08_SAM_COMPARISON.md) | SAM 비교 분석 |
| [draw-module.md](./legacy-5130/draw-module.md) | 도면 모듈 |

---

### mng-mobile-responsive - 모바일 반응형

**경로**: `docs/projects/mng-mobile-responsive/`
**상태**: 🟡 진행중
**목표**: mng 관리자 패널 모바일 반응형 개선

**문서**:
- [01-analysis.md](./mng-mobile-responsive/01-analysis.md) - 분석
- [02-implementation-plan.md](./mng-mobile-responsive/02-implementation-plan.md) - 구현 계획
- [06-excluded-menus.md](./mng-mobile-responsive/06-excluded-menus.md) - 제외 메뉴
- [PROGRESS.md](./mng-mobile-responsive/PROGRESS.md) - 진행 현황

---

### auto-login - 자동 로그인

**경로**: `docs/projects/auto-login/`
**상태**: ⚪ 대기
**목표**: 자동 로그인 기능 구현

**문서**:
- [PROGRESS.md](./auto-login/PROGRESS.md) - 진행 현황

---

### migration-5130-mng - 5130 → mng 마이그레이션

**경로**: `docs/projects/migration-5130-mng/`
**상태**: 🟡 진행중
**목표**: 5130 기능을 mng로 통합 마이그레이션

**문서**:
- [MIGRATION_TRACKER.md](./migration-5130-mng/MIGRATION_TRACKER.md) - 마이그레이션 추적

---

### e-sign - 전자계약 서명

**경로**: `docs/projects/e-sign/`
**상태**: 🟢 v1.0 구현 완료 (2026-02-12)
**목표**: 모두싸인과 유사한 간편 전자계약 서명 솔루션 자체 구축

**핵심 문서**:
- [technical-design.md](./e-sign/technical-design.md) - 기술 설계 문서
- [implementation-guide.md](./e-sign/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](./org-chart/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](./planning-design/README.md) - 프로젝트 개요 및 구현 이력

**구현 범위**:

| 영역 | 수량 |
|------|------|
| 블록 유형 | 15종 (텍스트/레이아웃/UI모형/미디어/체크리스트) |
| 편집 기능 | 올가미 선택, Undo/Redo, 복사/잘라내기, 서식 |
| 서식 시스템 | 글자색/배경색/크기/굵기/기울임/정렬/z-index |
| 작업 영역 | 사이드바/Description 접기/펼치기, 캔버스 폭 자동 확장 |
| 출력 | HTML 내보내기 + A4 인쇄 (좌표 기반 WYSIWYG) |

**기술 스택**: Alpine.js + localStorage (서버 API 없음)

**기술 스펙**: [features/rd/planning-design.md](../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](../INDEX.md) - 전체 문서 인덱스
- [docs/plans/index_plans.md](../plans/index_plans.md) - 기획 문서 인덱스
- [docs/guides/PROJECT_DEVELOPMENT_POLICY.md](../guides/PROJECT_DEVELOPMENT_POLICY.md) - 공통 개발 정책
- [CURRENT_WORKS.md](../../CURRENT_WORKS.md) - 현재 작업

---

**범례**:
- 🟢 완료
- 🟡 진행중
- ⚪ 대기
- 📚 참조용