规范气站与配送点提现渠道
This commit is contained in:
@@ -127,6 +127,7 @@
|
||||
- `payment_order` 是统一支付尝试事实,气站端必须通过 `business_type + business_identity` 关联燃气配送订单、商城订单或气站自有钱包充值单,并验证业务对象属于当前气站;不得假设支付单直接包含钱包主键。
|
||||
- 未知业务类型、业务对象缺失以及用户或工作人员钱包充值无法证明属于当前气站,不得向气站端返回。钱包余额支付当前记录在 `wallet_record`,不伪装为统一支付单。
|
||||
- 气站可以创建提现申请并查看处理结果。
|
||||
- 提现申请保留渠道字段并使用下拉选择;当前默认且仅开放“银行卡提现”,支付宝提现和微信提现显示“暂未开通”且不可选择,服务端拒绝未开放渠道。
|
||||
- 气站不能充值、冻结钱包,不能审批、驳回或标记提现完成。
|
||||
- 所有金额使用最小货币单位整数,服务端校验余额和归属。
|
||||
- `fin_reconciliation` 当前模型没有气站主体字段,为避免泄露平台全局渠道数据,气站端在补齐可验证归属前不返回全局记录。
|
||||
|
||||
@@ -152,6 +152,7 @@ Global:
|
||||
- `payment_order` 是统一支付尝试事实,配送点端必须通过 `business_type + business_identity` 关联燃气配送订单、商城订单或配送点自有钱包充值单,并验证业务对象属于当前配送点;不得假设支付单直接包含钱包主键。
|
||||
- 未知业务类型、业务对象缺失以及用户或工作人员钱包充值无法证明属于当前配送点,不得向配送点端返回。钱包余额支付当前记录在 `wallet_record`,不伪装为统一支付单。
|
||||
- 配送点可以创建提现申请,但不能审批、驳回或标记完成。
|
||||
- 提现申请保留渠道字段并使用下拉选择;当前默认且仅开放“银行卡提现”,支付宝提现和微信提现显示“暂未开通”且不可选择,服务端拒绝未开放渠道。
|
||||
- 配送点管理员可以给当前配送点钱包自主充值。
|
||||
- 充值必须填写幂等号、金额、原因和备注。
|
||||
- 单笔充值金额必须大于零且不超过 `Global.ManualRechargeMaxAmount`。
|
||||
|
||||
50
docs/操作日志_组织提现渠道规范化_20260819.md
Normal file
50
docs/操作日志_组织提现渠道规范化_20260819.md
Normal file
@@ -0,0 +1,50 @@
|
||||
# 操作日志:组织提现渠道规范化
|
||||
|
||||
操作时间: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` 提现保持兼容;新限制只拒绝此前可任意填写的未开放渠道。
|
||||
- 历史支付宝或微信记录仍可正常展示,不会被修改。
|
||||
- 本次不处理组织银行卡绑定入口和银行卡空数据问题。
|
||||
Reference in New Issue
Block a user