人才卡
blame | 历史 | 原始文档

电影券领券成功页面操作说明

页面信息

  • 页面名称：电影券领券成功
  • 路由：/pages/coupon-received/coupon-received
  • 源码：pages/coupon-received/coupon-received.uvue
  • 入口一：电影院商户详情确认领取成功后进入。
  • 入口二：使用记录切换“已领取”，点击电影兑换券进入。
  • 当前状态：已接入用户电影券详情、年度权益统计和兑换码接口；页面按领取记录 ID 加载真实数据。

功能点

功能 当前实现 接口说明
领券结果 顶部标题展示“领券成功”，卡片显示接口返回的电影兑换券名称；业务图标使用高对比度橙色矢量图。 GET /api/app/cinema-coupon-claims/{claimId}?talentId={talentId} 返回用户券名称和状态。
年度权益 依据年度总额度和已领数量显示进度条与剩余数量，不展示重复明细行。 返回 annualTotal、annualClaimed、annualRemaining。
兑换凭证 展示有效兑换码、有效期及影城使用说明。 返回兑换码、状态、有效期、使用渠道、核销规则及失效原因。
到店二维码 兑换码上方展示二维码，影城店员用商家端小程序扫码核销；票包（观影权益）与电影券的领取记录不在同一张表，各走各的二维码接口。 GET /api/app/benefit-verification-codes/{claimId}/image（电影券）、GET /api/app/benefit-verification-codes/ticket-package-claims/{claimId}/image（票包/观影权益）。
复制兑换码 仅在兑换码状态为 ACTIVE 时允许复制，成功后提示“兑换码已复制”。 复制后台返回的当前有效兑换码。
使用记录联动 领取成功页和“已领取”记录均携带 claimId，复用同一接口加载详情。 使用记录的 targetDetailId 为领取记录 ID。

操作说明

  1. 用户确认领取电影券后进入本页。
  2. 查看年度权益使用进度及剩余数量。
  3. 到店时向店员出示二维码（店员用商家端「扫码核销」扫它），也可查看/复制兑换码与使用说明。
  4. 点击“复制兑换码”，系统写入剪贴板并反馈复制结果。
  5. 用户也可从使用记录“已领取”进入本页查看同一兑换凭证。
  6. 点击左上角返回上一页；页面栈缺失时返回使用记录“已领取”。

异常处理

场景 页面处理要求
用户券详情加载失败 保留返回按钮，展示加载失败与重试入口。
兑换码为空 隐藏复制按钮并提示“兑换码生成中，请稍后重试”。
兑换码已使用 明确展示“已使用”及核销时间，复制按钮禁用。
兑换码已过期/失效 展示失效原因和处理方式，不继续提供复制。
复制失败 提示“复制失败，请长按兑换码”，兑换码仍保持可见。
年度权益字段缺失 不猜测额度；隐藏进度模块并展示可重试状态。
登录失效 重新登录后按用户券 ID 恢复本页。

已接接口

  • 用户券详情：GET /api/app/cinema-coupon-claims/{claimId}?talentId={talentId}。
  • 返回字段：领取记录 ID、券名称、领取状态、年度额度/已领取/剩余数量、兑换码、兑换码状态、有效期、使用渠道、核销说明、失效原因。