dingdanquanliucheng/docs/最终替换清单.md

最终替换清单

本文档只列最终验收或上线前需要你手动替换的内容，尽量做到不改业务代码，只改配置。

后端

文件：

• 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

你需要新建：

• 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

你需要新建：

• frontend/web-sales/.env.production 或本地联调用 frontend/web-sales/.env.local

需要替换：

• VITE_API_BASE_URL 说明：后端真实地址。
• VITE_ENABLE_DEMO_FALLBACK 说明：最终验收建议保持 false。

微信管理层小程序

文件：

• frontend/mini-manager/config.js

需要替换：

• apiBaseUrl 说明：替换成后端真实 HTTPS 地址，并确保该地址已加入微信小程序合法域名。

微信司机小程序

文件：

• 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. 小程序验收：管理层审批、司机接单/揽货/送达