完善配送订单创建联动

docs/操作日志_配送点订单创建联动_20260823.md

@@ -0,0 +1,48 @@
+# 操作日志：配送点订单创建联动
+
+操作时间：2026-08-23
+操作类型：扩展、修改
+影响模块：5176 创建订单页、配送合同候选、用户地址候选、合同气瓶候选
+
+## 操作前状态
+
+- 页面挂载时并行加载所有关系，地址和气瓶不依赖所选合同。
+- 配送后端忽略订单合同、合同用户地址和合同气瓶筛选参数。
+- 地址候选退化显示唯一标识；合同气瓶无法区分当前名称、编码和类型。
+- 切换合同不会清空旧地址和气瓶，可能填到最后才被服务端拒绝。
+- 优惠金额没有非负前端约束，页面不展示金额预估。
+
+## 具体操作
+
+1. 合同候选增加当前配送点范围和可履约状态过滤。
+2. 地址候选增加合同归属校验，并限定合同签约用户。
+3. 合同气瓶候选增加合同归属、未解绑过滤和名称/编码/类型搜索。
+4. 新增前端父子联动、默认地址选择、防抖搜索和请求版本守卫。
+5. 切换合同时原子清空旧地址和气瓶，加载期间禁用控件及保存。
+6. 联系人和联系电话继续独立手填；请求流水号继续按 5173 人工必填。
+7. 优惠金额默认 0、禁止负数，并展示服务端最终计算声明的金额预估。
+8. 保存增加显式防重入、候选空态阻断和金额正数校验。
+
+## 行为变化
+
+- 变更前：候选看似可选，但服务端最终可能因跨合同或失效记录拒绝。
+- 变更后：页面只展示当前合同有效候选，后端仍执行最终授权与一致性校验。
+- 兼容性：不修改数据库和创建订单请求结构；三个列表接口仅新增可选筛选参数。
+
+## 验证结果
+
+- `go test ./api/internal/logic/delivery ./api/internal/logic/platform/gasorder`：通过；覆盖当前点范围、有效合同、合同用户地址和未解绑气瓶。
+- `npm.cmd run type:check`：通过。
+- `npm.cmd run resource-pages:check`：通过，详情 17、新建 9、编辑 5；覆盖联动参数、可读候选、版本守卫、保存阻断和金额公式。
+- `npm.cmd run contract:check`：通过，18 个资源。
+- `npm.cmd run profile:check`：通过。
+- `npm.cmd run build`：通过，2648 个模块完成生产构建。
+- 后端已重新构建并恢复监听 12426；旧程序保存在 `platform-api.before-order-linkage.exe`。
+- 应用内浏览器访问创建订单页被登录页拦截，未在未授权状态下填写或提交账号信息；页面交互需由现有已登录会话刷新后复核。
+
+## 风险评估
+
+- 快速切换合同：通过逐资源版本号丢弃旧响应。
+- 伪造筛选参数：后端先校验合同属于当前配送点，并在创建时再次校验。
+- 前端金额与服务端不同：页面明确标为预估，写入金额完全由服务端计算。
+- 地址无联系人字段：保持独立必填快照，不生成虚假联系人数据。