merge main

video-gen-admin/src/types/index.ts

@@ -868,16 +868,32 @@ export interface VideoPromptSchemaPreviewOut {
 
 export interface AdminCreditRecordSummary {
   totalRecharge: number;
+  /** 总消费（仅 type=consume，不含团队内部转账）= 真实扣费 + 预扣占用 */
   totalConsume: number;
+  /** 总回退（仅 type=refund）= 真实退款 + 预扣释放 */
   totalRefund: number;
+  /** 独立统计列：真实扣费 charge(含历史 NULL)，对应"筛选类型=消费 & action=charge/NULL"求和 */
+  totalCharge: number;
+  /** 独立统计列：预扣占用 hold */
+  totalHold: number;
+  /** 独立统计列：真实退款 refund(含历史 NULL) */
+  totalRefundReal: number;
+  /** 独立统计列：预扣释放 hold_release（type=refund, action=hold_release） */
+  totalHoldRelease: number;
+  /** 净消耗 = max(totalConsume - totalRefund, 0)，即真正"用掉了"的积分 */
+  netConsume: number;
   transactionCount: number;
   generationCount: number;
   generationAttemptCount: number;
   imageGenerationCount: number;
   videoGenerationCount: number;
+  /** 子分类消费（图片）仅真实扣费 charge 口径 */
   imageConsume: number;
+  /** 子分类消费（视频）仅真实扣费 charge 口径 */
   videoConsume: number;
+  /** 子分类消费（提词）仅真实扣费 charge 口径 */
   textConsume: number;
+  /** 子分类消费（分析）仅真实扣费 charge 口径 */
   analysisConsume: number;
   totalTokens: number;
   inputTokens: number;
@@ -1542,3 +1558,51 @@ export interface LlmBillingExecution {
   finalErrorMessage?: string | null;
   calls: LlmCallAttempt[];
 }
+// ── Invoice Types ───────────────────────────────────────
+
+export interface InvoiceItem {
+  id: string;
+  invoiceNo: string;
+  userId: string;
+  username: string;
+  phone: string;
+  headerType: string;
+  headerName: string;
+  email: string;
+  totalAmount: number;
+  totalCredits: number;
+  orderCount: number;
+  status: string;
+  failureReason: string | null;
+  issuedAt: string | null;
+  createdAt: string | null;
+}
+
+export interface InvoiceOrder {
+  id: string;
+  orderNo: string;
+  amount: number;
+  credits: number;
+}
+
+export interface InvoiceDetail {
+  id: string;
+  invoiceNo: string;
+  userId: string;
+  headerType: string;
+  headerName: string;
+  headerTaxNo: string | null;
+  headerRegisterAddress: string | null;
+  headerRegisterPhone: string | null;
+  headerBankName: string | null;
+  headerBankAccount: string | null;
+  email: string;
+  totalAmount: number;
+  totalCredits: number;
+  status: string;
+  failureReason: string | null;
+  issuedAt: string | null;
+  createdAt: string | null;
+  updatedAt: string | null;
+  orders: InvoiceOrder[];
+}