# 기획 문서 인덱스

> SAM 시스템 개발 계획 및 기획 문서 모음
> **최종 업데이트**: 2026-01-20

---

## 문서 현황 요약

| 분류 | 개수 | 설명 |
|------|------|------|
| 진행중/대기 계획서 | 16개 | 기능별 API 개발 계획 |
| 완료 아카이브 | 15개 | `archive/` 폴더에 보관 |
| 스토리보드 | 1개 | ERP 화면 설계 (D1.0) |
| 플로우 테스트 | 32개 | API 검증용 JSON 테스트 케이스 |

> **Note**: D0.8 스토리보드는 `docs/history/2025-12/`로 아카이브됨
> **Note**: E2E 버그 수정 계획은 `docs/history/2026-01/`로 아카이브됨 (2026-01-15 완료)
> **Note**: 완료된 계획 15개는 `archive/` 폴더로 이동됨 (2026-01-20)

---

## 개발 계획서 (진행중/대기)

### ERP API 개발

| 문서 | 상태 | 설명 |
|------|------|------|
| [erp-api-development-plan.md](./erp-api-development-plan.md) | 🟡 Phase 3 진행중 | SAM ERP API 전체 개발 계획 (D0.8 기준) |

### 기능별 계획

| 문서 | 상태 | 설명 |
|------|------|------|
| [simulator-calculation-logic-mapping.md](./simulator-calculation-logic-mapping.md) | 📚 참조 | 견적 시뮬레이터 계산 로직 매핑 분석 |
| [mng-item-field-management-plan.md](./mng-item-field-management-plan.md) | ⚪ 계획수립 | 품목 필드 관리 (미착수) |
| [items-table-unification-plan.md](./items-table-unification-plan.md) | ⚪ 계획수립 | items 테이블 통합 (롤백 후 대기) |
| [mng-menu-system-plan.md](./mng-menu-system-plan.md) | 🔵 계획수립 | mng 메뉴 시스템 (설계 완료, 구현 대기) |

### 마이그레이션 & 연동

| 문서 | 상태 | 설명 |
|------|------|------|
| [5130-to-mng-migration-plan.md](./5130-to-mng-migration-plan.md) | 🟡 진행중 | 5130 → mng 마이그레이션 (5/38 완료) |
| [react-api-integration-plan.md](./react-api-integration-plan.md) | 🟡 진행중 | React ↔ API 연동 테스트 |
| [react-mock-to-api-migration-plan.md](./react-mock-to-api-migration-plan.md) | 🟡 진행중 | Mock → API 전환 (Phase A 부분 완료) |
| [dashboard-api-integration-plan.md](./dashboard-api-integration-plan.md) | 🟡 Phase 1 대기 | CEO Dashboard API 연동 |

### 영업/생산 (Sales/Production)

| 문서 | 상태 | 설명 |
|------|------|------|
| [quote-management-8issues-plan.md](./quote-management-8issues-plan.md) | 🟡 진행중 | 견적관리 8개 이슈 |
| [quote-calculation-api-plan.md](./quote-calculation-api-plan.md) | 🟡 진행중 | 견적 계산 API |
| [order-workorder-shipment-integration-plan.md](./order-workorder-shipment-integration-plan.md) | 🔵 계획수립 | 수주-작업지시-출하 연동 |
| [quote-system-development-plan.md](./quote-system-development-plan.md) | 🟡 진행중 | 견적 시스템 개발 |
| [simulator-ui-enhancement-plan.md](./simulator-ui-enhancement-plan.md) | 🔵 계획수립 | 시뮬레이터 UI 개선 |

### 시스템/기타

| 문서 | 상태 | 설명 |
|------|------|------|
| [dummy-data-seeding-plan.md](./dummy-data-seeding-plan.md) | ⚪ 계획수립 | 더미 데이터 시딩 (2025-12-23 작성) |
| [api-explorer-development-plan.md](./api-explorer-development-plan.md) | 🔵 계획수립 | API Explorer 개발 (설계 완료, 구현 대기) |
| [employee-user-linkage-plan.md](./employee-user-linkage-plan.md) | 🔵 계획수립 | 사원-회원 연결 기능 (2025-12-25 작성) |
| [docs-update-plan.md](./docs-update-plan.md) | 🟡 진행중 | 문서 업데이트 계획 (Phase 4 진행중) |
| [react-mock-remaining-tasks.md](./react-mock-remaining-tasks.md) | 📚 참조 | Mock 전환 잔여 작업 목록 |
| [hotfix-20260119-action-plan.md](./hotfix-20260119-action-plan.md) | 🟡 진행중 | Hotfix 액션 플랜 (2026-01-19) |

---

## 완료 아카이브 (archive/)

> 완료된 계획 문서들 - 참조용으로 보관

| 문서 | 완료일 | 설명 |
|------|--------|------|
| [erp-api-development-plan-d1.0-changes.md](./archive/erp-api-development-plan-d1.0-changes.md) | 2025-12 | D1.0 변경사항 (Phase 5-8) |
| [mng-quote-formula-development-plan.md](./archive/mng-quote-formula-development-plan.md) | 2025-12 | mng 견적 수식 관리 |
| [quote-auto-calculation-development-plan.md](./archive/quote-auto-calculation-development-plan.md) | 2025-12-22 | 견적 자동 계산 |
| [order-management-plan.md](./archive/order-management-plan.md) | 2025-01-09 | 수주관리 API 연동 |
| [work-order-plan.md](./archive/work-order-plan.md) | 2025-01-11 | 작업지시 검증 |
| [process-management-plan.md](./archive/process-management-plan.md) | 2025-12 | 공정관리 API 연동 |
| [construction-api-integration-plan.md](./archive/construction-api-integration-plan.md) | 2026-01 | 시공사 API 연동 |
| [notification-sound-system-plan.md](./archive/notification-sound-system-plan.md) | 2025-01-07 | 알림음 시스템 |
| [l2-permission-management-plan.md](./archive/l2-permission-management-plan.md) | 2025-12 | L2 권한 관리 |
| [react-fcm-push-notification-plan.md](./archive/react-fcm-push-notification-plan.md) | 2025-12 | FCM 푸시 알림 |
| [react-server-component-audit-plan.md](./archive/react-server-component-audit-plan.md) | 2025-12 | Server Component 점검 |
| [5130-bom-migration-plan.md](./archive/5130-bom-migration-plan.md) | 2025-12 | 5130 BOM 마이그레이션 |
| [5130-sam-data-migration-plan.md](./archive/5130-sam-data-migration-plan.md) | 2025-12 | 5130 데이터 마이그레이션 |
| [bidding-api-implementation-plan.md](./archive/bidding-api-implementation-plan.md) | 2025-12 | 입찰 API 구현 |
| [mes-integration-analysis-plan.md](./archive/mes-integration-analysis-plan.md) | 2025-01-09 | MES 연동 분석 |

---

## 스토리보드

### SAM_ERP_Storyboard_D1.0_251218 (현재 버전)

**경로**: `docs/plans/SAM_ERP_Storyboard_D1.0_251218/`
**일자**: 2025-12-18
**슬라이드 수**: 38장

**내용**: D0.8 대비 변경/추가된 화면 (D1.0 버전)

**변경 사항**: [erp-api-development-plan-d1.0-changes.md](./erp-api-development-plan-d1.0-changes.md) 참조

---

## 플로우 테스트

**경로**: `docs/plans/flow-tests/`
**용도**: Flow Tester (mng.sam.kr/dev-tools/flow-tester) 검증용 JSON

### 인증/권한

| 파일 | 설명 |
|------|------|
| [auth-api-flow.json](./flow-tests/auth-api-flow.json) | 인증 API 플로우 |
| [auth-legacy-flow.json](./flow-tests/auth-legacy-flow.json) | 레거시 인증 플로우 |
| [user-invitation-flow.json](./flow-tests/user-invitation-flow.json) | 사용자 초대 |

### 품목/BOM

| 파일 | 설명 |
|------|------|
| [items-crud-api-flow.json](./flow-tests/items-crud-api-flow.json) | 품목 CRUD |
| [items-bom-api-flow.json](./flow-tests/items-bom-api-flow.json) | BOM API |
| [items-bom-test.json](./flow-tests/items-bom-test.json) | BOM 테스트 |
| [item-master-page-api-flow.json](./flow-tests/item-master-page-api-flow.json) | 품목 마스터 페이지 |
| [item-master-full-api-flow.json](./flow-tests/item-master-full-api-flow.json) | 품목 마스터 전체 |
| [item-master-init-api-flow.json](./flow-tests/item-master-init-api-flow.json) | 품목 마스터 초기화 |
| [item-master-field-api-flow.json](./flow-tests/item-master-field-api-flow.json) | 품목 필드 |
| [item-master-legacy-flow.json](./flow-tests/item-master-legacy-flow.json) | 레거시 품목 |
| [item-delete-legacy-flow.json](./flow-tests/item-delete-legacy-flow.json) | 품목 삭제 (레거시) |
| [item-delete-force-delete.json](./flow-tests/item-delete-force-delete.json) | 품목 강제 삭제 |
| [item-fields-is-active-test.json](./flow-tests/item-fields-is-active-test.json) | 필드 활성화 테스트 |

### 거래처/영업

| 파일 | 설명 |
|------|------|
| [client-api-flow.json](./flow-tests/client-api-flow.json) | 거래처 API |
| [client-legacy-flow.json](./flow-tests/client-legacy-flow.json) | 레거시 거래처 |
| [client-group-api-flow.json](./flow-tests/client-group-api-flow.json) | 거래처 그룹 |
| [pricing-crud-flow.json](./flow-tests/pricing-crud-flow.json) | 단가 CRUD |
| [pricing-validation-test.json](./flow-tests/pricing-validation-test.json) | 단가 검증 |

### 인사/급여

| 파일 | 설명 |
|------|------|
| [employee-api-crud.json](./flow-tests/employee-api-crud.json) | 사원 CRUD |
| [attendance-api-crud.json](./flow-tests/attendance-api-crud.json) | 근태 CRUD |
| [department-tree-api.json](./flow-tests/department-tree-api.json) | 부서 트리 |

### 회계/재무

| 파일 | 설명 |
|------|------|
| [account-management-flow.json](./flow-tests/account-management-flow.json) | 계정 관리 |
| [sales-statement-flow.json](./flow-tests/sales-statement-flow.json) | 매출 전표 |
| [payment-flow.json](./flow-tests/payment-flow.json) | 결제 플로우 |
| [bad-debt-flow.json](./flow-tests/bad-debt-flow.json) | 대손 처리 |

### 기타

| 파일 | 설명 |
|------|------|
| [popup-flow.json](./flow-tests/popup-flow.json) | 팝업 플로우 |
| [company-request-flow.json](./flow-tests/company-request-flow.json) | 회사 요청 |
| [notification-settings-flow.json](./flow-tests/notification-settings-flow.json) | 알림 설정 |
| [subscription-flow.json](./flow-tests/subscription-flow.json) | 구독 플로우 |
| [branching-example-flow.json](./flow-tests/branching-example-flow.json) | 분기 예제 |

---

## 디렉토리 구조

```
docs/plans/
├── index_plans.md                     # 이 파일
│
├── erp-api-development-plan.md        # ERP API 개발 계획 (D0.8)
├── erp-api-development-plan-d1.0-changes.md  # D1.0 변경사항
├── mng-quote-formula-development-plan.md     # 견적 수식 관리
├── quote-auto-calculation-development-plan.md # 견적 자동 계산
├── simulator-calculation-logic-mapping.md    # 시뮬레이터 로직 매핑
├── mng-item-field-management-plan.md         # 품목 필드 관리
├── items-table-unification-plan.md           # items 테이블 통합
├── mng-menu-system-plan.md                   # mng 메뉴 시스템
├── 5130-to-mng-migration-plan.md             # 5130 마이그레이션
├── react-api-integration-plan.md             # React-API 연동
├── react-mock-to-api-migration-plan.md       # Mock→API 전환
├── dummy-data-seeding-plan.md                # 더미 데이터 시딩
├── api-explorer-development-plan.md          # API Explorer
├── employee-user-linkage-plan.md             # 사원-회원 연결
├── docs-update-plan.md                       # 문서 업데이트 계획
│
├── SAM_ERP_Storyboard_D1.0_251218/    # 스토리보드 D1.0 (38장)
│   └── 슬라이드*.jpeg
│
└── flow-tests/                         # 플로우 테스트 JSON (32개)
    ├── auth-*.json
    ├── items-*.json
    ├── client-*.json
    └── ...

# 아카이브됨
# docs/history/2025-12/SAM_ERP_Storyboard_D0.8_251216/  # D0.8 (113장)
```

---

## 관련 문서

- [docs/INDEX.md](../INDEX.md) - 전체 문서 인덱스
- [docs/projects/index_projects.md](../projects/index_projects.md) - 프로젝트 문서 인덱스
- [docs/specs/erp-analysis/](../specs/erp-analysis/) - ERP 분석 명세서
- [CURRENT_WORKS.md](../../CURRENT_WORKS.md) - 현재 작업

---

**범례**:
- 🟢 완료: 구현 완료
- 🟡 진행중: 현재 작업 중
- 🔵 계획수립: 설계/계획 완료, 구현 대기
- ⚪ 미착수: 계획만 수립, 작업 대기
- 📚 참조: 분석/참조용 문서