简体中文
项目概述
本页尚未完成新模型复核
本页保留旧版操作资料，不作为当前接口或产品能力的依据。课程/小节接口已移除，旧动画执行方式不再适用。新契约以前端接入流程为准；部署不得据旧文直接初始化已有数据库。
什么是 MakiMath？
MakiMath 是一个专为数学与数理学科设计的现代化开源结构化讲义与学习生态平台。
在传统的数学学习与教学中，教材与电子讲义通常采用线性篇章结构（一页接一页），难以直观体现定理、定义、算法之间错综复杂的前置依赖关系；同时，传统的 LaTeX 排版环境配置繁重、编译迟缓，难以提供灵动的 Web 交互体验。
MakiMath 融合了现代排版语言 Typst、DAG 有向无环图知识拓扑与现代前后端全栈架构，致力于为学习者、教师与内容创作者提供如同“数学思想路线图”般的学习与编纂体验。
核心设计理念
1. 结构化知识拓扑 (DAG Precedence Network)
传统的教材是线性的，而数学知识本质上是有向无环图（DAG）：
- 四级层级体系：平台将讲义组织为
分类 (Category)→课程 (Course)→章节 (Chapter)→小节 (Section)。 - 前置依赖编排：每个小节均可显式声明其前置依赖的小节（如：学习“多重积分换元”前必须掌握“二阶行列式”与“极坐标变换”）。
- 知识路线图：前端基于 D3 引擎将小节依赖自动“上卷”为章节级图谱，为学习者自动生成个性化的学习路径。
2. Typst 现代化数学排版
- 轻量且优雅：彻底摆脱传统 LaTeX 冗余的环境包裹标签与环境安装负担，Typst 语法极简、易写易读。
- 毫秒级 WASM 渲染：讲义正文在后端保存为源码，通过编译器转换为标准 AST JSON，前端依托 Typlet WebAssembly 引擎在浏览器原生渲染高保真矢量排版，公式缩放永不失真。
3. 安全、开放与现代全栈
- 全链路加密：前端请求体与后端响应体依托专有安全内核全程透明加解密，保护讲义内容版权与接口安全。
- 三级角色架构：
- 普通读者：完全免登，秒级直达公开讲义。
- 课程编者 (Editor)：通过邀请码准入，在专属工作台协同编纂讲义、调试排版与拓扑依赖。
- 平台管理员 (Super Admin)：全权管理用户权限、邀请码派发与全量操作审计日志。
代码仓库生态矩阵
MakiMath 采用清晰的多工程模块化组织：
| 仓库 / 目录 | 技术栈 | 职责描述 |
|---|---|---|
| MakiMath-Frontend | Vue 3 + Vite 8 + D3 + Typlet | 核心前端应用：包含讲义阅读器、知识图谱、编者工作台与平台管理后台 |
| MakiMath-Backend | Fastify 5 + PostgreSQL 16 | 异步高性能后端：拓扑排序、Typst AST 转换、全文检索、JWT 会话与审计 |
| MakiMath-Docs | VitePress 2 | 官方中英双语技术文档站与开发指南 |