PMFlow/mdproject/docker-hot-reload-plan-zh.md

PMFlow Docker 热部署执行回填

目标

• 启用 Docker 开发态热更新：后端代码改动自动重载，前端代码改动自动 HMR。

变更项

• 新增 docker-compose.dev.yml（开发态编排）
• 修改 frontend/vite.config.ts，支持 VITE_DEV_API_PROXY_TARGET
• 修改 scripts/docker_stack.sh，新增 dev-* 命令
• 修改 start.sh / stop.sh 为统一入口（默认 dev 热部署）
• 备份旧本地流程到 scripts/start_legacy_local.sh / scripts/stop_legacy_local.sh

已执行命令

bash scripts/docker_stack.sh stop
bash scripts/docker_stack.sh dev-start
bash scripts/docker_stack.sh dev-status
bash scripts/docker_stack.sh dev-health

当前状态

• pmflow-backend：uvicorn --reload 运行中
• pmflow-frontend：vite dev 运行中，端口 5174
• pmflow-db / pmflow-redis：健康
• 本地访问：
  • http://127.0.0.1:5174
  • http://127.0.0.1:8000/healthz

日常命令

./start.sh             # 默认 dev 热部署
./stop.sh              # 默认停止 dev 热部署
./start.sh prod        # 启动 Docker 生产编排
./stop.sh prod         # 停止 Docker 生产编排
./start.sh legacy      # 旧本地流程（venv+npm+tunnel）
./stop.sh legacy       # 停止旧本地流程