优化服务端部署-测试部署-1

README.md

@@ -28,7 +28,7 @@ npm run dev
 后端：
 
 ```bash
-cp .env.development.example .env
+cp .env.mac-docker.example .env
 cd apps/backend/subservices/ocr-worker
 uv sync
 cd apps/backend
@@ -39,15 +39,34 @@ npm run dev
 ## Docker 部署
 
 ```bash
-cp .env.production.example .env
-docker compose build
+cp .env.server.example .env
+mkdir -p deploy/data/backend
 docker compose up -d
 ```
 
+生产版 Compose 现在会把后端运行数据直接挂载到宿主机目录：
+
+- `deploy/data/backend`
+
+这样服务器上可以直接查看和备份：
+
+- `logs/`
+- `browser-sessions/`
+- `redeem-screenshots/`
+- `agiso-shops.json`
+- `order-fulfillment-bindings.json`
+
+如果你本地已经配好了店铺和履约绑定，首次上线前可以把这两份文件先放进去：
+
+- `deploy/data/backend/agiso-shops.json`
+- `deploy/data/backend/order-fulfillment-bindings.json`
+
+后端启动时会自动执行数据库 migration、初始化默认管理员、同步履约目录；但 `/app/data` 下的业务配置文件仍以宿主机目录内容为准。
+
 ## Docker 本地开发
 
 ```bash
-cp .env.development.example .env
+cp .env.mac-docker.example .env
 docker compose -f docker-compose.dev.yml up -d --build
 ```
 
@@ -126,12 +145,12 @@ docker compose build \
 
 - [服务器部署教程](/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)
-- [开发环境模板](/Users/yml/codes/order-site-workspace/.env.development.example)
-- [生产环境模板](/Users/yml/codes/order-site-workspace/.env.production.example)
+- [mac 本地 Docker 调试模板](/Users/yml/codes/order-site-workspace/.env.mac-docker.example)
+- [服务器部署模板](/Users/yml/codes/order-site-workspace/.env.server.example)
 
 ## 迁移原则
 
 - 不重写现有业务代码
 - 先统一目录、部署和配置
-- 生产环境优先使用 `.env` 和 Docker 卷
+- 生产环境优先使用 `.env` 和宿主机数据目录挂载
 - 本机 Docker 调试优先使用 [docker-compose.dev.yml](/Users/yml/codes/order-site-workspace/docker-compose.dev.yml)