40 lines
2.3 KiB
Markdown
40 lines
2.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. 当签约用户不再属于合同气站时，仅保留终止合同操作。
|
||
|
||
## 行为变化
|
||
|
||
- 变更前：未知英文键直接成为标签，子表列序随响应漂移。
|
||
- 变更后：只显示具有中文业务契约的字段；合同气瓶和修订记录使用固定列与完整参数查看器。
|
||
- 兼容性：不修改 API、数据库和原始业务值，未知历史状态或动作仍保留原编码用于排障。
|
||
|
||
## 验证结果
|
||
|
||
- `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 个模块完成生产构建。
|
||
- 应用内浏览器当前没有已登录的 5176 标签页，自动视觉回归被登录状态阻挡；用户提供的修复前截图已用于定位，不替代修复后回归。
|
||
|
||
## 风险评估
|
||
|
||
- 新后端字段默认隐藏：通过自动检查和维护规范要求先补中文契约，避免内部字段意外暴露。
|
||
- 当前设备名称可能变化：页面说明其非历史快照，编码和类型继续作为绑定快照展示。
|
||
- 子表字段较多：保留固定列宽和横向滚动，避免压缩导致内容不可读。
|