README.md

文档导航

产品与范围

• 项目愿景

协作约定

• 通用协作与编码细则

架构

• 架构总览
• 运行拓扑
• 后端模块分工
• 数据模型与存储
• 核心请求流程
• 前端 SPA 结构

配置与参考

• 配置项说明
• REST API 约定
• MCP 能力说明
• QML 测验格式

项目内 Skills

• MD-Quiz Skill
• Quiz Repo Spec Skill
• QML Authoring Skill
• Quiz Repo Sync 排障
• Quiz 仓库规范正文
• QML Parser 契约事实
• QML 详细规范

UI

• UI 主题覆盖
• Utility 落地规则

建议阅读顺序

1. 根目录 README.md
2. 项目愿景
3. 架构总览
4. 运行拓扑
5. 后端模块分工
6. 数据模型与存储
7. REST API 约定
8. UI 主题覆盖
9. Utility 落地规则

说明

• docs/architecture/ 只记录当前代码能够证明的稳定边界与实现事实。
• 当前正式前端入口为 static/admin/ 与 static/public/ 两套 Alpine SPA。