plan.md 1.4 KB

商家小票接口实现计划

目标:沿用现有商家订单控制器和权限,提供结构化打印数据,不接入打印设备。

  1. 小票功能始终提供,不添加开关接口、字典或 SQL。
  2. 新增 MerchantOrderPrintView 和 MerchantOrderPrintService,按订单快照装配;控制器新增小票 GET 接口,复用订单权限与商家身份检查。
  3. 覆盖商品规格/备注、运费优惠、自取堂食空地址、坏快照及越权;不增加 SQL,新增错误同步所有后端语言文件。
  4. 更新 App 接入文档,执行 JDK21 定向测试及模块打包、差异检查。设备绑定、自动打印和真机出纸不在本轮验证范围。

备选:直接返回 PosOrder 会暴露无关信息并要求 App 解析 JSON;复刻 CTE 的 Map 会丢失本系统运费契约。采用明确 DTO 和快照转换,不引入新表或新的订单状态。

2026-10-29 查询参数调整

前端改传完整订单号 ddId;控制器先按 pos_order.dd_id 查询、再用所得订单主键执行现有商家权限检查,服务层复用已查出的订单快照装配小票。响应字段保持不变。

2026-10-30 支付方式文字

小票响应保留支付方式原始码值,新增 payTypeName,根据订单已保存的 payType 映射为台湾繁体名称。未知或空码值给出「未知付款方式」,不改变支付流程。