开始多平台 多店铺整改

apps/backend/README.md

@@ -20,14 +20,15 @@ npm install
 首次使用前同步 OCR 子服务依赖：
 
 ```bash
-cd /Users/yml/codes/order-site-backend/subservices/ocr-worker
+cd /Users/yml/codes/order-site-workspace/apps/backend/subservices/ocr-worker
 uv sync
 ```
 
-回到项目根目录启动：
+复制并填写环境变量后启动：
 
 ```bash
-cd /Users/yml/codes/order-site-backend
+cp /Users/yml/codes/order-site-workspace/.env.development.example /Users/yml/codes/order-site-workspace/.env
+cd /Users/yml/codes/order-site-workspace/apps/backend
 npm run dev
 ```
 
@@ -39,19 +40,12 @@ npm run browser:install:linux
 npm run start
 ```
 
-## 配置文件
+## 配置
 
-现在推荐直接改配置文件，不需要每次在终端里手动拼环境变量。
+当前后端采用 `.env` 单一路径做环境配置：
 
-- 默认配置：`config/default.cjs`
-- 本地覆盖：`config/local.cjs`
-- 参考模板：`config/local.example.cjs`
-
-推荐做法：
-
-1. 通用默认值放在 `config/default.cjs`
-2. 你自己机器上的配置放在 `config/local.cjs`
-3. 只有 CI、部署脚本、临时排查时再用环境变量覆盖
+- 通用默认值：`config/default.cjs`
+- 本地/部署覆盖：工作区根目录 `.env`
 
 当前最常改的配置有：
 
@@ -91,6 +85,20 @@ npm run start
 - `subservices/ocr-worker`
   内嵌 OCR 子服务
 
+## Docker 开发
+
+当前 `docker-compose.dev.yml` 已切到源码挂载模式：
+
+- 后端容器启动时执行 `npm install` 和 `npm run dev`
+- OCR 子服务会在容器里执行 `pip install -e /app/subservices/ocr-worker`
+- 所以平时改 `src/`、改 OCR Python、改 `.env`，一般都不需要重建镜像
+
+只有下面几类改动通常还需要 `docker compose -f docker-compose.dev.yml up -d --build backend`：
+
+- `deploy/docker/backend.Dockerfile`
+- 系统层依赖
+- Playwright 浏览器基础环境
+
 ## 产物
 
 浏览器会话产物默认保存在：
@@ -104,6 +112,17 @@ npm run start
 
 这些都是运行时产物，默认不提交 Git。
 
+运行日志默认保存在：
+
+- `data/logs/app.log`
+- `data/logs/webhook.log`
+
+OCR 子服务已经简化为：
+
+- 本地源码开发：在 `subservices/ocr-worker` 里执行一次 `uv sync`
+- Docker 运行：镜像构建时直接安装 Python 依赖
+- 后端调用：每次识别单独拉起一次 Python 进程，不维护常驻 OCR worker
+
 `TENCENT_REDEEM_PROOF_MODE` 对应的配置文件项会影响生成强度：
 
 - `full`：完整证明