52 lines
4.2 KiB
Markdown
52 lines
4.2 KiB
Markdown
# 订单中心视觉与气瓶操作开发日志
|
||
|
||
操作时间：2026-09-11
|
||
操作类型：修改、扩展
|
||
影响模块：用户端订单中心、用户订单接口、商城订单成交快照、视觉验收脚本
|
||
|
||
## 操作前状态
|
||
|
||
订单中心使用搜索框和稀疏卡片，和图20的页头搜索图标、横向状态标签、商品信息及底部操作差异明显。气瓶订单列表没有气站名称，已分配但未付款状态显示“待处理”，气瓶取消接口已存在但列表未发布取消动作。商城成交快照没有封面地址，新订单详情无法稳定展示成交时图片。
|
||
|
||
## 具体操作
|
||
|
||
- 用户端改为“我的订单”居中页头和搜索图标，保留气瓶订单、商城订单、报修工单三标签。
|
||
- 增加订单号及商品名称搜索，三类列表共同响应搜索条件；状态区保留设计稿固定状态并合并服务端实际状态。
|
||
- 订单卡展示订单号、下单时间、状态、商品、气站、规格、金额及服务端允许动作；点击卡片仍可进入详情。
|
||
- 气瓶取消调用专用接口并要求二次确认；待付款状态同时显示取消订单和去支付。
|
||
- 再次购买、申请售后、电子发票属于后续阶段，入口保留并统一展示“该功能将在后续版本开放，敬请期待。”
|
||
- 气瓶订单接口批量读取气站名称，状态16统一为“待付款”，创建态和已分配态发布取消动作。
|
||
- 商城新订单读取后台商品封面并写入 `product_snapshot.image_url`，保证后台后续改图不会改变历史成交快照。历史订单的空快照保持真实，不进行猜测补图。
|
||
- 视觉脚本补入商城订单分支，气瓶与商城均生成320、360、390、430宽和1.0/1.3文本比例截图。
|
||
|
||
## 操作后状态
|
||
|
||
首期已有订单列表、搜索、状态筛选、详情跳转、气瓶取消、商城取消/收货和既有支付/退款动作均有真实接口或页面连接。远程气瓶完成订单可显示气站和15kg规格；商城历史订单可正常读取，之后新建的商城订单能够展示成交时封面。
|
||
|
||
当前气瓶商品类型及订单明细没有图片字段，远程账号也只有1笔完成气瓶订单，因此没有伪造设计稿中的钢瓶图和3笔不同状态数据。图20仍为部分实现，不能标记严格1:1通过。
|
||
|
||
## 代码变更
|
||
|
||
- `apps/user_app/lib/ui/features/orders/orders_page.dart`：三标签控制、页头搜索和列表查询传递。
|
||
- `apps/user_app/lib/ui/features/orders/order_list.dart`：状态筛选、订单卡字段、紧凑操作及后续功能提示。
|
||
- `apps/user_app/lib/domain/models/order_summary.dart`：订单号、气站、规格和图片快照解析。
|
||
- `apps/user_app/lib/data/repositories/client_repository.dart`、`order_action_handler.dart`：气瓶取消接口和动作分流。
|
||
- `backend/api/internal/logic/client/user/gasorder.go`、`gas_detail.go`：气站名称、状态名称及允许动作。
|
||
- `backend/api/internal/logic/client/user/shop.go`、`cart.go`：商品封面读取和成交快照固化。
|
||
- `apps/user_app/test/ui/orders_page_test.dart`、`backend/api/internal/logic/client/user/gas_order_list_test.go`、`checkout_test.go`：真实动作路由、搜索、后续提示及图片快照回归。
|
||
|
||
## 验证结果
|
||
|
||
- Flutter静态分析通过；随后加入个人中心认证解析回归后，全量166项测试通过。
|
||
- Flutter Web release构建通过，API地址为本地12426端口。
|
||
- Go全量测试、`go vet ./...` 和API可执行文件构建通过。
|
||
- API已在12426重启并通过健康检查；继续使用 `etc/heqi_dev.yaml` 中既有远程PostgreSQL和Redis，没有启动本地数据库容器。
|
||
- 160项视觉fixture生成通过；已查看图20气瓶与商城390×844并排对照。
|
||
- 内置浏览器以远程账号验证气瓶订单真实字段、搜索空态、后续版本弹层、商城订单列表及详情；未执行支付、取消或其他写操作。
|
||
|
||
## 风险评估
|
||
|
||
- 历史商城订单没有 `image_url` 的成交快照，无法无依据补回原商品图；新订单已修复。
|
||
- 气瓶商品图片尚无正式数据模型和后台维护入口，继续显示真实的无图状态。
|
||
- 取消和支付属于写操作，本轮浏览器只验证入口与自动测试，没有改变远程业务订单。
|