init

2026-04-08 16:30:42 +08:00
commit 313c036845
131 changed files with 22393 additions and 0 deletions
@@ -0,0 +1,64 @@
+# order-site-workspace
+
+统一工作区版本的订单自动兑换系统。
+
+## 目录结构
+
+```text
+apps/
+  backend/   Node + Express + Playwright + OCR worker
+  frontend/  Vue 3 + Vite + Element Plus
+deploy/
+  caddy/     Caddy 配置
+  docker/    Dockerfile
+docs/        迁移与部署文档
+docker-compose.yml
+```
+
+## 本地开发
+
+前端：
+
+```bash
+cd apps/frontend
+npm install
+npm run dev
+```
+
+后端：
+
+```bash
+cd apps/backend
+npm install
+cd subservices/ocr-worker
+uv sync
+cd ../..
+cp config/local.example.cjs config/local.cjs
+npm run dev
+```
+
+## Docker 部署
+
+```bash
+cp .env.example .env
+docker compose build
+docker compose up -d
+```
+
+默认入口：
+
+- 前端与领取页：`https://你的域名/`
+- 后端健康检查：`https://你的域名/health`
+- 后端接口前缀：`https://你的域名/api/v1/...`
+
+详细文档：
+
+- [服务器部署教程](/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)
+
+## 迁移原则
+
+- 不重写现有业务代码
+- 先统一目录、部署和配置
+- 生产环境优先使用 `.env` 和 Docker 卷