fix: paginate operational list pages

api/src/billing/billing.controller.ts

@@ -1,4 +1,4 @@
-import { Body, Controller, Get, Param, Post } from '@nestjs/common';
+import { Body, Controller, Get, Param, Post, Query } from '@nestjs/common';
 import { ApiTags } from '@nestjs/swagger';
 import { TenantId } from '../common/tenant-id.decorator';
 import { RequireRecentAuthentication } from '../auth/require-recent-authentication.decorator';
@@ -37,13 +37,17 @@ export class BillingController {
   }
 
   @Get('recharges')
-  listRechargeOrders(@TenantId() tenantId?: string) {
-    return this.billing.listRechargeOrders(tenantId);
+  listRechargeOrders(@TenantId() tenantId?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.billing.listRechargeOrdersPage({ tenantId, page: Number(page), pageSize: Number(pageSize) })
+      : this.billing.listRechargeOrders(tenantId);
   }
 
   @Get('manual-recharges')
-  listManualRechargeRecords(@TenantId() tenantId?: string) {
-    return this.billing.listManualRechargeRecords(tenantId);
+  listManualRechargeRecords(@TenantId() tenantId?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('createdAtFrom') createdAtFrom?: string, @Query('createdAtTo') createdAtTo?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.billing.listManualRechargeRecordsPage({ tenantId, enterpriseKeyword, createdAtFrom, createdAtTo, page: Number(page), pageSize: Number(pageSize) })
+      : this.billing.listManualRechargeRecords(tenantId);
   }
 
   @Post('manual-recharges')
@@ -121,8 +125,10 @@ export class ClientBillingController {
   constructor(private readonly billing: BillingService) {}
 
   @Get('orders')
-  listRechargeOrders(@TenantId() tenantId?: string) {
-    return this.billing.listRechargeOrders(tenantId);
+  listRechargeOrders(@TenantId() tenantId?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.billing.listRechargeOrdersPage({ tenantId, page: Number(page), pageSize: Number(pageSize) })
+      : this.billing.listRechargeOrders(tenantId);
   }
 
   @Post('estimate')

api/src/billing/billing.service.ts

@@ -139,6 +139,17 @@ export class BillingService {
     });
   }
 
+  async listRechargeOrdersPage(query: { tenantId?: string; page?: number; pageSize?: number }) {
+    const page = Math.max(1, Math.floor(Number(query.page) || 1));
+    const pageSize = Math.min(100, Math.max(1, Math.floor(Number(query.pageSize) || 10)));
+    const where: Prisma.RechargeOrderWhereInput = query.tenantId ? { tenantId: query.tenantId } : {};
+    const [items, total] = await Promise.all([
+      this.prisma.rechargeOrder.findMany({ where, orderBy: { createdAt: 'desc' }, skip: (page - 1) * pageSize, take: pageSize }),
+      this.prisma.rechargeOrder.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
   async listManualRechargeRecords(tenantId?: string) {
     const orders = await this.prisma.rechargeOrder.findMany({
       where: {
@@ -167,6 +178,36 @@ export class BillingService {
     }));
   }
 
+  async listManualRechargeRecordsPage(query: { tenantId?: string; enterpriseKeyword?: string; createdAtFrom?: string; createdAtTo?: string; page?: number; pageSize?: number }) {
+    const page = Math.max(1, Math.floor(Number(query.page) || 1));
+    const pageSize = Math.min(100, Math.max(1, Math.floor(Number(query.pageSize) || 10)));
+    const where: Prisma.RechargeOrderWhereInput = {
+      tenantId: query.tenantId,
+      payMethod: 'manual_topup',
+      tenant: query.enterpriseKeyword?.trim() ? { name: { contains: query.enterpriseKeyword.trim() } } : undefined,
+      createdAt: query.createdAtFrom || query.createdAtTo ? {
+        gte: query.createdAtFrom ? new Date(`${query.createdAtFrom}T00:00:00+08:00`) : undefined,
+        lte: query.createdAtTo ? new Date(`${query.createdAtTo}T23:59:59.999+08:00`) : undefined,
+      } : undefined,
+    };
+    const [orders, total] = await Promise.all([
+      this.prisma.rechargeOrder.findMany({ where, include: { tenant: true }, orderBy: { createdAt: 'desc' }, skip: (page - 1) * pageSize, take: pageSize }),
+      this.prisma.rechargeOrder.count({ where }),
+    ]);
+    const orderIds = orders.map((order) => order.id);
+    const transactions = orderIds.length ? await this.prisma.accountTransaction.findMany({
+      where: { relatedType: 'recharge_order', relatedId: { in: orderIds } },
+      select: { relatedId: true, balanceAfter: true },
+    }) : [];
+    const balances = new Map(transactions.map((item) => [item.relatedId, moneyToNumber(item.balanceAfter)]));
+    return {
+      items: orders.map((order) => ({ ...order, balanceAfterCents: balances.get(order.id) ?? null })),
+      total,
+      page,
+      pageSize,
+    };
+  }
+
   async createRechargeOrder(data: CreateRechargeOrderDto) {
     const amountCents = data.amountCents;
     assertMoneyUnits(amountCents, '充值金额', { allowNegative: true, allowZero: false });