# 기획 문서 인덱스

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

---

## 문서 현황 요약

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

> **Note**: 완료된 계획 37개는 `archive/` 폴더로 이동됨 (최종 정리: 2026-02-22)

---

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

### ERP API 개발

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [erp-api-development-plan.md](./erp-api-development-plan.md) | 🟡 진행중 | Phase 3/L | SAM ERP API 전체 개발 계획, L-2 React 연동 대기 |

### 견적/수주 (Quote/Order)

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [kd-quote-logic-plan.md](./kd-quote-logic-plan.md) | 🟡 진행중 | 4/5 (80%) | 경동 견적 로직, Phase 5 통합 테스트 미완 |
| [quote-management-url-migration-plan.md](./quote-management-url-migration-plan.md) | 🟡 진행중 | 11/12 (92%) | URL 마이그레이션, 사용자 테스트 잔여 |
| [quote-management-8issues-plan.md](./quote-management-8issues-plan.md) | ⚪ 대기 | 0/8 (0%) | 견적관리 8개 이슈, 컨펌 대기 |
| [quote-calculation-api-plan.md](./quote-calculation-api-plan.md) | ⚪ 대기 | 0/12 (0%) | 견적 계산 API, 미착수 |
| [quote-order-sync-improvement-plan.md](./quote-order-sync-improvement-plan.md) | ⚪ 대기 | 0/4 (0%) | 견적-수주 동기화 개선, 미착수 |
| [quote-system-development-plan.md](./quote-system-development-plan.md) | ⚪ 대기 | - | 견적 시스템 개발, 계획 수립 |

### 생산/절곡 (Production/Bending)

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [bending-preproduction-stock-plan.md](./bending-preproduction-stock-plan.md) | 🟡 진행중 | 14/14 코드 | 선재고, 마이그레이션 실행/검증 잔여 |
| [bending-info-auto-generation-plan.md](./bending-info-auto-generation-plan.md) | ⚪ 대기 | 0/7 (0%) | 절곡 정보 자동 생성, 분석만 완료 |
| [bending-material-input-mapping-plan.md](./bending-material-input-mapping-plan.md) | ⚪ 대기 | 분석 | 절곡 자재투입 매핑, GAP 분석 완료 |

### 품목/BOM (Item/BOM)

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [bom-item-mapping-plan.md](./bom-item-mapping-plan.md) | 🟡 진행중 | 2/3 (66%) | BOM 품목 매핑, Phase 3 검증 잔여 |
| [item-master-data-alignment-plan.md](./item-master-data-alignment-plan.md) | 🟡 진행중 | - | 품목 마스터 정합, 섀도잉 정리 잔여 |
| [mng-item-field-management-plan.md](./mng-item-field-management-plan.md) | ⚪ 대기 | 0% | 품목 필드 관리, 미착수 |
| [item-inventory-management-plan.md](./item-inventory-management-plan.md) | ⚪ 대기 | 설계 | 품목 재고 관리, 설계 확정/구현 대기 |
| [fg-code-consolidation-plan.md](./fg-code-consolidation-plan.md) | ⚪ 대기 | 0/8 (0%) | FG 코드 통합, 미착수 |

### 문서/서식 (Document System)

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [document-management-system-plan.md](./document-management-system-plan.md) | 🟡 진행중 | 16/20 (80%) | 문서관리 시스템, Phase 4.4 잔여 |
| [document-system-master.md](./document-system-master.md) | 🟡 진행중 | Phase 4-5 | 마스터 문서, 일부 Phase 잔여 |
| [document-system-mid-inspection.md](./document-system-mid-inspection.md) | 🟡 진행중 | 5/6 | 중간검사, 1개 미완 |
| [document-system-work-log.md](./document-system-work-log.md) | 🟡 진행중 | 3/4+α | 작업일지, React 연동 잔여 |
| [incoming-inspection-document-integration-plan.md](./incoming-inspection-document-integration-plan.md) | ⚪ 대기 | 0/8 (0%) | 수입검사 서류 연동, 분석만 완료 |
| [incoming-inspection-templates-plan.md](./incoming-inspection-templates-plan.md) | 🟡 진행중 | 19/23 (83%) | 수입검사 템플릿, 4종 품목 대기 |
| [intermediate-inspection-report-plan.md](./intermediate-inspection-report-plan.md) | ⚪ 대기 | 0/14 (0%) | 중간검사 보고서, 검토 대기 |

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

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [5130-to-mng-migration-plan.md](./5130-to-mng-migration-plan.md) | 🟡 진행중 | 5/38 (13%) | 5130→mng 마이그레이션 |
| [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 전환, 별도 문서 추적 |
| [dashboard-api-integration-plan.md](./dashboard-api-integration-plan.md) | 🟡 진행중 | 5/11 (45%) | CEO Dashboard API 연동 |
| [kd-orders-migration-plan.md](./kd-orders-migration-plan.md) | ⚪ 대기 | 0/2 (0%) | 경동 수주 마이그레이션, 선행조건 미충족 |
| [items-migration-kyungdong-plan.md](./items-migration-kyungdong-plan.md) | 📚 참조 | ARCHIVED | 후속 문서로 이관됨 |

### 시스템/인프라

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [db-trigger-audit-system-plan.md](./db-trigger-audit-system-plan.md) | 🟡 진행중 | 15/16 (94%) | DB 트리거 감사, 옵션 3건 잔여 |
| [db-backup-system-plan.md](./db-backup-system-plan.md) | 🟡 진행중 | 11/14 (79%) | DB 백업, 서버 작업 3건 잔여 |
| [tenant-id-compliance-plan.md](./tenant-id-compliance-plan.md) | ⚪ 대기 | 0/4 (0%) | 테넌트 ID 정합, 실행 대기 |
| [tenant-numbering-system-plan.md](./tenant-numbering-system-plan.md) | ⚪ 대기 | 0/8 (0%) | 테넌트 채번, 미착수 |
| [mng-numbering-rule-management-plan.md](./mng-numbering-rule-management-plan.md) | ⚪ 대기 | 0% | 채번 규칙 관리, 미착수 |

### 프론트엔드 & UI

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [simulator-ui-enhancement-plan.md](./simulator-ui-enhancement-plan.md) | 🟡 진행중 | 6/10 (60%) | 시뮬레이터 UI 개선 |
| [card-management-section-plan.md](./card-management-section-plan.md) | 🟡 진행중 | 6/12 (50%) | 카드 관리 섹션 |
| [dev-toolbar-plan.md](./dev-toolbar-plan.md) | 🟡 진행중 | 3/8 (38%) | 개발 툴바 |

### 기타

| 문서 | 상태 | 진행률 | 설명 |
|------|------|--------|------|
| [hotfix-20260119-action-plan.md](./hotfix-20260119-action-plan.md) | 🟡 진행중 | API 완료 | Hotfix, React P0 2건 대기 |
| [mng-menu-system-plan.md](./mng-menu-system-plan.md) | 🟡 진행중 | 구현 완료 | 메뉴 시스템, Phase 3 테스트 잔여 |
| [monthly-expense-integration-plan.md](./monthly-expense-integration-plan.md) | ⚪ 대기 | 0/8 (0%) | 월별 경비 연동, 미착수 |
| [receiving-management-analysis-plan.md](./receiving-management-analysis-plan.md) | ⚪ 대기 | 분석 | 입고 관리, 분석 완료/개발 대기 |
| [api-explorer-development-plan.md](./api-explorer-development-plan.md) | ⚪ 대기 | 0% | API Explorer, 미착수 |
| [employee-user-linkage-plan.md](./employee-user-linkage-plan.md) | ⚪ 대기 | 0% | 사원-회원 연결, 미착수 |
| [dummy-data-seeding-plan.md](./dummy-data-seeding-plan.md) | ⚪ 대기 | - | 더미 데이터 시딩, 미착수 |
| [react-mock-remaining-tasks.md](./react-mock-remaining-tasks.md) | 📚 참조 | - | Mock 전환 잔여 작업 목록 |

---

## 완료 아카이브 (archive/) - 37개

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

| 문서 | 완료일 | 설명 |
|------|--------|------|
| [bending-lot-pipeline-dev-plan.md](./archive/bending-lot-pipeline-dev-plan.md) | 2026-02 | 절곡 LOT 매핑 파이프라인 |
| [bending-worklog-reimplementation-plan.md](./archive/bending-worklog-reimplementation-plan.md) | 2026-02 | 절곡 작업일지 재구현 |
| [document-system-product-inspection.md](./archive/document-system-product-inspection.md) | 2026-02 | 제품검사 서식 |
| [formula-engine-real-data-plan.md](./archive/formula-engine-real-data-plan.md) | 2026-02 | 수식 엔진 실데이터 |
| [material-input-per-item-mapping-plan.md](./archive/material-input-per-item-mapping-plan.md) | 2026-02 | 품목별 자재투입 매핑 |
| [mng-item-formula-integration-plan.md](./archive/mng-item-formula-integration-plan.md) | 2026-02 | mng 품목 수식 연동 |
| [mng-item-management-plan.md](./archive/mng-item-management-plan.md) | 2026-02 | mng 품목 관리 |
| [fcm-user-targeted-notification-plan.md](./archive/fcm-user-targeted-notification-plan.md) | 2026-01 | 사용자 타겟 FCM 알림 |
| [docs-update-plan.md](./archive/docs-update-plan.md) | 2026-01 | 문서 업데이트 계획 |
| [order-location-management-plan.md](./archive/order-location-management-plan.md) | 2026-01 | 수주 현장 관리 |
| [quote-v2-auto-calculation-fix-plan.md](./archive/quote-v2-auto-calculation-fix-plan.md) | 2026-01 | 견적 V2 자동계산 수정 |
| [sam-stat-database-design-plan.md](./archive/sam-stat-database-design-plan.md) | 2026-01 | 통계 DB 설계 |
| [stock-integration-plan.md](./archive/stock-integration-plan.md) | 2026-01 | 재고 연동 |
| [welfare-section-plan.md](./archive/welfare-section-plan.md) | 2026-01 | 복리후생 섹션 |
| [order-workorder-shipment-integration-plan.md](./archive/order-workorder-shipment-integration-plan.md) | 2026-01 | 수주-작업지시-출하 연동 |
| [document-management-system-changelog.md](./archive/document-management-system-changelog.md) | 2026-01 | 문서관리 변경 이력 |
| [items-table-unification-plan.md](./archive/items-table-unification-plan.md) | 2025-12 | items 테이블 통합 |
| [kd-items-migration-plan.md](./archive/kd-items-migration-plan.md) | 2025-12 | 경동 품목 마이그레이션 |
| [simulator-calculation-logic-mapping.md](./archive/simulator-calculation-logic-mapping.md) | 2025-12 | 시뮬레이터 로직 매핑 |
| [AI_리포트_키워드_색상체계_가이드_v1.4.md](./archive/AI_리포트_키워드_색상체계_가이드_v1.4.md) | 2025-12 | AI 리포트 색상 가이드 |
| [SEEDERS_LIST.md](./archive/SEEDERS_LIST.md) | 2025-12 | 시더 참조 목록 |
| [api-analysis-report.md](./archive/api-analysis-report.md) | 2025-12 | API 분석 보고서 |
| [erp-api-development-plan-d1.0-changes.md](./archive/erp-api-development-plan-d1.0-changes.md) | 2025-12 | D1.0 변경사항 |
| [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 | 견적 자동 계산 |
| [order-management-plan.md](./archive/order-management-plan.md) | 2025-01 | 수주관리 API 연동 |
| [work-order-plan.md](./archive/work-order-plan.md) | 2025-01 | 작업지시 검증 |
| [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 | 알림음 시스템 |
| [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 | MES 연동 분석 |

---

## 스토리보드

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

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

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

---

## 플로우 테스트

**경로**: `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/INDEX.md](../INDEX.md) - 전체 문서 인덱스
- [docs/projects/index_projects.md](../projects/index_projects.md) - 프로젝트 문서 인덱스

---

**범례**:
- 🟡 진행중: 현재 작업 중 또는 일부 완료
- ⚪ 대기: 미착수 또는 선행조건 대기
- 📚 참조: 분석/참조용 문서