feat: 列表接口分页排序与验证

src/Application/TakeoutSaaS.Application/App/Payments/Handlers/SearchPaymentsQueryHandler.cs

@@ -3,6 +3,7 @@ using TakeoutSaaS.Application.App.Payments.Dto;
 using TakeoutSaaS.Application.App.Payments.Queries;
 using TakeoutSaaS.Domain.Payments.Entities;
 using TakeoutSaaS.Domain.Payments.Repositories;
+using TakeoutSaaS.Shared.Abstractions.Results;
 using TakeoutSaaS.Shared.Abstractions.Tenancy;
 
 namespace TakeoutSaaS.Application.App.Payments.Handlers;
@@ -13,13 +14,13 @@ namespace TakeoutSaaS.Application.App.Payments.Handlers;
 public sealed class SearchPaymentsQueryHandler(
     IPaymentRepository paymentRepository,
     ITenantProvider tenantProvider)
-    : IRequestHandler<SearchPaymentsQuery, IReadOnlyList<PaymentDto>>
+    : IRequestHandler<SearchPaymentsQuery, PagedResult<PaymentDto>>
 {
     private readonly IPaymentRepository _paymentRepository = paymentRepository;
     private readonly ITenantProvider _tenantProvider = tenantProvider;
 
     /// <inheritdoc />
-    public async Task<IReadOnlyList<PaymentDto>> Handle(SearchPaymentsQuery request, CancellationToken cancellationToken)
+    public async Task<PagedResult<PaymentDto>> Handle(SearchPaymentsQuery request, CancellationToken cancellationToken)
     {
         var tenantId = _tenantProvider.GetCurrentTenantId();
         var payments = await _paymentRepository.SearchAsync(tenantId, request.Status, cancellationToken);
@@ -35,7 +36,7 @@ public sealed class SearchPaymentsQueryHandler(
             .Take(request.PageSize)
             .ToList();
 
-        return paged.Select(payment => new PaymentDto
+        var items = paged.Select(payment => new PaymentDto
         {
             Id = payment.Id,
             TenantId = payment.TenantId,
@@ -50,6 +51,8 @@ public sealed class SearchPaymentsQueryHandler(
             Payload = payment.Payload,
             CreatedAt = payment.CreatedAt
         }).ToList();
+
+        return new PagedResult<PaymentDto>(items, request.Page, request.PageSize, payments.Count);
     }
 
     private static IOrderedEnumerable<Domain.Payments.Entities.PaymentRecord> ApplySorting(

src/Application/TakeoutSaaS.Application/App/Payments/Queries/SearchPaymentsQuery.cs

@@ -1,13 +1,14 @@
 using MediatR;
 using TakeoutSaaS.Application.App.Payments.Dto;
 using TakeoutSaaS.Domain.Payments.Enums;
+using TakeoutSaaS.Shared.Abstractions.Results;
 
 namespace TakeoutSaaS.Application.App.Payments.Queries;
 
 /// <summary>
 /// 支付记录列表查询。
 /// </summary>
-public sealed class SearchPaymentsQuery : IRequest<IReadOnlyList<PaymentDto>>
+public sealed class SearchPaymentsQuery : IRequest<PagedResult<PaymentDto>>
 {
     /// <summary>
     /// 订单 ID（可选）。