platforms/docs/操作日志_财务支付记录展示修复_20260816.md

财务支付记录展示修复操作日志

操作时间：2026-08-16

操作类型：修改

影响模块：平台总后台、财务管理、支付记录

操作前状态

• 商城订单关系直接显示截断 UUID，没有展示订单号。
• 财务支付记录使用通用支付订单状态格式化器，无法识别财务领域的 35=已支付，显示“未知支付状态（35）”。
• 支付渠道直接显示 wallet 等接口编码。

具体操作

1. 商城订单关系改为以订单号作为主文案，保留订单唯一标识复制和详情跳转。
2. 为财务支付记录单独声明 10=待支付、35=已支付 状态，不修改其他支付资源的状态口径。
3. 按业务文档将渠道编码映射为“余额支付”“支付宝”“微信支付”，未知编码继续明确显示原值。
4. 增加静态展示契约断言，防止跨领域支付状态再次混用。
5. 财务支付详情从商城订单明细的成交快照生成“支付商品”，多商品以顿号分隔，数量大于 1 时显示“× 数量”。
6. 财务支付列表按当前页订单主键批量查询订单明细并附加相同商品摘要，避免逐行查询和列表显示“商品信息缺失”。

行为变化

• 修改前：商城订单显示 UUID，支付状态显示未知状态，渠道显示英文编码。
• 修改后：商城订单显示订单号，状态显示“已支付”，渠道显示“余额支付”。
• 详情同时显示成交商品名称；当前 Mock 记录显示“15kg 液化气配送服务”。
• 支付金额、支付时间、接口、数据库数据和业务状态均未修改。

代码变更

• 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：增加财务支付展示回归断言。
• backend/api/internal/logic/platform/fin/fin.go：增加财务支付详情和成交商品快照汇总。
• backend/api/internal/logic/platform/fin/fin_test.go：覆盖单商品、多数量和快照缺失场景。
• backend/api/internal/routers/platform.go：财务支付路由切换为专属只读处理器，路径与权限保持不变。
• docs/项目文档_平台资源中文展示统一_v1.0.md：记录 v1.8 变更。

验证结果

• pnpm resource-display-contracts:check：通过。
• pnpm contract:check：通过，48 个资源契约一致。
• 修改文件定向 Biome lint：通过。
• pnpm build：通过，TypeScript 类型检查及 Vite 生产构建完成，共转换 2621 个模块。
• go test ./internal/logic/platform/fin ./internal/routers：通过。
• go test ./...：通过。
• go vet ./...：通过。
• go build ./cmd/main/main.go：通过。
• 列表批量商品摘要补充后再次执行财务模块、路由测试、定向 go vet 和主程序构建：通过。

风险评估

• 本次仅修改 fin_payment 的前端展示契约，不改变支付订单、钱包支付或商城订单的业务状态。
• 未知支付状态和未知渠道仍保留原值提示，避免历史数据被错误归类。
• 商品名称只读取下单时的成交快照，不读取当前商品名称，避免历史财务记录随商品资料修改而漂移。