feat(redeem): 核销记录标记扫码/手机号并支持方式统计

落库 RedeemChannel，门店记录页增加统计按钮，HQ 可按方式筛选。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-03 16:21:38 +08:00
parent 54fca99208
commit dc30932012
10 changed files with 531 additions and 48 deletions
@@ -19,14 +19,39 @@ export interface RedeemPreviewDto {
  boundStoreId?: string | null;
 }

+/** 门店核销方式 */
+export type RedeemChannel = 'SCAN' | 'PHONE';
+
+export const REDEEM_CHANNEL_LABELS: Record<RedeemChannel, string> = {
+  SCAN: '扫码核销',
+  PHONE: '手机号核销',
+};
+
 export interface RedeemRecordDto {
  id: string;
  redeemNo: string;
  amount: number;
  settleAmount: number;
+  /** 核销方式：扫码 SCAN / 手机号 PHONE */
+  channel?: RedeemChannel;
  createdAt: string;
 }

+export interface RedeemChannelStatsBucket {
+  channel: RedeemChannel;
+  count: number;
+  amount: number;
+  settleAmount: number;
+}
+
+export interface RedeemStatsDto {
+  range: 'today' | '7d' | '30d';
+  totalCount: number;
+  totalAmount: number;
+  totalSettleAmount: number;
+  byChannel: RedeemChannelStatsBucket[];
+}
+
 export interface RedeemPhoneBalanceDto {
  sessionId: string;
  totalBalance: number;