order_site/docs/迁移与部署计划.md

迁移与部署计划

目标

将现有两个项目整理为统一工作区：

• apps/backend
• apps/frontend

并以 Docker Compose + Caddy 作为标准部署方式。

已完成

1. 新建统一工作区目录 order-site-workspace
2. 将原后端迁移到 apps/backend
3. 将原前端迁移到 apps/frontend
4. 增加 docker-compose.yml
5. 增加后端 Dockerfile
6. 增加前端+Caddy Dockerfile
7. 增加 Caddy 反代配置
8. 增加根目录 .env.example
9. 后端新增环境变量支持：
   • ADMIN_DEFAULT_USERS_JSON
   • ORDER_SKU_MAPPINGS_JSON
   • AGISO_MESSAGE_TEMPLATE

当前部署结构

backend

• Node 运行主服务
• Playwright 安装 Chromium
• uv 管理 OCR 子服务
• SQLite 与截图产物通过 Docker 卷持久化

web

• 前端先构建
• 最终由 Caddy 提供静态文件
• /api/* 与 /health 反向代理到 backend

上线前仍需确认

1. .env 中的生产域名
2. 后台默认账号密码
3. Agiso 密钥与消息配置
4. SKU 映射 JSON
5. 是否继续使用 SQLite，或后续切换 MySQL/PostgreSQL

建议的下一步

1. 在新工作区本地执行一次：
   • docker compose build
   • docker compose up -d
2. 验证：
   • /health
   • /api/v1/admin/auth/login
   • 前台 claim 页面
   • 后台管理页
3. 再补服务器部署文档与备份策略

已补充文档

• 服务器部署教程
• 首次上线检查清单
• 生产环境变量模板.env