46 lines
3.3 KiB
Markdown
46 lines
3.3 KiB
Markdown
# 操作日志：配送点详情字段中文化
|
||
|
||
操作时间：2026-08-23
|
||
操作类型：新增、修改
|
||
影响模块：5176 标准资源详情、合同关联记录、合同动作区
|
||
|
||
## 操作前状态
|
||
|
||
详情组件按响应对象键顺序动态展示字段。合同详情出现 `user_account_display_name`、`user_service_active`、`bound_at`、`product_name`、`product_params` 等英文键；合同状态显示数字，JSON 参数在表格中被截断。
|
||
|
||
## 具体操作
|
||
|
||
1. 新增配送端聚合详情契约，固定合同、订单的主字段和关联记录列序。
|
||
2. 建立主详情与集合上下文中文标签，未知响应键默认不展示。
|
||
3. 将用户名称合并到用户唯一标识行，将设备和操作人名称与唯一标识组合展示。
|
||
4. 增加合同状态、合同动作、订单状态、布尔、金额和时间格式化。
|
||
5. 为 JSON 参数增加“查看参数”弹层，支持对象、合法 JSON 字符串和历史普通文本。
|
||
6. 明确当前设备名称与合同绑定快照的语义区别。
|
||
7. 当签约用户不再属于合同气站时，仅保留终止合同操作。
|
||
8. 根据修复后页面截图收尾：合同关系字段使用“所属气站、所属配送点”，状态标签改为内容宽度，避免在详情网格中拉伸成整条色块。
|
||
9. 补齐合同详情接口的气站、配送点只读名称字段，使三个主体关系统一显示“名称 + 唯一标识复制”，不再把 UUID 当作主要文案。
|
||
|
||
## 行为变化
|
||
|
||
- 变更前：未知英文键直接成为标签，子表列序随响应漂移。
|
||
- 变更后：只显示具有中文业务契约的字段；合同气瓶和修订记录使用固定列与完整参数查看器。
|
||
- 兼容性：不修改 API 原字段、数据库和原始业务值，仅新增只读名称；未知历史状态或动作仍保留原编码用于排障。
|
||
- 视觉变化：状态标签保留状态颜色但紧凑展示；合同关联对象使用业务称呼，不再显示“气站唯一标识、配送点唯一标识”等技术标签。
|
||
- 接口变化：合同详情兼容性新增 `gas_basic_display_name`、`delivery_basic_display_name`；原 identity 字段、数据库结构和写入协议不变。
|
||
|
||
## 验证结果
|
||
|
||
- `npm.cmd run type:check`：通过。
|
||
- `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 个模块完成生产构建。
|
||
- `go test ./api/internal/logic/platform/gasorder ./api/internal/logic/delivery`：通过。
|
||
- 用户提供的修复后截图确认英文辅助键、固定中文列序与 JSON 查看入口已生效，并据此发现和修正状态标签拉伸、关系标签技术化问题。
|
||
- 后端已重新构建并恢复监听 12426；旧程序保存在 `platform-api.before-contract-relation-display.exe`，可回退。
|
||
|
||
## 风险评估
|
||
|
||
- 新后端字段默认隐藏：通过自动检查和维护规范要求先补中文契约，避免内部字段意外暴露。
|
||
- 当前设备名称可能变化：页面说明其非历史快照，编码和类型继续作为绑定快照展示。
|
||
- 子表字段较多：保留固定列宽和横向滚动，避免压缩导致内容不可读。
|