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