# 商品评价关联名称展示操作日志

操作时间：2026-08-16

操作类型：修改

影响模块：平台总后台电商平台管理、商品评价只读列表与详情

## 操作前状态

- 商品评价列表直接显示商城订单、商品和用户 UUID。
- 管理员无法从列表直接识别评价对应的订单号、商品名称和用户名称。

## 具体操作

1. 商城订单关系统一展示订单号。
2. 商品关系统一展示商品名称。
3. 用户关系统一展示用户名称。
4. 三类关系继续保留 UUID 复制入口及已有详情跳转能力。
5. 增加静态展示契约检查，防止关系字段退回裸 UUID。

## 行为变化

- 修改前：三个关系字段以“唯一标识”为列名并直接显示 UUID。
- 修改后：列表以“商城订单”“商品”“用户”为列名并显示可读名称，UUID 降级为复制和排障信息。
- 商品评价仍为只读资源，接口、权限、评分和评价内容均未改变。

## 代码变更

- `frontend/platform_admin/src/api/resources.ts`：补齐 `ec_review` 三类关系的名称展示配置。
- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`：增加商品评价关系展示回归检查。
- `docs/项目文档_平台资源中文展示统一_v1.0.md`：记录 v1.5 变更。

## 验证结果

- `pnpm resource-display-contracts:check`：通过。
- `pnpm type:check`：通过。
- `pnpm build`：通过，Vite 成功完成 2621 个模块的生产构建。

## 风险评估

- 关联加载失败时显示“名称加载失败”，UUID 仍可用于排障。
- 本次仅修改展示契约，不改变业务数据。