45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
|
# 购物车关联名称展示操作日志
|
|||
|
|
|
|||
|
|
操作时间：2026-08-15
|
|||
|
|
|
|||
|
|
操作类型：修改
|
|||
|
|
|
|||
|
|
影响模块：平台总后台电商平台管理、购物车只读列表
|
|||
|
|
|
|||
|
|
## 操作前状态
|
|||
|
|
|
|||
|
|
- 购物车列表将用户与商品关系按普通唯一标识字段渲染。
|
|||
|
|
- 页面表头显示“用户唯一标识”“商品唯一标识”，单元格直接显示 UUID。
|
|||
|
|
- 现有关系补载能力已具备，但购物车资源未启用名称优先展示配置。
|
|||
|
|
|
|||
|
|
## 具体操作
|
|||
|
|
|
|||
|
|
1. 将购物车用户关系列表标题调整为“用户”，并启用用户名称优先展示。
|
|||
|
|
2. 将购物车商品关系列表标题调整为“商品”，并启用商品名称优先展示。
|
|||
|
|
3. 保留两类关系 UUID 的复制入口和关联详情跳转能力。
|
|||
|
|
4. 增加静态契约检查，防止购物车关系列退回裸 UUID 展示。
|
|||
|
|
|
|||
|
|
## 代码变更
|
|||
|
|
|
|||
|
|
- `frontend/platform_admin/src/api/resources.ts`：补齐 `ec_cart` 用户、商品关系的名称展示配置。
|
|||
|
|
- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`：增加购物车关系列回归检查。
|
|||
|
|
- `docs/项目文档_平台资源中文展示统一_v1.0.md`：记录 v1.3 展示规则变更。
|
|||
|
|
|
|||
|
|
## 行为变化
|
|||
|
|
|
|||
|
|
- 修改前：购物车列表以“用户唯一标识”“商品唯一标识”为主要内容并直接展示 UUID。
|
|||
|
|
- 修改后：购物车列表以“用户”“商品”为列名并展示关联名称；UUID 仅通过复制入口和悬浮提示提供。
|
|||
|
|
- 购物车记录自身仍按既有契约显示“系统唯一标识”，接口、权限和只读行为不变。
|
|||
|
|
|
|||
|
|
## 验证结果
|
|||
|
|
|
|||
|
|
- `pnpm resource-display-contracts:check`：通过。
|
|||
|
|
- `pnpm type:check`：通过。
|
|||
|
|
- `pnpm build`：通过，Vite 成功完成 2621 个模块的生产构建。
|
|||
|
|
- `git diff --check`：通过，仅出现仓库既有的 LF/CRLF 转换提示。
|
|||
|
|
|
|||
|
|
## 风险评估
|
|||
|
|
|
|||
|
|
- 关联资源加载失败时仍会显示“名称加载失败”，并保留 UUID 供排障。
|
|||
|
|
- 本次仅修改前端展示契约，不改变 API、数据库、权限和业务数据。
|