platforms/docs/操作日志_气站订单合同气瓶选择_20260818.md

操作日志：气站订单合同气瓶选择

操作时间：2026-08-18 操作类型：修改 影响模块：气站管理端 5175、气站 API 合同气瓶候选

操作前状态

• 创建订单页将合同气瓶直接显示为 UUID，无法直观区分设备。
• 气站端字段没有按所选合同联动，后端气站列表也未处理 contract_identity 候选筛选。
• 创建订单页的配送合同和用户地址仍显示技术字段名称，不便于业务人员理解。

具体操作

• 参考 5173 增加合同气瓶的可读标签、搜索提示、空状态和合同联动配置。
• 气站后端在候选场景先校验合同属于当前气站，再返回当前合同未解绑的气瓶及可读设备信息。
• 仅将两个字段标题改为“配送合同”和“收货地址”，不复制 5173 的平台级候选、联动或校验规则。
• 收货地址选项参考 5173 显示实际地址和默认地址标识，不再向业务人员显示 UUID。

操作后状态

• 候选显示“智能气阀名称（设备类型）”，同名时追加设备编码。
• 支持按名称、类型和编码搜索。
• 候选严格限制为当前合同的有效绑定，切换合同会清空旧选择。
• 字段标题使用业务名称；气站端原有合同和地址行为保持不变。

代码变更

• frontend/gas_admin/src/api/resources.ts：完善 gasorder_contract_product_identities 字段配置。
• backend/api/internal/logic/gas/gasorder.go：增加气站合同范围校验和候选查询分支。
• docs/06-气站管理系统需求.md：补充订单候选展示要求。

验证结果

• go test ./internal/logic/gas ./internal/logic/platform/gasorder ./internal/routers：通过。
• pnpm type:check：通过。
• pnpm contract:check：通过，20 个资源。
• pnpm build：通过。

风险评估

• 修改只影响携带 contract_identity 的订单候选查询；合同气瓶列表页保持原查询行为。
• 后端仍执行当前气站合同归属校验，不能通过修改查询参数读取其他气站合同候选。