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