46 lines
2.6 KiB
Markdown
46 lines
2.6 KiB
Markdown
# 商品分类树名称显示修复操作日志
|
||
|
||
操作时间：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` 字段，兼容现有两类树形资源。
|
||
- 静态回归检查可防止后续再次误用标题插槽参数。
|