From 043ba8df7713f8ee9762dcd6da4f533fe993b3d1 Mon Sep 17 00:00:00 2001
From: czl231 <3286836406@qq.com>
Date: Sun, 16 Aug 2026 19:07:27 +0800
Subject: [PATCH] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E5=95=86=E5=93=81=E5=88=86?=
 =?UTF-8?q?=E7=B1=BB=E6=A0=87=E8=AF=86=E4=B8=8E=E8=AF=84=E4=BB=B7=E5=85=B3?=
 =?UTF-8?q?=E8=81=94=E5=B1=95=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...—¥å¿—_商å“�分类系统唯一标识展示统一_20260816.md | 43 +++++++++++++++++++
 .../�作日志_商�评价关��称展示_20260816.md | 43 +++++++++++++++++++
 .../�作日志_商城订�列表展示修�_20260816.md |  1 +
 docs/项目文档_平�资�中文展示统一_v1.0.md    |  2 +
 .../check-resource-display-contracts.mjs      | 38 +++++++++++++++-
 frontend/platform_admin/src/api/resources.ts  | 14 +++++-
 .../src/views/shared/TreePage.vue             | 15 ++++++-
 7 files changed, 150 insertions(+), 6 deletions(-)
 create mode 100644 docs/�作日志_商�分类系统唯一标识展示统一_20260816.md
 create mode 100644 docs/�作日志_商�评价关��称展示_20260816.md

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(
   '<template #columns>',
   'Arco 树形表格列必须放入 columns �槽，���行时渲染为空白',
 );
-for (const columnTitle of ['分类�称', '排�', '状�', '系统标识', '�作']) {
+for (const columnTitle of ['分类�称', '排�', '状�', '�作']) {
   assertIncludes(treePage, columnTitle, `树形表格缺少必�列：${columnTitle}`);
 }
+assertIncludes(
+  treePage,
+  "definition.name === 'ec_category' ? '系统唯一标识' : '系统标识'",
+  '商�分类必须使用与标准列表一致的系统唯一标识列�',
+);
+assertIncludes(
+  treePage,
+  'v-if="definition.name === \'ec_category\'"',
+  '商�分类必须显示截断系统唯一标识而�是通用�制文案',
+);
 assertIncludes(
   treePage,
   '{{ record.name }}',
@@ -176,7 +210,7 @@ assertIncludes(
 assertIncludes(
   treePage,
   'display-text="�制标识"',
-  '树形表格�得把截断唯一标识作为高优先级正文',
+  '�商�分类树形资��应�留低优先级�制文案',
 );
 assertIncludes(
   identityText,
diff --git a/frontend/platform_admin/src/api/resources.ts b/frontend/platform_admin/src/api/resources.ts
index 4076f76..5875b30 100644
--- a/frontend/platform_admin/src/api/resources.ts
+++ b/frontend/platform_admin/src/api/resources.ts
@@ -728,8 +728,18 @@ export const resources: ResourceUiDefinition[] = [
     f('product_snapshot'), f('quantity'), f('sale_amount'),
   ]),
   define('ec_review', '商�评价', 'readonly', [
-    relation('ec_order_identity', '/ec_order'), relation('ec_product_identity', '/ec_product'),
-    relation('user_account_identity', '/user_account'), f('score'), f('content'),
+    relation('ec_order_identity', '/ec_order', false, {
+      label: '商城订�', listLabel: '商城订�', listRelationNameOnly: true,
+      displayRelationLabel: true, showIdentityCopy: true,
+    }),
+    relation('ec_product_identity', '/ec_product', false, {
+      label: '商�', listLabel: '商�', listRelationNameOnly: true,
+      displayRelationLabel: true, showIdentityCopy: true,
+    }),
+    relation('user_account_identity', '/user_account', false, {
+      label: '用户', listLabel: '用户', listRelationNameOnly: true,
+      displayRelationLabel: true, showIdentityCopy: true,
+    }), f('score'), f('content'),
   ]),
 
   define('wallet_basic', '钱包', 'readonly', [f('owner_type'), f('owner_identity', {
diff --git a/frontend/platform_admin/src/views/shared/TreePage.vue b/frontend/platform_admin/src/views/shared/TreePage.vue
index 47a4ad9..773fc7e 100644
--- a/frontend/platform_admin/src/views/shared/TreePage.vue
+++ b/frontend/platform_admin/src/views/shared/TreePage.vue
@@ -37,9 +37,20 @@
           </a-tag>
         </template>
         </a-table-column>
-        <a-table-column title="系统标识" :width="120">
+        <a-table-column
+          :title="definition.name === 'ec_category' ? '系统唯一标识' : '系统标识'"
+          :width="definition.name === 'ec_category' ? 170 : 120"
+        >
         <template #cell="{ record }">
-          <IdentityText :value="String(record.identity)" display-text="�制标识" />
+          <IdentityText
+            v-if="definition.name === 'ec_category'"
+            :value="String(record.identity)"
+          />
+          <IdentityText
+            v-else
+            :value="String(record.identity)"
+            display-text="�制标识"
+          />
         </template>
         </a-table-column>
         <a-table-column v-if="canEdit || canChangeStatus || canArchive" title="�作" :width="230" fixed="right">