diff --git a/docs/操作日志_商品分类系统唯一标识展示统一_20260816.md b/docs/操作日志_商品分类系统唯一标识展示统一_20260816.md new file mode 100644 index 0000000..0c3069b --- /dev/null +++ b/docs/操作日志_商品分类系统唯一标识展示统一_20260816.md @@ -0,0 +1,43 @@ +# 商品分类系统唯一标识展示统一操作日志 + +操作时间:2026-08-16 + +操作类型:修改 + +影响模块:平台总后台电商平台管理、商品分类树形表格 + +## 操作前状态 + +- 商品分类使用“系统标识”列名,单元格固定显示“复制标识”。 +- 商城订单、商品评价等标准列表使用“系统唯一标识”列名并显示截断标识,电商模块内部不一致。 + +## 具体操作 + +1. 商品分类列名改为“系统唯一标识”。 +2. 商品分类单元格显示截断系统唯一标识,并继续支持完整 UUID 悬浮查看和复制。 +3. 商品分类标识列宽由 `120px` 调整为与标准列表一致的 `170px`。 +4. 共享树页中的平台菜单维持“系统标识 / 复制标识”,避免扩大改动范围。 +5. 更新静态展示契约检查,分别约束商品分类和其他树形资源。 + +## 行为变化 + +- 修改前:商品分类显示“系统标识 / 复制标识”。 +- 修改后:商品分类显示“系统唯一标识 / 截断标识”,交互与其他电商列表一致。 +- 分类新增、编辑、启停、归档及层级关系均未改变。 + +## 代码变更 + +- `frontend/platform_admin/src/views/shared/TreePage.vue`:增加商品分类专属标识列展示。 +- `frontend/platform_admin/scripts/check-resource-display-contracts.mjs`:更新树形资源展示断言。 +- `docs/项目文档_平台资源中文展示统一_v1.0.md`:记录 v1.6 变更。 + +## 验证结果 + +- `pnpm resource-display-contracts:check`:通过。 +- `pnpm type:check`:通过。 +- `pnpm build`:通过,Vite 成功完成 2621 个模块的生产构建。 + +## 风险评估 + +- 本次只改变商品分类的技术标识展示,不修改 UUID、接口或业务数据。 +- 平台菜单继续保持原展示方式。 diff --git a/docs/操作日志_商品评价关联名称展示_20260816.md b/docs/操作日志_商品评价关联名称展示_20260816.md new file mode 100644 index 0000000..21aa182 --- /dev/null +++ b/docs/操作日志_商品评价关联名称展示_20260816.md @@ -0,0 +1,43 @@ +# 商品评价关联名称展示操作日志 + +操作时间: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 仍可用于排障。 +- 本次仅修改展示契约,不改变业务数据。 diff --git a/docs/操作日志_商城订单列表展示修复_20260816.md b/docs/操作日志_商城订单列表展示修复_20260816.md index e9bd471..528f227 100644 --- a/docs/操作日志_商城订单列表展示修复_20260816.md +++ b/docs/操作日志_商城订单列表展示修复_20260816.md @@ -24,6 +24,7 @@ 8. 待发货、未收货及无备注字段使用明确业务文案,不再统一显示短横线。 9. 增加独立幂等修复命令,只更新固定十条商城 Mock 订单及其用户、地址快照来源。 10. 增加前端展示契约与后端种子测试,防止跨领域状态再次混入商城订单。 +11. 补齐商品评价列表的商城订单、商品和用户关系名称展示,避免相邻电商页面继续直接显示 UUID。 ## 行为变化 diff --git a/docs/项目文档_平台资源中文展示统一_v1.0.md b/docs/项目文档_平台资源中文展示统一_v1.0.md index dfb2db3..a34b8a7 100644 --- a/docs/项目文档_平台资源中文展示统一_v1.0.md +++ b/docs/项目文档_平台资源中文展示统一_v1.0.md @@ -66,3 +66,5 @@ frontend/platform_admin/ - v1.2.1:补齐 Arco 表格 `columns` 插槽,修复树形表格容器存在但列和数据不渲染的问题。 - v1.3:购物车列表的用户与商品关系列统一展示可读名称,UUID 降级为复制和排障信息。 - v1.4:商城订单统一展示用户名称及空值业务文案;Mock 订单改用商城独立交易状态,并补齐金额、支付时间和下单快照。 +- v1.5:商品评价列表的商城订单、商品和用户关系统一展示可读业务名称,UUID 降级为复制信息。 +- v1.6:商品分类的技术标识列与其他电商列表统一为“系统唯一标识”,显示截断值并保留复制能力。 diff --git a/frontend/platform_admin/scripts/check-resource-display-contracts.mjs b/frontend/platform_admin/scripts/check-resource-display-contracts.mjs index 1e908c2..1c25359 100644 --- a/frontend/platform_admin/scripts/check-resource-display-contracts.mjs +++ b/frontend/platform_admin/scripts/check-resource-display-contracts.mjs @@ -151,6 +151,30 @@ for (const displayContract of [ } } +// 商品评价的订单、商品和用户关系必须以可读业务名称展示。 +const reviewDefinition = resources.match( + /define\('ec_review',[\s\S]*?\n\s*\]\),/, +)?.[0]; +if (!reviewDefinition) throw new Error('无法读取商品评价资源定义'); +for (const [key, label] of [ + ['ec_order_identity', '商城订单'], + ['ec_product_identity', '商品'], + ['user_account_identity', '用户'], +]) { + const field = reviewDefinition.match( + new RegExp(`relation\\('${key}'[\\s\\S]*?\\}\\)`), + )?.[0]; + if ( + !field || + !field.includes(`listLabel: '${label}'`) || + !field.includes('listRelationNameOnly: true') || + !field.includes('displayRelationLabel: true') || + !field.includes('showIdentityCopy: true') + ) { + throw new Error(`商品评价的${label}列必须展示业务名称并保留唯一标识复制入口`); + } +} + if (/title="ID"|data-index="id"/.test(listPage)) { throw new Error('标准资源列表不得把数据库ID作为业务列展示'); } @@ -165,9 +189,19 @@ assertIncludes( ' - +