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

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserWeeklyBalances/GetUserWeeklyBalancesQuery.cs

@@ -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; }
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserWeeklyBalances/GetUserWeeklyBalancesQueryHandler.cs

@@ -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
+        };
+    }
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserWeeklyBalances/GetUserWeeklyBalancesQueryValidator.cs

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

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserWeeklyBalances/GetUserWeeklyBalancesResponseDto.cs

@@ -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; }
+}