24 lines
2.2 KiB
Markdown
24 lines
2.2 KiB
Markdown
# 开发日志：气瓶下单首期闭环
|
||
|
||
操作时间：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个预约时段，并准确指出押金规则未配置。
|
||
|
||
风险评估：下单范围受现有供气合同及合同已绑定实体气瓶约束。未配置押金规则的首次用瓶不得下单；需运营人员在平台后台“押金规则”完成配置后再做真实创建与支付验收。
|