platforms/docs/操作日志_商品分类树名称显示修复_20260815.md

商品分类树名称显示修复操作日志

操作时间：2026-08-15

操作类型：修改、扩展

影响模块：平台总后台商品分类与平台菜单共享树页面

操作前状态

树组件已将接口 name 字段配置为标题来源，但自定义标题插槽错误读取原始节点中不存在的 title 字段，导致中文业务名称为空，页面只剩系统唯一标识的末尾 12 位和操作按钮。

具体操作

1. 树节点主标题改为读取接口原始节点的 name 字段。
2. 保留现有系统唯一标识复制、父子层级、编辑、启停和归档行为。
3. 在平台资源中文展示契约检查中增加树节点名称断言，并禁止回退到错误的 node.title。
4. 按确认方案将共享树页升级为树形表格，增加名称、排序、状态、系统标识和操作列。
5. 唯一标识由 12 位缩略正文降级为“复制标识”入口，完整值仍可通过提示和剪贴板获取。
6. 浏览器回归发现 Arco 声明式表格列缺少 columns 插槽导致页面空白；补齐插槽并增加静态回归断言。

操作后状态

商品分类和平台菜单均以中文业务名称作为树节点主标题，并通过表格列明确表达排序和状态；系统唯一标识作为次要复制入口展示。商品分类保留编辑、启停和归档操作，平台菜单继续保持只读。

代码变更

• frontend/platform_admin/src/views/shared/TreePage.vue：修复树节点主标题字段并补充中文说明。
• frontend/platform_admin/src/components/IdentityText.vue：扩展可选复制入口文案，默认行为保持兼容。
• frontend/platform_admin/scripts/check-resource-display-contracts.mjs：增加树节点中文名称回归检查。
• docs/项目文档_平台资源中文展示统一_v1.0.md：补充 v1.1 变更记录。

验证结果

• pnpm run resource-display-contracts:check：通过。
• pnpm run type:check：通过。
• pnpm run build：通过，树形表格改造后 Vite 成功转换 2621 个模块并生成生产构建。
• 变更文件定向 Biome 检查：退出码为 0；现有 Vue 模板变量识别仍产生非阻断警告，本次未扩大为全仓格式化。
• 本地浏览器回归：修复前表格容器存在但表头数为 0；补齐 columns 插槽后表头数为 5，可正常显示空状态，控制台无错误。

风险评估

• 修改仅影响树节点主标题文本，不改变接口、数据库、树层级、权限或业务动作。
• 商品分类和平台菜单接口均提供 name 字段，兼容现有两类树形资源。
• 静态回归检查可防止后续再次误用标题插槽参数。