docs: 자동 스케줄 생성 기능 추가 및 관련 문서 업데이트

- 생산계획 목록에 자동 스케줄 생성 기능에 대한 상세 가이드를 추가하였습니다. - 스케줄 생성의 데이터 흐름과 설정을 명확히 설명하였으며, JSON 형식의 설정 예시를 포함하였습니다. - 버튼 설정 및 연결 필터 설정에 대한 정보를 추가하여 사용자가 기능을 쉽게 이해할 수 있도록 하였습니다. - 구현 상태를 체크리스트 형식으로 정리하여 각 항목의 진행 상황을 명시하였습니다.
2026-02-02 17:37:13 +09:00
parent 7043f26ac8
commit 61b67c3619
3 changed files with 1067 additions and 2 deletions
--- a/docs/screen-implementation-guide/03_production/production-plan.md
+++ b/docs/screen-implementation-guide/03_production/production-plan.md
@@ -1209,17 +1209,117 @@ v2-table-list (생산계획 목록)

 ---

-## 16. 관련 문서
+## 16. 자동 스케줄 생성 기능
+
+> 상세 가이드: [스케줄 자동 생성 기능 구현 가이드](../00_analysis/schedule-auto-generation-guide.md)
+
+### 16.1 개요
+
+좌측 수주 테이블에서 품목을 선택하고 "자동 스케줄 생성" 버튼을 클릭하면, 선택된 품목들에 대한 생산 스케줄이 자동으로 생성되어 우측 타임라인에 표시됩니다.
+
+### 16.2 데이터 흐름
+
+```
+1. 좌측 v2-table-grouped에서 품목 선택 (그룹 선택 시 자식 포함)
+2. "자동 스케줄 생성" 버튼 클릭
+3. 백엔드 API에서 미리보기 생성 (생성/삭제/수정될 스케줄)
+4. 변경사항 확인 다이얼로그 표시
+5. 확인 시 스케줄 적용 및 타임라인 새로고침
+6. 다음 방문 시: 좌측 선택 → linkedFilter로 우측 자동 필터링
+```
+
+### 16.3 스케줄 생성 설정
+
+```json
+{
+  "scheduleType": "PRODUCTION",
+  "source": {
+    "componentId": "order_table",
+    "tableName": "sales_order_mng",
+    "groupByField": "part_code",
+    "quantityField": "balance_qty",
+    "dueDateField": "due_date"
+  },
+  "resource": {
+    "type": "ITEM",
+    "idField": "part_code",
+    "nameField": "part_name"
+  },
+  "rules": {
+    "leadTimeDays": 3,
+    "dailyCapacity": 100,
+    "workingDays": [1, 2, 3, 4, 5],
+    "considerStock": true,
+    "stockTableName": "inventory_mng",
+    "stockQtyField": "current_qty"
+  },
+  "target": {
+    "tableName": "production_plan_mng",
+    "timelineComponentId": "production_timeline"
+  }
+}
+```
+
+### 16.4 버튼 설정
+
+```json
+{
+  "componentType": "v2-button-primary",
+  "componentId": "btn_auto_schedule",
+  "componentConfig": {
+    "label": "자동 스케줄 생성",
+    "variant": "default",
+    "icon": "Calendar",
+    "action": {
+      "type": "custom",
+      "customAction": "autoGenerateSchedule",
+      "scheduleConfig": { /* 위 설정 */ }
+    }
+  }
+}
+```
+
+### 16.5 연결 필터 설정 (linkedFilters)
+
+좌측 테이블 선택 시 우측 타임라인 자동 필터링:
+
+```json
+{
+  "linkedFilters": [
+    {
+      "sourceComponentId": "order_table",
+      "sourceField": "part_code",
+      "targetColumn": "resource_id"
+    }
+  ]
+}
+```
+
+### 16.6 구현 상태
+
+| 항목 | 상태 | 비고 |
+|------|:----:|------|
+| schedule_mng 테이블 | ⏳ 대기 | 범용 스케줄 테이블 |
+| /api/schedule/preview API | ⏳ 대기 | 미리보기 |
+| /api/schedule/apply API | ⏳ 대기 | 적용 |
+| autoGenerateSchedule 버튼 액션 | ⏳ 대기 | buttonActions.ts |
+| 확인 다이얼로그 | ⏳ 대기 | 기존 AlertDialog 활용 |
+| linkedFilter 연동 | ⏳ 대기 | 타임라인 필터링 |
+
+---
+
+## 17. 관련 문서

 - [수주관리](../02_sales/order.md)
 - [품목정보](../01_master-data/item-info.md)
 - [설비관리](../05_equipment/equipment-info.md)
 - [BOM관리](../01_master-data/bom.md)
 - [작업지시](./work-order.md)
+- **[스케줄 자동 생성 기능 가이드](../00_analysis/schedule-auto-generation-guide.md)**

 ---

-## 17. 참고: 표준 가이드
+## 18. 참고: 표준 가이드

 - [화면개발 표준 가이드](../화면개발_표준_가이드.md)
 - [V2 컴포넌트 사용 가이드](../00_analysis/v2-component-usage-guide.md)