部署方式

构建应用

在仓库根目录执行：

npm run build

构建过程编译 Vite 前端并打包 Spring Boot JAR。Docker 构建会把 frontend/dist 放入 JAR，生产环境由 8080 同时提供 /api/** 和 React 应用。

Docker Compose

仓库提供本地 H2 和 PostgreSQL 两种部署组合：

docker compose -f docker-compose.deploy-h2.yml up --build

或：

docker compose -f docker-compose.deploy-postgres.yml up --build

生产部署应为系统数据库和传输目录配置持久卷与备份。

路径前缀

同一个 JAR/镜像可以直接部署在根路径，也可以由反向代理挂载到任意前缀：

location = /platform/tools/db { return 308 /platform/tools/db/; }
location /platform/tools/db/ {
    proxy_pass http://super-db-manager:8080/;
    proxy_set_header X-Forwarded-Prefix /platform/tools/db;
    proxy_cookie_path / /platform/tools/db/;
}

不要为此设置 server.servlet.context-path。proxy_pass 尾部斜杠必须保留。

多实例注意事项

传输目录必须被所有实例共享。清理任务会先在系统数据库中声明过期文件，确保同一文件只由一个实例删除；共享存储和系统数据库必须保持一致可用。