完整上线指南
本指南面向把系统正式推向生产的实施与运营人员：每个配置域要不要配、什么时候配、不配会怎样，全部给出决策依据与文档跳转。
上线阶段总览
| 阶段 | 指南章节 | 解决什么问题 |
|---|---|---|
| 1. 基础设施 | 基础设施与域名规划 | 域名怎么规划、HTTPS 与证书谁负责、生产环境变量、对外接口开关、部署模式切 PROD |
| 2. 平台初始化 | 平台初始化配置 | 账号权限收紧、端点、站点合规、存储、邮件、安全策略，每个域的必须性与不配后果 |
| 3. 支付能力 | 支付能力开通 | 产品环境、通道商户与密钥、通道路由、支付应用强绑规则、风控默认值与收紧建议 |
| 4. 商户开通 | 商户开通与对接就绪 | 商户 / 应用 / 对接密钥的生产发放流程与就绪检查 |
| 5. 网关收款 | 网关收款上线 | 统一收银台、聚合扫码、码牌、收银小程序的五环节上线链路（API 直连可跳过） |
| 6. 可选功能 | 可选功能上线 | 分账、转账、易支付按需开通的前置条件 |
| 7. 验收运维 | 上线验收与运维交接 | 上线前验收、小额真实支付、首日观察、升级与应急 |
配置域全景地图
按「必须性」分三档：必须（不配核心流程不通或有安全风险）、强烈建议（影响运营/合规/体验）、按需（用到才配）。
| 配置域 | 必须 | 不配 / 配错的后果 | 详情 |
|---|---|---|---|
| 域名与 HTTPS | 必须 | 付款人页面被浏览器告警、微信/支付宝拒绝回调与跳转 | 基础设施 |
| 生产环境变量 | 必须 | 必填变量缺失启动直接失败（DB/Redis/密钥等） | 配置说明 - 生产环境变量清单 |
| 部署模式 PROD | 必须 | DEV 模式下开发超管（固定弱口令）可登录、沙箱入口对外可见 | 基础设施 |
| 网关对外接口 | 必须 | 网关按路径前缀放行：/unipay、/unipay/callback、/app-*（小程序/APP）默认开启，/epay 默认关闭；误关则对应调用全不通 | 基础设施 |
| 端点配置 | 必须 | 收银台跳转、回调通知、三方登录回调地址全部错误 | 平台初始化 |
| 运营管理员账号 | 必须 | 只依赖开发超管账号登录，生产环境不可用 | 平台初始化 |
| 支付产品环境 | 必须 | 沙箱/生产环境固化错乱，下单被路由拒绝 | 支付能力 |
| 通道商户与密钥 | 必须 | 无可用收款通道，或密钥配错下单失败 | 支付能力 |
| 通道路由 | 必须 | 下单报路由无法解析，无法收款 | 支付能力 |
| 商户对接密钥 | 必须 | 业务系统无法完成签名互信 | 商户开通 |
| 存储配置（OSS） | 强烈建议 | 文件上传类功能不可用（站点素材、对账单、导入导出） | 平台初始化 |
| 邮件（SMTP） | 强烈建议 | 邮箱找回密码、验证码通道不可用 | 平台初始化 |
| 用户协议 | 强烈建议 | 合规缺口：登录页协议空态 | 平台初始化 |
| 系统安全策略 | 强烈建议 | 默认策略宽松（密码永不过期、会话不限时），生产应人工收紧 | 平台初始化 |
| 风控策略 | 强烈建议 | 默认仅黑名单拦截；上线初期建议「仅记录」观察 | 支付能力 |
| 支付应用（微信/抖音） | 按需 | 微信 JSAPI/小程序收款必需；不涉及则免 | 支付能力 |
| 域名验证 | 按需 | 微信内打开页面/小程序拉起失败 | 支付能力 |
| 网关收款五环节 | 按需 | 仅 API 直连可跳过；用收银台/码牌必须完成 | 网关收款 |
| 分账 / 转账 / 易支付 | 按需 | 各有通道侧前置，用到才配 | 可选功能 |
建议时间线
以正式收款日为 T 日倒排（中小规模部署参考）：
| 时间 | 事项 |
|---|---|
| T-7 ~ T-5 | 域名注册备案、服务器与中间件就绪、按基础设施完成部署与 PROD 切换 |
| T-5 ~ T-3 | 平台初始化全部必配项 + 强烈建议项；通道侧（微信/支付宝商户平台）材料申请 |
| T-3 ~ T-1 | 支付能力开通与商户开通；沙箱联调（仅支付宝可用）；网关收款链路按需上线 |
| T-1 ~ T | 小额真实支付端到端验证（见上线验收），核对检查清单 |
| T+1 ~ T+7 | 观察期：风控「仅记录」模式观察命中情况，日志与回调推送日常巡检 |