# 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 卷