50 lines
1.8 KiB
Plaintext
50 lines
1.8 KiB
Plaintext
|
服务端文档入口
|
|||
|
|
==============
|
|||
|
|
|
|||
|
|
你第一次打开 update-server/Docs 时，先看这一份。这里告诉你每份文档是干什么的，以及部署、测试、维护分别该看哪一份。
|
|||
|
|
|
|||
|
|
文档阅读顺序
|
|||
|
|
============
|
|||
|
|
|
|||
|
|
1. 01-服务端Docker打包部署指南.md
|
|||
|
|
适合部署和运维。说明 Docker 离线包里有什么、怎么打包、怎么部署、.env 每个字段怎么填、怎么查看日志和备份数据。
|
|||
|
|
|
|||
|
|
2. 02-崩溃报告接口联调指南.md
|
|||
|
|
适合测试人员、客户端崩溃上报接入人员。说明 CRASH_REPORT_TOKEN、CRASH_SYMBOL_TOKEN、CRASH_ADMIN_TOKEN 分别怎么用，并给出可直接复制的 curl 示例。
|
|||
|
|
|
|||
|
|
3. 03-后端工程化结构说明.md
|
|||
|
|
适合后端维护人员。说明当前 FastAPI 后端如何按 routes/services/repositories/schemas 分层，以及后续工程化方向。
|
|||
|
|
|
|||
|
|
常用任务入口
|
|||
|
|
============
|
|||
|
|
|
|||
|
|
如果你已经拿到 `SimCAEServerDockerPackage.tar.gz`，直接看：
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
01-服务端Docker打包部署指南.md 的“三、使用者：最小部署流程”
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果你要重新生成 Docker 离线部署包，执行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd update-server
|
|||
|
|
bash ./scripts/package-offline-server.sh --version 0.1.0 --output-dir ./dist/SimCAEServerDockerPackage
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
常用源码入口：
|
|||
|
|
|
|||
|
|
- 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
|
|||
|
|
```
|