78 lines
2.4 KiB
Markdown
78 lines
2.4 KiB
Markdown
# 🔧 系統結構文件拆分說明
|
|
|
|
## 📋 拆分概述
|
|
**原文件**: `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 開發團隊 |