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

操作时间：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` 的订单候选查询；合同气瓶列表页保持原查询行为。
- 后端仍执行当前气站合同归属校验，不能通过修改查询参数读取其他气站合同候选。