雾区谜解社 —— 项目架构全景

flowchart TB
    subgraph Data["📦 数据层"]
        KG["🧠 知识图谱
knowledgeGraph
51个知识点 + 依赖关系 + 案件映射"]
        KP["📚 知识面板数据
KNOWLEDGE_DATA
漫画面板 + SVG图表"]
    end

    subgraph Intelligence["🧠 智能层"]
        KS["🎯 知识选择器
MZ_KnowledgeSelector
玩家评估 + 自适应选点"]
        CF["🏭 案件工厂
MZ_Factory
配置驱动动态生成案件"]
    end

    subgraph Engine["🎮 引擎层"]
        GE["⚙️ 游戏引擎
game.js
状态机 + 对话树 + 苏格拉底提问"]
    end

    subgraph Storage["💾 存储层"]
        ST["🗄️ 本地存储
MZ_Storage
玩家数据 + 档案 + 案件状态"]
    end

    KG -->|"知识点映射"| CF
    KP -->|"面板渲染"| GE
    KS -->|"评估结果"| CF
    CF -->|"完整案件脚本"| GE
    GE -->|"存档/读档"| ST
    ST -->|"历史数据"| KS
    GE -->|"最终输出"| UI["🖥️ 用户界面
对话 + 线索墙 + 知识展板 + 结案报告"]
  

graph LR
    subgraph Physics["物理"]
        PJ03["P-J-03
速度概念"] --> PJ04["P-J-04
速度测量实验"]
        PJ08["P-J-08
摩擦力"] --> PG09["P-G1-09
牛顿第二定律"]
        PJ20["P-J-20
内能·热传递"] -->|"跨学科"| CG03["C-G1-03
氧化还原反应"]
    end
    subgraph Math["数学"]
        MJ01["M-J-01
有效数字"]
        MJ02["M-J-02
比例换算"]
        MJ03["M-J-03
二次函数"]
    end
    subgraph Chemistry["化学"]
        CG02["C-G1-02
化学能与热能"]
        CG03["C-G1-03
氧化还原反应"]
    end
    PJ01["P-J-01
长度测量"] -.->|"横向展开"| MJ01
    PJ03 -.->|"横向展开"| MJ02
    PG03["P-G1-03
匀变速运动"] -.->|"横向展开"| MJ03
    PG01["P-G1-01
质点参考系"] -.->|"前置"| PG03
    PG03 -.->|"后续"| PG19["P-G1-19
抛体运动"]
  

stateDiagram-v2
    [*] --> exploration: 接受案件
    exploration --> reasoning: 线索收集完毕
    reasoning --> report: 核心问题解答正确
    report --> done: 提交结案报告
    done --> [*]: 解锁奖励

    state exploration {
        [*] --> scene_intro: 场景引入
        scene_intro --> clue_discussion: 发现线索
        clue_discussion --> knowledge_panel: 展开知识展板
        knowledge_panel --> scene_intro: 继续勘查
    }

    state reasoning {
        [*] --> socratic_q1: 苏格拉底提问①
        socratic_q1 --> socratic_q2: 追问
        socratic_q2 --> formula: 公式推导
        formula --> conclusion: 得出结论
    }

    state report {
        [*] --> detective_eye: 侦探之眼
        detective_eye --> flash: 灵光一闪
        flash --> superpower: 超能力解锁
        superpower --> [*]
    }
  

sequenceDiagram
    participant User as 👤 玩家
    participant UI as 🖥️ 界面
    participant KS as 🎯 知识选择器
    participant CF as 🏭 案件工厂
    participant KG as 🧠 知识图谱
    participant GE as ⚙️ 游戏引擎
    participant ST as 💾 存储

    User->>UI: 点击"生成案件" / 选择口味
    UI->>KS: 请求评估玩家水平
    KS->>ST: 读取玩家档案
    ST-->>KS: 历史破案记录 + 已掌握知识点
    KS->>KS: evaluatePlayer() 计算难度等级
    KS->>KS: selectKnowledgePoints() 筛选知识点
    KS-->>CF: 返回 {knowledgeIds, assessment, targetSubject}

    CF->>KG: 读取知识图谱依赖关系
    KG-->>CF: 返回 prerequisites + leadsTo + lateralExpanse
    CF->>CF: buildCase() 生成完整案件脚本
    CF-->>UI: 返回 {caseInfo, hotspots, dialogue, report}

    UI->>GE: 加载案件数据，启动游戏
    GE->>GE: 播放场景引入对话
    GE->>GE: 线索勘查 → 知识展板展开
    GE->>GE: 苏格拉底提问 → 卡关检测
    GE->>GE: 完成推理 → 生成结案报告

    GE->>ST: 保存案件状态 + 更新档案
    ST-->>User: 解锁成就 + 经验值 + 新案件