flowchart TD
    A[CLI / REST / MCP / SDK / Playground] --> B[AcademicCopilotFacade]
    B --> C[Copilot: 意图识别]
    B --> D[Planner + What-if]
    C --> E[DecisionContext + RuleEngine]
    D --> E
    E --> F[AuditSnapshot + 五层证据链]
    F --> G[Repository 层]
    G --> H[Knowledge / Rule / Ontology]
    H --> I[Compiler: PDF → AST → IR → plan JSON]

cd academic-copilot-framework/packages/ade

# 1. 构建知识库（5 个专业）
python -m compiler.cli knowledge build --verify

# 2. 健康检查（版本 / Hash / 知识库 / 规则 / Ontology / Benchmark / Replay）
python -m compiler.cli doctor

cd academic-copilot-framework/examples
python 01_basic_status.py     # Student → Audit → Response
python 02_risk.py             # 毕业风险评估
python 03_plan.py             # 补修计划
python 04_what_if.py          # 补修课程 → 重新判定

# 1. WebUI（Dashboard API + 静态资源，零新增 Python 依赖，默认 127.0.0.1:8787）
python -m academic_copilot.webui.server

# 2. 统一 MCP 入口（19 个教务数据工具 + 3 个 academic.* 决策工具）
python kernel_server.py

# 3. 前端（独立开发模式）
cd frontend && npm install && npm run dev

.
├── academic_copilot/             # 学业知识库与决策内核
│   ├── data/knowledge/           #   10 专业培养方案数据集（2025）
│   ├── knowledge_*/              #   知识库：数据集 / 注册 / 审计 / 发布 / 门控
│   ├── student_source/           #   学生数据源：导入 / GDMU 实时 / 演示
│   ├── student_profile/          #   学生画像（脱敏）
│   ├── curriculum/               #   课程解析与学分核算
│   ├── planning/ timeline/       #   补修规划 / 学业时间线
│   ├── snapshot_history/         #   快照历史与差异
│   └── webui/                    #   WebUI 服务端（127.0.0.1:8787）
├── frontend/                     # WebUI 前端（原生 JS + Vite + Vitest）
├── gdmu_mcp/ server.py           # 正方教务 MCP 桥
├── kernel_server.py              # 统一 MCP 入口（数据工具 + academic.* 工具）
├── scripts/                      # 数据集生成 / 审计 / 导出脚本
├── academic-copilot-framework/   # ADE 学业决策引擎
│   ├── packages/ade/             #   核心：compiler/knowledge/rule/decision/
│   │                             #         audit/matcher/copilot/planner/simulation
│   ├── validation/               #   验证工作区：golden cases + benchmark
│   ├── docs/                     #   架构 / API / ADR / 图
│   ├── examples/                 #   8 个可运行示例
│   ├── demo/                     #   开箱即用的演示学生
│   ├── playground/               #   交互式 Playground
│   ├── benchmark/                #   Benchmark 可视化
│   ├── plugins/                  #   插件 SDK（Notification/Rule/Planner/Matcher）
│   ├── installer/                #   Windows 安装器脚手架
│   └── paper/                    #   学术论文
└── docs/                         # 架构 / 数据源 / 知识治理文档

python -m pytest tests -q                                  # 根模块测试
cd academic_copilot && python -m pytest tests -q           # 内核 / 知识库测试
cd frontend && npm test                                    # 前端测试（Vitest）
cd academic-copilot-framework/packages/ade && python -m pytest tests -q   # 426 tests
cd academic-copilot-framework/validation && python -m pytest tests -q     # 241 tests