From 0548692db0448e360c8ed204b0a50c22a0467069 Mon Sep 17 00:00:00 2001 From: nikelaluo <2135665716@qq.com> Date: Tue, 14 Jul 2026 10:32:50 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E5=90=8E=E7=AB=AF?= =?UTF-8?q?=E6=A1=86=E6=9E=B6=E5=92=8C=E6=9C=8D=E5=8A=A1=E7=AB=AF=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Docs/03-后端工程化结构说明.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/Docs/03-后端工程化结构说明.md b/Docs/03-后端工程化结构说明.md index 7b80361..efd4bea 100644 --- a/Docs/03-后端工程化结构说明.md +++ b/Docs/03-后端工程化结构说明.md @@ -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。后续生产化安全加固时,可以继续引入成熟认证权限组件。 + ## 当前已落地 已经新增模板化目录: