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

操作时间：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` 提现保持兼容；新限制只拒绝此前可任意填写的未开放渠道。
- 历史支付宝或微信记录仍可正常展示，不会被修改。
- 本次不处理组织银行卡绑定入口和银行卡空数据问题。