# 观影券详情（使用记录）

## 基本信息

| 项目 | 内容 |
| --- | --- |
| 路由 | `/pages/ticket-package-detail/ticket-package-detail?claimId={领取记录ID}&talentId={持卡人ID}&merchantId={商家ID}` |
| 页面目标 | 在「使用记录」里点开已领取的观影券，出示二维码给影城店员扫码核销，并查看领取/核销时间。 |
| 进入方式 | 个人中心 → 使用记录 → 观影券记录（`targetDetailType=TICKET_PACKAGE_DETAIL`）。 |
| 负责人/更新时间 | 待指定 / 2026-10-09 |

## 功能点

| 编号 | 功能 | 说明 | 当前状态 |
| --- | --- | --- | --- |
| F-001 | 核销二维码 | 展示票包兑换码的二维码（`GET /api/app/benefit-verification-codes/ticket-package-claims/{claimId}/image`），店员扫码后走观影权益核销。 | 已接入 |
| F-002 | 适用门店 | 展示票包配置的适用商家（多个用「、」连接）。 | 已接入 |
| F-003 | 领取时间 | 领取记录创建时间。 | 已接入 |
| F-004 | 核销时间 | 已核销后才显示。 | 已接入 |
| F-005 | 复制兑换码 | 未核销时可复制兑换码；已核销时按钮置灰显示「已使用」。 | 已接入 |

## 状态差异

| 状态 | 表现 |
| --- | --- |
| 未核销（`ACTIVE`） | 显示二维码、适用门店、领取时间；底部蓝色「复制兑换码」按钮可用。 |
| 已核销（`USED`） | 二维码保留（核销时服务端会拒绝重复核销），额外显示核销时间；底部按钮置灰显示「已使用」。 |

## 接口与数据

| 数据项/动作 | 接口标识 | 参数 | 返回字段 | 状态 |
| --- | --- | --- | --- | --- |
| 领取详情 | `GET /api/app/ticket-packages/claims/{claimId}` | `claimId`、`talentId` | `merchantNames`、`exchangeCode`、`exchangeCodeStatus`、`createdAt`、`usedAt` | 已接入 |
| 核销二维码 | `GET /api/app/benefit-verification-codes/ticket-package-claims/{claimId}/image` | `claimId` | PNG 二维码 | 已接入 |

## 与「电影券领券成功」的区别

`/pages/coupon-received/coupon-received` 是领券成功页（展示可领取额度、兑换码与二维码）；
本页是使用记录里的观影券详情，按「观影券」原型展示二维码、适用门店与领取/核销时间。