统一智能气阀空归属展示
库房、气站、配送点和用户归属为空时统一显示未填写,保留归属互斥与接口规则,并补充专项检查、中文操作日志及项目文档。
This commit is contained in:
37
docs/操作日志_智能气阀归属空值展示_20260813.md
Normal file
37
docs/操作日志_智能气阀归属空值展示_20260813.md
Normal file
@@ -0,0 +1,37 @@
|
||||
# 智能气阀归属空值展示操作日志
|
||||
|
||||
操作时间:2026-08-13
|
||||
操作类型:修改
|
||||
影响模块:平台总后台智能气阀管理
|
||||
|
||||
## 操作前状态
|
||||
|
||||
智能气阀的库房、气站、配送点和用户归属没有数据时,列表、详情和编辑只读区域使用通用默认文案 `-`,与当前业务页面的“未填写”约定不一致。
|
||||
|
||||
## 具体操作
|
||||
|
||||
1. 为四个可选归属字段统一配置空值文案“未填写”。
|
||||
2. 保持四个字段的可选关系、接口键和归属互斥规则不变。
|
||||
3. 增加专项静态检查,防止后续配置遗漏或回退。
|
||||
|
||||
## 操作后状态
|
||||
|
||||
库房、气站、配送点和用户归属没有数据时,在列表、详情及编辑只读展示中统一显示“未填写”。其他字段的空值文案不受影响。
|
||||
|
||||
## 代码变更
|
||||
|
||||
- `frontend/platform_admin/src/api/resources.ts`:配置四个归属字段的空值文案。
|
||||
- `frontend/platform_admin/scripts/check-product-ownership-display.mjs`:增加归属展示专项检查。
|
||||
- `frontend/platform_admin/package.json`:注册专项检查命令。
|
||||
|
||||
## 验证结果
|
||||
|
||||
- `npm.cmd run product-ownership-display:check`:通过,四类空归属统一显示“未填写”。
|
||||
- `npm.cmd run product-ownership:check`:通过,归属互斥选择行为保持正常。
|
||||
- `npm.cmd run resource-pages:check`:通过,详情 46 类、新建 25 类、编辑 23 类。
|
||||
- `npm.cmd run build`:通过,TypeScript 类型检查与 Vite 生产构建成功。
|
||||
- `git diff --check`:通过,未发现空白符错误。
|
||||
|
||||
## 风险评估
|
||||
|
||||
仅修改前端展示元数据,不改变数据库、后端接口、历史数据和归属变更业务规则。
|
||||
33
docs/项目文档_智能气阀归属空值展示_v1.0.md
Normal file
33
docs/项目文档_智能气阀归属空值展示_v1.0.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# 项目文档:智能气阀归属空值展示 v1.0
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
智能气阀的库房、气站、配送点和用户均为可选且互斥的当前归属。未设置的归属统一展示为“未填写”,避免使用含义不明确的横线。
|
||||
|
||||
## 2. 目录结构说明
|
||||
|
||||
```text
|
||||
platforms/
|
||||
├── frontend/platform_admin/
|
||||
│ ├── src/api/resources.ts
|
||||
│ └── scripts/check-product-ownership-display.mjs
|
||||
└── docs/
|
||||
├── 项目文档_智能气阀归属空值展示_v1.0.md
|
||||
└── 操作日志_智能气阀归属空值展示_20260813.md
|
||||
```
|
||||
|
||||
## 3. 核心行为
|
||||
|
||||
- `warehouse_identity` 空值显示“未填写”。
|
||||
- `gas_basic_identity` 空值显示“未填写”。
|
||||
- `delivery_basic_identity` 空值显示“未填写”。
|
||||
- `user_account_identity` 空值显示“未填写”。
|
||||
- 非空关系仍按现有规则显示业务名称或唯一标识。
|
||||
|
||||
## 4. 接口兼容性
|
||||
|
||||
前端仍通过四个 identity 字段读取和提交关系,不修改接口字段及数据格式。归属变更继续遵守最多一个当前归属的规则。
|
||||
|
||||
## 5. 维护指南
|
||||
|
||||
智能气阀归属字段应作为同一组维护。调整其中一个字段的空值文案时,应同步检查其余三个字段以及列表、详情和编辑页面。
|
||||
Reference in New Issue
Block a user