49 lines
2.5 KiB
Markdown
49 lines
2.5 KiB
Markdown
# 用户地址账户名称展示操作日志
|
||
|
||
操作时间：2026-08-11
|
||
|
||
操作类型：扩展
|
||
|
||
影响模块：平台总后台用户地址列表
|
||
|
||
## 操作前状态
|
||
|
||
用户地址列表的“用户唯一标识”列直接显示截断标识，详情页则显示“账户名称＋标识”，同一关系在两个页面的识别方式不一致。
|
||
|
||
## 具体操作
|
||
|
||
1. 为资源字段增加仅列表生效的关系名称展示配置。
|
||
2. 用户地址列表列名改为“用户账户”，主内容显示账户名称。
|
||
3. 名称悬停展示完整唯一标识，名称旁提供复制按钮。
|
||
4. 关系名称缺失时降级显示完整唯一标识。
|
||
5. 详情页及其他资源保持原展示规则。
|
||
6. 新增静态回归检查和 v1.1 项目文档。
|
||
|
||
## 操作后状态
|
||
|
||
用户地址列表可以直接按账户名称识别所属用户，同时仍可查看、复制完整唯一标识。详情页继续显示账户名称和唯一标识。
|
||
|
||
## 代码变更
|
||
|
||
- `frontend/platform_admin/src/api/resources.ts`：新增字段级列表关系名称配置并应用于用户地址。
|
||
- `frontend/platform_admin/src/views/shared/CrudListPage.vue`：新增配置驱动的关系名称列表分流及名称降级。
|
||
- `frontend/platform_admin/src/views/shared/RelationNameText.vue`：新增关系名称、标识悬停与复制组件。
|
||
- `frontend/platform_admin/src/views/shared/resource-list-field-display.ts`：拆分关系名称、标识读取和列宽判断，控制共享列表文件规模。
|
||
- `frontend/platform_admin/scripts/check-user-address-relation-display.mjs`：新增静态回归检查。
|
||
- `frontend/platform_admin/package.json`：新增检查命令。
|
||
- `docs/项目文档_用户地址受控展示_v1.1.md`：新增版本化项目文档。
|
||
|
||
## 验证结果
|
||
|
||
- `pnpm.cmd user-address-display:check`：通过，账户名称、标识降级、悬停与复制入口均已覆盖。
|
||
- `pnpm.cmd type:check`：通过。
|
||
- 项目内 Biome 对本次前端文件执行定向检查：通过；仅报告项目现有的 Vue 模板识别告警，无错误。
|
||
- `pnpm.cmd contract:check`：通过，共校验 48 个资源。
|
||
- `pnpm.cmd build`：通过，Vite 成功构建 2611 个模块。
|
||
- `git diff --check`：通过。
|
||
- `http://localhost:5173`：服务可访问并启用 Vite 热更新；自动化浏览器无平台登录态，未读取受保护的真实用户地址列表。
|
||
|
||
## 风险评估
|
||
|
||
风险较低。新配置默认关闭且只应用于用户地址所属用户字段；不改变接口、权限、详情页或其他资源展示。关系数据加载失败时通过标识降级避免空白。
|