platforms/docs/项目文档_智能气阀归属空值展示_v1.0.md

项目文档：智能气阀归属空值展示 v1.0

1. 项目概述

智能气阀的库房、气站、配送点和用户均为可选且互斥的当前归属。未设置的归属统一展示为“未填写”，避免使用含义不明确的横线。

2. 目录结构说明

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. 维护指南

智能气阀归属字段应作为同一组维护。调整其中一个字段的空值文案时，应同步检查其余三个字段以及列表、详情和编辑页面。