120 lines
3.2 KiB
Markdown
120 lines
3.2 KiB
Markdown
# 最终替换清单
|
||
|
||
本文档只列最终验收或上线前需要你手动替换的内容，尽量做到不改业务代码，只改配置。
|
||
|
||
## 后端
|
||
|
||
文件：
|
||
|
||
- [backend/.env.example](D:/work/python/coding/dingdanquanliucheng/backend/.env.example)
|
||
|
||
你需要复制为：
|
||
|
||
- `backend/.env`
|
||
|
||
重点替换项：
|
||
|
||
- `SECRET_KEY`
|
||
说明：JWT 签名密钥，必须换成正式随机字符串。
|
||
- `MYSQL_HOST`
|
||
- `MYSQL_PORT`
|
||
- `MYSQL_DATABASE`
|
||
- `MYSQL_USER`
|
||
- `MYSQL_PASSWORD`
|
||
说明：以上五项替换成正式 MySQL 连接信息。
|
||
- `ALIYUN_OSS_BUCKET`
|
||
- `ALIYUN_OSS_ENDPOINT`
|
||
- `ALIYUN_OSS_ACCESS_KEY_ID`
|
||
- `ALIYUN_OSS_ACCESS_KEY_SECRET`
|
||
- `ALIYUN_OSS_PUBLIC_BASE_URL`
|
||
说明：以上五项替换成正式 OSS 配置。
|
||
- `AI_PROVIDER`
|
||
说明：如果要启用真实 OCR，改成 `aliyun`。
|
||
- `ALIYUN_OCR_ENDPOINT`
|
||
- `ALIYUN_OCR_PATH`
|
||
- `ALIYUN_OCR_APPCODE`
|
||
说明：替换成正式 OCR 接口配置。
|
||
- `LOGISTICS_TRACE_PROVIDER`
|
||
- `LOGISTICS_TRACE_ENDPOINT`
|
||
- `LOGISTICS_TRACE_PATH`
|
||
- `LOGISTICS_TRACE_APPCODE`
|
||
说明：替换成正式第三方物流轨迹服务配置。
|
||
- `CORS_ALLOW_ORIGINS`
|
||
说明：替换成实际前端访问域名，多个地址用英文逗号分隔。
|
||
|
||
## Web 管理后台
|
||
|
||
文件：
|
||
|
||
- [frontend/web-admin/.env.example](D:/work/python/coding/dingdanquanliucheng/frontend/web-admin/.env.example)
|
||
|
||
你需要新建：
|
||
|
||
- `frontend/web-admin/.env.production`
|
||
或本地联调用 `frontend/web-admin/.env.local`
|
||
|
||
需要替换：
|
||
|
||
- `VITE_API_BASE_URL`
|
||
说明：后端真实地址。
|
||
- `VITE_ENABLE_DEMO_FALLBACK`
|
||
说明：最终验收建议保持 `false`，避免接口失败时自动回退演示数据。
|
||
|
||
## Web 业务员端
|
||
|
||
文件：
|
||
|
||
- [frontend/web-sales/.env.example](D:/work/python/coding/dingdanquanliucheng/frontend/web-sales/.env.example)
|
||
|
||
你需要新建：
|
||
|
||
- `frontend/web-sales/.env.production`
|
||
或本地联调用 `frontend/web-sales/.env.local`
|
||
|
||
需要替换：
|
||
|
||
- `VITE_API_BASE_URL`
|
||
说明：后端真实地址。
|
||
- `VITE_ENABLE_DEMO_FALLBACK`
|
||
说明：最终验收建议保持 `false`。
|
||
|
||
## 微信管理层小程序
|
||
|
||
文件：
|
||
|
||
- [frontend/mini-manager/config.js](D:/work/python/coding/dingdanquanliucheng/frontend/mini-manager/config.js)
|
||
|
||
需要替换：
|
||
|
||
- `apiBaseUrl`
|
||
说明：替换成后端真实 HTTPS 地址，并确保该地址已加入微信小程序合法域名。
|
||
|
||
## 微信司机小程序
|
||
|
||
文件：
|
||
|
||
- [frontend/mini-driver/config.js](D:/work/python/coding/dingdanquanliucheng/frontend/mini-driver/config.js)
|
||
|
||
需要替换：
|
||
|
||
- `apiBaseUrl`
|
||
说明：替换成后端真实 HTTPS 地址，并确保该地址已加入微信小程序合法域名。
|
||
|
||
## 上线前还要确认
|
||
|
||
- 已执行 `alembic upgrade head`
|
||
- 已执行 `python backend/scripts/bootstrap_data.py`
|
||
- 已修改管理员初始密码
|
||
- OSS Bucket 权限与公网访问策略已确认
|
||
- OCR 与物流服务商测试凭证已切换正式凭证
|
||
- 小程序合法域名已配置
|
||
|
||
## 建议验收顺序
|
||
|
||
1. 后端启动并检查 `/health`
|
||
2. 执行 `python backend/scripts/smoke_check.py`
|
||
3. 构建 `web-admin` 与 `web-sales`
|
||
4. 管理后台验收：审批、履约、报表、系统管理
|
||
5. 业务员端验收：登录、建单、提交、取消、提醒
|
||
6. 小程序验收：管理层审批、司机接单/揽货/送达
|