弱网核销功能

packages/shared-types/src/enums.ts

@@ -180,3 +180,7 @@ export const SMS_CODE_TTL_SECONDS = 180;
 export const REDEEM_RESULT_TTL_SECONDS = 360;
 /** 手机号核销会话 TTL（查权益 → 选金额 → 确认） */
 export const REDEEM_PHONE_SESSION_TTL_SECONDS = 600;
+/** 弱网兜底：preview 快照 TTL（token 失效后仍可提交待处理单） */
+export const REDEEM_PENDING_SNAPSHOT_TTL_SECONDS = 600;
+/** 弱网核销：网络类失败阈值 */
+export const REDEEM_WEAKNET_FAIL_THRESHOLD = 5;

packages/shared-types/src/redeem.ts

@@ -44,3 +44,46 @@ export interface RedeemPhonePrepareDto {
   amount: number;
   expireInSeconds: number;
 }
+
+export type RedeemPendingStatus = 'PENDING' | 'COMPLETED' | 'REJECTED';
+
+export const REDEEM_PENDING_STATUS_LABELS: Record<RedeemPendingStatus, string> = {
+  PENDING: '待处理',
+  COMPLETED: '已补核销',
+  REJECTED: '已驳回',
+};
+
+export type RedeemErrorClass = 'NETWORK' | 'BUSINESS';
+
+export type RedeemFailureReportResult = {
+  failCount: number;
+  thresholdReached: boolean;
+  threshold: number;
+};
+
+export type RedeemPendingSubmitResult = {
+  pendingId: string;
+  pendingNo: string;
+  redeemToken: string;
+  failCount: number;
+};
+
+export type RedeemPendingItem = {
+  id: string;
+  pendingNo: string;
+  redeemToken: string;
+  amount: number;
+  redeemType: string;
+  failCount: number;
+  status: RedeemPendingStatus;
+  remark?: string | null;
+  rejectReason?: string | null;
+  processedAt?: string | null;
+  createdAt: string;
+  updatedAt: string;
+  store?: { id: string; name: string; cityName?: string } | null;
+  user?: { id: string; userNo?: string | null; phone?: string | null; nickname?: string | null } | null;
+  photoUrl?: string | null;
+  redeemRecordId?: string | null;
+  redeemRecord?: { id: string; redeemNo: string } | null;
+};

packages/shared-types/src/store-log.ts

@@ -8,7 +8,18 @@ export type StoreLogCategory =
 export const STORE_LOG_EVENT_CATEGORIES: Record<StoreLogCategory, readonly string[]> = {
   login: ['store_sms_send', 'store_sms_login', 'store_sms_verify_fail', 'store_login_success'],
   wechat_auth: ['store_wechat_login', 'store_wechat_bind'],
-  redeem: ['store_redeem_preview', 'store_redeem_confirm'],
+  redeem: [
+    'store_redeem_preview',
+    'store_redeem_confirm',
+    'store_redeem_confirm_fail',
+    'store_redeem_weaknet_threshold',
+    'store_redeem_pending_submit',
+    'store_redeem_pending_complete',
+    'store_redeem_pending_reject',
+    'store_redeem_phone_lookup_sms',
+    'store_redeem_phone_balance',
+    'store_redeem_phone_prepare',
+  ],
   payout: ['store_payout_created', 'store_payout_paid'],
   store_ops: ['store_status_change'],
 };