完善合同关联主体名称展示

This commit is contained in:
czl231
2026-08-23 09:50:46 +08:00
parent cbaedafaf1
commit 48cf44bc99
6 changed files with 52 additions and 16 deletions

View File

@@ -17,12 +17,16 @@
5. 为 JSON 参数增加“查看参数”弹层,支持对象、合法 JSON 字符串和历史普通文本。
6. 明确当前设备名称与合同绑定快照的语义区别。
7. 当签约用户不再属于合同气站时,仅保留终止合同操作。
8. 根据修复后页面截图收尾:合同关系字段使用“所属气站、所属配送点”,状态标签改为内容宽度,避免在详情网格中拉伸成整条色块。
9. 补齐合同详情接口的气站、配送点只读名称字段,使三个主体关系统一显示“名称 + 唯一标识复制”,不再把 UUID 当作主要文案。
## 行为变化
- 变更前:未知英文键直接成为标签,子表列序随响应漂移。
- 变更后:只显示具有中文业务契约的字段;合同气瓶和修订记录使用固定列与完整参数查看器。
- 兼容性:不修改 API、数据库和原始业务值未知历史状态或动作仍保留原编码用于排障。
- 兼容性:不修改 API 原字段、数据库和原始业务值,仅新增只读名称;未知历史状态或动作仍保留原编码用于排障。
- 视觉变化:状态标签保留状态颜色但紧凑展示;合同关联对象使用业务称呼,不再显示“气站唯一标识、配送点唯一标识”等技术标签。
- 接口变化:合同详情兼容性新增 `gas_basic_display_name``delivery_basic_display_name`;原 identity 字段、数据库结构和写入协议不变。
## 验证结果
@@ -30,7 +34,9 @@
- `npm.cmd run resource-pages:check`:通过,详情 17、新建 9、编辑 5并覆盖详情白名单、固定列序、关系合并、JSON 查看器和动作限制。
- `npm.cmd run contract:check``npm.cmd run profile:check`:通过。
- `npm.cmd run build`通过2643 个模块完成生产构建。
- 应用内浏览器当前没有已登录的 5176 标签页,自动视觉回归被登录状态阻挡;用户提供的修复前截图已用于定位,不替代修复后回归
- `go test ./api/internal/logic/platform/gasorder ./api/internal/logic/delivery`:通过
- 用户提供的修复后截图确认英文辅助键、固定中文列序与 JSON 查看入口已生效,并据此发现和修正状态标签拉伸、关系标签技术化问题。
- 后端已重新构建并恢复监听 12426旧程序保存在 `platform-api.before-contract-relation-display.exe`,可回退。
## 风险评估

View File

@@ -4,7 +4,7 @@
本项目将 5176 配送点管理端的标准资源详情展示对齐 5173。所有管理员可见字段必须来自显式中文契约后端辅助键、内部 ID 和未知响应字段不得直接成为页面标签。
技术栈Vue 3、TypeScript、Arco Design。功能仅修改展示层和前端动作可见性,不修改数据库聚合详情接口。
技术栈Vue 3、TypeScript、Arco Design、Go/GORM。功能不修改数据库聚合详情接口仅向下兼容新增关联主体只读名称
## 2. 目录结构
@@ -14,6 +14,8 @@ frontend/delivery_admin/src/
├── api/resource-display.ts # 中文标签、状态、动作、金额与时间格式化
├── views/resource/ResourceDetailContent.vue # 白名单详情与关联表渲染
└── views/resource/ResourceRecordPage.vue # 服务关系失效时的动作限制
backend/api/internal/logic/platform/gasorder/
└── contract_party_display.go # 合同关联主体只读名称和服务关系状态
```
## 3. 核心规则
@@ -25,6 +27,8 @@ frontend/delivery_admin/src/
- `user_service_active` 显示为“签约用户仍属合同气站:是/否”;为否时只保留终止合同操作。
- 合同气瓶和修订记录使用固定中文列序,超宽表格横向滚动。
- 名称字段与唯一标识组合展示;`product_params` 通过弹层完整查看格式化 JSON。
- 合同主记录中的气站、配送点关系分别标为“所属气站、所属配送点”;状态标签按内容宽度紧凑展示。
- 用户、气站、配送点关系均以服务端返回的当前名称为主文案,并保留唯一标识复制;名称失效时显示明确的失效占位,不把 UUID 退化成主要名称。
## 4. 合同气瓶语义
@@ -36,4 +40,4 @@ frontend/delivery_admin/src/
## 6. 变更记录
- v1.02026-08-23新增配送端详情中文白名单、合同固定子表、JSON 查看器、关系合并和合同动作限制。
- v1.02026-08-23新增配送端详情中文白名单、合同固定子表、JSON 查看器、关系合并和合同动作限制,并完成关系标签与紧凑状态标签的视觉收尾