platforms/docs/操作日志_商品评价关联名称展示_20260816.md

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

操作时间：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 仍可用于排障。
• 本次仅修改展示契约，不改变业务数据。