七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西

docs/environment-variables.md

@@ -165,6 +165,36 @@ JUNHONG_WORKER_ROLE=consumer
 JUNHONG_WORKER_INSTANCE_NAME=worker-consumer-1
 ```
 
+### Gateway 服务
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `JUNHONG_GATEWAY_BASE_URL` | 默认配置文件值 | Gateway API 基础地址，配置后必须为 HTTP/HTTPS URL |
+| `JUNHONG_GATEWAY_APP_ID` | 默认配置文件值 | Gateway 应用 ID |
+| `JUNHONG_GATEWAY_APP_SECRET` | 默认配置文件值 | Gateway 应用密钥 |
+| `JUNHONG_GATEWAY_TIMEOUT` | `60` | Gateway 请求超时秒数，允许 5～300 |
+
+生产环境必须通过环境变量覆盖应用身份和密钥。IoT 卡固定档位限速只向 Gateway 发送卡 ICCID 和档位编码，不支持设备限速。
+
+### 企业微信 Adapter
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `JUNHONG_WECOM_BASE_URL` | `https://qyapi.weixin.qq.com` | 企业微信 API 基础地址 |
+| `JUNHONG_WECOM_TIMEOUT` | `10s` | 企业微信外部请求超时时间 |
+| `JUNHONG_WECOM_CREDENTIAL_ENCRYPTION_KEY` | `""` | 启用企业微信功能前必填，32 字节随机密钥的 Base64 文本 |
+
+可使用 `openssl rand -base64 32` 生成加密密钥。密钥缺失或格式错误不会阻止不使用企微的环境启动，但企业微信配置保存、查询和连接测试会按失败关闭处理。更换密钥前必须先制定已有凭据的重新加密方案，否则历史密文将无法读取。
+
+### 审批旧入口切换
+
+| 环境变量 | 默认值 | 说明 |
+|---------|--------|------|
+| `JUNHONG_APPROVAL_LEGACY_REFUND_MANUAL_ENABLED` | `true` | 是否保留退款人工通过/拒绝入口；仅在企微真实闭环和存量清单完成后改为 `false` |
+| `JUNHONG_APPROVAL_LEGACY_OFFLINE_RECHARGE_PAY_ENABLED` | `true` | 是否保留线下充值人工确认入口；仅在企微真实闭环和存量清单完成后改为 `false` |
+
+两个开关默认开启，避免部署新版本时中断存量旧 provider。关闭后接口仍保留路由，但返回“入口已停用”，前端只展示本地批量投影的审批渠道和状态。配置变更需要重启 API 实例，Worker 不依赖这两个旧入口开关。
+
 ### 限流中间件
 
 | 环境变量 | 默认值 | 说明 |