docs: 补充后端框架和服务端文档说明

This commit is contained in:
2026-07-14 10:32:50 +00:00
parent d7c7eeefc7
commit 0548692db0
+15 -1
View File
@@ -6,12 +6,26 @@
服务端后端不再继续把所有配置、鉴权、审计、页面入口和业务接口堆在 `main.py` 里,而是逐步改成成熟 FastAPI 后台项目常见的分层结构。
参考方向
当前采用的成熟框架和模板生态
- 后端 HTTP 框架:FastAPI。
- 运行服务:Uvicorn。
- 请求模型和参数校验:FastAPI 自带的 Pydantic 体系。
- 管理后台前端:GitHub 上的 pure-admin-thin / vue-pure-admin 生态,技术栈是 Vue3、Element Plus、TypeScript、Vite。
- 对象存储:MinIO。
后端工程化参考方向:
- FastAPI 官方 full-stack 模板:后端工程结构、配置、JWT、数据库模型、迁移、Docker。
- FastAPI Users:用户、认证、JWT、密码哈希、用户管理。
- 现有 SimCAE 业务:版本发布、Manifest 签名、License、设备、崩溃报告、日志审计。
当前说明:
- 目前不是把某个 GitHub 后端模板整套照搬进项目,而是采用 FastAPI 作为成熟后端框架,并按成熟 FastAPI 后台项目的常见结构做工程化拆分。
- 管理后台前端已经基于 pure-admin-thin 这类成熟后台模板改造。
- 管理员鉴权当前仍是项目自有令牌机制,尚未整套接入 FastAPI Users/JWT/RBAC。后续生产化安全加固时,可以继续引入成熟认证权限组件。
## 当前已落地
已经新增模板化目录: