init

docs/迁移与部署计划.md

@@ -0,0 +1,66 @@
+# 迁移与部署计划
+
+## 目标
+
+将现有两个项目整理为统一工作区：
+
+- `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. 再补服务器部署文档与备份策略
+
+## 已补充文档
+
+- [服务器部署教程](/Users/yml/codes/order-site-workspace/docs/%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%83%A8%E7%BD%B2%E6%95%99%E7%A8%8B.md)
+- [首次上线检查清单](/Users/yml/codes/order-site-workspace/docs/%E9%A6%96%E6%AC%A1%E4%B8%8A%E7%BA%BF%E6%A3%80%E6%9F%A5%E6%B8%85%E5%8D%95.md)
+- [生产环境变量模板.env](/Users/yml/codes/order-site-workspace/docs/%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E6%A8%A1%E6%9D%BF.env)