4.2 KiB
4.2 KiB
退款审核关联名称展示修复操作日志
操作时间：2026-08-17
操作类型：修改
影响模块：平台总后台、财务管理、退款审核
操作前状态
- 退款业务对象依赖前端动态加载原订单关系，加载不到时显示“名称加载失败”。
- 申请用户直接显示截断 UUID，财务列表无法直接识别用户。
具体操作
- 退款列表按当前页批量读取气体配送订单、商城订单和用户名称，不执行逐行查询。
- 退款详情复用同一展示构建逻辑，接口增加
business_display_name和user_display_name只读展示字段。 - 业务对象显示原订单号，用户显示姓名；两个字段均保留 UUID 复制和详情跳转。
- 订单或用户已失效时显示明确业务文案，不将失效关系误报为普通网络加载失败。
- 增加业务类型、订单号和失效关系的回归测试及前端展示契约断言。
- 新增“退款商品”：商城订单使用成交快照，气体配送订单通过退款明细关联原订单项和产品档案，多件退款显示“× 数量”。
- 空说明和空审核说明分别显示“无说明”“无审核说明”，不再使用无语义短横线。
- 审核人由后端解析平台账号展示名称；历史账号归档后仍可读取，失效时显示明确文案，并保留标识复制。
- 支付记录显示支付单号，钱包显示归属类型摘要，完整唯一标识继续作为辅助复制信息。
- 修正
MOCK-REFUND-001的审核人归属：由气站账号改为平台根管理员，并在重复执行 Mock 初始化时修复已有错误数据。 - 增加独立命令
repair-mock-refund-reviewer，用于绕开无关 Mock 数据冲突并安全修复当前数据库。
行为变化
- 修改前：业务对象显示“名称加载失败”，用户显示 UUID。
- 修改后：业务对象显示原订单号，用户显示姓名。
- 当前 Mock 退款的“退款商品”显示“示例液化气钢瓶”。
- 当前 Mock 退款的“审核人”显示平台根管理员，不再显示“审核人记录已失效”。
- 退款金额、审核状态、入账事务、权限和接口路径均未改变。
代码变更
backend/api/internal/logic/platform/payment/refund.go：增加退款列表和详情可读关系字段。backend/api/internal/logic/platform/payment/refund_test.go：增加订单类型、订单号和失效关系测试。backend/api/internal/seed/mock.go：修正 Mock 退款审核人并增加历史错误数据幂等修复。backend/api/internal/seed/mock_test.go：增加修复范围的输入保护测试。backend/api/cmd/cli/main.go：增加 Mock 退款审核人定向修复命令。frontend/platform_admin/src/api/resources.ts：退款关系字段改用接口展示名称。frontend/platform_admin/src/api/resource-detail-contract.ts：固定退款详情字段顺序并隐藏审核人辅助名称字段。frontend/platform_admin/scripts/check-resource-display-contracts.mjs：增加退款展示契约断言。docs/项目文档_平台资源中文展示统一_v1.0.md：记录 v1.10 至 v1.13 变更。
验证结果
go test ./internal/logic/platform/payment ./internal/routers：通过。go test ./...：通过。go vet ./...：通过。go build ./cmd/main/main.go：通过。pnpm resource-display-contracts:check：通过。pnpm contract:check：通过，48 个资源契约一致。- 修改文件定向 Biome lint：通过。
pnpm build：通过，TypeScript 类型检查及 Vite 生产构建完成，共转换 2621 个模块。- 新增退款商品汇总后再次执行退款模块、全量后端测试、
go vet、主程序构建及前端全套检查：全部通过。 go run ./cmd/cli repair-mock-refund-reviewer：执行成功，当前数据库修复 1 条 Mock 退款审核人记录。- 增加定向修复命令后再次执行后端全量测试、
go vet、主程序与 CLI 构建：全部通过。
风险评估
- 可读名称仅用于已授权财务审核页面，不改变退款事实字段或跨服务标识。
- 订单号来自不可变业务编号；用户姓名用于退款审核识别，UUID 仍作为审计定位依据保留。