feat: 完善服务端工程化、发布流程和自动化测试

Dockerfile

@@ -1,3 +1,5 @@
+# 第一阶段：构建 Vue 管理后台。
+# 最终镜像只需要 admin-ui/dist，不需要 Node、源码依赖和 node_modules。
 FROM node:22-alpine AS admin_ui_builder
 
 WORKDIR /ui
@@ -9,6 +11,8 @@ COPY admin-ui ./
 RUN npm run build
 
 
+# 第二阶段：运行 FastAPI 服务端。
+# 镜像里只放后端代码、Python 依赖和已经构建好的管理后台静态文件。
 FROM python:3.12-slim
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
@@ -28,6 +32,8 @@ COPY main.py db.py minio_tool.py tables.sql ./
 COPY app ./app
 COPY --from=admin_ui_builder --chown=updateapp:updateapp /ui/dist ./admin-ui/dist
 
+# 运行数据不进镜像，启动时通过 docker-compose 挂载到 /data、/minio_data、/run/secrets/update-keys。
+# 这样升级文件、SQLite 数据库和私钥可以独立备份，也不会跟镜像版本绑死。
 RUN mkdir -p /data/uploads /data/upload_spool /run/secrets/update-keys \
     && chown -R updateapp:updateapp /app /data \
     && find /app/admin-ui/dist -type f -exec chmod 644 {} \; \