fix: paginate operational list pages

api/prisma/migrations/20260728223000_optimize_list_pagination/migration.sql

@@ -0,0 +1,9 @@
+CREATE INDEX "RechargeOrder_payMethod_createdAt_idx" ON "RechargeOrder"("payMethod", "createdAt");
+CREATE INDEX "SmsApplication_status_createdAt_idx" ON "SmsApplication"("status", "createdAt");
+CREATE INDEX "SmsSignature_tenantId_updatedAt_idx" ON "SmsSignature"("tenantId", "updatedAt");
+CREATE INDEX "SmsTemplate_tenantId_auditStatus_createdAt_idx" ON "SmsTemplate"("tenantId", "auditStatus", "createdAt");
+CREATE INDEX "SmsChannel_status_createdAt_idx" ON "SmsChannel"("status", "createdAt");
+CREATE INDEX "ChannelSignatureReportTask_status_createdAt_idx" ON "ChannelSignatureReportTask"("status", "createdAt");
+CREATE INDEX "ChannelSignatureReportRecord_createdAt_idx" ON "ChannelSignatureReportRecord"("createdAt");
+CREATE INDEX "SmsMessageRecord_queuedAt_idx" ON "SmsMessageRecord"("queuedAt");
+CREATE INDEX "SmsUplinkMessage_receivedAt_idx" ON "SmsUplinkMessage"("receivedAt");

api/prisma/schema.prisma

@@ -359,6 +359,7 @@ model RechargeOrder {
   tenant Tenant @relation(fields: [tenantId], references: [id])
 
   @@index([tenantId, createdAt])
+  @@index([payMethod, createdAt])
 }
 
 model SmsBillingRecord {
@@ -441,6 +442,7 @@ model SmsApplication {
   riskRules                         RiskRule[]
 
   @@index([tenantId, status])
+  @@index([status, createdAt])
   @@index([status, autoDisableAt])
 }
 
@@ -666,6 +668,7 @@ model SmsSignature {
   reportBatchItems        ReportMaterialBatchItem[]
 
   @@index([tenantId, auditStatus])
+  @@index([tenantId, updatedAt])
   @@index([tenantId, reportStatus])
 }
 
@@ -734,6 +737,7 @@ model SmsTemplate {
   batchTasks     SmsBatchTask[]
   messageRecords SmsMessageRecord[]
 
+  @@index([tenantId, auditStatus, createdAt])
   @@index([tenantId, auditStatus])
   @@index([applicationId])
 }
@@ -808,6 +812,7 @@ model SmsChannel {
   gatewaySubmitDeadLetters GatewaySubmitDeadLetter[]
 
   @@index([status])
+  @@index([status, createdAt])
 }
 
 model CmppConnectionState {
@@ -1043,6 +1048,7 @@ model ChannelSignatureReportTask {
   exportItems    ReportExportFileItem[]
 
   @@index([tenantId, status])
+  @@index([status, createdAt])
   @@index([signatureId, channelId])
   @@index([signatureId, drainageItemId, channelId])
   @@index([reportType, status])
@@ -1065,6 +1071,7 @@ model ChannelSignatureReportRecord {
 
   @@index([taskId, createdAt])
   @@index([channelId, createdAt])
+  @@index([createdAt])
 }
 
 model ReportExportFile {
@@ -1447,6 +1454,7 @@ model SmsMessageRecord {
 
   @@unique([applicationId, clientMessageId])
   @@index([tenantId, status, queuedAt])
+  @@index([queuedAt])
   @@index([batchTaskId, status])
   @@index([reviewTaskId, status])
   @@index([phoneNumber])
@@ -1726,6 +1734,7 @@ model SmsUplinkMessage {
   matchCandidates SmsUplinkMatchCandidate[]
 
   @@index([tenantId, createdAt])
+  @@index([receivedAt])
   @@index([applicationId, receivedAt])
   @@index([channelId, receivedAt])
   @@index([messageRecordId])

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 });

api/src/channels/channels.controller.ts

@@ -30,8 +30,10 @@ export class ChannelsController {
   constructor(private readonly channels: ChannelsService, private readonly deletions: DeletionGovernanceService) {}
 
   @Get('channels')
-  listChannels() {
-    return this.channels.listChannels();
+  listChannels(@Query('keyword') keyword?: string, @Query('carrier') carrier?: string, @Query('status') status?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.channels.listChannelsPage({ keyword, carrier, status, page: Number(page), pageSize: Number(pageSize) })
+      : this.channels.listChannels();
   }
 
   @Post('channels')
@@ -167,8 +169,10 @@ export class ChannelsController {
   }
 
   @Get('report-tasks')
-  listReportTasks(@Query('tenantId') tenantId?: string, @Query('status') status?: string, @Query('channelId') channelId?: string, @Query('reportType') reportType?: string) {
-    return this.channels.listReportTasks(tenantId, status, channelId, reportType);
+  listReportTasks(@Query('tenantId') tenantId?: string, @Query('status') status?: string, @Query('channelId') channelId?: string, @Query('reportType') reportType?: string, @Query('keyword') keyword?: string, @Query('createdAtFrom') createdAtFrom?: string, @Query('createdAtTo') createdAtTo?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize || keyword || createdAtFrom || createdAtTo
+      ? this.channels.listReportTasksPage({ tenantId, status, channelId, reportType, keyword, createdAtFrom, createdAtTo, page: Number(page), pageSize: Number(pageSize) })
+      : this.channels.listReportTasks(tenantId, status, channelId, reportType);
   }
 
   @Post('report-tasks/generate')
@@ -193,7 +197,9 @@ export class ChannelsController {
   }
 
   @Get('report-records')
-  listReportRecords(@Query('taskId') taskId?: string, @Query('channelId') channelId?: string) {
-    return this.channels.listReportRecords(taskId, channelId);
+  listReportRecords(@Query('taskId') taskId?: string, @Query('channelId') channelId?: string, @Query('keyword') keyword?: string, @Query('reportType') reportType?: string, @Query('createdAtFrom') createdAtFrom?: string, @Query('createdAtTo') createdAtTo?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize || keyword || reportType || createdAtFrom || createdAtTo
+      ? this.channels.listReportRecordsPage({ taskId, channelId, keyword, reportType, createdAtFrom, createdAtTo, page: Number(page), pageSize: Number(pageSize) })
+      : this.channels.listReportRecords(taskId, channelId);
   }
 }

api/src/channels/channels.service.ts

@@ -252,6 +252,27 @@ export class ChannelsService implements OnModuleInit, OnModuleDestroy {
     });
   }
 
+  async listChannelsPage(query: { keyword?: string; carrier?: string; status?: 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.SmsChannelWhereInput = {
+      status: query.status && query.status !== 'all' ? query.status : { not: 'deleted' },
+      carrier: query.carrier && query.carrier !== 'all' ? query.carrier : undefined,
+      name: query.keyword?.trim() ? { contains: query.keyword.trim() } : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.prisma.smsChannel.findMany({
+        where,
+        include: { connectionStates: true },
+        orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.smsChannel.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
   async createChannel(data: CreateChannelDto) {
     assertMoneyUnits(data.unitPrice ?? 0, '通道单价');
     const missingFields = ['code', 'name', 'gatewayHost', 'account', 'passwordCipher', 'srcId'].filter((field) => {
@@ -1281,6 +1302,63 @@ export class ChannelsService implements OnModuleInit, OnModuleDestroy {
     });
   }
 
+  async listReportTasksPage(query: {
+    tenantId?: string;
+    status?: string;
+    channelId?: string;
+    reportType?: string;
+    keyword?: 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 keyword = query.keyword?.trim();
+    const where: Prisma.ChannelSignatureReportTaskWhereInput = {
+      tenantId: query.tenantId,
+      status: query.status,
+      channelId: query.channelId,
+      reportType: query.reportType,
+      signature: { auditStatus: { not: 'deleted' } },
+      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,
+      OR: keyword ? [
+        { id: { contains: keyword } },
+        { channel: { name: { contains: keyword } } },
+        { signature: { name: { contains: keyword } } },
+        { signature: { tenant: { name: { contains: keyword } } } },
+        { signature: { application: { name: { contains: keyword } } } },
+        { drainageInfo: { siteName: { contains: keyword } } },
+        { drainageInfo: { url: { contains: keyword } } },
+      ] : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.prisma.channelSignatureReportTask.findMany({
+        where,
+        include: {
+          signature: { include: { tenant: true, application: true } },
+          channel: true,
+          drainageInfo: true,
+          exportItems: {
+            include: { exportFile: true, batchItem: { include: { batch: true } } },
+            orderBy: { id: 'desc' },
+            take: 1,
+          },
+          records: { orderBy: { createdAt: 'desc' }, take: 20 },
+        },
+        orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.channelSignatureReportTask.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
   async createReportTask(data: CreateReportTaskDto) {
     const reportType = data.reportType ?? 'signature';
     if (reportType === 'drainage' && !data.drainageItemId) throw new BadRequestException('drainageItemId is required');
@@ -1414,6 +1492,50 @@ export class ChannelsService implements OnModuleInit, OnModuleDestroy {
     });
   }
 
+  async listReportRecordsPage(query: {
+    taskId?: string;
+    channelId?: string;
+    keyword?: string;
+    reportType?: 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 keyword = query.keyword?.trim();
+    const where: Prisma.ChannelSignatureReportRecordWhereInput = {
+      taskId: query.taskId,
+      channelId: query.channelId,
+      task: query.reportType ? { reportType: query.reportType } : 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,
+      OR: keyword ? [
+        { taskId: { contains: keyword } },
+        { action: { contains: keyword } },
+        { reason: { contains: keyword } },
+        { channel: { name: { contains: keyword } } },
+        { task: { signature: { name: { contains: keyword } } } },
+        { task: { drainageInfo: { siteName: { contains: keyword } } } },
+        { task: { drainageInfo: { url: { contains: keyword } } } },
+      ] : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.prisma.channelSignatureReportRecord.findMany({
+        where,
+        include: { channel: true, task: { include: { signature: true, drainageInfo: true } } },
+        orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.channelSignatureReportRecord.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
   private async getReportTaskOrThrow(taskId: string) {
     const task = await this.prisma.channelSignatureReportTask.findUnique({ where: { id: taskId }, include: { drainageInfo: true } });
     if (!task) {

api/src/operations/admin-operations.controller.ts

@@ -42,8 +42,10 @@ export class AdminOperationsController {
     @Query('queuedAtFrom') queuedAtFrom?: string,
     @Query('queuedAtTo') queuedAtTo?: string,
     @Query('status') status?: string,
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
   ) {
-    return this.operations.listMessages({
+    return this.operations.listMessagesPage({
       tenantId,
       applicationId,
       channelId,
@@ -55,9 +57,40 @@ export class AdminOperationsController {
       queuedAtFrom,
       queuedAtTo,
       status,
+      page: Number(page),
+      pageSize: Number(pageSize),
     });
   }
 
+  @Get('messages/export')
+  async exportMessages(
+    @Query('tenantId') tenantId: string | undefined,
+    @Query('applicationId') applicationId: string | undefined,
+    @Query('channelId') channelId: string | undefined,
+    @Query('phoneNumber') phoneNumber: string | undefined,
+    @Query('contentKeyword') contentKeyword: string | undefined,
+    @Query('channelKeyword') channelKeyword: string | undefined,
+    @Query('queuedAtFrom') queuedAtFrom: string | undefined,
+    @Query('queuedAtTo') queuedAtTo: string | undefined,
+    @Query('status') status: string | undefined,
+    @Res() response: DownloadResponse,
+  ) {
+    const exported = await this.operations.exportMessages({
+      tenantId,
+      applicationId,
+      channelId,
+      phoneNumber,
+      contentKeyword,
+      channelKeyword,
+      queuedAtFrom,
+      queuedAtTo,
+      status,
+    });
+    response.setHeader('Content-Type', 'text/csv; charset=utf-8');
+    response.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodeURIComponent(exported.fileName)}`);
+    response.send(`\uFEFF${exported.content}`);
+  }
+
   @Get('message-segment-audits')
   messageSegmentAudits(
     @Query('messageId') messageId?: string,
@@ -67,8 +100,10 @@ export class AdminOperationsController {
   }
 
   @Get('uplink-messages')
-  listUplinkMessages(@Query('tenantId') tenantId?: string, @Query('channelId') channelId?: string) {
-    return this.operations.listUplinkMessages({ tenantId, channelId });
+  listUplinkMessages(@Query('tenantId') tenantId?: string, @Query('channelId') channelId?: string, @Query('phoneNumber') phoneNumber?: string, @Query('keyword') keyword?: string, @Query('startTime') startTime?: string, @Query('endTime') endTime?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.operations.listUplinkMessagesPage({ tenantId, channelId, phoneNumber, keyword, startTime, endTime, page: Number(page), pageSize: Number(pageSize) })
+      : this.operations.listUplinkMessages({ tenantId, channelId, phoneNumber, keyword, startTime, endTime });
   }
 
   @Post('uplink-messages/:id/claim')

api/src/operations/client-operations.controller.ts

@@ -27,13 +27,32 @@ export class ClientOperationsController {
     @Query('messageId') messageId?: string,
     @Query('phoneNumber') phoneNumber?: string,
     @Query('status') status?: string,
+    @Query('contentKeyword') contentKeyword?: string,
+    @Query('queuedAtFrom') queuedAtFrom?: string,
+    @Query('queuedAtTo') queuedAtTo?: string,
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
   ) {
-    return this.operations.listClientMessages({ tenantId, applicationId, taskId, messageId, phoneNumber, status });
+    return this.operations.listClientMessagesPage({
+      tenantId,
+      applicationId,
+      taskId,
+      messageId,
+      phoneNumber,
+      status,
+      contentKeyword,
+      queuedAtFrom,
+      queuedAtTo,
+      page: Number(page),
+      pageSize: Number(pageSize),
+    });
   }
 
   @Get('uplink-messages')
-  listUplinkMessages(@TenantId() tenantId?: string, @Query('channelId') channelId?: string, @Query('applicationId') applicationId?: string, @Query('phoneNumber') phoneNumber?: string, @Query('keyword') keyword?: string, @Query('startTime') startTime?: string, @Query('endTime') endTime?: string) {
-    return this.operations.listClientUplinkMessages({ tenantId, applicationId, phoneNumber, keyword, startTime, endTime });
+  listUplinkMessages(@TenantId() tenantId?: string, @Query('channelId') channelId?: string, @Query('applicationId') applicationId?: string, @Query('phoneNumber') phoneNumber?: string, @Query('keyword') keyword?: string, @Query('startTime') startTime?: string, @Query('endTime') endTime?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.operations.listUplinkMessagesPage({ tenantId, applicationId, phoneNumber, keyword, startTime, endTime, page: Number(page), pageSize: Number(pageSize) }, true)
+      : this.operations.listClientUplinkMessages({ tenantId, applicationId, phoneNumber, keyword, startTime, endTime });
   }
 
   @Get('dashboard')

api/src/operations/operations.service.spec.ts

@@ -15,9 +15,10 @@ function createPrismaMock() {
     },
     smsMessageRecord: {
       findMany: jest.fn().mockResolvedValue([{ messageId: 'MSG-1' }]),
+      count: jest.fn().mockResolvedValue(51),
       groupBy: jest.fn().mockResolvedValue([{ status: 'delivered', _count: { _all: 2 }, _sum: { amountCents: 20, billingUnits: 2 } }]),
       aggregate: jest.fn().mockResolvedValue({ _count: { _all: 2 }, _sum: { amountCents: 20, billingUnits: 2 } }),
-    },
+  },
     smsReceiptRecord: {
       findMany: jest.fn().mockResolvedValue([]),
     },
@@ -254,6 +255,27 @@ describe('OperationsService', () => {
     }));
   });
 
+  it('paginates message records in PostgreSQL and limits heavy relations to the requested page', async () => {
+    const prisma = createPrismaMock();
+    const service = new OperationsService(prisma as never);
+
+    await expect(service.listMessagesPage({ tenantId: 'tenant-1', page: 2, pageSize: 25 })).resolves.toEqual({
+      items: [{ messageId: 'MSG-1' }],
+      total: 51,
+      page: 2,
+      pageSize: 25,
+    });
+    expect(prisma.smsMessageRecord.findMany).toHaveBeenCalledWith(expect.objectContaining({
+      where: expect.objectContaining({ tenantId: 'tenant-1' }),
+      skip: 25,
+      take: 25,
+      orderBy: [{ queuedAt: 'desc' }, { id: 'desc' }],
+    }));
+    expect(prisma.smsMessageRecord.count).toHaveBeenCalledWith({
+      where: expect.objectContaining({ tenantId: 'tenant-1' }),
+    });
+  });
+
   it('returns uplink messages with tenant and channel display data', async () => {
     const prisma = createPrismaMock();
     const service = new OperationsService(prisma as never);

api/src/operations/operations.service.ts

@@ -16,6 +16,8 @@ export interface MessageQuery {
   status?: string;
   queuedAtFrom?: string;
   queuedAtTo?: string;
+  page?: number;
+  pageSize?: number;
 }
 
 export interface TraceQuery extends MessageQuery {
@@ -122,12 +124,117 @@ export class OperationsService {
     });
   }
 
+  async listMessagesPage(query: MessageQuery) {
+    const page = Math.max(1, Math.floor(Number(query.page) || 1));
+    const pageSize = Math.min(100, Math.max(1, Math.floor(Number(query.pageSize) || 25)));
+    const where = messageWhere(query);
+    const [items, total] = await Promise.all([
+      this.prisma.smsMessageRecord.findMany({
+        where,
+        include: {
+          tenant: { select: { id: true, name: true } },
+          application: { select: { id: true, name: true } },
+          channel: { select: { id: true, name: true, srcId: true } },
+          submitRecords: {
+            select: {
+              id: true,
+              submitId: true,
+              channelId: true,
+              channelGroupId: true,
+              channelGroupName: true,
+              gatewayMessageId: true,
+              submitStatus: true,
+              submittedAt: true,
+              createdAt: true,
+              channel: { select: { id: true, name: true } },
+              channelGroup: { select: { id: true, name: true } },
+            },
+          },
+          receiptRecords: {
+            select: {
+              id: true,
+              messageId: true,
+              gatewayMessageId: true,
+              receiptStatus: true,
+              rawStatus: true,
+              errorCode: true,
+              errorMessage: true,
+              deliveredAt: true,
+              createdAt: true,
+              channelId: true,
+              channel: { select: { id: true, name: true } },
+            },
+          },
+          downstreamDeliveries: {
+            where: { deliveryType: 'receipt' },
+            select: { id: true, deliveryType: true, status: true, deliveredAt: true, lastError: true },
+          },
+        },
+        orderBy: [{ queuedAt: 'desc' }, { id: 'desc' }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.smsMessageRecord.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
+  async exportMessages(query: MessageQuery) {
+    const items = await this.prisma.smsMessageRecord.findMany({
+      where: messageWhere(query),
+      select: {
+        messageId: true,
+        queuedAt: true,
+        phoneNumber: true,
+        province: true,
+        carrier: true,
+        billingUnits: true,
+        amountCents: true,
+        status: true,
+        submitStatus: true,
+        deliveredAt: true,
+        content: true,
+        tenant: { select: { name: true } },
+        application: { select: { name: true } },
+        channel: { select: { name: true } },
+      },
+      orderBy: [{ queuedAt: 'desc' }, { id: 'desc' }],
+    });
+    const rows = [
+      ['消息编号', '企业', '应用', '提交时间', '手机号', '地区', '运营商', '计费条数', '金额', '通道', '状态', '回执时间', '短信内容'],
+      ...items.map((item) => [
+        item.messageId,
+        item.tenant?.name ?? '',
+        item.application?.name ?? '',
+        item.queuedAt.toISOString(),
+        item.phoneNumber,
+        item.province ?? '',
+        item.carrier ?? '',
+        String(item.billingUnits),
+        String(moneyToNumber(item.amountCents)),
+        item.channel?.name ?? '',
+        item.status === 'submit_failed' || ['rejected', 'timeout'].includes(item.submitStatus ?? '') ? 'submit_failed' : item.status,
+        item.deliveredAt?.toISOString() ?? '',
+        item.content,
+      ]),
+    ];
+    return {
+      fileName: `sms-records-${formatExportTimestamp(new Date())}.csv`,
+      content: rows.map((row) => row.map((cell) => escapeCsvCell(String(cell))).join(',')).join('\n'),
+    };
+  }
+
   async listClientMessages(query: MessageQuery) {
     const items = await this.listMessages(query);
     return items.map(clientMessageView);
   }
 
-  listUplinkMessages(query: { tenantId?: string; channelId?: string; applicationId?: string; phoneNumber?: string; keyword?: string; startTime?: string; endTime?: string }) {
+  async listClientMessagesPage(query: MessageQuery) {
+    const result = await this.listMessagesPage(query);
+    return { ...result, items: result.items.map(clientMessageView) };
+  }
+
+  listUplinkMessages(query: { tenantId?: string; channelId?: string; applicationId?: string; phoneNumber?: string; keyword?: string; startTime?: string; endTime?: string; page?: number; pageSize?: number }) {
     return this.prisma.smsUplinkMessage.findMany({
       where: {
         tenantId: query.tenantId,
@@ -152,15 +259,42 @@ export class OperationsService {
         },
       },
       orderBy: { receivedAt: 'desc' },
-      take: 500,
+      skip: query.page && query.pageSize ? (query.page - 1) * query.pageSize : undefined,
+      take: query.pageSize ?? 500,
     });
   }
 
-  async listClientUplinkMessages(query: { tenantId?: string; applicationId?: string; phoneNumber?: string; keyword?: string; startTime?: string; endTime?: string }) {
+  async listClientUplinkMessages(query: { tenantId?: string; applicationId?: string; phoneNumber?: string; keyword?: string; startTime?: string; endTime?: string; page?: number; pageSize?: number }) {
     const items = await this.listUplinkMessages(query);
     return items.map(clientUplinkView);
   }
 
+  async listUplinkMessagesPage(query: { tenantId?: string; channelId?: string; applicationId?: string; phoneNumber?: string; keyword?: string; startTime?: string; endTime?: string; page?: number; pageSize?: number }, clientView = false) {
+    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.SmsUplinkMessageWhereInput = {
+      tenantId: query.tenantId,
+      channelId: query.channelId,
+      applicationId: query.applicationId,
+      phoneNumber: query.phoneNumber ? { contains: query.phoneNumber } : undefined,
+      content: query.keyword ? { contains: query.keyword } : undefined,
+      receivedAt: query.startTime || query.endTime ? {
+        gte: query.startTime ? new Date(query.startTime) : undefined,
+        lte: query.endTime ? new Date(query.endTime) : undefined,
+      } : undefined,
+    };
+    const [rawItems, total] = await Promise.all([
+      this.listUplinkMessages({ ...query, page, pageSize }),
+      this.prisma.smsUplinkMessage.count({ where }),
+    ]);
+    return {
+      items: clientView ? rawItems.map(clientUplinkView) : rawItems,
+      total,
+      page,
+      pageSize,
+    };
+  }
+
   async monitor(query: { tenantId?: string; channelId?: string }) {
     const where = messageWhere(query);
     const [byStatus, recentMessages, recentReceipts, recentUplinks] = await Promise.all([

api/src/send-chain/admin-send-chain.controller.ts

@@ -8,8 +8,10 @@ export class AdminSendChainController {
   constructor(private readonly sendChain: SendChainService) {}
 
   @Get('batch-tasks')
-  listBatchTasks(@Query('tenantId') tenantId?: string, @Query('status') status?: string) {
-    return this.sendChain.listBatchTasks(tenantId, status);
+  listBatchTasks(@Query('tenantId') tenantId?: string, @Query('status') status?: string, @Query('keyword') keyword?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('createdAtFrom') createdAtFrom?: string, @Query('createdAtTo') createdAtTo?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.sendChain.listBatchTasksPage({ tenantId, status, keyword, enterpriseKeyword, applicationKeyword, createdAtFrom, createdAtTo, page: Number(page), pageSize: Number(pageSize) })
+      : this.sendChain.listBatchTasks(tenantId, status);
   }
 
   @Get('batch-tasks/:id/messages')

api/src/send-chain/client-send-chain.controller.ts

@@ -24,8 +24,10 @@ export class ClientSendChainController {
   }
 
   @Get('batch-tasks')
-  listBatchTasks(@TenantId() tenantId?: string, @Query('status') status?: string) {
-    return this.sendChain.listBatchTasks(requireTenantId(tenantId), status, 'client');
+  listBatchTasks(@TenantId() tenantId?: string, @Query('status') status?: string, @Query('keyword') keyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('createdAtFrom') createdAtFrom?: string, @Query('createdAtTo') createdAtTo?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.sendChain.listBatchTasksPage({ tenantId: requireTenantId(tenantId), status, sourceType: 'client', keyword, applicationKeyword, createdAtFrom, createdAtTo, page: Number(page), pageSize: Number(pageSize) })
+      : this.sendChain.listBatchTasks(requireTenantId(tenantId), status, 'client');
   }
 
   @Get('batch-tasks/:id')

api/src/send-chain/send-chain.service.ts

@@ -599,6 +599,65 @@ export class SendChainService implements OnModuleInit, OnModuleDestroy {
     return this.listMessages({ tenantId, taskId });
   }
 
+  async listBatchTasksPage(query: {
+    tenantId?: string;
+    status?: string;
+    sourceType?: string;
+    keyword?: string;
+    enterpriseKeyword?: string;
+    applicationKeyword?: 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.SmsBatchTaskWhereInput = {
+      tenantId: query.tenantId,
+      status: query.status,
+      sourceType: query.sourceType ?? 'client',
+      taskNo: query.keyword?.trim() ? { contains: query.keyword.trim() } : undefined,
+      tenant: query.enterpriseKeyword?.trim() ? { name: { contains: query.enterpriseKeyword.trim() } } : undefined,
+      application: query.applicationKeyword?.trim() ? { name: { contains: query.applicationKeyword.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 [tasks, total] = await Promise.all([
+      this.prisma.smsBatchTask.findMany({
+        where,
+        include: {
+          tenant: { select: { id: true, name: true } },
+          application: { select: { id: true, name: true } },
+          template: { select: { id: true, name: true, content: true } },
+          apiRequests: true,
+        },
+        orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.smsBatchTask.count({ where }),
+    ]);
+    const taskIds = tasks.map((task) => task.id);
+    const messageStats = taskIds.length > 0 ? await this.prisma.smsMessageRecord.groupBy({
+      by: ['batchTaskId', 'carrier', 'province', 'status'],
+      where: { batchTaskId: { in: taskIds } },
+      _count: { _all: true },
+      _sum: { billingUnits: true },
+    }) : [];
+    return {
+      items: tasks.map((task) => ({
+        ...task,
+        messageStats: messageStats.filter((item) => item.batchTaskId === task.id),
+      })),
+      total,
+      page,
+      pageSize,
+    };
+  }
+
   async listAdminBatchTaskMessages(taskId: string, phone?: string, page = 1, pageSize = 20) {
     const task = await this.prisma.smsBatchTask.findFirst({
       where: { id: taskId, sourceType: 'client' },

api/src/sms-config/admin-sms-config.controller.ts

@@ -12,8 +12,14 @@ export class AdminSmsConfigController {
   constructor(private readonly smsConfig: SmsConfigService, private readonly reviewGovernance: ReviewGovernanceService, private readonly deletions: DeletionGovernanceService) {}
 
   @Get('enterprise-applications')
-  listApplications(@Query('tenantId') tenantId?: string, @Query('keyword') keyword?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('status') status?: string) {
-    return this.smsConfig.listApplications({ tenantId, keyword, enterpriseKeyword, applicationKeyword, status, includeConnections: true });
+  listApplications(@Query('tenantId') tenantId?: string, @Query('keyword') keyword?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('status') status?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    const query = { tenantId, keyword, enterpriseKeyword, applicationKeyword, status, includeConnections: true, page: Number(page), pageSize: Number(pageSize) };
+    return page || pageSize ? this.smsConfig.listApplicationsPage(query) : this.smsConfig.listApplications(query);
+  }
+
+  @Get('enterprise-application-options')
+  listApplicationOptions(@Query('tenantId') tenantId?: string) {
+    return this.smsConfig.listApplicationOptions(tenantId);
   }
 
   @Get('enterprise-applications/:id')
@@ -65,8 +71,14 @@ export class AdminSmsConfigController {
   }
 
   @Get('enterprise-signatures')
-  listSignatures(@Query('tenantId') tenantId?: string, @Query('keyword') keyword?: string, @Query('status') status?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('signatureKeyword') signatureKeyword?: string, @Query('drainageKeyword') drainageKeyword?: string) {
-    return this.smsConfig.listSignatures({ tenantId, keyword, status, enterpriseKeyword, applicationKeyword, signatureKeyword, drainageKeyword });
+  listSignatures(@Query('tenantId') tenantId?: string, @Query('keyword') keyword?: string, @Query('status') status?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('signatureKeyword') signatureKeyword?: string, @Query('drainageKeyword') drainageKeyword?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    const query = { tenantId, keyword, status, enterpriseKeyword, applicationKeyword, signatureKeyword, drainageKeyword, page: Number(page), pageSize: Number(pageSize) };
+    return page || pageSize ? this.smsConfig.listSignaturesPage(query) : this.smsConfig.listSignatures(query);
+  }
+
+  @Get('enterprise-signature-options')
+  listSignatureOptions(@Query('tenantId') tenantId?: string) {
+    return this.smsConfig.listSignatureOptions(tenantId);
   }
 
   @Post('enterprise-signatures')
@@ -113,8 +125,9 @@ export class AdminSmsConfigController {
   }
 
   @Get('enterprise-templates')
-  listTemplates(@Query('tenantId') tenantId?: string, @Query('status') status?: string, @Query('keyword') keyword?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('nameKeyword') nameKeyword?: string, @Query('contentKeyword') contentKeyword?: string) {
-    return this.smsConfig.listTemplates({ tenantId, status, keyword, enterpriseKeyword, applicationKeyword, nameKeyword, contentKeyword });
+  listTemplates(@Query('tenantId') tenantId?: string, @Query('status') status?: string, @Query('keyword') keyword?: string, @Query('enterpriseKeyword') enterpriseKeyword?: string, @Query('applicationKeyword') applicationKeyword?: string, @Query('nameKeyword') nameKeyword?: string, @Query('contentKeyword') contentKeyword?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    const query = { tenantId, status, keyword, enterpriseKeyword, applicationKeyword, nameKeyword, contentKeyword, page: Number(page), pageSize: Number(pageSize) };
+    return page || pageSize ? this.smsConfig.listTemplatesPage(query) : this.smsConfig.listTemplates(query);
   }
 
   @Post('enterprise-templates')

api/src/sms-config/client-sms-config.controller.ts

@@ -23,8 +23,15 @@ export class ClientSmsConfigController {
   constructor(private readonly smsConfig: SmsConfigService, private readonly deletions: DeletionGovernanceService) {}
 
   @Get('applications')
-  listApplications(@TenantId() tenantId?: string) {
-    return this.smsConfig.listApplications(tenantId);
+  listApplications(@TenantId() tenantId?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.smsConfig.listApplicationsPage({ tenantId, page: Number(page), pageSize: Number(pageSize) })
+      : this.smsConfig.listApplications(tenantId);
+  }
+
+  @Get('application-options')
+  listApplicationOptions(@TenantId() tenantId?: string) {
+    return this.smsConfig.listApplicationOptions(tenantId);
   }
 
   @Post('applications')
@@ -64,9 +71,14 @@ export class ClientSmsConfigController {
     return this.smsConfig.listClientSignatures(tenantId);
   }
 
+  @Get('signature-options')
+  listSignatureOptions(@TenantId() tenantId?: string) {
+    return this.smsConfig.listSignatureOptions(tenantId);
+  }
+
   @Get('signatures-workspace')
-  getSignatureWorkspace(@TenantId() tenantId?: string) {
-    return this.smsConfig.getClientSignatureWorkspace(tenantId);
+  getSignatureWorkspace(@TenantId() tenantId?: string, @Query('keyword') keyword?: string, @Query('applicationId') applicationId?: string, @Query('status') status?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return this.smsConfig.getClientSignatureWorkspace(tenantId, { keyword, applicationId, status, page: Number(page), pageSize: Number(pageSize) });
   }
 
   @Post('signatures')
@@ -124,8 +136,10 @@ export class ClientSmsConfigController {
   }
 
   @Get('templates')
-  listTemplates(@TenantId() tenantId?: string, @Query('includeHistory') includeHistory?: string) {
-    return this.smsConfig.listClientTemplates(tenantId, includeHistory === 'true');
+  listTemplates(@TenantId() tenantId?: string, @Query('includeHistory') includeHistory?: string, @Query('keyword') keyword?: string, @Query('page') page?: string, @Query('pageSize') pageSize?: string) {
+    return page || pageSize
+      ? this.smsConfig.listTemplatesPage({ tenantId, status: includeHistory === 'true' ? 'all' : 'approved', keyword, page: Number(page), pageSize: Number(pageSize) })
+      : this.smsConfig.listClientTemplates(tenantId, includeHistory === 'true');
   }
 
   @Post('templates')

api/src/sms-config/sms-config.service.spec.ts

@@ -69,6 +69,7 @@ function createPrismaMock() {
     },
     smsSignature: {
       groupBy: jest.fn().mockResolvedValue([]),
+      count: jest.fn().mockResolvedValue(0),
       findMany: jest.fn().mockResolvedValue([{
         id: 'sig-1',
         tenantId: 'tenant-1',
@@ -900,6 +901,7 @@ describe('SmsConfigService', () => {
   it('returns real client signature workspace counts from database grouping', async () => {
     const prisma = createPrismaMock();
     prisma.smsSignature.findMany.mockResolvedValue([]);
+    prisma.smsSignature.count.mockResolvedValue(8);
     prisma.smsSignature.groupBy.mockResolvedValue([
       { auditStatus: 'pending', _count: { _all: 2 } },
       { auditStatus: 'approved', _count: { _all: 5 } },
@@ -910,6 +912,9 @@ describe('SmsConfigService', () => {
     await expect(service.getClientSignatureWorkspace('tenant-1')).resolves.toEqual({
       items: [],
       summary: { total: 8, pending: 2, approved: 5, rejected: 1, draft: 0 },
+      total: 8,
+      page: 1,
+      pageSize: 10,
     });
     expect(prisma.smsSignature.groupBy).toHaveBeenCalledWith(expect.objectContaining({
       where: { tenantId: 'tenant-1', auditStatus: { notIn: ['deleted', 'disabled'] } },

api/src/sms-config/sms-config.service.ts

@@ -122,6 +122,8 @@ export interface TemplateListQuery {
   applicationKeyword?: string;
   nameKeyword?: string;
   contentKeyword?: string;
+  page?: number;
+  pageSize?: number;
 }
 
 export interface ApplicationListQuery {
@@ -131,6 +133,8 @@ export interface ApplicationListQuery {
   applicationKeyword?: string;
   status?: string;
   includeConnections?: boolean;
+  page?: number;
+  pageSize?: number;
 }
 
 export interface SignatureListQuery {
@@ -141,6 +145,8 @@ export interface SignatureListQuery {
   applicationKeyword?: string;
   signatureKeyword?: string;
   drainageKeyword?: string;
+  page?: number;
+  pageSize?: number;
 }
 
 export interface GatewayDownstreamConnectionEventDto {
@@ -205,7 +211,15 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
         ipAllowlist: true,
         httpConfig: true,
       },
+      omit: {
+        secretHash: true,
+        passwordCipher: true,
+      },
       orderBy: { createdAt: 'desc' },
+      ...(query.page && query.pageSize ? {
+        skip: (query.page - 1) * query.pageSize,
+        take: query.pageSize,
+      } : {}),
     });
     if (!query.includeConnections) {
       return applications;
@@ -243,6 +257,34 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
       || left.id.localeCompare(right.id));
   }
 
+  async listApplicationsPage(query: ApplicationListQuery) {
+    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.SmsApplicationWhereInput = {
+      tenantId: query.tenantId,
+      status: query.status && query.status !== 'all' ? query.status : { not: 'deleted' },
+      tenant: query.enterpriseKeyword ? { name: { contains: query.enterpriseKeyword } } : undefined,
+      name: query.applicationKeyword ? { contains: query.applicationKeyword } : undefined,
+      OR: query.keyword ? [
+        { name: { contains: query.keyword } },
+        { tenant: { name: { contains: query.keyword } } },
+      ] : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.listApplications({ ...query, page, pageSize }),
+      this.prisma.smsApplication.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
+  listApplicationOptions(tenantId?: string) {
+    return this.prisma.smsApplication.findMany({
+      where: { tenantId, status: { not: 'deleted' } },
+      select: { id: true, tenantId: true, name: true, status: true },
+      orderBy: [{ name: 'asc' }, { id: 'asc' }],
+    });
+  }
+
   async getApplication(applicationId: string, tenantId?: string) {
     const application = await this.prisma.smsApplication.findUnique({
       where: { id: applicationId },
@@ -905,6 +947,10 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
         reportTasks: { include: { channel: true, drainageInfo: true } },
       },
       orderBy: { createdAt: 'desc' },
+      ...(query.page && query.pageSize ? {
+        skip: (query.page - 1) * query.pageSize,
+        take: query.pageSize,
+      } : {}),
     });
     const applicationIds = signatures.map((signature) => signature.applicationId).filter((id): id is string => Boolean(id));
     const routes = applicationIds.length ? await this.prisma.channelRouteRule.findMany({
@@ -979,9 +1025,60 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
     });
   }
 
-  async listClientSignatures(tenantId?: string, signatureId?: string) {
+  async listSignaturesPage(query: SignatureListQuery) {
+    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.SmsSignatureWhereInput = {
+      tenantId: query.tenantId,
+      auditStatus: query.status && query.status !== 'all' ? query.status : { not: 'deleted' },
+      tenant: query.enterpriseKeyword ? { name: { contains: query.enterpriseKeyword } } : undefined,
+      application: query.applicationKeyword ? { name: { contains: query.applicationKeyword } } : undefined,
+      name: query.signatureKeyword ? { contains: query.signatureKeyword } : undefined,
+      drainageItems: query.drainageKeyword ? {
+        some: {
+          auditStatus: { not: 'deleted' },
+          OR: [
+            { siteName: { contains: query.drainageKeyword } },
+            { url: { contains: query.drainageKeyword } },
+            { remark: { contains: query.drainageKeyword } },
+          ],
+        },
+      } : undefined,
+      OR: query.keyword ? [
+        { name: { contains: query.keyword } },
+        { purpose: { contains: query.keyword } },
+        { tenant: { name: { contains: query.keyword } } },
+        { application: { name: { contains: query.keyword } } },
+      ] : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.listSignatures({ ...query, page, pageSize }),
+      this.prisma.smsSignature.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
+  listSignatureOptions(tenantId?: string) {
+    return this.prisma.smsSignature.findMany({
+      where: { tenantId, auditStatus: { not: 'deleted' } },
+      select: { id: true, tenantId: true, applicationId: true, name: true, auditStatus: true },
+      orderBy: [{ name: 'asc' }, { id: 'asc' }],
+    });
+  }
+
+  async listClientSignatures(tenantId?: string, signatureId?: string, query: { keyword?: string; applicationId?: string; status?: string; page?: number; pageSize?: number } = {}) {
     const signatures = await this.prisma.smsSignature.findMany({
-      where: { id: signatureId, tenantId, auditStatus: { notIn: ['deleted', 'disabled'] } },
+      where: {
+        id: signatureId,
+        tenantId,
+        applicationId: query.applicationId,
+        auditStatus: query.status || { notIn: ['deleted', 'disabled'] },
+        OR: query.keyword?.trim() ? [
+          { name: { contains: query.keyword.trim() } },
+          { purpose: { contains: query.keyword.trim() } },
+          { application: { name: { contains: query.keyword.trim() } } },
+        ] : undefined,
+      },
       select: {
         id: true,
         tenantId: true,
@@ -1020,6 +1117,8 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
         _count: { select: { reportMaterials: true } },
       },
       orderBy: { updatedAt: 'desc' },
+      skip: query.page && query.pageSize ? (query.page - 1) * query.pageSize : undefined,
+      take: query.pageSize,
     });
     return signatures.map((signature) => {
       const stored = isRecord(signature.drainageInfo) ? signature.drainageInfo : {};
@@ -1056,9 +1155,22 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
     return signature;
   }
 
-  async getClientSignatureWorkspace(tenantId?: string) {
-    const [items, statusCounts] = await Promise.all([
-      this.listClientSignatures(tenantId),
+  async getClientSignatureWorkspace(tenantId?: string, query: { keyword?: string; applicationId?: string; status?: 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 filteredWhere: Prisma.SmsSignatureWhereInput = {
+      tenantId,
+      applicationId: query.applicationId,
+      auditStatus: query.status || { notIn: ['deleted', 'disabled'] },
+      OR: query.keyword?.trim() ? [
+        { name: { contains: query.keyword.trim() } },
+        { purpose: { contains: query.keyword.trim() } },
+        { application: { name: { contains: query.keyword.trim() } } },
+      ] : undefined,
+    };
+    const [items, total, statusCounts] = await Promise.all([
+      this.listClientSignatures(tenantId, undefined, { ...query, page, pageSize }),
+      this.prisma.smsSignature.count({ where: filteredWhere }),
       this.prisma.smsSignature.groupBy({
         by: ['auditStatus'],
         where: { tenantId, auditStatus: { notIn: ['deleted', 'disabled'] } },
@@ -1073,7 +1185,7 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
         summary[item.auditStatus as keyof Omit<typeof summary, 'total'>] = count;
       }
     }
-    return { items, summary };
+    return { items, summary, total, page, pageSize };
   }
 
   async listClientDrainageInfos(tenantId?: string, itemId?: string) {
@@ -1464,9 +1576,38 @@ export class SmsConfigService implements OnModuleInit, OnModuleDestroy {
       },
       include: { variables: true, application: true, tenant: true, signature: true },
       orderBy: { createdAt: 'desc' },
+      ...(query.page && query.pageSize ? {
+        skip: (query.page - 1) * query.pageSize,
+        take: query.pageSize,
+      } : {}),
     });
   }
 
+  async listTemplatesPage(query: TemplateListQuery) {
+    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.SmsTemplateWhereInput = {
+      tenantId: query.tenantId,
+      auditStatus: query.status && query.status !== 'all' ? query.status : { not: 'deleted' },
+      tenant: query.enterpriseKeyword ? { name: { contains: query.enterpriseKeyword } } : undefined,
+      application: query.applicationKeyword ? { name: { contains: query.applicationKeyword } } : undefined,
+      name: query.nameKeyword ? { contains: query.nameKeyword } : undefined,
+      content: query.contentKeyword ? { contains: query.contentKeyword } : undefined,
+      OR: query.keyword ? [
+        { name: { contains: query.keyword } },
+        { content: { contains: query.keyword } },
+        { category: { contains: query.keyword } },
+        { application: { name: { contains: query.keyword } } },
+        { tenant: { name: { contains: query.keyword } } },
+      ] : undefined,
+    };
+    const [items, total] = await Promise.all([
+      this.listTemplates({ ...query, page, pageSize }),
+      this.prisma.smsTemplate.count({ where }),
+    ]);
+    return { items, total, page, pageSize };
+  }
+
   listClientTemplates(tenantId: string | undefined, includeHistory = false) {
     return this.listTemplates({ tenantId, status: includeHistory ? 'all' : 'approved' });
   }