apps/
  backend/   Node + Express + Playwright + OCR worker
  frontend/  Vue 3 + Vite + Element Plus
deploy/
  caddy/     Caddy 配置
  docker/    Dockerfile
docs/        迁移与部署文档
docker-compose.yml

本地开发

前端：

cd apps/frontend
npm install
npm run dev

后端：

cp .env.development.example .env
cd apps/backend/subservices/ocr-worker
uv sync
cd apps/backend
npm install
npm run dev

Docker 部署

cp .env.production.example .env
docker compose build
docker compose up -d

Docker 本地开发

cp .env.development.example .env
docker compose -f docker-compose.dev.yml up -d --build

开发版 Compose 现在是热更新模式：

后端源码挂载到容器里，运行 npm run dev
前端源码挂载到容器里，运行 vite
Caddy 只负责把 80/443 反代到前后端容器

通常只有首次启动、改 Dockerfile、改系统依赖时才需要 --build。

开发版 Compose 会把后端数据目录直接挂载到：

apps/backend/data

这样本地可以直接看到：

SQLite 数据库
data/logs/*.log
浏览器会话产物
截图和证明文件

当前 Dockerfile 已默认针对国内服务器优化以下下载源：

Debian apt 使用腾讯云镜像
npm 使用 npmmirror
Python pip 使用腾讯云 PyPI 镜像
后端 Playwright 固定为 1.42.1，浏览器下载使用 npmmirror

如果你的服务器网络环境不同，也可以在构建时覆盖：

docker compose build \
  --build-arg DEBIAN_MIRROR=mirrors.tuna.tsinghua.edu.cn \
  --build-arg NPM_REGISTRY=https://registry.npmjs.org \
  --build-arg UV_INDEX_URL=https://pypi.org/simple

默认入口：

前端与领取页：https://你的域名/
后端健康检查：https://你的域名/health
后端接口前缀：https://你的域名/api/v1/...

开发时如果只改业务代码，直接保留 docker compose -f docker-compose.dev.yml up -d 即可：

改后端 src/：容器内自动热重启
改前端 src/：Vite 自动热更新
改 OCR Python：后端下次调用时直接走挂载后的最新源码

详细文档：

迁移原则

不重写现有业务代码
先统一目录、部署和配置
生产环境优先使用 .env 和 Docker 卷
本机 Docker 调试优先使用 docker-compose.dev.yml

README.md Unescape Escape

order-site-workspace

目录结构

本地开发

Docker 部署

Docker 本地开发

迁移原则

README.md