部署
本页汇总当前推荐的部署路径，而不是保留历史实验路径的并列叙述。
本地联调
docker compose up -d --build
如需带 mock 数据：
bash scripts/docker_up_with_mock_data.sh
当前线上形态
docker-compose.infra.deploy.yml：infra host，承载 PostgreSQL、MinIO、Qdrant、Redis 与备份相关服务docker-compose.deploy.yml：app host，承载ai-service、前端与 docs
部署原则
- 线上不再推荐用单一 compose 同时承载 app 和 infra
- 环境变量按服务器职责拆分
- 文档站改动也应通过
uv run mkdocs build验证