修复提现详情关联名称展示

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

@@ -0,0 +1,51 @@
+# 提现详情关联名称展示修复操作日志
+
+操作时间：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 个模块的生产构建。
+
+## 风险评估
+
+- 本次仅改变提现详情的关联展示，不修改资金事实、权限、状态流转或后端接口。
+- 钱包没有独立业务名称，因此使用归属主体类型作为稳定摘要；完整钱包标识仍可复制并可进入钱包详情核验。

docs/项目文档_平台资源中文展示统一_v1.0.md

@@ -68,3 +68,5 @@ frontend/platform_admin/
 - v1.4：商城订单统一展示用户名称及空值业务文案；Mock 订单改用商城独立交易状态，并补齐金额、支付时间和下单快照。
 - v1.5：商品评价列表的商城订单、商品和用户关系统一展示可读业务名称，UUID 降级为复制信息。
 - v1.6：商品分类的技术标识列与其他电商列表统一为“系统唯一标识”，显示截断值并保留复制能力。
+- v1.7：提现详情的钱包关系改为可读归属类型摘要，审核人合并展示姓名快照与可复制标识，移除“名称加载失败”和重复裸 UUID。
+- v1.7.1：提现列表的审核人改为直接使用审核姓名快照，并保留审核人标识复制与详情跳转，避免历史账户关系加载失败影响列表展示。