platforms/docs/操作日志_提现详情关联名称展示修复_20260816.md

提现详情关联名称展示修复操作日志

操作时间：2026-08-16

操作类型：修改

影响模块：平台总后台、财务管理、提现记录详情

操作前状态

• 钱包唯一标识被声明为无目标资源的身份字段，详情页无法加载关系名称，固定显示“名称加载失败”。
• 审核人姓名快照已经展示，但响应中的审核人唯一标识又作为独立字段显示完整 UUID，信息重复且不符合统一展示规范。

具体操作

1. 将提现记录的钱包字段声明为 /wallet_basic 关系，按钱包归属类型显示“用户钱包”“工作人员钱包”“气站钱包”“配送点钱包”或“平台钱包”。
2. 钱包关系继续保留详情跳转和完整 UUID 复制能力。
3. 将审核人唯一标识声明为 /platform_account 关系，优先使用接口已有的 reviewer_name 姓名快照展示。
4. 在提现详情专属契约中隐藏独立的审核人姓名快照字段，避免姓名与 UUID 分成两项重复展示。
5. 增加静态展示契约断言，防止钱包关系退回“名称加载失败”或审核人退回裸 UUID。
6. 提现列表直接使用 reviewer_name 审核姓名快照作为主文案，同时保留审核人标识复制和详情跳转。

行为变化

• 修改前：钱包显示“名称加载失败”；审核人姓名与完整审核人 UUID 分开显示。
• 修改后：钱包显示可读归属类型摘要；审核人显示姓名并附带可复制标识，可点击进入对应详情。
• 列表中的历史审核人不再依赖实时账户名称加载，避免显示“名称加载失败”。
• 提现金额、状态机、审核动作、接口入参和数据库数据均未改变。

代码变更

• frontend/platform_admin/src/api/resources.ts：补齐钱包及审核人的关系展示配置。
• frontend/platform_admin/src/api/resource-display.ts：新增钱包归属类型摘要格式化，并统一复用关系选项格式化器。
• frontend/platform_admin/src/api/resource-detail-contract.ts：增加提现详情字段顺序和姓名快照隐藏规则。
• frontend/platform_admin/scripts/check-resource-display-contracts.mjs：增加提现关系展示回归断言。
• docs/项目文档_平台资源中文展示统一_v1.0.md：记录 v1.7 变更。

验证结果

• pnpm resource-display-contracts:check：通过。
• pnpm contract:check：通过，48 个资源契约一致。
• pnpm type:check：通过。
• pnpm exec prettier --check ...：未执行，项目未安装 Prettier 命令；不影响既有质量脚本。
• pnpm biome lint src/api/resources.ts src/api/resource-display.ts src/api/resource-detail-contract.ts scripts/check-resource-display-contracts.mjs：通过；仅报告一项修改前已存在的 Object.hasOwn 建议警告。
• pnpm lint：未通过；全仓既有组件存在 2 个错误、188 个警告和 12 项提示，本次修改文件的定向 lint 未产生错误。
• pnpm build：通过，Vite 成功完成 2621 个模块的生产构建。

风险评估

• 本次仅改变提现详情的关联展示，不修改资金事实、权限、状态流转或后端接口。
• 钱包没有独立业务名称，因此使用归属主体类型作为稳定摘要；完整钱包标识仍可复制并可进入钱包详情核验。