2026-07-14 01:38:41 +00:00
|
|
|
|
服务端文档入口
|
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
|
|
本目录用于保存 update-server 服务端子仓库的说明文档。
|
|
|
|
|
|
|
|
|
|
|
|
建议阅读顺序：
|
|
|
|
|
|
|
|
|
|
|
|
1. 服务端部署说明.md
|
|
|
|
|
|
面向部署和运维，说明 Docker 离线包里有什么、怎么部署、.env 每个字段怎么填、怎么查看日志和备份数据。
|
|
|
|
|
|
|
|
|
|
|
|
2. 后端模板化改造说明.md
|
|
|
|
|
|
面向后端维护，说明当前 FastAPI 后端如何按 routes/services/repositories/schemas 分层，以及后续工程化方向。
|
|
|
|
|
|
|
2026-07-14 03:50:22 +00:00
|
|
|
|
3. 崩溃报告接口联调说明.md
|
|
|
|
|
|
面向测试和客户端接入，说明 CRASH_REPORT_TOKEN、CRASH_SYMBOL_TOKEN、CRASH_ADMIN_TOKEN 分别怎么用，并给出可直接复制的 curl 示例。
|
|
|
|
|
|
|
2026-07-14 01:38:41 +00:00
|
|
|
|
常用源码入口：
|
|
|
|
|
|
|
|
|
|
|
|
- main.py：服务启动、数据库初始化、MinIO 初始化、全局客户端鉴权。
|
|
|
|
|
|
- app/api/routes/：管理后台、客户端更新、崩溃报告等 HTTP 路由。
|
|
|
|
|
|
- app/services/：业务逻辑。
|
|
|
|
|
|
- app/repositories/：SQLite 数据库读写。
|
|
|
|
|
|
- admin-ui/：新版管理后台前端源码。
|
|
|
|
|
|
- legacy/：旧版单文件管理后台，仅作为兼容 fallback。
|
|
|
|
|
|
- scripts/package-offline-server.sh：生成服务端 Docker 离线部署包。
|
|
|
|
|
|
|
|
|
|
|
|
本地源码启动：
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd update-server
|
|
|
|
|
|
./venv/bin/python3 main.py
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Docker 离线包打包：
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd update-server
|
|
|
|
|
|
bash ./scripts/package-offline-server.sh \
|
|
|
|
|
|
--version 0.1.0 \
|
|
|
|
|
|
--output-dir ./dist/SimCAEServerDockerPackage
|
|
|
|
|
|
```
|
