服务端文档入口
==============

本目录用于保存 update-server 服务端子仓库的说明文档。

建议阅读顺序：

1. 服务端部署说明.md
   面向部署和运维，说明 Docker 离线包里有什么、怎么部署、.env 每个字段怎么填、怎么查看日志和备份数据。

2. 后端模板化改造说明.md
   面向后端维护，说明当前 FastAPI 后端如何按 routes/services/repositories/schemas 分层，以及后续工程化方向。

常用源码入口：

- 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
```