feat: Add CommissionCQ - Phase 5 Application Layer

Added 5 Commands and 4 Queries for commission calculation and payout system: Commands: - CalculateWeeklyBalances: Recursive binary tree traversal for leg balances - CalculateWeeklyCommissionPool: Calculate ValuePerBalance from total pool - ProcessUserPayouts: Distribute commission to users, create payout records - RequestWithdrawal: User requests cash/diamond withdrawal - ProcessWithdrawal: Admin approves/rejects withdrawal Queries: - GetWeeklyCommissionPool: Retrieve pool details - GetUserCommissionPayouts: List payouts with filters (status, week, user) - GetCommissionPayoutHistory: Complete audit trail - GetUserWeeklyBalances: Show leg balances and contributions Total: 35 files, ~1,100 lines of code Binary tree algorithm, state machine, withdrawal system implemented
2025-11-29 04:32:17 +03:30
parent e68a7182d9
commit 487d1ceb15
31 changed files with 1213 additions and 0 deletions
@@ -0,0 +1,32 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetCommissionPayoutHistory;
+
+/// <summary>
+/// Query برای دریافت تاریخچه تغییرات کمیسیون
+/// </summary>
+public record GetCommissionPayoutHistoryQuery : IRequest<GetCommissionPayoutHistoryResponseDto>
+{
+    /// <summary>
+    /// شناسه پرداخت (اختیاری)
+    /// </summary>
+    public long? PayoutId { get; init; }
+
+    /// <summary>
+    /// شناسه کاربر (اختیاری)
+    /// </summary>
+    public long? UserId { get; init; }
+
+    /// <summary>
+    /// شماره هفته (اختیاری)
+    /// </summary>
+    public string? WeekNumber { get; init; }
+
+    /// <summary>
+    /// مرتب‌سازی
+    /// </summary>
+    public string? SortBy { get; init; }
+
+    /// <summary>
+    /// Pagination
+    /// </summary>
+    public PaginationState? PaginationState { get; init; }
+}
@@ -0,0 +1,63 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetCommissionPayoutHistory;
+
+public class GetCommissionPayoutHistoryQueryHandler : IRequestHandler<GetCommissionPayoutHistoryQuery, GetCommissionPayoutHistoryResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+
+    public GetCommissionPayoutHistoryQueryHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<GetCommissionPayoutHistoryResponseDto> Handle(GetCommissionPayoutHistoryQuery request, CancellationToken cancellationToken)
+    {
+        var query = _context.CommissionPayoutHistories
+            .AsNoTracking()
+            .AsQueryable();
+
+        // فیلترها
+        if (request.PayoutId.HasValue)
+        {
+            query = query.Where(x => x.UserCommissionPayoutId == request.PayoutId.Value);
+        }
+
+        if (request.UserId.HasValue)
+        {
+            query = query.Where(x => x.UserId == request.UserId.Value);
+        }
+
+        if (!string.IsNullOrEmpty(request.WeekNumber))
+        {
+            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+        }
+
+        query = query.ApplyOrder(sortBy: request.SortBy ?? "-Created");
+
+        var meta = await query.GetMetaData(request.PaginationState, cancellationToken);
+
+        var models = await query
+            .PaginatedListAsync(paginationState: request.PaginationState)
+            .Select(x => new GetCommissionPayoutHistoryResponseModel
+            {
+                Id = x.Id,
+                UserCommissionPayoutId = x.UserCommissionPayoutId,
+                UserId = x.UserId,
+                WeekNumber = x.WeekNumber,
+                AmountBefore = x.AmountBefore,
+                AmountAfter = x.AmountAfter,
+                OldStatus = x.OldStatus,
+                NewStatus = x.NewStatus,
+                Action = x.Action,
+                PerformedBy = x.PerformedBy,
+                Reason = x.Reason,
+                Created = x.Created
+            })
+            .ToListAsync(cancellationToken);
+
+        return new GetCommissionPayoutHistoryResponseDto
+        {
+            MetaData = meta,
+            Models = models
+        };
+    }
+}
@@ -0,0 +1,35 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetCommissionPayoutHistory;
+
+public class GetCommissionPayoutHistoryQueryValidator : AbstractValidator<GetCommissionPayoutHistoryQuery>
+{
+    public GetCommissionPayoutHistoryQueryValidator()
+    {
+        RuleFor(x => x.PayoutId)
+            .GreaterThan(0)
+            .WithMessage("شناسه پرداخت معتبر نیست")
+            .When(x => x.PayoutId.HasValue);
+
+        RuleFor(x => x.UserId)
+            .GreaterThan(0)
+            .WithMessage("شناسه کاربر معتبر نیست")
+            .When(x => x.UserId.HasValue);
+
+        RuleFor(x => x.WeekNumber)
+            .Matches(@"^\d{4}-W\d{2}$")
+            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد")
+            .When(x => !string.IsNullOrEmpty(x.WeekNumber));
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<GetCommissionPayoutHistoryQuery>.CreateWithOptions(
+                (GetCommissionPayoutHistoryQuery)model,
+                x => x.IncludeProperties(propertyName)));
+
+        if (result.IsValid)
+            return Array.Empty<string>();
+
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}
@@ -0,0 +1,23 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetCommissionPayoutHistory;
+
+public class GetCommissionPayoutHistoryResponseDto
+{
+    public MetaData MetaData { get; set; }
+    public List<GetCommissionPayoutHistoryResponseModel> Models { get; set; }
+}
+
+public class GetCommissionPayoutHistoryResponseModel
+{
+    public long Id { get; set; }
+    public long UserCommissionPayoutId { get; set; }
+    public long UserId { get; set; }
+    public string WeekNumber { get; set; } = string.Empty;
+    public long AmountBefore { get; set; }
+    public long AmountAfter { get; set; }
+    public CommissionPayoutStatus? OldStatus { get; set; }
+    public CommissionPayoutStatus NewStatus { get; set; }
+    public CommissionPayoutAction Action { get; set; }
+    public string? PerformedBy { get; set; }
+    public string? Reason { get; set; }
+    public DateTimeOffset Created { get; set; }
+}
@@ -0,0 +1,32 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserCommissionPayouts;
+
+/// <summary>
+/// Query برای دریافت پرداخت‌های کمیسیون کاربر
+/// </summary>
+public record GetUserCommissionPayoutsQuery : IRequest<GetUserCommissionPayoutsResponseDto>
+{
+    /// <summary>
+    /// شناسه کاربر (اختیاری)
+    /// </summary>
+    public long? UserId { get; init; }
+
+    /// <summary>
+    /// فیلتر وضعیت
+    /// </summary>
+    public CommissionPayoutStatus? Status { get; init; }
+
+    /// <summary>
+    /// شماره هفته (اختیاری)
+    /// </summary>
+    public string? WeekNumber { get; init; }
+
+    /// <summary>
+    /// مرتب‌سازی
+    /// </summary>
+    public string? SortBy { get; init; }
+
+    /// <summary>
+    /// Pagination
+    /// </summary>
+    public PaginationState? PaginationState { get; init; }
+}
@@ -0,0 +1,64 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserCommissionPayouts;
+
+public class GetUserCommissionPayoutsQueryHandler : IRequestHandler<GetUserCommissionPayoutsQuery, GetUserCommissionPayoutsResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+
+    public GetUserCommissionPayoutsQueryHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<GetUserCommissionPayoutsResponseDto> Handle(GetUserCommissionPayoutsQuery request, CancellationToken cancellationToken)
+    {
+        var query = _context.UserCommissionPayouts
+            .AsNoTracking()
+            .AsQueryable();
+
+        // فیلترها
+        if (request.UserId.HasValue)
+        {
+            query = query.Where(x => x.UserId == request.UserId.Value);
+        }
+
+        if (request.Status.HasValue)
+        {
+            query = query.Where(x => x.Status == request.Status.Value);
+        }
+
+        if (!string.IsNullOrEmpty(request.WeekNumber))
+        {
+            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+        }
+
+        query = query.ApplyOrder(sortBy: request.SortBy ?? "-Created");
+
+        var meta = await query.GetMetaData(request.PaginationState, cancellationToken);
+
+        var models = await query
+            .PaginatedListAsync(paginationState: request.PaginationState)
+            .Select(x => new GetUserCommissionPayoutsResponseModel
+            {
+                Id = x.Id,
+                UserId = x.UserId,
+                WeekNumber = x.WeekNumber,
+                WeeklyPoolId = x.WeeklyPoolId,
+                BalancesEarned = x.BalancesEarned,
+                ValuePerBalance = x.ValuePerBalance,
+                TotalAmount = x.TotalAmount,
+                Status = x.Status,
+                PaidAt = x.PaidAt,
+                WithdrawalMethod = x.WithdrawalMethod,
+                IbanNumber = x.IbanNumber,
+                WithdrawnAt = x.WithdrawnAt,
+                Created = x.Created
+            })
+            .ToListAsync(cancellationToken);
+
+        return new GetUserCommissionPayoutsResponseDto
+        {
+            MetaData = meta,
+            Models = models
+        };
+    }
+}
@@ -0,0 +1,35 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserCommissionPayouts;
+
+public class GetUserCommissionPayoutsQueryValidator : AbstractValidator<GetUserCommissionPayoutsQuery>
+{
+    public GetUserCommissionPayoutsQueryValidator()
+    {
+        RuleFor(x => x.UserId)
+            .GreaterThan(0)
+            .WithMessage("شناسه کاربر معتبر نیست")
+            .When(x => x.UserId.HasValue);
+
+        RuleFor(x => x.Status)
+            .IsInEnum()
+            .WithMessage("وضعیت معتبر نیست")
+            .When(x => x.Status.HasValue);
+
+        RuleFor(x => x.WeekNumber)
+            .Matches(@"^\d{4}-W\d{2}$")
+            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد")
+            .When(x => !string.IsNullOrEmpty(x.WeekNumber));
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<GetUserCommissionPayoutsQuery>.CreateWithOptions(
+                (GetUserCommissionPayoutsQuery)model,
+                x => x.IncludeProperties(propertyName)));
+
+        if (result.IsValid)
+            return Array.Empty<string>();
+
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}
@@ -0,0 +1,24 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserCommissionPayouts;
+
+public class GetUserCommissionPayoutsResponseDto
+{
+    public MetaData MetaData { get; set; }
+    public List<GetUserCommissionPayoutsResponseModel> Models { get; set; }
+}
+
+public class GetUserCommissionPayoutsResponseModel
+{
+    public long Id { get; set; }
+    public long UserId { get; set; }
+    public string WeekNumber { get; set; } = string.Empty;
+    public long WeeklyPoolId { get; set; }
+    public long BalancesEarned { get; set; }
+    public decimal ValuePerBalance { get; set; }
+    public long TotalAmount { get; set; }
+    public CommissionPayoutStatus Status { get; set; }
+    public DateTime? PaidAt { get; set; }
+    public WithdrawalMethod? WithdrawalMethod { get; set; }
+    public string? IbanNumber { get; set; }
+    public DateTime? WithdrawnAt { get; set; }
+    public DateTimeOffset Created { get; set; }
+}
@@ -0,0 +1,32 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserWeeklyBalances;
+
+/// <summary>
+/// Query برای دریافت تعادل‌های هفتگی کاربر
+/// </summary>
+public record GetUserWeeklyBalancesQuery : IRequest<GetUserWeeklyBalancesResponseDto>
+{
+    /// <summary>
+    /// شناسه کاربر (اختیاری)
+    /// </summary>
+    public long? UserId { get; init; }
+
+    /// <summary>
+    /// شماره هفته (اختیاری)
+    /// </summary>
+    public string? WeekNumber { get; init; }
+
+    /// <summary>
+    /// فقط موارد Expired نشده؟
+    /// </summary>
+    public bool? OnlyActive { get; init; }
+
+    /// <summary>
+    /// مرتب‌سازی
+    /// </summary>
+    public string? SortBy { get; init; }
+
+    /// <summary>
+    /// Pagination
+    /// </summary>
+    public PaginationState? PaginationState { get; init; }
+}
@@ -0,0 +1,61 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserWeeklyBalances;
+
+public class GetUserWeeklyBalancesQueryHandler : IRequestHandler<GetUserWeeklyBalancesQuery, GetUserWeeklyBalancesResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+
+    public GetUserWeeklyBalancesQueryHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<GetUserWeeklyBalancesResponseDto> Handle(GetUserWeeklyBalancesQuery request, CancellationToken cancellationToken)
+    {
+        var query = _context.NetworkWeeklyBalances
+            .AsNoTracking()
+            .AsQueryable();
+
+        // فیلترها
+        if (request.UserId.HasValue)
+        {
+            query = query.Where(x => x.UserId == request.UserId.Value);
+        }
+
+        if (!string.IsNullOrEmpty(request.WeekNumber))
+        {
+            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+        }
+
+        if (request.OnlyActive.HasValue && request.OnlyActive.Value)
+        {
+            query = query.Where(x => !x.IsExpired);
+        }
+
+        query = query.ApplyOrder(sortBy: request.SortBy ?? "-WeekNumber");
+
+        var meta = await query.GetMetaData(request.PaginationState, cancellationToken);
+
+        var models = await query
+            .PaginatedListAsync(paginationState: request.PaginationState)
+            .Select(x => new GetUserWeeklyBalancesResponseModel
+            {
+                Id = x.Id,
+                UserId = x.UserId,
+                WeekNumber = x.WeekNumber,
+                LeftLegBalances = x.LeftLegBalances,
+                RightLegBalances = x.RightLegBalances,
+                TotalBalances = x.TotalBalances,
+                WeeklyPoolContribution = x.WeeklyPoolContribution,
+                CalculatedAt = x.CalculatedAt,
+                IsExpired = x.IsExpired,
+                Created = x.Created
+            })
+            .ToListAsync(cancellationToken);
+
+        return new GetUserWeeklyBalancesResponseDto
+        {
+            MetaData = meta,
+            Models = models
+        };
+    }
+}
@@ -0,0 +1,30 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserWeeklyBalances;
+
+public class GetUserWeeklyBalancesQueryValidator : AbstractValidator<GetUserWeeklyBalancesQuery>
+{
+    public GetUserWeeklyBalancesQueryValidator()
+    {
+        RuleFor(x => x.UserId)
+            .GreaterThan(0)
+            .WithMessage("شناسه کاربر معتبر نیست")
+            .When(x => x.UserId.HasValue);
+
+        RuleFor(x => x.WeekNumber)
+            .Matches(@"^\d{4}-W\d{2}$")
+            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد")
+            .When(x => !string.IsNullOrEmpty(x.WeekNumber));
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<GetUserWeeklyBalancesQuery>.CreateWithOptions(
+                (GetUserWeeklyBalancesQuery)model,
+                x => x.IncludeProperties(propertyName)));
+
+        if (result.IsValid)
+            return Array.Empty<string>();
+
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}
@@ -0,0 +1,21 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserWeeklyBalances;
+
+public class GetUserWeeklyBalancesResponseDto
+{
+    public MetaData MetaData { get; set; }
+    public List<GetUserWeeklyBalancesResponseModel> Models { get; set; }
+}
+
+public class GetUserWeeklyBalancesResponseModel
+{
+    public long Id { get; set; }
+    public long UserId { get; set; }
+    public string WeekNumber { get; set; } = string.Empty;
+    public int LeftLegBalances { get; set; }
+    public int RightLegBalances { get; set; }
+    public int TotalBalances { get; set; }
+    public long WeeklyPoolContribution { get; set; }
+    public DateTime? CalculatedAt { get; set; }
+    public bool IsExpired { get; set; }
+    public DateTimeOffset Created { get; set; }
+}
@@ -0,0 +1,12 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPool;
+
+/// <summary>
+/// Query برای دریافت استخر کمیسیون هفتگی
+/// </summary>
+public record GetWeeklyCommissionPoolQuery : IRequest<WeeklyCommissionPoolDto?>
+{
+    /// <summary>
+    /// شماره هفته
+    /// </summary>
+    public string WeekNumber { get; init; } = string.Empty;
+}
@@ -0,0 +1,32 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPool;
+
+public class GetWeeklyCommissionPoolQueryHandler : IRequestHandler<GetWeeklyCommissionPoolQuery, WeeklyCommissionPoolDto?>
+{
+    private readonly IApplicationDbContext _context;
+
+    public GetWeeklyCommissionPoolQueryHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<WeeklyCommissionPoolDto?> Handle(GetWeeklyCommissionPoolQuery request, CancellationToken cancellationToken)
+    {
+        var pool = await _context.WeeklyCommissionPools
+            .AsNoTracking()
+            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Select(x => new WeeklyCommissionPoolDto
+            {
+                Id = x.Id,
+                WeekNumber = x.WeekNumber,
+                TotalPoolAmount = x.TotalPoolAmount,
+                TotalBalances = x.TotalBalances,
+                ValuePerBalance = x.ValuePerBalance,
+                IsCalculated = x.IsCalculated,
+                CalculatedAt = x.CalculatedAt,
+                Created = x.Created
+            })
+            .FirstOrDefaultAsync(cancellationToken);
+
+        return pool;
+    }
+}
@@ -0,0 +1,26 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPool;
+
+public class GetWeeklyCommissionPoolQueryValidator : AbstractValidator<GetWeeklyCommissionPoolQuery>
+{
+    public GetWeeklyCommissionPoolQueryValidator()
+    {
+        RuleFor(x => x.WeekNumber)
+            .NotEmpty()
+            .WithMessage("شماره هفته نمی‌تواند خالی باشد")
+            .Matches(@"^\d{4}-W\d{2}$")
+            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد");
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<GetWeeklyCommissionPoolQuery>.CreateWithOptions(
+                (GetWeeklyCommissionPoolQuery)model,
+                x => x.IncludeProperties(propertyName)));
+
+        if (result.IsValid)
+            return Array.Empty<string>();
+
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}
@@ -0,0 +1,16 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPool;
+
+/// <summary>
+/// DTO برای استخر کمیسیون هفتگی
+/// </summary>
+public class WeeklyCommissionPoolDto
+{
+    public long Id { get; set; }
+    public string WeekNumber { get; set; } = string.Empty;
+    public long TotalPoolAmount { get; set; }
+    public long TotalBalances { get; set; }
+    public decimal ValuePerBalance { get; set; }
+    public bool IsCalculated { get; set; }
+    public DateTime? CalculatedAt { get; set; }
+    public DateTimeOffset Created { get; set; }
+}