platforms/docs/开发日志_气瓶下单首期闭环_20260911.md

开发日志：气瓶下单首期闭环

操作时间：2026-09-11 23:25 操作类型：新增、扩展 影响模块：用户端 App、Client API、供气订单、支付与押金、平台字段展示

操作前状态：设计图18没有独立页面和用户创建供气订单接口；合同气瓶、价格、押金、地址和预约时段无法形成用户下单闭环，钢瓶只可用近似图标表示。

具体操作：

• 新增 /gas/order，实现气站信息、规格数量、真实钢瓶商品图、配送信息、押金说明、费用明细和二次确认。
• 新增 GET /gas/order-options 与 POST /gas/orders，按JWT账户校验有效合同、气瓶占用、本人地址、预约时间、服务端金额和幂等冲突。
• 为供气订单增加地址、预约时间和押金金额快照；新增 gasorder_deposit，支付成功后原子生成正式押金记录。
• 取消未支付订单时同步释放气瓶占用并取消待支付押金；缺押金规则时返回可见规格和明确原因，但禁止提交。
• 生成透明背景液化气钢瓶商品图并纳入 Flutter 资产，完成390×844并排比较和8组响应式视觉检查。

操作后状态：用户可从首页进入真实气瓶下单页；配置完整时可创建待支付订单并进入支付确认，配置不完整时明确显示首期缺项。远程账号未写入演示订单。

代码变更：gas_order_create.go、gasorder_basic.go、gasorder_deposit.go、gas_deposit.go、gasorder.go、callback.go、client.go、gas_order_checkout.dart、gas_order_create_page.dart、client_repository.dart、router.dart、home_page.dart、支付确认和订单详情页面、三套后台字段配置及测试文件。

验证结果：Go用户逻辑、支付及路由测试通过；Go Vet与构建通过；Flutter Analyze、气瓶下单Widget测试和8组视觉变体通过；远程只读接口确认返回气站、15kg合同气瓶、地址及6个预约时段，并准确指出押金规则未配置。

风险评估：下单范围受现有供气合同及合同已绑定实体气瓶约束。未配置押金规则的首次用瓶不得下单；需运营人员在平台后台“押金规则”完成配置后再做真实创建与支付验收。