platforms/docs/项目文档_合同气阀候选范围统一_v1.0.md

项目文档：合同气阀候选范围统一 v1.0

1. 项目概述

平台总后台、气站后台和配送点后台统一使用合同级智能气阀候选规则。组织端不再按全部服务用户返回设备，避免其他用户的智能气阀进入当前合同候选。

2. 核心规则

• 候选请求必须提供 contract_identity，缺少合同上下文时返回空列表。
• 智能气阀必须直接归属于合同签约用户。
• 智能气阀记录必须启用，设备生命周期不得为已报废。
• 已在当前合同中有效绑定的设备不得重复进入候选。
• 气站端要求合同用户当前仍属于合同气站。
• 配送点端要求合同用户当前仍属于合同气站及当前配送点。
• 配送点用户转出后隐藏绑定入口，绑定接口继续执行相同的服务端范围校验。

3. 页面行为

• 合同气瓶新建页先取得已锁定的合同，再携带 contract_identity 加载智能气阀候选。
• 切换合同会清空原智能气阀选择并重新加载。
• 无候选设备时提示管理员由平台总后台先将设备归属变更为合同用户。

4. 接口兼容性

继续使用现有 /product_info 候选资源和合同气瓶绑定接口，不新增数据库字段。新增的 user_delivery_service_active 是合同查询派生字段，用于配送点页面和服务端动作范围判断，不修改合同表结构。

5. 验证方法

• 运行平台合同、产品、气站合同及配送点订单逻辑测试。
• 运行气站与配送点资源页面静态契约检查。
• 运行两个组织端的 TypeScript 类型检查和生产构建。