2.4 KiB

Raw Blame History

🔧 系統結構文件拆分說明

📋 拆分概述

原文件: 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、名稱、類型
交互目標、組件結構
導航關係和動作定義

🔗 文件關聯關係

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 進行介面設計
產品經理: 全部三個文件都需要了解

文件維護原則

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

⚠️ 注意事項

🔍 關聯性維護

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 開發團隊

2.4 KiB Raw Blame History