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