Files

交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过；完整测试仍有2项失败，后端模型注释检查未通过，详见交付记录。

2026-09-13 00:57:32 +08:00

订单中心视觉与气瓶操作开发日志

操作时间：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：真实动作路由、搜索、后续提示及图片快照回归。