From e52934f6527027bd6008c2ade61c3083159efd4a Mon Sep 17 00:00:00 2001
From: shinnosuke <tantao@1hoper.com>
Date: 星期五, 09 十月 2026 18:14:28 +0800
Subject: [PATCH] 更新....
---
rencaika_merchant/docs/pages/02-订单管理.md | 5 +++++
1 files changed, 5 insertions(+), 0 deletions(-)
diff --git "a/rencaika_merchant/docs/pages/02-\350\256\242\345\215\225\347\256\241\347\220\206.md" "b/rencaika_merchant/docs/pages/02-\350\256\242\345\215\225\347\256\241\347\220\206.md"
index 73dfa39..f59632f 100644
--- "a/rencaika_merchant/docs/pages/02-\350\256\242\345\215\225\347\256\241\347\220\206.md"
+++ "b/rencaika_merchant/docs/pages/02-\350\256\242\345\215\225\347\256\241\347\220\206.md"
@@ -21,6 +21,8 @@
| F-006 | 详情路由 | 非免费入住订单携带订单 ID、订单号进入已有详情页。 | 已接入路由 |
| F-007 | 开发演示 | 开发环境标题右侧提供“演示数据”开关，可在本地分页数据与真实接口之间切换。 | 已完成 |
| F-008 | 底部导航 | 与首页、商户中心同级，使用 `uni.reLaunch` 切换。 | 已完成 |
+| F-009 | 观影券样式 | 「团购」里混排观影券（票包领取记录）：标题固定「观影券1张」，与人才卡等级同一行，无金额行；未核销显示「领取时间」、已核销显示「核销时间」，状态标签为「待核销 / 已核销」。 | 已接入 |
+| F-010 | 观影券详情 | 点开观影券进入 `/pages/ticket-package-detail/ticket-package-detail?claimId={领取记录ID}`。 | 已接入路由 |
## 操作说明
@@ -30,12 +32,14 @@
4. 上滑触底加载下一页；追加失败时保留已展示订单并可点击底部重试。
5. 无登录会话却关闭演示数据时，页面提示登录后加载真实订单，不将该场景误显示为空列表。
6. 点击团购待核销订单进入待核销详情；到店待支付和已完成订单进入对应详情；免费入住不提供详情入口。
+7. 团购列表里的观影券来自票包领取记录（`ticket_package_claim`），和普通团购订单按时间倒序混排分页；点开进入观影券核销详情。
## 接口与数据
| 数据项/动作 | 接口标识 | 参数 | 返回字段 | 状态 |
| --- | --- | --- | --- | --- |
| 订单分页列表 | `GET /api/merchant/orders` | `page`、`size`、`category`、`status`、`startDate`、`endDate`；门店来自会话 | 订单 ID/号、分类、稳定状态、脱敏用户、金额、卡种、下单/核销时间、`total` | 已接入 |
+| 观影券领取记录详情 | `GET /api/merchant/ticket-package-claims/{claimId}` | 领取记录 ID；商户来自会话 | 领取编号、券名、持卡人与卡等级、状态、领取/核销时间、当前权益 | 已接入 |
| 订单详情 | `GET /api/merchant/orders/{orderNo}` | 订单号；门店来自会话 | 商品/权益、用户摘要、金额、状态 | 服务端已有，详情页视觉后续继续深化 |
| 订单核销 | `POST /api/merchant/orders/{orderNo}/verify` | 核销方式、备注 | 核销结果 | 服务端已有，扫码核销为主流程 |
@@ -43,6 +47,7 @@
- 分类只接受 `group`、`store`、`stay`；状态只接受约定枚举，后端不依赖中文文案。
- 日期采用 `yyyy-MM-dd`，结束日期按次日零点前包含整日；开始日期晚于结束日期时返回明确错误。
+- `category=group` 时列表把普通团购订单与观影券混排，`sourceType=TICKET_PACKAGE` 表示这一条是观影券；分页 `total` 是两类记录之和。
- 后端按当前商户、门店权限过滤，并只向列表返回脱敏姓名和手机号。
- 列表响应使用 `records`、`page`、`size`、`total` 判断分页，不以本地长度猜测是否到底。
--
Gitblit v1.7.1