platforms/docs/项目文档_智能气阀归属互斥选择_v1.0.md

项目文档：智能气阀归属互斥选择 v1.0

1. 项目概述

智能气阀归属变更支持库房、气站、配送点和用户四类目标，但当前归属最多一个。前端选择目标后自动清空其他归属，后端继续负责最终合法性校验和归属历史记录。

2. 目录结构说明

platforms/
├── frontend/platform_admin/
│   ├── src/views/resource/ResourceActionDialog.vue
│   └── scripts/check-product-ownership-action.mjs
└── docs/
    ├── 项目文档_智能气阀归属互斥选择_v1.0.md
    └── 操作日志_智能气阀归属互斥选择_20260813.md

3. 核心行为

• 弹窗打开时保留当前归属，便于管理员确认现状。
• 选择新的非空归属时，前端自动清空另外三个字段。
• 主动清空当前字段不会自动选择其他归属。
• 提交时仍发送全部四个归属字段，空字符串表示清除旧关系。
• 提交前继续执行最多一个归属的防御校验。

4. 接口兼容性

继续使用 PUT /product_info/:identity，不新增或修改请求字段。动作、原因、备注和后端审计行为保持不变。

5. 维护指南

新增归属类型时，必须同步更新互斥字段集合、后端合法性校验、归属历史模型和回归检查，不得只增加一个下拉控件。