platforms/docs/操作日志_组织提现渠道规范化_20260819.md

操作日志：组织提现渠道规范化

操作时间：2026-08-19 操作类型：修改 影响模块：气站管理系统、配送点管理系统、组织钱包提现接口

操作前状态

• 气站端和配送点端的提现渠道使用必填文本框，申请人可以提交任意字符串。
• 渠道没有默认值，列表和详情会直接显示内部编码。
• 服务端只校验渠道非空，可能保存当前无法处理的渠道。

具体操作

• 两个管理端的渠道字段统一改为下拉框。
• 银行卡提现默认选中并可用；支付宝提现和微信提现保留展示，但标记“暂未开通”并禁用。
• 列表和详情将 bank、alipay、wechat 映射为对应中文名称。
• 服务端新增组织提现渠道白名单，当前只接受 bank。
• 增加渠道白名单单元测试与前端静态回归检查。

操作后状态

• 用户无需填写内部渠道编码，新建申请默认使用银行卡提现。
• 未开通渠道无法在页面选择，也不能绕过页面直接提交。
• 历史记录按已知渠道显示中文名称，未知值保留“未知提现渠道（原值）”提示。
• 银行卡数据来源、提现余额预扣、审核及打款流程均未改变。

代码变更

• frontend/gas_admin/src/api/resources.ts：增加气站端提现渠道选项和默认值。
• frontend/gas_admin/src/views/resource/ResourceFieldForm.vue：支持禁用未开通选项。
• frontend/delivery_admin/src/api/resources.ts：增加配送点端提现渠道选项和默认值。
• frontend/delivery_admin/src/views/shared/CrudListPage.vue：支持禁用未开通选项。
• backend/api/internal/logic/common/withdrawal_channel.go：定义组织端提现渠道白名单。
• backend/api/internal/logic/gas/finance.go：校验气站提现渠道。
• backend/api/internal/logic/delivery/finance.go：校验配送点提现渠道。
• docs/06-气站管理系统需求.md、docs/07-配送点管理系统需求.md：同步提现渠道规则。

验证结果

• 后端全量测试 go test ./...：通过。
• 气站端契约检查：通过，20 个资源一致。
• 配送点端契约检查：通过，18 个资源一致。
• 气站端和配送点端类型检查及生产构建：通过。

风险评估

• 现有 bank 提现保持兼容；新限制只拒绝此前可任意填写的未开放渠道。
• 历史支付宝或微信记录仍可正常展示，不会被修改。
• 本次不处理组织银行卡绑定入口和银行卡空数据问题。