# 🔧 系統結構文件拆分說明

## 📋 拆分概述
**原文件**: `system_structure_design.json` (35,322 tokens)  
**拆分日期**: 2025-09-12  
**拆分原因**: 文件過大，超過閱讀限制，需分別管理不同架構層級

## 📂 拆分結果

### 1. 系統模組文件
**文件位置**: `system_modules.json`  
**內容**: 6個核心系統模組定義
- 用戶認證與引導系統 (MD_ENT)
- 核心學習功能 (MD_CORE) 
- 學習任務與活動 (MD_TASK)
- 商業模式功能 (MD_BIZ)
- 四關線性闖關系統 (MD_PROGRESSIVE)
- AI智能分析系統 (MD_AI)

### 2. 系統功能文件
**文件位置**: `system_features.json`  
**內容**: 29個功能特性定義
- 包含功能名稱、ID、關聯模組
- 使用場景、目標、數據綁定
- 關聯UI視圖ID清單

### 3. 系統畫面文件
**文件位置**: `system_views.json`  
**內容**: 121個UI視圖定義
- 包含視圖ID、名稱、類型
- 交互目標、組件結構
- 導航關係和動作定義

## 🔗 文件關聯關係

```mermaid
graph TD
    A[system_modules.json] --> B[system_features.json]
    B --> C[system_views.json]
    A -.-> C
    
    A1[模組 MD_CORE] --> B1[功能 FT_ScenarioDialogue]
    B1 --> C1[視圖 UI_Dialogue_Main]
    B1 --> C2[視圖 UI_Level_Map]
```

## 📖 使用指南

### 開發團隊使用方式
- **後端工程師**: 主要參考 `system_modules.json` 和 `system_features.json`
- **前端工程師**: 重點關注 `system_features.json` 和 `system_views.json`
- **UI/UX設計師**: 主要使用 `system_views.json` 進行介面設計
- **產品經理**: 全部三個文件都需要了解

### 文件維護原則
1. **同步更新**: 修改任一文件時，需檢查其他文件是否需要相應更新
2. **關聯檢查**: 新增功能時確保 module_id、feature_id、view_ids 的一致性
3. **版本管理**: 三個文件應同步進行版本控制

## ⚠️ 注意事項

### 🔍 關聯性維護
- `features.module_id` 必須對應 `modules.module_id`
- `features.view_ids` 必須對應 `views.view_id`
- 修改任一 ID 時需全面檢查關聯性

### 📝 命名規範
- 模組ID: `MD_` 前綴 (如 `MD_CORE`)
- 功能ID: `FT_` 前綴 (如 `FT_ScenarioDialogue`)  
- 視圖ID: `UI_` 前綴 (如 `UI_Dialogue_Main`)

### 🔄 原文件處理
**建議**: 保留原始 `system_structure_design.json` 作為備份，日常開發使用拆分後的三個文件。

---

**最後更新**: 2025-09-12  
**維護者**: Drama Ling 開發團隊