feat: implement commission calculation strategy with ORM and SP options

src/CMSMicroservice.Application/CMSMicroservice.Application.csproj

@@ -12,7 +12,10 @@
     <PackageReference Include="MediatR.Extensions.Microsoft.DependencyInjection" Version="11.0.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.11" />
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="9.0.11" />
+    <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.4.0" />
     <PackageReference Include="System.Linq.Dynamic.Core" Version="1.6.10" />
+      <PackageReference Include="DateTimeConverterCL" Version="1.0.0" />
+
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\CMSMicroservice.Domain\CMSMicroservice.Domain.csproj" />

src/CMSMicroservice.Application/CityCQ/Queries/GetAllCitiesByFilter/GetAllCitiesByFilterQuery.cs

@@ -0,0 +1,42 @@
+namespace CMSMicroservice.Application.CityCQ.Queries.GetAllCitiesByFilter;
+
+public record GetAllCitiesByFilterQuery : IRequest<GetAllCitiesByFilterResponseDto>
+{
+    /// <summary>
+    /// موقعیت صفحه بندی
+    /// </summary>
+    public PaginationState? PaginationState { get; init; }
+    
+    /// <summary>
+    /// مرتب سازی بر اساس
+    /// </summary>
+    public string? SortBy { get; init; }
+    
+    /// <summary>
+    /// فیلتر
+    /// </summary>
+    public GetAllCitiesByFilterFilter? Filter { get; init; }
+}
+
+public class GetAllCitiesByFilterFilter
+{
+    /// <summary>
+    /// شناسه
+    /// </summary>
+    public long? Id { get; set; }
+    
+    /// <summary>
+    /// نام شهر (Contains)
+    /// </summary>
+    public string? Name { get; set; }
+    
+    /// <summary>
+    /// نام بومی شهر (Contains)
+    /// </summary>
+    public string? Native { get; set; }
+    
+    /// <summary>
+    /// شناسه استان
+    /// </summary>
+    public long? StateId { get; set; }
+}

src/CMSMicroservice.Application/CityCQ/Queries/GetAllCitiesByFilter/GetAllCitiesByFilterQueryHandler.cs

@@ -0,0 +1,43 @@
+using CMSMicroservice.Application.Common.Interfaces;
+using Microsoft.EntityFrameworkCore;
+
+namespace CMSMicroservice.Application.CityCQ.Queries.GetAllCitiesByFilter;
+
+public class GetAllCitiesByFilterQueryHandler : IRequestHandler<GetAllCitiesByFilterQuery, GetAllCitiesByFilterResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+
+    public GetAllCitiesByFilterQueryHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<GetAllCitiesByFilterResponseDto> Handle(
+        GetAllCitiesByFilterQuery request, 
+        CancellationToken cancellationToken)
+    {
+        var query = _context.Cities
+            .Include(c => c.State)
+            .ApplyOrder(sortBy: request.SortBy)
+            .AsNoTracking()
+            .AsQueryable();
+            
+        if (request.Filter is not null)
+        {
+            query = query
+                .Where(x => request.Filter.Id == null || x.Id == request.Filter.Id)
+                .Where(x => request.Filter.Name == null || x.Name.Contains(request.Filter.Name))
+                .Where(x => request.Filter.Native == null || x.Native.Contains(request.Filter.Native))
+                .Where(x => request.Filter.StateId == null || x.StateId == request.Filter.StateId);
+        }
+        
+        return new GetAllCitiesByFilterResponseDto
+        {
+            MetaData = await query.GetMetaData(request.PaginationState, cancellationToken),
+            Models = await query
+                .PaginatedListAsync(paginationState: request.PaginationState)
+                .ProjectToType<GetAllCitiesByFilterResponseModel>()
+                .ToListAsync(cancellationToken)
+        };
+    }
+}

src/CMSMicroservice.Application/CityCQ/Queries/GetAllCitiesByFilter/GetAllCitiesByFilterQueryValidator.cs

@@ -0,0 +1,20 @@
+using FluentValidation;
+
+namespace CMSMicroservice.Application.CityCQ.Queries.GetAllCitiesByFilter;
+
+public class GetAllCitiesByFilterQueryValidator : AbstractValidator<GetAllCitiesByFilterQuery>
+{
+    public GetAllCitiesByFilterQueryValidator()
+    {
+        // Validation rules اگر نیاز باشد
+    }
+    
+    public async Task<bool> Validate(object model, string propertyName)
+    {
+        var result = await ValidateAsync(
+            ValidationContext<GetAllCitiesByFilterQuery>.CreateWithOptions(
+                (GetAllCitiesByFilterQuery)model, 
+                x => x.IncludeProperties(propertyName)));
+        return result.IsValid;
+    }
+}

src/CMSMicroservice.Application/CityCQ/Queries/GetAllCitiesByFilter/GetAllCitiesByFilterResponseDto.cs

@@ -0,0 +1,62 @@
+namespace CMSMicroservice.Application.CityCQ.Queries.GetAllCitiesByFilter;
+
+public class GetAllCitiesByFilterResponseDto
+{
+    /// <summary>
+    /// متادیتا
+    /// </summary>
+    public MetaData MetaData { get; set; } = null!;
+    
+    /// <summary>
+    /// مدل خروجی
+    /// </summary>
+    public List<GetAllCitiesByFilterResponseModel>? Models { get; set; }
+}
+
+public class GetAllCitiesByFilterResponseModel
+{
+    /// <summary>
+    /// شناسه
+    /// </summary>
+    public long Id { get; set; }
+    
+    /// <summary>
+    /// شناسه خارجی
+    /// </summary>
+    public long ExternalId { get; set; }
+    
+    /// <summary>
+    /// نام شهر
+    /// </summary>
+    public string Name { get; set; } = null!;
+    
+    /// <summary>
+    /// نام بومی شهر (فارسی)
+    /// </summary>
+    public string Native { get; set; } = null!;
+    
+    /// <summary>
+    /// عرض جغرافیایی
+    /// </summary>
+    public string Latitude { get; set; } = null!;
+    
+    /// <summary>
+    /// طول جغرافیایی
+    /// </summary>
+    public string Longitude { get; set; } = null!;
+    
+    /// <summary>
+    /// شناسه استان
+    /// </summary>
+    public long StateId { get; set; }
+    
+    /// <summary>
+    /// نام استان
+    /// </summary>
+    public string StateName { get; set; } = null!;
+    
+    /// <summary>
+    /// نام بومی استان
+    /// </summary>
+    public string StateNative { get; set; } = null!;
+}

src/CMSMicroservice.Application/ClubFeatureCQ/Queries/GetUserClubFeatures/GetUserClubFeaturesQueryHandler.cs

@@ -31,8 +31,11 @@ public class GetUserClubFeaturesQueryHandler : IRequestHandler<GetUserClubFeatur
                 FeatureDescription = ucf.ClubFeature.Description,
                 IsActive = ucf.IsActive,
                 GrantedAt = ucf.GrantedAt,
-                Notes = ucf.Notes
+                Notes = ucf.Notes,
+                SortOrder = ucf.ClubFeature.SortOrder,
+                CreatedAt = ucf.Created
             })
+            .OrderBy(ucf => ucf.SortOrder)
             .ToListAsync(cancellationToken);
 
         return userClubFeatures;

src/CMSMicroservice.Application/ClubFeatureCQ/Queries/GetUserClubFeatures/UserClubFeatureDto.cs

@@ -31,7 +31,7 @@ public class UserClubFeatureDto
     public string FeatureTitle { get; set; }
 
     /// <summary>
-    /// توضیحات ویژگی
+    /// توضیحات کوتاه ویژگی
     /// </summary>
     public string? FeatureDescription { get; set; }
 
@@ -46,7 +46,17 @@ public class UserClubFeatureDto
     public DateTime GrantedAt { get; set; }
 
     /// <summary>
-    /// یادداشت
+    /// یادداشت (برای نمایش در مدال جزئیات)
     /// </summary>
     public string? Notes { get; set; }
+    
+    /// <summary>
+    /// ترتیب نمایش
+    /// </summary>
+    public int SortOrder { get; set; }
+    
+    /// <summary>
+    /// تاریخ ایجاد رکورد
+    /// </summary>
+    public DateTime CreatedAt { get; set; }
 }

src/CMSMicroservice.Application/ClubMembershipCQ/Commands/AcceptClubMembershipContract/AcceptClubMembershipContractCommand.cs

@@ -0,0 +1,48 @@
+namespace CMSMicroservice.Application.ClubMembershipCQ.Commands.AcceptClubMembershipContract;
+
+/// <summary>
+/// Command برای پذیرش قرارداد باشگاه مشتریان
+/// </summary>
+public record AcceptClubMembershipContractCommand : IRequest<AcceptClubMembershipContractResponseDto>
+{
+    /// <summary>
+    /// شناسه کاربر
+    /// </summary>
+    public long UserId { get; init; }
+    
+    /// <summary>
+    /// کد OTP برای تایید
+    /// </summary>
+    public string OtpCode { get; init; }
+    
+    /// <summary>
+    /// شناسه یکتای امضا (GUID)
+    /// </summary>
+    public string SignGuid { get; init; }
+    
+    /// <summary>
+    /// محتوای HTML قرارداد
+    /// </summary>
+    public string ContractHtml { get; init; }
+}
+
+/// <summary>
+/// DTO پاسخ پذیرش قرارداد باشگاه مشتریان
+/// </summary>
+public class AcceptClubMembershipContractResponseDto
+{
+    /// <summary>
+    /// آیا عملیات موفق بود؟
+    /// </summary>
+    public bool Success { get; set; }
+    
+    /// <summary>
+    /// پیام نتیجه
+    /// </summary>
+    public string Message { get; set; }
+    
+    /// <summary>
+    /// شناسه قرارداد ثبت شده
+    /// </summary>
+    public long ContractId { get; set; }
+}

src/CMSMicroservice.Application/ClubMembershipCQ/Commands/AcceptClubMembershipContract/AcceptClubMembershipContractCommandHandler.cs

@@ -0,0 +1,196 @@
+using CMSMicroservice.Application.Common.Exceptions;
+using CMSMicroservice.Domain.Entities;
+using CMSMicroservice.Domain.Enums;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Logging;
+
+namespace CMSMicroservice.Application.ClubMembershipCQ.Commands.AcceptClubMembershipContract;
+
+/// <summary>
+/// Handler برای پذیرش قرارداد باشگاه مشتریان
+/// این handler:
+/// 1. کد OTP را تایید می‌کند
+/// 2. قرارداد را در جدول UserContract ثبت می‌کند
+/// 3. باشگاه مشتری را فعال می‌کند (IsActive = true)
+/// </summary>
+public class AcceptClubMembershipContractCommandHandler 
+    : IRequestHandler<AcceptClubMembershipContractCommand, AcceptClubMembershipContractResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+    private readonly IConfiguration _cfg;
+    private readonly IHashService _hashService;
+    private readonly ILogger<AcceptClubMembershipContractCommandHandler> _logger;
+    
+    private const int MaxAttempts = 5;
+    private const string OtpPurpose = "signClubContract";
+
+    public AcceptClubMembershipContractCommandHandler(
+        IApplicationDbContext context,
+        IConfiguration cfg,
+        IHashService hashService,
+        ILogger<AcceptClubMembershipContractCommandHandler> logger)
+    {
+        _context = context;
+        _cfg = cfg;
+        _hashService = hashService;
+        _logger = logger;
+    }
+
+    public async Task<AcceptClubMembershipContractResponseDto> Handle(
+        AcceptClubMembershipContractCommand request,
+        CancellationToken cancellationToken)
+    {
+        _logger.LogInformation(
+            "Processing club membership contract for UserId: {UserId}",
+            request.UserId
+        );
+
+        // 1. دریافت کاربر
+        var user = await _context.Users
+            .Include(u => u.ClubMembership)
+            .FirstOrDefaultAsync(u => u.Id == request.UserId, cancellationToken);
+
+        if (user == null)
+        {
+            _logger.LogWarning("User not found: {UserId}", request.UserId);
+            throw new NotFoundException(nameof(User), request.UserId);
+        }
+
+        // 2. بررسی خرید پکیج
+        if (user.PackagePurchaseMethod == PackagePurchaseMethod.None)
+        {
+            return new AcceptClubMembershipContractResponseDto
+            {
+                Success = false,
+                Message = "برای امضای قرارداد باشگاه مشتریان ابتدا باید پکیج پایه را خریداری کنید"
+            };
+        }
+
+        // 3. بررسی عدم فعال بودن قبلی باشگاه
+        if (user.ClubMembership?.IsActive == true)
+        {
+            return new AcceptClubMembershipContractResponseDto
+            {
+                Success = false,
+                Message = "شما قبلاً عضو باشگاه مشتریان شده‌اید"
+            };
+        }
+
+        // 4. تایید OTP
+        var otpResult = await VerifyOtpAsync(user.Mobile, request.OtpCode, cancellationToken);
+        if (!otpResult.Success)
+        {
+            return new AcceptClubMembershipContractResponseDto
+            {
+                Success = false,
+                Message = otpResult.Message
+            };
+        }
+
+        // 5. ثبت قرارداد در جدول UserContract
+        var contract = await _context.Contracts
+            .FirstOrDefaultAsync(c => c.Type == ContractType.ClubMembership, cancellationToken);
+
+        if (contract == null)
+        {
+            // اگر قرارداد وجود ندارد، یک قرارداد پیش‌فرض ایجاد کنید
+            contract = new Contract
+            {
+                Title = "قرارداد باشگاه مشتریان",
+                Description = "قوانین و مقررات باشگاه مشتریان کارابازار",
+                HtmlContent = request.ContractHtml,
+                Type = ContractType.ClubMembership
+            };
+            await _context.Contracts.AddAsync(contract, cancellationToken);
+            await _context.SaveChangesAsync(cancellationToken);
+        }
+
+        var userContract = new UserContract
+        {
+            UserId = user.Id,
+            ContractId = contract.Id,
+            SignGuid = request.SignGuid,
+            SignedPdfFile = request.ContractHtml
+        };
+        await _context.UserContracts.AddAsync(userContract, cancellationToken);
+
+        // 6. فعال‌سازی باشگاه مشتریان
+        if (user.ClubMembership == null)
+        {
+            user.ClubMembership = new Domain.Entities.Club.ClubMembership
+            {
+                UserId = user.Id,
+                IsActive = true,
+                ActivatedAt = DateTime.Now,
+                InitialContribution = 56_000_000,
+                GiftValue = 25_200_000,
+                PurchaseMethod = user.PackagePurchaseMethod
+            };
+            await _context.ClubMemberships.AddAsync(user.ClubMembership, cancellationToken);
+        }
+        else
+        {
+            user.ClubMembership.IsActive = true;
+            user.ClubMembership.ActivatedAt = DateTime.Now;
+            _context.ClubMemberships.Update(user.ClubMembership);
+        }
+
+        await _context.SaveChangesAsync(cancellationToken);
+
+        _logger.LogInformation(
+            "Club membership contract accepted and activated for UserId: {UserId}, ContractId: {ContractId}",
+            request.UserId,
+            userContract.Id
+        );
+
+        return new AcceptClubMembershipContractResponseDto
+        {
+            Success = true,
+            Message = "قرارداد باشگاه مشتریان با موفقیت ثبت شد و عضویت شما فعال گردید",
+            ContractId = userContract.Id
+        };
+    }
+
+    private async Task<(bool Success, string Message)> VerifyOtpAsync(
+        string mobile,
+        string code,
+        CancellationToken cancellationToken)
+    {
+        var normalizedMobile = mobile.NormalizeIranMobile();
+        var now = DateTime.Now;
+
+        var otp = await _context.OtpTokens
+            .Where(o => o.Mobile == normalizedMobile 
+                     && o.Purpose == OtpPurpose 
+                     && !o.IsUsed 
+                     && o.ExpiresAt > now)
+            .OrderByDescending(o => o.Created)
+            .FirstOrDefaultAsync(cancellationToken);
+
+        if (otp == null)
+        {
+            return (false, "کد تایید پیدا نشد یا منقضی شده است");
+        }
+
+        if (otp.Attempts >= MaxAttempts)
+        {
+            return (false, "تعداد تلاش‌ها بیش از حد مجاز است. لطفاً کد جدید دریافت کنید");
+        }
+
+        otp.Attempts++;
+
+        var secret = _cfg["Otp:Secret"] ?? throw new InvalidOperationException("Otp:Secret not configured");
+        
+        if (!_hashService.VerifyHmacSha256Hex(code, otp.CodeHash, secret))
+        {
+            await _context.SaveChangesAsync(cancellationToken);
+            return (false, "کد تایید نادرست است");
+        }
+
+        // کد صحیح است - علامت‌گذاری به عنوان استفاده شده
+        otp.IsUsed = true;
+        await _context.SaveChangesAsync(cancellationToken);
+
+        return (true, "کد تایید صحیح است");
+    }
+}

src/CMSMicroservice.Application/ClubMembershipCQ/Commands/AcceptClubMembershipContract/AcceptClubMembershipContractCommandValidator.cs

@@ -0,0 +1,25 @@
+namespace CMSMicroservice.Application.ClubMembershipCQ.Commands.AcceptClubMembershipContract;
+
+public class AcceptClubMembershipContractCommandValidator : AbstractValidator<AcceptClubMembershipContractCommand>
+{
+    public AcceptClubMembershipContractCommandValidator()
+    {
+        RuleFor(x => x.UserId)
+            .GreaterThan(0)
+            .WithMessage("شناسه کاربر الزامی است");
+
+        RuleFor(x => x.OtpCode)
+            .NotEmpty()
+            .WithMessage("کد تایید الزامی است")
+            .Length(6)
+            .WithMessage("کد تایید باید ۶ رقم باشد");
+
+        RuleFor(x => x.SignGuid)
+            .NotEmpty()
+            .WithMessage("شناسه امضا الزامی است");
+
+        RuleFor(x => x.ContractHtml)
+            .NotEmpty()
+            .WithMessage("محتوای قرارداد الزامی است");
+    }
+}

src/CMSMicroservice.Application/ClubMembershipCQ/Commands/ActivateClubMembership/ActivateClubMembershipCommandHandler.cs

@@ -17,15 +17,18 @@ public class ActivateClubMembershipCommandHandler : IRequestHandler<ActivateClub
 {
     private readonly IApplicationDbContext _context;
     private readonly ICurrentUserService _currentUser;
+    private readonly IWeekDefinitionRepository _weekRepository;
     private readonly ILogger<ActivateClubMembershipCommandHandler> _logger;
 
     public ActivateClubMembershipCommandHandler(
         IApplicationDbContext context,
         ICurrentUserService currentUser,
+        IWeekDefinitionRepository weekRepository,
         ILogger<ActivateClubMembershipCommandHandler> logger)
     {
         _context = context;
         _currentUser = currentUser;
+        _weekRepository = weekRepository;
         _logger = logger;
     }
 
@@ -250,16 +253,16 @@ public class ActivateClubMembershipCommandHandler : IRequestHandler<ActivateClub
             await _context.SaveChangesAsync(cancellationToken);
 
             // ⭐ 8. اضافه کردن مبلغ به Pool هفته جاری
-            var currentWeekNumber = GetCurrentWeekNumber();
+            var currentWeekDefinitionId = GetCurrentWeekDefinitionId();
             var weeklyPool = await _context.WeeklyCommissionPools
-                .FirstOrDefaultAsync(p => p.WeekNumber == currentWeekNumber, cancellationToken);
+                .FirstOrDefaultAsync(p => p.WeekDefinitionId == currentWeekDefinitionId, cancellationToken);
 
             if (weeklyPool == null)
             {
                 // ایجاد Pool جدید برای این هفته
                 weeklyPool = new WeeklyCommissionPool
                 {
-                    WeekNumber = currentWeekNumber,
+                    WeekDefinitionId = currentWeekDefinitionId,
                     TotalPoolAmount = activationFeeValue, // مبلغ هدیه به Pool اضافه میشه
                     TotalBalances = 0, // در CalculateWeeklyBalances محاسبه میشه
                     ValuePerBalance = 0, // در CalculateWeeklyCommissionPool محاسبه میشه
@@ -270,8 +273,8 @@ public class ActivateClubMembershipCommandHandler : IRequestHandler<ActivateClub
                 await _context.WeeklyCommissionPools.AddAsync(weeklyPool, cancellationToken);
                 
                 _logger.LogInformation(
-                    "Created new WeeklyCommissionPool for {WeekNumber} with initial amount: {Amount}",
-                    currentWeekNumber,
+                    "Created new WeeklyCommissionPool for WeekDefinitionId={WeekDefinitionId} with initial amount: {Amount}",
+                    currentWeekDefinitionId,
                     giftValue
                 );
             }
@@ -282,9 +285,9 @@ public class ActivateClubMembershipCommandHandler : IRequestHandler<ActivateClub
                 _context.WeeklyCommissionPools.Update(weeklyPool);
                 
                 _logger.LogInformation(
-                    "Added {Amount} to existing WeeklyCommissionPool for {WeekNumber}. New total: {NewTotal}",
+                    "Added {Amount} to existing WeeklyCommissionPool for WeekDefinitionId={WeekDefinitionId}. New total: {NewTotal}",
                     activationFeeValue,
-                    currentWeekNumber,
+                    currentWeekDefinitionId,
                     weeklyPool.TotalPoolAmount
                 );
             }
@@ -346,13 +349,15 @@ public class ActivateClubMembershipCommandHandler : IRequestHandler<ActivateClub
     }
 
     /// <summary>
-    /// دریافت شماره هفته جاری (مثال: "2025-W50")
+    /// دریافت شناسه تعریف هفته جاری
     /// </summary>
-    private string GetCurrentWeekNumber()
+    private long GetCurrentWeekDefinitionId()
     {
-        var now = DateTime.Now;
-        var calendar = CultureInfo.CurrentCulture.Calendar;
-        var weekOfYear = calendar.GetWeekOfYear(now, CalendarWeekRule.FirstDay, DayOfWeek.Saturday);
-        return $"{now.Year}-W{weekOfYear:D2}";
+        var week = _weekRepository.GetCurrentWeek();
+        if (week == null)
+        {
+            throw new InvalidOperationException("هفته جاری در سیستم تعریف نشده است");
+        }
+        return week.Id;
     }
 }

src/CMSMicroservice.Application/ClubMembershipCQ/Queries/GetAllClubMemberships/GetAllClubMembershipsQueryHandler.cs

@@ -12,6 +12,7 @@ public class GetAllClubMembershipsQueryHandler : IRequestHandler<GetAllClubMembe
     public async Task<GetAllClubMembershipsResponseDto> Handle(GetAllClubMembershipsQuery request, CancellationToken cancellationToken)
     {
         var query = _context.ClubMemberships
+            .Include(x => x.User)
             .ApplyOrder(sortBy: request.SortBy)
             .AsNoTracking()
             .AsQueryable();
@@ -33,6 +34,7 @@ public class GetAllClubMembershipsQueryHandler : IRequestHandler<GetAllClubMembe
             {
                 Id = x.Id,
                 UserId = x.UserId,
+                UserName = x.User != null ? $"{x.User.FirstName} {x.User.LastName}" : string.Empty,
                 IsActive = x.IsActive,
                 ActivatedAt = x.ActivatedAt,
                 InitialContribution = x.InitialContribution,

src/CMSMicroservice.Application/ClubMembershipCQ/Queries/GetAllClubMemberships/GetAllClubMembershipsResponseDto.cs

@@ -10,6 +10,7 @@ public class GetAllClubMembershipsResponseModel
 {
     public long Id { get; set; }
     public long UserId { get; set; }
+    public string UserName { get; set; } = string.Empty;
     public bool IsActive { get; set; }
     public DateTime? ActivatedAt { get; set; }
     public long InitialContribution { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/CalculateWeeklyBalancesCommand.cs

@@ -8,7 +8,7 @@ public record CalculateWeeklyBalancesCommand : IRequest<int>
     /// <summary>
     /// شماره هفته (فرمت: YYYY-Www مثل 2025-W01)
     /// </summary>
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; }
 
     /// <summary>
     /// آیا محاسبه مجدد انجام شود؟ (پیش‌فرض: false)

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/CalculateWeeklyBalancesCommandHandler.cs

@@ -3,22 +3,33 @@ namespace CMSMicroservice.Application.CommissionCQ.Commands.CalculateWeeklyBalan
 public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWeeklyBalancesCommand, int>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekRepository;
 
-    public CalculateWeeklyBalancesCommandHandler(IApplicationDbContext context)
+    public CalculateWeeklyBalancesCommandHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekRepository)
     {
         _context = context;
+        _weekRepository = weekRepository;
     }
 
     public async Task<int> Handle(CalculateWeeklyBalancesCommand request, CancellationToken cancellationToken)
     {
+       
+        var regorianWeekNumber = _weekRepository.GetGregorianWeekNumber(request.WeekDefinitionId);
+        if (regorianWeekNumber == null)
+        {
+            throw new InvalidOperationException($"هفته {request.WeekDefinitionId} در سیستم تعریف نشده است");
+        }
+        
         // بررسی وجود محاسبه قبلی
         var existingBalances = await _context.NetworkWeeklyBalances
-            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId)
             .ToListAsync(cancellationToken);
 
         if (existingBalances.Any() && !request.ForceRecalculate)
         {
-            throw new InvalidOperationException($"تعادل‌های هفته {request.WeekNumber} قبلاً محاسبه شده است. برای محاسبه مجدد از ForceRecalculate استفاده کنید");
+            throw new InvalidOperationException($"تعادل‌های هفته {request.WeekDefinitionId} قبلاً محاسبه شده است. برای محاسبه مجدد از ForceRecalculate استفاده کنید");
         }
 
         // حذف محاسبات قبلی در صورت ForceRecalculate
@@ -43,16 +54,22 @@ public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWe
             .ToListAsync(cancellationToken);
 
         // دریافت باقیمانده‌های هفته قبل
-        var previousWeekNumber = GetPreviousWeekNumber(request.WeekNumber);
-        var previousWeekCarryovers = await _context.NetworkWeeklyBalances
-            .Where(x => x.WeekNumber == previousWeekNumber)
-            .Select(x => new
+        var previousWeekDefinitionId = GetPreviousWeekDefinitionId(request.WeekDefinitionId);
+        Dictionary<long, (int LeftLegRemainder, int RightLegRemainder)> previousWeekCarryovers;
+        
+        if (previousWeekDefinitionId.HasValue)
         {
-                x.UserId,
-                x.LeftLegRemainder,
-                x.RightLegRemainder
-            })
-            .ToDictionaryAsync(x => x.UserId, cancellationToken);
+            previousWeekCarryovers = await _context.NetworkWeeklyBalances
+                .Where(x => x.WeekDefinitionId == previousWeekDefinitionId.Value)
+                .ToDictionaryAsync(
+                    x => x.UserId, 
+                    x => (x.LeftLegRemainder, x.RightLegRemainder), 
+                    cancellationToken);
+        }
+        else
+        {
+            previousWeekCarryovers = new Dictionary<long, (int, int)>();
+        }
 
         var balancesList = new List<NetworkWeeklyBalance>();
         var calculatedAt = DateTime.Now;
@@ -85,8 +102,8 @@ public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWe
             }
 
             // محاسبه تعداد اعضای جدید در این هفته (تا maxNetworkLevel لول پایین‌تر)
-            var leftNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Left, request.WeekNumber, maxNetworkLevel, cancellationToken);
-            var rightNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Right, request.WeekNumber, maxNetworkLevel, cancellationToken);
+            var leftNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Left, request.WeekDefinitionId, maxNetworkLevel, cancellationToken);
+            var rightNewMembers = await CountNewMembersInLeg(user.Id, NetworkLeg.Right, request.WeekDefinitionId, maxNetworkLevel, cancellationToken);
 
             // محاسبه مجموع هر پا (جدید + باقیمانده)
             var leftTotal = leftNewMembers + leftCarryover;
@@ -124,7 +141,7 @@ public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWe
             var balance = new NetworkWeeklyBalance
             {
                 UserId = user.Id,
-                WeekNumber = request.WeekNumber,
+                WeekDefinitionId = request.WeekDefinitionId,
                 
                 // اطلاعات جدید
                 LeftLegNewMembers = leftNewMembers,
@@ -189,36 +206,30 @@ public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWe
     }
 
     /// <summary>
-    /// شماره هفته قبل را محاسبه می‌کند
+    /// شناسه هفته قبل را از WeekDefinitionRepository می‌گیرد
     /// </summary>
-    private string GetPreviousWeekNumber(string currentWeekNumber)
+    private long? GetPreviousWeekDefinitionId(long currentWeekDefinitionId)
     {
-        // مثال: "2025-W48" -> "2025-W47"
-        var parts = currentWeekNumber.Split('-');
-        var year = int.Parse(parts[0]);
-        var week = int.Parse(parts[1].Replace("W", ""));
+        var currentWeekNumber = _weekRepository.GetGregorianWeekNumber(currentWeekDefinitionId);
+        if (currentWeekNumber == null) return null;
         
-        week--;
-        if (week < 1)
-        {
-            year--;
-            week = 52; // یا 53 بسته به سال
-        }
+        var previousWeekNumber = _weekRepository.GetPreviousWeekNumber(currentWeekNumber);
+        if (previousWeekNumber == null) return null;
         
-        return $"{year}-W{week:D2}";
+        return _weekRepository.GetWeekDefinitionId(previousWeekNumber);
     }
 
     /// <summary>
     /// شمارش اعضای جدیدی که در این هفته به یک پا اضافه شدند
     /// تا maxLevel لول پایین‌تر شمارش می‌شود
     /// </summary>
-    private async Task<int> CountNewMembersInLeg(long userId, NetworkLeg leg, string weekNumber, int maxLevel, CancellationToken cancellationToken)
+    private async Task<int> CountNewMembersInLeg(long userId, NetworkLeg leg, long WeekDefinitionId, int maxLevel, CancellationToken cancellationToken)
     {
         // تبدیل WeekNumber به بازه تاریخی
-        var (startDate, endDate) = GetWeekDateRange(weekNumber);
+       var startDateEndDate =_weekRepository.GetWeekDateRange(WeekDefinitionId);
 
         // شمارش تمام اعضای زیرمجموعه که در این هفته فعال شدند (تا maxLevel لول)
-        var count = await CountNewMembersRecursive(userId, leg, startDate, endDate, 0, maxLevel, cancellationToken);
+        var count = await CountNewMembersRecursive(userId, leg, startDateEndDate.Value.startDate, startDateEndDate.Value.endDate, 0, maxLevel, cancellationToken);
         
         return count;
     }
@@ -270,27 +281,31 @@ public class CalculateWeeklyBalancesCommandHandler : IRequestHandler<CalculateWe
     }
 
     /// <summary>
-    /// تبدیل شماره هفته به بازه تاریخی
+    /// تبدیل شماره هفته به بازه تاریخی از WeekDefinitionRepository
     /// </summary>
-    private (DateTime startDate, DateTime endDate) GetWeekDateRange(string weekNumber)
-    {
-        // مثال: "2025-W48"
-        var parts = weekNumber.Split('-');
-        var year = int.Parse(parts[0]);
-        var week = int.Parse(parts[1].Replace("W", ""));
-
-        // محاسبه اولین شنبه سال
-        var jan1 = new DateTime(year, 1, 1);
-        var jan1DayOfWeek = (int)jan1.DayOfWeek;
-        // اگر 1 ژانویه شنبه باشد: offset=0، اگر یکشنبه: offset=6، دوشنبه: offset=5، ...
-        var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
-        var firstSaturday = jan1.AddDays(daysToFirstSaturday);
-        
-        var weekStart = firstSaturday.AddDays((week - 1) * 7);
-        var weekEnd = weekStart.AddDays(6).AddHours(23).AddMinutes(59).AddSeconds(59);
-
-        return (weekStart, weekEnd);
-    }
+    // private (DateTime startDate, DateTime endDate) GetWeekDateRange(string weekNumber)
+    // {
+    //     var dateRange = _weekRepository.GetWeekDateRange(weekNumber);
+    //     if (dateRange.HasValue)
+    //     {
+    //         return dateRange.Value;
+    //     }
+    //     
+    //     // Fallback: محاسبه دستی اگر در کش نبود
+    //     var parts = weekNumber.Split('-');
+    //     var year = int.Parse(parts[0]);
+    //     var week = int.Parse(parts[1].Replace("W", ""));
+    //
+    //     var jan1 = new DateTime(year, 1, 1);
+    //     var jan1DayOfWeek = (int)jan1.DayOfWeek;
+    //     var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
+    //     var firstSaturday = jan1.AddDays(daysToFirstSaturday);
+    //     
+    //     var weekStart = firstSaturday.AddDays((week - 1) * 7);
+    //     var weekEnd = weekStart.AddDays(6).AddHours(23).AddMinutes(59).AddSeconds(59);
+    //
+    //     return (weekStart, weekEnd);
+    // }
 
     /// <summary>
     /// محاسبه مجموع تعادل‌های زیرمجموعه یک کاربر تا maxLevel لول پایین‌تر

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyBalances/CalculateWeeklyBalancesCommandValidator.cs

@@ -4,11 +4,11 @@ public class CalculateWeeklyBalancesCommandValidator : AbstractValidator<Calcula
 {
     public CalculateWeeklyBalancesCommandValidator()
     {
-        RuleFor(x => x.WeekNumber)
-            .NotEmpty()
+        RuleFor(x => x.WeekDefinitionId)
+            .NotNull()
+            .GreaterThan(0)
             .WithMessage("شماره هفته نمی‌تواند خالی باشد")
-            .Matches(@"^\d{4}-W\d{2}$")
-            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد (مثل 2025-W01)");
+;
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyCommissionPool/CalculateWeeklyCommissionPoolCommand.cs

@@ -8,7 +8,7 @@ public record CalculateWeeklyCommissionPoolCommand : IRequest<long>
     /// <summary>
     /// شماره هفته (فرمت: YYYY-Www)
     /// </summary>
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; } 
 
     /// <summary>
     /// آیا محاسبه مجدد انجام شود؟

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyCommissionPool/CalculateWeeklyCommissionPoolCommandHandler.cs

@@ -3,39 +3,50 @@ namespace CMSMicroservice.Application.CommissionCQ.Commands.CalculateWeeklyCommi
 public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<CalculateWeeklyCommissionPoolCommand, long>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekRepository;
 
-    public CalculateWeeklyCommissionPoolCommandHandler(IApplicationDbContext context)
+    public CalculateWeeklyCommissionPoolCommandHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekRepository)
     {
         _context = context;
+        _weekRepository = weekRepository;
     }
 
     public async Task<long> Handle(CalculateWeeklyCommissionPoolCommand request, CancellationToken cancellationToken)
     {
+        // تبدیل WeekNumber به WeekDefinitionId
+        var weekDefinitionId  = _weekRepository.GetGregorianWeekNumber(request.WeekDefinitionId);
+        if (weekDefinitionId == null)
+        {
+            throw new InvalidOperationException($"هفته {request.WeekDefinitionId} در سیستم تعریف نشده است");
+        }
+        
         // بررسی وجود استخر
         var existingPool = await _context.WeeklyCommissionPools
-            .FirstOrDefaultAsync(x => x.WeekNumber == request.WeekNumber, cancellationToken);
+            .FirstOrDefaultAsync(x => x.WeekDefinitionId == request.WeekDefinitionId, cancellationToken);
 
         if (existingPool == null)
         {
             throw new InvalidOperationException(
-                $"Pool هفته {request.WeekNumber} وجود ندارد. " +
+                $"Pool هفته {request.WeekDefinitionId} وجود ندارد. " +
                 "Pool باید در هنگام فعالسازی باشگاه مشتریان ایجاد شده باشد"
             );
         }
 
         if (existingPool.IsCalculated && !request.ForceRecalculate)
         {
-            throw new InvalidOperationException($"استخر کمیسیون هفته {request.WeekNumber} قبلاً محاسبه شده است");
+            throw new InvalidOperationException($"استخر کمیسیون هفته {request.WeekDefinitionId} قبلاً محاسبه شده است");
         }
 
         // بررسی وجود تعادل‌های هفتگی
         var weeklyBalances = await _context.NetworkWeeklyBalances
-            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId)
             .ToListAsync(cancellationToken);
 
         if (!weeklyBalances.Any())
         {
-            throw new InvalidOperationException($"تعادل‌های هفته {request.WeekNumber} هنوز محاسبه نشده است. ابتدا CalculateWeeklyBalances را اجرا کنید");
+            throw new InvalidOperationException($"تعادل‌های هفته {request.WeekDefinitionId} هنوز محاسبه نشده است. ابتدا CalculateWeeklyBalances را اجرا کنید");
         }
 
         // ⭐ Pool از قبل پُر شده (توسط ActivateClubMembership)
@@ -66,14 +77,17 @@ public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<Calcu
         if (request.ForceRecalculate)
         {
             var oldPayouts = await _context.UserCommissionPayouts
-                .Where(p => p.WeekNumber == request.WeekNumber)
+                .Where(p => p.WeekDefinitionId == request.WeekDefinitionId)
                 .ToListAsync(cancellationToken);
             
             if (oldPayouts.Any())
             {
                 var oldPayoutIds = oldPayouts.Select(p => p.Id).ToList();
                 
-                // ⭐ اول باید تاریخچه‌ها حذف بشن (به خاطر FK constraint)
+                // ⭐ ۱. برگرداندن NetworkBalance به حالت قبل (Revert)
+                await RevertUserWalletsAsync(oldPayoutIds, cancellationToken);
+                
+                // ⭐ ۲. حذف تاریخچه‌ها (به خاطر FK constraint)
                 var oldHistories = await _context.CommissionPayoutHistories
                     .Where(h => oldPayoutIds.Contains(h.UserCommissionPayoutId))
                     .ToListAsync(cancellationToken);
@@ -83,7 +97,7 @@ public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<Calcu
                     _context.CommissionPayoutHistories.RemoveRange(oldHistories);
                 }
                 
-                // بعد پرداخت‌ها حذف می‌شن
+                // ⭐ ۳. حذف پرداخت‌ها
                 _context.UserCommissionPayouts.RemoveRange(oldPayouts);
                 await _context.SaveChangesAsync(cancellationToken);
             }
@@ -110,7 +124,7 @@ public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<Calcu
             var payout = new UserCommissionPayout
             {
                 UserId = balance.UserId,
-                WeekNumber = request.WeekNumber,
+                WeekDefinitionId = request.WeekDefinitionId,
                 WeeklyPoolId = existingPool.Id,
                 BalancesEarned = userBalance,
                 ValuePerBalance = valuePerBalance,
@@ -138,7 +152,7 @@ public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<Calcu
                 {
                     UserCommissionPayoutId = payout.Id,
                     UserId = payout.UserId,
-                    WeekNumber = request.WeekNumber,
+                    WeekDefinitionId = request.WeekDefinitionId,
                     AmountBefore = 0,
                     AmountAfter = payout.TotalAmount,
                     OldStatus = default(CommissionPayoutStatus),
@@ -153,8 +167,141 @@ public class CalculateWeeklyCommissionPoolCommandHandler : IRequestHandler<Calcu
 
             await _context.CommissionPayoutHistories.AddRangeAsync(historyList, cancellationToken);
             await _context.SaveChangesAsync(cancellationToken);
+            
+            // ⭐ شارژ کیف پول کاربران (NetworkBalance) و ثبت لاگ
+            await ChargeUserWalletsAsync(payouts, request.WeekDefinitionId, cancellationToken);
         }
 
         return existingPool.Id;
     }
+    
+    /// <summary>
+    /// شارژ کیف پول کاربران با مبلغ کمیسیون (به NetworkBalance اضافه می‌شود)
+    /// و ثبت لاگ تغییرات کیف پول
+    /// </summary>
+    private async Task ChargeUserWalletsAsync(
+        List<UserCommissionPayout> payouts, 
+        long weekDefinitionId,
+        CancellationToken cancellationToken)
+    {
+        var userIds = payouts.Select(p => p.UserId).Distinct().ToList();
+        
+        // دریافت کیف پول‌های موجود
+        var existingWallets = await _context.UserWallets
+            .Where(w => userIds.Contains(w.UserId))
+            .ToDictionaryAsync(w => w.UserId, cancellationToken);
+        
+        var newWallets = new List<UserWallet>();
+        var walletLogs = new List<UserWalletChangeLog>();
+        
+        foreach (var payout in payouts)
+        {
+            if (payout.TotalAmount <= 0) continue;
+            
+            UserWallet wallet;
+            
+            // پیدا کردن یا ایجاد کیف پول
+            if (existingWallets.TryGetValue(payout.UserId, out var existingWallet))
+            {
+                wallet = existingWallet;
+            }
+            else
+            {
+                // ایجاد کیف پول جدید
+                wallet = new UserWallet
+                {
+                    UserId = payout.UserId,
+                    Balance = 0,
+                    NetworkBalance = 0,
+                    DiscountBalance = 0
+                };
+                newWallets.Add(wallet);
+                existingWallets[payout.UserId] = wallet; // برای جلوگیری از تکرار
+            }
+        }
+        
+        // ذخیره کیف پول‌های جدید
+        if (newWallets.Any())
+        {
+            await _context.UserWallets.AddRangeAsync(newWallets, cancellationToken);
+            await _context.SaveChangesAsync(cancellationToken);
+        }
+        
+        // شارژ کیف پول‌ها و ثبت لاگ
+        foreach (var payout in payouts)
+        {
+            if (payout.TotalAmount <= 0) continue;
+            
+            var wallet = existingWallets[payout.UserId];
+            
+            // ذخیره موجودی قبلی برای لاگ
+            var previousNetworkBalance = wallet.NetworkBalance;
+            
+            // شارژ NetworkBalance
+            wallet.NetworkBalance += payout.TotalAmount;
+            
+            // ایجاد لاگ تغییر کیف پول
+            var walletLog = new UserWalletChangeLog
+            {
+                WalletId = wallet.Id,
+                CurrentBalance = wallet.Balance,
+                ChangeValue = 0, // Balance اصلی تغییر نمی‌کند
+                CurrentNetworkBalance = wallet.NetworkBalance,
+                ChangeNerworkValue = payout.TotalAmount,
+                CurrentDiscountBalance = wallet.DiscountBalance,
+                ChangeDiscountValue = 0,
+                IsIncrease = true,
+                RefrenceId = payout.Id // ارجاع به UserCommissionPayout
+            };
+            
+            walletLogs.Add(walletLog);
+        }
+        
+        // ذخیره تغییرات کیف پول و لاگ‌ها
+        await _context.UserWalletChangeLogs.AddRangeAsync(walletLogs, cancellationToken);
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+    
+    /// <summary>
+    /// برگرداندن NetworkBalance به حالت قبل از شارژ کمیسیون
+    /// این متد قبل از محاسبه مجدد (ForceRecalculate) اجرا می‌شود
+    /// </summary>
+    private async Task RevertUserWalletsAsync(
+        List<long> oldPayoutIds, 
+        CancellationToken cancellationToken)
+    {
+        // پیدا کردن لاگ‌های کیف پول مرتبط با پرداخت‌های قبلی
+        var oldWalletLogs = await _context.UserWalletChangeLogs
+            .Where(l => l.RefrenceId.HasValue && oldPayoutIds.Contains(l.RefrenceId.Value))
+            .ToListAsync(cancellationToken);
+        
+        if (!oldWalletLogs.Any()) return;
+        
+        // پیدا کردن کیف پول‌های مرتبط
+        var walletIds = oldWalletLogs.Select(l => l.WalletId).Distinct().ToList();
+        var wallets = await _context.UserWallets
+            .Where(w => walletIds.Contains(w.Id))
+            .ToDictionaryAsync(w => w.Id, cancellationToken);
+        
+        // برگرداندن NetworkBalance
+        foreach (var log in oldWalletLogs)
+        {
+            if (wallets.TryGetValue(log.WalletId, out var wallet))
+            {
+                // کم کردن مبلغ شارژ شده قبلی از NetworkBalance
+                wallet.NetworkBalance -= log.ChangeNerworkValue;
+                
+                // اطمینان از منفی نشدن
+                if (wallet.NetworkBalance < 0)
+                {
+                    wallet.NetworkBalance = 0;
+                }
+            }
+        }
+        
+        // حذف لاگ‌های قبلی
+        _context.UserWalletChangeLogs.RemoveRange(oldWalletLogs);
+        
+        await _context.SaveChangesAsync(cancellationToken);
+    }
 }

src/CMSMicroservice.Application/CommissionCQ/Commands/CalculateWeeklyCommissionPool/CalculateWeeklyCommissionPoolCommandValidator.cs

@@ -4,11 +4,10 @@ public class CalculateWeeklyCommissionPoolCommandValidator : AbstractValidator<C
 {
     public CalculateWeeklyCommissionPoolCommandValidator()
     {
-        RuleFor(x => x.WeekNumber)
-            .NotEmpty()
-            .WithMessage("شماره هفته نمی‌تواند خالی باشد")
-            .Matches(@"^\d{4}-W\d{2}$")
-            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد");
+        RuleFor(x => x.WeekDefinitionId)
+            .NotNull()
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند خالی باشد");
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Commands/ProcessUserPayouts/ProcessUserPayoutsCommand.cs

@@ -8,7 +8,7 @@ public record ProcessUserPayoutsCommand : IRequest<int>
     /// <summary>
     /// شماره هفته
     /// </summary>
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; } 
 
     /// <summary>
     /// آیا پرداخت مجدد انجام شود؟

src/CMSMicroservice.Application/CommissionCQ/Commands/ProcessUserPayouts/ProcessUserPayoutsCommandHandler.cs

@@ -3,31 +3,41 @@ namespace CMSMicroservice.Application.CommissionCQ.Commands.ProcessUserPayouts;
 public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayoutsCommand, int>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekRepository;
 
-    public ProcessUserPayoutsCommandHandler(IApplicationDbContext context)
+    public ProcessUserPayoutsCommandHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekRepository)
     {
         _context = context;
+        _weekRepository = weekRepository;
     }
 
     public async Task<int> Handle(ProcessUserPayoutsCommand request, CancellationToken cancellationToken)
     {
+        var regorianWeekNumber = _weekRepository.GetGregorianWeekNumber(request.WeekDefinitionId);
+        if (regorianWeekNumber == null)
+        {
+            throw new InvalidOperationException($"هفته {request.WeekDefinitionId} در سیستم تعریف نشده است");
+        }
+        
         // بررسی وجود استخر
         var pool = await _context.WeeklyCommissionPools
-            .FirstOrDefaultAsync(x => x.WeekNumber == request.WeekNumber, cancellationToken);
+            .FirstOrDefaultAsync(x => x.WeekDefinitionId == request.WeekDefinitionId, cancellationToken);
 
         if (pool == null || !pool.IsCalculated)
         {
-            throw new InvalidOperationException($"استخر کمیسیون هفته {request.WeekNumber} هنوز محاسبه نشده است");
+            throw new InvalidOperationException($"استخر کمیسیون هفته {request.WeekDefinitionId} هنوز محاسبه نشده است");
         }
 
         // بررسی پرداخت قبلی
         var existingPayouts = await _context.UserCommissionPayouts
-            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId)
             .ToListAsync(cancellationToken);
 
         if (existingPayouts.Any() && !request.ForceReprocess)
         {
-            throw new InvalidOperationException($"پرداخت‌های هفته {request.WeekNumber} قبلاً انجام شده است");
+            throw new InvalidOperationException($"پرداخت‌های هفته {request.WeekDefinitionId} قبلاً انجام شده است");
         }
 
         // حذف پرداخت‌های قبلی در صورت ForceReprocess
@@ -46,12 +56,12 @@ public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayou
 
         // دریافت همه تعادل‌های هفتگی (شامل صفرها هم برای محاسبه زیرمجموعه)
         var allWeeklyBalances = await _context.NetworkWeeklyBalances
-            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId)
             .ToDictionaryAsync(x => x.UserId, cancellationToken);
 
         // دریافت کاربرانی که تعادل > 0 دارند (یا زیرمجموعه‌شان دارد)
         var usersWithBalances = await _context.NetworkWeeklyBalances
-            .Where(x => x.WeekNumber == request.WeekNumber && x.TotalBalances > 0)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId && x.TotalBalances > 0)
             .Select(x => x.UserId)
             .ToListAsync(cancellationToken);
 
@@ -82,7 +92,7 @@ public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayou
             // ⭐ محاسبه مجموع تعادل‌های زیرمجموعه تا maxNetworkLevel لول
             var subordinateBalances = await CalculateSubordinateBalancesAsync(
                 userId, 
-                request.WeekNumber,
+                request.WeekDefinitionId,
                 allWeeklyBalances,
                 maxNetworkLevel,
                 cancellationToken
@@ -103,7 +113,7 @@ public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayou
             var payout = new UserCommissionPayout
             {
                 UserId = userId,
-                WeekNumber = request.WeekNumber,
+                WeekDefinitionId = request.WeekDefinitionId,
                 WeeklyPoolId = pool.Id,
                 BalancesEarned = totalBalancesWithSubordinates, // ⭐ شامل زیرمجموعه
                 ValuePerBalance = pool.ValuePerBalance,
@@ -129,7 +139,7 @@ public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayou
             {
                 UserCommissionPayoutId = payout.Id,
                 UserId = payout.UserId,
-                WeekNumber = request.WeekNumber,
+                WeekDefinitionId = request.WeekDefinitionId,
                 AmountBefore = 0,
                 AmountAfter = payout.TotalAmount,
                 OldStatus = default(CommissionPayoutStatus),
@@ -180,7 +190,7 @@ public class ProcessUserPayoutsCommandHandler : IRequestHandler<ProcessUserPayou
     /// </summary>
     private async Task<int> CalculateSubordinateBalancesAsync(
         long userId,
-        string weekNumber,
+        long WeekDefinitionId,
         Dictionary<long, NetworkWeeklyBalance> allBalances,
         int maxLevel,
         CancellationToken cancellationToken)

src/CMSMicroservice.Application/CommissionCQ/Commands/ProcessUserPayouts/ProcessUserPayoutsCommandValidator.cs

@@ -4,11 +4,10 @@ public class ProcessUserPayoutsCommandValidator : AbstractValidator<ProcessUserP
 {
     public ProcessUserPayoutsCommandValidator()
     {
-        RuleFor(x => x.WeekNumber)
-            .NotEmpty()
-            .WithMessage("شماره هفته نمی‌تواند خالی باشد")
-            .Matches(@"^\d{4}-W\d{2}$")
-            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد");
+        RuleFor(x => x.WeekDefinitionId)
+            .NotNull()
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند خالی باشد");
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Commands/ProcessWithdrawal/ProcessWithdrawalCommandHandler.cs

@@ -73,7 +73,7 @@ public class ProcessWithdrawalCommandHandler : IRequestHandler<ProcessWithdrawal
                         UserId = payout.UserId,
                         Iban = payout.IbanNumber ?? throw new InvalidOperationException("شماره شبا یافت نشد"),
                         AccountHolderName = $"{payout.User.FirstName} {payout.User.LastName}",
-                        Description = $"برداشت کمیسیون هفته {payout.WeekNumber}",
+                        Description = $"برداشت کمیسیون هفته {payout.WeekDefinitionId}",
                         InternalRefId = $"PAYOUT-{payout.Id}"
                     };
                     
@@ -120,7 +120,7 @@ public class ProcessWithdrawalCommandHandler : IRequestHandler<ProcessWithdrawal
             {
                 UserCommissionPayoutId = payout.Id,
                 UserId = payout.UserId,
-                WeekNumber = payout.WeekNumber,
+                WeekDefinitionId = payout.WeekDefinitionId,
                 AmountBefore = payout.TotalAmount,
                 AmountAfter = payout.TotalAmount,
                 OldStatus = oldStatus,
@@ -147,7 +147,7 @@ public class ProcessWithdrawalCommandHandler : IRequestHandler<ProcessWithdrawal
             {
                 UserCommissionPayoutId = payout.Id,
                 UserId = payout.UserId,
-                WeekNumber = payout.WeekNumber,
+                WeekDefinitionId = payout.WeekDefinitionId,
                 AmountBefore = payout.TotalAmount,
                 AmountAfter = payout.TotalAmount,
                 OldStatus = oldStatus,

src/CMSMicroservice.Application/CommissionCQ/Commands/RequestWithdrawal/RequestWithdrawalCommandHandler.cs

@@ -48,7 +48,7 @@ public class RequestWithdrawalCommandHandler : IRequestHandler<RequestWithdrawal
         {
             UserCommissionPayoutId = payout.Id,
             UserId = payout.UserId,
-            WeekNumber = payout.WeekNumber,
+            WeekDefinitionId = payout.WeekDefinitionId,
             AmountBefore = payout.TotalAmount,
             AmountAfter = payout.TotalAmount,
             OldStatus = oldStatus,

src/CMSMicroservice.Application/CommissionCQ/Commands/TriggerWeeklyCalculation/TriggerWeeklyCalculationCommand.cs

@@ -5,7 +5,7 @@ public record TriggerWeeklyCalculationCommand : IRequest<TriggerWeeklyCalculatio
     /// <summary>
     /// شماره هفته (فرمت: "YYYY-Www")
     /// </summary>
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; }
 
     /// <summary>
     /// اگر true باشد، محاسبات قبلی را حذف و دوباره محاسبه می‌کند

src/CMSMicroservice.Application/CommissionCQ/Commands/TriggerWeeklyCalculation/TriggerWeeklyCalculationCommandHandler.cs

@@ -8,13 +8,16 @@ public class TriggerWeeklyCalculationCommandHandler : IRequestHandler<TriggerWee
 {
     private readonly IApplicationDbContext _context;
     private readonly IMediator _mediator;
+    private readonly ICommissionCalculationStrategyFactory _strategyFactory;
 
     public TriggerWeeklyCalculationCommandHandler(
         IApplicationDbContext context,
-        IMediator mediator)
+        IMediator mediator,
+        ICommissionCalculationStrategyFactory strategyFactory)
     {
         _context = context;
         _mediator = mediator;
+        _strategyFactory = strategyFactory;
     }
 
     public async Task<TriggerWeeklyCalculationResponseDto> Handle(
@@ -27,7 +30,7 @@ public class TriggerWeeklyCalculationCommandHandler : IRequestHandler<TriggerWee
         try
         {
             // Validate week number format
-            if (string.IsNullOrWhiteSpace(request.WeekNumber))
+            if (request.WeekDefinitionId <= 0)
             {
                 return new TriggerWeeklyCalculationResponseDto
                 {
@@ -40,32 +43,36 @@ public class TriggerWeeklyCalculationCommandHandler : IRequestHandler<TriggerWee
 
             var steps = new List<string>();
             
+            // ⭐ دریافت استراتژی براساس Config (ORM یا SP)
+            var strategy = await _strategyFactory.CreateStrategyAsync(cancellationToken);
+            var strategyName = strategy.GetType().Name.Contains("StoredProcedure") ? "SP" : "ORM";
+
             // Step 1: Calculate Weekly Balances (تا 15 لول)
             if (!request.SkipBalances)
             {
-                await _mediator.Send(new CalculateWeeklyBalancesCommand
-                {
-                    WeekNumber = request.WeekNumber,
-                    ForceRecalculate = request.ForceRecalculate
-                }, cancellationToken);
-                steps.Add("محاسبه امتیازات هفتگی");
+                var balancesCount = await strategy.CalculateWeeklyBalancesAsync(
+                    request.WeekDefinitionId,
+                    request.ForceRecalculate,
+                    cancellationToken);
+                
+                steps.Add($"محاسبه امتیازات هفتگی ({balancesCount} کاربر)");
             }
 
             // Step 2: Calculate Pool & Process Payouts (محاسبه استخر + پرداخت کاربران)
             if (!request.SkipPayouts)
             {
-                await _mediator.Send(new CalculateWeeklyCommissionPoolCommand
-                {
-                    WeekNumber = request.WeekNumber,
-                    ForceRecalculate = request.ForceRecalculate
-                }, cancellationToken);
-                steps.Add("محاسبه استخر و پرداخت کاربران");
+                var poolId = await strategy.CalculateWeeklyCommissionPoolAsync(
+                    request.WeekDefinitionId,
+                    request.ForceRecalculate,
+                    cancellationToken);
+                
+                steps.Add($"محاسبه استخر و پرداخت کاربران (Pool: {poolId})");
             }
 
             return new TriggerWeeklyCalculationResponseDto
             {
                 Success = true,
-                Message = $"محاسبات هفته {request.WeekNumber} با موفقیت انجام شد. مراحل: {string.Join(", ", steps)}",
+                Message = $"محاسبات هفته {request.WeekDefinitionId} با موفقیت انجام شد [{strategyName}]. مراحل: {string.Join(", ", steps)}",
                 ExecutionId = executionId,
                 StartedAt = startedAt
             };

src/CMSMicroservice.Application/CommissionCQ/Commands/TriggerWeeklyCalculation/TriggerWeeklyCalculationCommandValidator.cs

@@ -0,0 +1,27 @@
+using CMSMicroservice.Application.CommissionCQ.Commands.ProcessWithdrawal;
+
+namespace CMSMicroservice.Application.CommissionCQ.Commands.TriggerWeeklyCalculation;
+
+public class TriggerWeeklyCalculationCommandValidator : AbstractValidator<TriggerWeeklyCalculationCommand>
+{
+    public TriggerWeeklyCalculationCommandValidator()
+    {
+        RuleFor(x => x.WeekDefinitionId)
+            .NotNull()
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند خالی باشد");
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<TriggerWeeklyCalculationCommand>.CreateWithOptions(
+                (TriggerWeeklyCalculationCommand)model,
+                x => x.IncludeProperties(propertyName)));
+
+        if (result.IsValid)
+            return Array.Empty<string>();
+
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetAllWeeklyPools/GetAllWeeklyPoolsQuery.cs

@@ -8,12 +8,12 @@ public record GetAllWeeklyPoolsQuery : IRequest<GetAllWeeklyPoolsResponseDto>
     /// <summary>
     /// از هفته (فیلتر اختیاری)
     /// </summary>
-    public string? FromWeek { get; init; }
+    public int? FromWeekOrder { get; init; }
 
     /// <summary>
     /// تا هفته (فیلتر اختیاری)
     /// </summary>
-    public string? ToWeek { get; init; }
+    public int? ToWeekOrder { get; init; }
 
     /// <summary>
     /// فقط Pool های محاسبه شده

src/CMSMicroservice.Application/CommissionCQ/Queries/GetAllWeeklyPools/GetAllWeeklyPoolsQueryHandler.cs

@@ -3,25 +3,31 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetAllWeeklyPools;
 public class GetAllWeeklyPoolsQueryHandler : IRequestHandler<GetAllWeeklyPoolsQuery, GetAllWeeklyPoolsResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetAllWeeklyPoolsQueryHandler(IApplicationDbContext context)
+    public GetAllWeeklyPoolsQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetAllWeeklyPoolsResponseDto> Handle(GetAllWeeklyPoolsQuery request, CancellationToken cancellationToken)
     {
-        var query = _context.WeeklyCommissionPools.AsNoTracking();
+        var query = _context.WeeklyCommissionPools
+            .Include(i=> i.WeekDefinition)
+            .AsNoTracking();
 
         // Apply filters
-        if (!string.IsNullOrWhiteSpace(request.FromWeek))
+        if (request.FromWeekOrder!=null)
         {
-            query = query.Where(x => string.Compare(x.WeekNumber, request.FromWeek) >= 0);
+            query = query.Where(x => x.WeekDefinition.WeekOrder>=request.FromWeekOrder );
         }
 
-        if (!string.IsNullOrWhiteSpace(request.ToWeek))
+        if (request.ToWeekOrder!=null)
         {
-            query = query.Where(x => string.Compare(x.WeekNumber, request.ToWeek) <= 0);
+            query = query.Where(x =>x.WeekDefinition.WeekOrder<= request.ToWeekOrder);
         }
 
         if (request.OnlyCalculated.HasValue && request.OnlyCalculated.Value)
@@ -30,7 +36,7 @@ public class GetAllWeeklyPoolsQueryHandler : IRequestHandler<GetAllWeeklyPoolsQu
         }
 
         // Order by week number descending (newest first)
-        query = query.OrderByDescending(x => x.WeekNumber);
+        query = query.OrderByDescending(x => x.WeekDefinitionId);
 
         // Count total
         var totalCount = await query.CountAsync(cancellationToken);
@@ -42,7 +48,8 @@ public class GetAllWeeklyPoolsQueryHandler : IRequestHandler<GetAllWeeklyPoolsQu
             .Select(x => new WeeklyCommissionPoolDto
             {
                 Id = x.Id,
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName = x.WeekDefinition.PersianWeekNumber,
                 TotalPoolAmount = x.TotalPoolAmount,
                 TotalBalances = x.TotalBalances,
                 ValuePerBalance = x.ValuePerBalance,
@@ -52,6 +59,19 @@ public class GetAllWeeklyPoolsQueryHandler : IRequestHandler<GetAllWeeklyPoolsQu
             })
             .ToListAsync(cancellationToken);
 
+        // Populate WeekDisplayName from cache
+        // foreach (var pool in pools)
+        // {
+        //     // WeeklyCommissionPoolDto is a record, need to create new instance with display name
+        //     // Since records are immutable, we can't modify them directly
+        // }
+        
+        // // Create new list with WeekDisplayName populated
+        // var poolsWithDisplayName = pools.Select(p => p with 
+        // { 
+        //     WeekDisplayName = _weekDefinitionRepository.GetDisplayNameByGregorianWeekNumber(p.WeekNumber) 
+        // }).ToList();
+
         return new GetAllWeeklyPoolsResponseDto
         {
             MetaData = new MetaDataDto

src/CMSMicroservice.Application/CommissionCQ/Queries/GetAllWeeklyPools/GetAllWeeklyPoolsResponseDto.cs

@@ -9,7 +9,8 @@ public record GetAllWeeklyPoolsResponseDto
 public record WeeklyCommissionPoolDto
 {
     public long Id { get; init; }
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; } 
+    public string WeekDisplayName { get; init; } = string.Empty;
     public long TotalPoolAmount { get; init; }
     public int TotalBalances { get; init; }
     public long ValuePerBalance { get; init; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetAvailableWeeks/GetAvailableWeeksQueryHandler.cs

@@ -2,29 +2,36 @@ using CMSMicroservice.Application.Common.Interfaces;
 using CMSMicroservice.Domain.Enums;
 using Microsoft.EntityFrameworkCore;
 using System.Globalization;
+using DateTimeConverterCL;
 
 namespace CMSMicroservice.Application.CommissionCQ.Queries.GetAvailableWeeks;
 
 public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQuery, GetAvailableWeeksResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetAvailableWeeksQueryHandler(IApplicationDbContext context)
+    public GetAvailableWeeksQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetAvailableWeeksResponseDto> Handle(
         GetAvailableWeeksQuery request, 
         CancellationToken cancellationToken)
     {
-        var currentDate = DateTime.Now;
-        var currentWeekNumber = GetWeekNumber(currentDate);
+        var currentWeekDef = _weekDefinitionRepository.GetCurrentWeek();
+        // var currentWeekNumber = currentWeekDef != null 
+        //     ? $"{currentWeekDef.GregorianYear}-W{currentWeekDef.GregorianWeekNumber:D2}" 
+        //     : _weekDefinitionRepository.CalculateGregorianWeekNumber(DateTime.Now);
         
         // دریافت هفته‌های محاسبه شده از دیتابیس
         var calculatedPools = await _context.WeeklyCommissionPools
             .Where(p => p.IsCalculated)
-            .OrderByDescending(p => p.WeekNumber)
+            .OrderByDescending(p => p.WeekDefinitionId)
             .Take(request.PastWeeksCount)
             .ToListAsync(cancellationToken);
 
@@ -32,7 +39,7 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         var executionLogs = await _context.WorkerExecutionLogs
             .Where(log => log.Status == WorkerExecutionStatus.Success || 
                           log.Status == WorkerExecutionStatus.Failed)
-            .GroupBy(log => log.WeekNumber)
+            .GroupBy(log => log.WeekDefinitionId)
             .Select(g => new 
             { 
                 WeekNumber = g.Key, 
@@ -43,15 +50,16 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         var allWeeks = new List<WeekInfoDto>();
         
         // هفته جاری
-        var currentWeekInfo = CreateWeekInfo(currentDate, currentWeekNumber, calculatedPools, executionLogs);
+        var currentDate = DateTime.Now;
+        var currentWeekInfo = CreateWeekInfo(currentDate, currentWeekDef.Id, calculatedPools, executionLogs);
         
         // هفته‌های گذشته (12 هفته)
         var pastWeeks = new List<WeekInfoDto>();
         for (int i = 1; i <= request.PastWeeksCount; i++)
         {
             var pastDate = currentDate.AddDays(-7 * i);
-            var weekNumber = GetWeekNumber(pastDate);
-            pastWeeks.Add(CreateWeekInfo(pastDate, weekNumber, calculatedPools, executionLogs));
+            var weekNumber = GetWeekNumberUsingRepository(pastDate);
+            pastWeeks.Add(CreateWeekInfo(pastDate, currentWeekDef.Id, calculatedPools, executionLogs));
         }
         
         // هفته‌های آینده (4 هفته)
@@ -59,8 +67,8 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         for (int i = 1; i <= request.FutureWeeksCount; i++)
         {
             var futureDate = currentDate.AddDays(7 * i);
-            var weekNumber = GetWeekNumber(futureDate);
-            futureWeeks.Add(CreateWeekInfo(futureDate, weekNumber, calculatedPools, executionLogs));
+            var weekNumber = GetWeekNumberUsingRepository(futureDate);
+            futureWeeks.Add(CreateWeekInfo(futureDate, currentWeekDef.Id, calculatedPools, executionLogs));
         }
         
         // تفکیک به calculated و pending
@@ -76,26 +84,54 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         };
     }
 
+    private string GetWeekNumberUsingRepository(DateTime date)
+    {
+        var weekDef = _weekDefinitionRepository.GetWeekByDate(date);
+        if (weekDef != null)
+        {
+            return $"{weekDef.GregorianYear}-W{weekDef.GregorianWeekNumber:D2}";
+        }
+        
+        // Fallback to manual calculation if not in cache
+        return _weekDefinitionRepository.CalculateGregorianWeekNumber(date);
+    }
+
     private WeekInfoDto CreateWeekInfo(
         DateTime date, 
-        string weekNumber,
+        long weekDefinitionId,
         List<Domain.Entities.Commission.WeeklyCommissionPool> calculatedPools,
-        Dictionary<string, Domain.Entities.Commission.WorkerExecutionLog> executionLogs)
+        Dictionary<long, Domain.Entities.Commission.WorkerExecutionLog> executionLogs)
     {
+        // Get the actual WeekDefinition for this date
+        var weekDef = _weekDefinitionRepository.GetWeekByDate(date);
+        var actualWeekDefId = weekDef?.Id ?? weekDefinitionId;
+        
         var (startDate, endDate) = GetWeekRange(date);
-        var pool = calculatedPools.FirstOrDefault(p => p.WeekNumber == weekNumber);
-        var log = executionLogs.GetValueOrDefault(weekNumber);
+        var pool = calculatedPools.FirstOrDefault(p => p.WeekDefinitionId == actualWeekDefId);
+        var log = executionLogs.GetValueOrDefault(actualWeekDefId);
         
         var isCalculated = pool != null && pool.IsCalculated;
+        //
+        // // تبدیل تاریخ به شمسی برای نمایش
+        // var persianCalendar = new PersianCalendar();
+        // var startDatePersian = $"{persianCalendar.GetYear(startDate):D4}/{persianCalendar.GetMonth(startDate):D2}/{persianCalendar.GetDayOfMonth(startDate):D2}";
+        // var endDatePersian = $"{persianCalendar.GetYear(endDate):D4}/{persianCalendar.GetMonth(endDate):D2}/{persianCalendar.GetDayOfMonth(endDate):D2}";
         
-        // تبدیل تاریخ به شمسی برای نمایش
-        var persianCalendar = new PersianCalendar();
-        var startDatePersian = $"{persianCalendar.GetYear(startDate):D4}/{persianCalendar.GetMonth(startDate):D2}/{persianCalendar.GetDayOfMonth(startDate):D2}";
-        var endDatePersian = $"{persianCalendar.GetYear(endDate):D4}/{persianCalendar.GetMonth(endDate):D2}/{persianCalendar.GetDayOfMonth(endDate):D2}";
+        // استفاده از DisplayName از WeekDefinition
+        var displayName = weekDef?.DisplayName ?? GetDisplayName(startDate);
+        string displayText;
         
-        // تبدیل weekNumber به شمسی فقط برای نمایش
-        var persianWeekNumber = ConvertWeekNumberToPersian(weekNumber, startDate);
-        var displayText = $"{persianWeekNumber} ({startDatePersian} - {endDatePersian})";
+        if (!string.IsNullOrEmpty(displayName))
+        {
+            // اگر DisplayName وجود داشت، از آن استفاده کن
+            displayText = $"{displayName} ({startDate.MiladiToJalali()} - {endDate.MiladiToJalali()})";
+        }
+        else
+        {
+            // تبدیل weekNumber به شمسی فقط برای نمایش (fallback)
+            var persianWeekNumber = _weekDefinitionRepository.GetWeekById(actualWeekDefId);
+            displayText = $"{persianWeekNumber?.PersianWeekNumber} ({startDate.MiladiToJalali()} - {endDate.MiladiToJalali()})";
+        }
         
         if (isCalculated)
         {
@@ -104,7 +140,8 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         
         return new WeekInfoDto
         {
-            WeekNumber = weekNumber, // میلادی (برای API)
+            WeekDefinitionId = actualWeekDefId,
+            DisplayName = weekDef?.DisplayName ?? _weekDefinitionRepository.GetWeekById(actualWeekDefId)?.DisplayName ?? "", // میلادی (برای API)
             StartDate = startDate,
             EndDate = endDate,
             IsCalculated = isCalculated,
@@ -116,40 +153,16 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         };
     }
 
-    private static string GetWeekNumber(DateTime date)
+    private (DateTime startDate, DateTime endDate) GetWeekRange(DateTime date)
     {
-        var year = date.Year;
-        
-        // پیدا کردن اولین شنبه سال
-        var jan1 = new DateTime(year, 1, 1);
-        var jan1DayOfWeek = (int)jan1.DayOfWeek; // 0=Sunday, 1=Monday, ..., 6=Saturday
-        
-        // محاسبه تعداد روزهایی که باید اضافه کنیم تا به اولین شنبه برسیم
-        var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
-        var firstSaturday = jan1.AddDays(daysToFirstSaturday);
-        
-        // پیدا کردن شنبه شروع هفته جاری
-        var currentDayOfWeek = (int)date.DayOfWeek; // 0=Sun, 1=Mon, ..., 6=Sat
-        var daysToCurrentSaturday = currentDayOfWeek == 6 ? 0 : (currentDayOfWeek + 1) % 7;
-        var weekStartSaturday = date.Date.AddDays(-daysToCurrentSaturday);
-        
-        // محاسبه شماره هفته
-        int weekNum;
-        if (weekStartSaturday < firstSaturday)
+        // First try to get from repository
+        var weekDef = _weekDefinitionRepository.GetWeekByDate(date);
+        if (weekDef != null)
         {
-            weekNum = 1; // هفته اول سال
-        }
-        else
-        {
-            var daysSinceFirstSaturday = (weekStartSaturday - firstSaturday).Days;
-            weekNum = (daysSinceFirstSaturday / 7) + 1;
+            return (weekDef.StartDate, weekDef.EndDate);
         }
         
-        return $"{year}-W{weekNum:D2}";
-    }
-
-    private static (DateTime startDate, DateTime endDate) GetWeekRange(DateTime date)
-    {
+        // Fallback: manual calculation
         var dayOfWeek = (int)date.DayOfWeek;
         // محاسبه تعداد روزهایی که باید عقب برویم تا به شنبه برسیم
         // شنبه = 6, یکشنبه = 0, دوشنبه = 1, ..., جمعه = 5
@@ -161,32 +174,38 @@ public class GetAvailableWeeksQueryHandler : IRequestHandler<GetAvailableWeeksQu
         return (startDate, endDate);
     }
 
-    private static string ConvertWeekNumberToPersian(string gregorianWeekNumber, DateTime weekStartDate)
+    private string GetDisplayName(DateTime date)
     {
-        // ورودی: "2025-W48"
-        var persianCalendar = new PersianCalendar();
-        var persianYear = persianCalendar.GetYear(weekStartDate);
-        
-        // محاسبه شماره هفته شمسی
-        var jan1Persian = persianCalendar.ToDateTime(persianYear, 1, 1, 0, 0, 0, 0);
-        
-        // پیدا کردن اولین شنبه سال شمسی
-        var jan1DayOfWeek = (int)jan1Persian.DayOfWeek;
-        var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
-        var firstSaturday = jan1Persian.AddDays(daysToFirstSaturday);
-        
-        // محاسبه شماره هفته
-        int weekNum;
-        if (weekStartDate < firstSaturday)
-        {
-            weekNum = 1;
-        }
-        else
-        {
-            var daysSinceFirstSaturday = (weekStartDate - firstSaturday).Days;
-            weekNum = (daysSinceFirstSaturday / 7) + 1;
+        var weekDef = _weekDefinitionRepository.GetWeekByDate(date);
+        return weekDef?.DisplayName ?? "";
     }
 
-        return $"{persianYear}-W{weekNum:D2}";
-    }
+    // private static string ConvertWeekNumberToPersian(string gregorianWeekNumber, DateTime weekStartDate)
+    // {
+    //     // ورودی: "2025-W48"
+    //     var persianCalendar = new PersianCalendar();
+    //     var persianYear = persianCalendar.GetYear(weekStartDate);
+    //     
+    //     // محاسبه شماره هفته شمسی
+    //     var jan1Persian = persianCalendar.ToDateTime(persianYear, 1, 1, 0, 0, 0, 0);
+    //     
+    //     // پیدا کردن اولین شنبه سال شمسی
+    //     var jan1DayOfWeek = (int)jan1Persian.DayOfWeek;
+    //     var daysToFirstSaturday = jan1DayOfWeek == 6 ? 0 : (6 - jan1DayOfWeek + 7) % 7;
+    //     var firstSaturday = jan1Persian.AddDays(daysToFirstSaturday);
+    //     
+    //     // محاسبه شماره هفته
+    //     int weekNum;
+    //     if (weekStartDate < firstSaturday)
+    //     {
+    //         weekNum = 1;
+    //     }
+    //     else
+    //     {
+    //         var daysSinceFirstSaturday = (weekStartDate - firstSaturday).Days;
+    //         weekNum = (daysSinceFirstSaturday / 7) + 1;
+    //     }
+    //     
+    //     return $"{persianYear}-W{weekNum:D2}";
+    // }
 }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetAvailableWeeks/GetAvailableWeeksResponseDto.cs

@@ -17,8 +17,11 @@ public class GetAvailableWeeksResponseDto
 
 public class WeekInfoDto
 {
+    /// <summary>شناسه یکتای هفته</summary>
+    public required long WeekDefinitionId { get; init; }
+    
     /// <summary>شماره هفته (YYYY-Www)</summary>
-    public required string WeekNumber { get; init; }
+    public required string DisplayName { get; init; }
     
     /// <summary>تاریخ شروع هفته</summary>
     public required DateTime StartDate { get; init; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetCommissionPayoutHistory/GetCommissionPayoutHistoryQuery.cs

@@ -18,7 +18,7 @@ public record GetCommissionPayoutHistoryQuery : IRequest<GetCommissionPayoutHist
     /// <summary>
     /// شماره هفته (اختیاری)
     /// </summary>
-    public string? WeekNumber { get; init; }
+    public long? WeekDefinitionId { get; init; }
 
     /// <summary>
     /// مرتب‌سازی

src/CMSMicroservice.Application/CommissionCQ/Queries/GetCommissionPayoutHistory/GetCommissionPayoutHistoryQueryHandler.cs

@@ -3,15 +3,20 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetCommissionPayoutHi
 public class GetCommissionPayoutHistoryQueryHandler : IRequestHandler<GetCommissionPayoutHistoryQuery, GetCommissionPayoutHistoryResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetCommissionPayoutHistoryQueryHandler(IApplicationDbContext context)
+    public GetCommissionPayoutHistoryQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetCommissionPayoutHistoryResponseDto> Handle(GetCommissionPayoutHistoryQuery request, CancellationToken cancellationToken)
     {
         var query = _context.CommissionPayoutHistories
+            .Include(i=>i.WeekDefinition)
             .AsNoTracking()
             .AsQueryable();
 
@@ -26,9 +31,9 @@ public class GetCommissionPayoutHistoryQueryHandler : IRequestHandler<GetCommiss
             query = query.Where(x => x.UserId == request.UserId.Value);
         }
 
-        if (!string.IsNullOrEmpty(request.WeekNumber))
+        if (request.WeekDefinitionId!=null)
         {
-            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+            query = query.Where(x => x.WeekDefinitionId == request.WeekDefinitionId);
         }
 
         query = query.ApplyOrder(sortBy: request.SortBy ?? "Created");
@@ -42,7 +47,8 @@ public class GetCommissionPayoutHistoryQueryHandler : IRequestHandler<GetCommiss
                 Id = x.Id,
                 UserCommissionPayoutId = x.UserCommissionPayoutId,
                 UserId = x.UserId,
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName=x.WeekDefinition!.DisplayName,
                 AmountBefore = x.AmountBefore,
                 AmountAfter = x.AmountAfter,
                 OldStatus = x.OldStatus,
@@ -54,6 +60,12 @@ public class GetCommissionPayoutHistoryQueryHandler : IRequestHandler<GetCommiss
             })
             .ToListAsync(cancellationToken);
 
+        // // Populate WeekDisplayName from cache
+        // foreach (var model in models)
+        // {
+        //     model.WeekDisplayName = _weekDefinitionRepository.GetDisplayNameByGregorianWeekNumber(model.WeekNumber);
+        // }
+
         return new GetCommissionPayoutHistoryResponseDto
         {
             MetaData = meta,

src/CMSMicroservice.Application/CommissionCQ/Queries/GetCommissionPayoutHistory/GetCommissionPayoutHistoryQueryValidator.cs

@@ -13,11 +13,10 @@ public class GetCommissionPayoutHistoryQueryValidator : AbstractValidator<GetCom
             .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));
+        RuleFor(x => x.WeekDefinitionId)
+            .NotNull()
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند خالی باشد");
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Queries/GetCommissionPayoutHistory/GetCommissionPayoutHistoryResponseDto.cs

@@ -11,7 +11,8 @@ 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 WeekDefinitionId { get; set; }
+    public string WeekDisplayName { get; set; } = string.Empty;
     public long AmountBefore { get; set; }
     public long AmountAfter { get; set; }
     public CommissionPayoutStatus? OldStatus { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserCommissionPayouts/GetUserCommissionPayoutsQuery.cs

@@ -18,7 +18,7 @@ public record GetUserCommissionPayoutsQuery : IRequest<GetUserCommissionPayoutsR
     /// <summary>
     /// شماره هفته (اختیاری)
     /// </summary>
-    public string? WeekNumber { get; init; }
+    public long? WeekDefinitionId { get; init; }
 
     /// <summary>
     /// مرتب‌سازی

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserCommissionPayouts/GetUserCommissionPayoutsQueryHandler.cs

@@ -3,15 +3,20 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserCommissionPayo
 public class GetUserCommissionPayoutsQueryHandler : IRequestHandler<GetUserCommissionPayoutsQuery, GetUserCommissionPayoutsResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetUserCommissionPayoutsQueryHandler(IApplicationDbContext context)
+    public GetUserCommissionPayoutsQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetUserCommissionPayoutsResponseDto> Handle(GetUserCommissionPayoutsQuery request, CancellationToken cancellationToken)
     {
         var query = _context.UserCommissionPayouts
+            .Include(x => x.WeekDefinition)
             .Include(x => x.User)
             .AsNoTracking()
             .AsQueryable();
@@ -27,9 +32,9 @@ public class GetUserCommissionPayoutsQueryHandler : IRequestHandler<GetUserCommi
             query = query.Where(x => x.Status == request.Status.Value);
         }
 
-        if (!string.IsNullOrEmpty(request.WeekNumber))
+        if (request.WeekDefinitionId!=null)
         {
-            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+            query = query.Where(x => x.WeekDefinitionId == request.WeekDefinitionId);
         }
 
         query = query.ApplyOrder(sortBy: request.SortBy ?? "Created");
@@ -44,7 +49,8 @@ public class GetUserCommissionPayoutsQueryHandler : IRequestHandler<GetUserCommi
                 UserId = x.UserId,
                 FirstName = x.User.FirstName,
                 LastName = x.User.LastName,
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName = x.WeekDefinition != null ? x.WeekDefinition.DisplayName : "",
                 WeeklyPoolId = x.WeeklyPoolId,
                 BalancesEarned = x.BalancesEarned,
                 ValuePerBalance = x.ValuePerBalance,
@@ -58,6 +64,12 @@ public class GetUserCommissionPayoutsQueryHandler : IRequestHandler<GetUserCommi
             })
             .ToListAsync(cancellationToken);
 
+        // // Populate WeekDisplayName from cache
+        // foreach (var model in models)
+        // {
+        //     model.WeekDisplayName = _weekDefinitionRepository.GetDisplayNameByGregorianWeekNumber(model.WeekNumber);
+        // }
+
         return new GetUserCommissionPayoutsResponseDto
         {
             MetaData = meta,

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserCommissionPayouts/GetUserCommissionPayoutsQueryValidator.cs

@@ -14,10 +14,10 @@ public class GetUserCommissionPayoutsQueryValidator : AbstractValidator<GetUserC
             .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));
+        RuleFor(x => x.WeekDefinitionId)
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند صفر باشد")
+            .When(x => x.WeekDefinitionId.HasValue);
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Queries/GetUserCommissionPayouts/GetUserCommissionPayoutsResponseDto.cs

@@ -12,7 +12,8 @@ public class GetUserCommissionPayoutsResponseModel
     public long UserId { get; set; }
     public string FirstName { get; set; } = string.Empty;
     public string LastName { get; set; } = string.Empty;
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; }
+    public string WeekDisplayName { get; set; } = string.Empty;
     public long WeeklyPoolId { get; set; }
     public long BalancesEarned { get; set; }
     public decimal ValuePerBalance { get; set; }

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

@@ -11,9 +11,10 @@ public record GetUserWeeklyBalancesQuery : IRequest<GetUserWeeklyBalancesRespons
     public long? UserId { get; init; }
 
     /// <summary>
-    /// شماره هفته (اختیاری)
+    /// شناسه تعریف هفته (اختیاری) - روش ترجیحی
     /// </summary>
-    public string? WeekNumber { get; init; }
+    public long? WeekDefinitionId { get; init; }
+
 
     /// <summary>
     /// فقط موارد Expired نشده؟

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

@@ -3,15 +3,20 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetUserWeeklyBalances
 public class GetUserWeeklyBalancesQueryHandler : IRequestHandler<GetUserWeeklyBalancesQuery, GetUserWeeklyBalancesResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetUserWeeklyBalancesQueryHandler(IApplicationDbContext context)
+    public GetUserWeeklyBalancesQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetUserWeeklyBalancesResponseDto> Handle(GetUserWeeklyBalancesQuery request, CancellationToken cancellationToken)
     {
         var query = _context.NetworkWeeklyBalances
+            .Include(x => x.WeekDefinition)
             .AsNoTracking()
             .AsQueryable();
 
@@ -21,19 +26,20 @@ public class GetUserWeeklyBalancesQueryHandler : IRequestHandler<GetUserWeeklyBa
             query = query.Where(x => x.UserId == request.UserId.Value);
         }
 
-        if (!string.IsNullOrEmpty(request.WeekNumber))
+        // فیلتر بر اساس WeekDefinitionId (روش ترجیحی)
+        if (request.WeekDefinitionId.HasValue)
         {
-            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+            query = query.Where(x => x.WeekDefinitionId == request.WeekDefinitionId.Value);
         }
     
+
         if (request.OnlyActive.HasValue && request.OnlyActive.Value)
         {
             query = query.Where(x => !x.IsExpired);
         }
 
-        // نمی‌توانیم "-WeekNumber" استفاده کنیم چون WeekNumber یک string است
-        // از Created برای مرتب‌سازی استفاده می‌کنیم (جدیدترین هفته‌ها اول)
-        query = query.ApplyOrder(sortBy: request.SortBy ?? "Created");
+        // مرتب‌سازی بر اساس WeekDefinitionId (نزولی = جدیدترین اول)
+        query = query.ApplyOrder(sortBy: request.SortBy ?? "-WeekDefinitionId");
 
         var meta = await query.GetMetaData(request.PaginationState, cancellationToken);
 
@@ -43,7 +49,8 @@ public class GetUserWeeklyBalancesQueryHandler : IRequestHandler<GetUserWeeklyBa
             {
                 Id = x.Id,
                 UserId = x.UserId,
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName = x.WeekDefinition != null ? x.WeekDefinition.DisplayName : "",
                 LeftLegBalances = x.LeftLegBalances,
                 RightLegBalances = x.RightLegBalances,
                 TotalBalances = x.TotalBalances,

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

@@ -9,10 +9,10 @@ public class GetUserWeeklyBalancesQueryValidator : AbstractValidator<GetUserWeek
             .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));
+        RuleFor(x => x.WeekDefinitionId)
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند صفر باشد")
+            .When(x => x.WeekDefinitionId.HasValue);
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

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

@@ -10,7 +10,9 @@ public class GetUserWeeklyBalancesResponseModel
 {
     public long Id { get; set; }
     public long UserId { get; set; }
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; }
+
+    public string WeekDisplayName { get; set; } = string.Empty;
     public int LeftLegBalances { get; set; }
     public int RightLegBalances { get; set; }
     public int TotalBalances { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeekDefinitions/GetWeekDefinitionsQuery.cs

@@ -0,0 +1,45 @@
+using CMSMicroservice.Application.Common.Models;
+
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeekDefinitions;
+
+/// <summary>
+/// Query برای دریافت لیست هفته‌ها از کش (برای dropdown)
+/// </summary>
+public record GetWeekDefinitionsQuery : IRequest<GetWeekDefinitionsResponseDto>
+{
+    //موقعیت صفحه بندی 
+    public PaginationState? PaginationState { get; init; }
+    
+    //مرتب سازی بر اساس 
+    public string? SortBy { get; init; }
+    
+    //فیلتر 
+    public GetWeekDefinitionsFilter? Filter { get; init; }
+}
+
+/// <summary>
+/// فیلترهای جستجوی هفته‌ها
+/// </summary>
+public class GetWeekDefinitionsFilter
+{
+    //جستجوی متنی روی DisplayName (مثل "هفته یک")
+    public string? SearchText { get; set; }
+    
+    //شماره ترتیب هفته
+    public int? WeekOrder { get; set; }
+    
+    //شماره هفته میلادی (2025-W46)
+    public string? GregorianWeekNumber { get; set; }
+    
+    //شماره هفته شمسی (1404-W35)
+    public string? PersianWeekNumber { get; set; }
+    
+    //سال میلادی
+    public int? GregorianYear { get; set; }
+    
+    //سال شمسی
+    public int? PersianYear { get; set; }
+    
+    //فقط هفته‌های فعال
+    public bool? IsActive { get; set; }
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeekDefinitions/GetWeekDefinitionsQueryHandler.cs

@@ -0,0 +1,130 @@
+using CMSMicroservice.Application.Common.Interfaces;
+
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeekDefinitions;
+
+/// <summary>
+/// Handler برای دریافت لیست هفته‌ها از کش
+/// </summary>
+public class GetWeekDefinitionsQueryHandler : IRequestHandler<GetWeekDefinitionsQuery, GetWeekDefinitionsResponseDto>
+{
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
+
+    public GetWeekDefinitionsQueryHandler(IWeekDefinitionRepository weekDefinitionRepository)
+    {
+        _weekDefinitionRepository = weekDefinitionRepository;
+    }
+
+    public Task<GetWeekDefinitionsResponseDto> Handle(
+        GetWeekDefinitionsQuery request, 
+        CancellationToken cancellationToken)
+    {
+        // گرفتن همه هفته‌ها از کش
+        var allWeeks = _weekDefinitionRepository.GetAllWeeks();
+        
+        // اعمال فیلترها
+        var filteredWeeks = allWeeks.AsEnumerable();
+        
+        if (request.Filter != null)
+        {
+            var filter = request.Filter;
+            
+            // جستجوی متنی روی DisplayName
+            if (!string.IsNullOrWhiteSpace(filter.SearchText))
+            {
+                filteredWeeks = filteredWeeks.Where(w => 
+                    w.DisplayName.Contains(filter.SearchText, StringComparison.OrdinalIgnoreCase));
+            }
+            
+            // فیلتر بر اساس WeekOrder
+            if (filter.WeekOrder.HasValue)
+            {
+                filteredWeeks = filteredWeeks.Where(w => w.WeekOrder == filter.WeekOrder.Value);
+            }
+            
+            // فیلتر بر اساس GregorianWeekNumber
+            if (!string.IsNullOrWhiteSpace(filter.GregorianWeekNumber))
+            {
+                filteredWeeks = filteredWeeks.Where(w => 
+                    w.GregorianWeekNumber == filter.GregorianWeekNumber);
+            }
+            
+            // فیلتر بر اساس PersianWeekNumber
+            if (!string.IsNullOrWhiteSpace(filter.PersianWeekNumber))
+            {
+                filteredWeeks = filteredWeeks.Where(w => 
+                    w.PersianWeekNumber == filter.PersianWeekNumber);
+            }
+            
+            // فیلتر بر اساس سال میلادی
+            if (filter.GregorianYear.HasValue)
+            {
+                filteredWeeks = filteredWeeks.Where(w => w.GregorianYear == filter.GregorianYear.Value);
+            }
+            
+            // فیلتر بر اساس سال شمسی
+            if (filter.PersianYear.HasValue)
+            {
+                filteredWeeks = filteredWeeks.Where(w => w.PersianYear == filter.PersianYear.Value);
+            }
+            
+            // فیلتر بر اساس فعال بودن
+            if (filter.IsActive.HasValue)
+            {
+                filteredWeeks = filteredWeeks.Where(w => w.IsActive == filter.IsActive.Value);
+            }
+        }
+        
+        // مرتب‌سازی
+        filteredWeeks = request.SortBy?.ToLower() switch
+        {
+            "weekorder_desc" => filteredWeeks.OrderByDescending(w => w.WeekOrder),
+            "displayname" => filteredWeeks.OrderBy(w => w.DisplayName),
+            "displayname_desc" => filteredWeeks.OrderByDescending(w => w.DisplayName),
+            "startdate" => filteredWeeks.OrderBy(w => w.StartDate),
+            "startdate_desc" => filteredWeeks.OrderByDescending(w => w.StartDate),
+            _ => filteredWeeks.OrderBy(w => w.WeekOrder) // پیش‌فرض: weekorder
+        };
+        
+        // تعداد کل قبل از صفحه‌بندی
+        var weeksList = filteredWeeks.ToList();
+        var totalCount = weeksList.Count;
+        
+        // صفحه‌بندی
+        if (request.PaginationState != null)
+        {
+            var pageNumber = request.PaginationState.PageNumber > 0 ? request.PaginationState.PageNumber : 1;
+            var pageSize = request.PaginationState.PageSize > 0 ? request.PaginationState.PageSize : 20;
+            
+            weeksList = weeksList
+                .Skip((pageNumber - 1) * pageSize)
+                .Take(pageSize)
+                .ToList();
+        }
+        
+        // گرفتن هفته جاری برای مشخص کردن IsCurrentWeek
+        var currentWeek = _weekDefinitionRepository.GetCurrentWeek();
+        
+        // تبدیل به DTO
+        var weekDtos = weeksList.Select(w => new WeekDefinitionItemDto
+        {
+            WeekOrder = w.WeekOrder,
+            DisplayName = w.DisplayName,
+            GregorianWeekNumber = w.GregorianWeekNumber,
+            PersianWeekNumber = w.PersianWeekNumber,
+            StartDate = w.StartDate,
+            EndDate = w.EndDate,
+            GregorianYear = w.GregorianYear,
+            PersianYear = w.PersianYear,
+            IsActive = w.IsActive,
+            IsCurrentWeek = currentWeek != null && w.WeekOrder == currentWeek.WeekOrder
+        }).ToList();
+
+        var response = new GetWeekDefinitionsResponseDto
+        {
+            Data = weekDtos,
+            TotalCount = totalCount
+        };
+
+        return Task.FromResult(response);
+    }
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeekDefinitions/GetWeekDefinitionsResponseDto.cs

@@ -0,0 +1,49 @@
+namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeekDefinitions;
+
+/// <summary>
+/// DTO برای پاسخ لیست هفته‌ها
+/// </summary>
+public class GetWeekDefinitionsResponseDto
+{
+    //لیست هفته‌ها
+    public List<WeekDefinitionItemDto> Data { get; set; } = new();
+    
+    //تعداد کل
+    public int TotalCount { get; set; }
+}
+
+/// <summary>
+/// آیتم هفته برای dropdown
+/// </summary>
+public class WeekDefinitionItemDto
+{
+    //شماره ترتیب هفته (1, 2, 3, ...)
+    public int WeekOrder { get; set; }
+    
+    //نام نمایشی هفته (هفته یکم، هفته دوم، ...)
+    public string DisplayName { get; set; } = string.Empty;
+    
+    //شماره هفته میلادی (2025-W46)
+    public string GregorianWeekNumber { get; set; } = string.Empty;
+    
+    //شماره هفته شمسی (1404-W35)
+    public string PersianWeekNumber { get; set; } = string.Empty;
+    
+    //تاریخ شروع هفته
+    public DateTime StartDate { get; set; }
+    
+    //تاریخ پایان هفته
+    public DateTime EndDate { get; set; }
+    
+    //سال میلادی
+    public int GregorianYear { get; set; }
+    
+    //سال شمسی
+    public int PersianYear { get; set; }
+    
+    //فعال بودن
+    public bool IsActive { get; set; }
+    
+    //آیا هفته جاری است؟
+    public bool IsCurrentWeek { get; set; }
+}

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeeklyCommissionPool/GetWeeklyCommissionPoolQuery.cs

@@ -8,5 +8,5 @@ public record GetWeeklyCommissionPoolQuery : IRequest<WeeklyCommissionPoolDto?>
     /// <summary>
     /// شماره هفته
     /// </summary>
-    public string WeekNumber { get; init; } = string.Empty;
+    public long WeekDefinitionId { get; init; }
 }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeeklyCommissionPool/GetWeeklyCommissionPoolQueryHandler.cs

@@ -3,21 +3,27 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPo
 public class GetWeeklyCommissionPoolQueryHandler : IRequestHandler<GetWeeklyCommissionPoolQuery, WeeklyCommissionPoolDto?>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetWeeklyCommissionPoolQueryHandler(IApplicationDbContext context)
+    public GetWeeklyCommissionPoolQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<WeeklyCommissionPoolDto?> Handle(GetWeeklyCommissionPoolQuery request, CancellationToken cancellationToken)
     {
         var pool = await _context.WeeklyCommissionPools  
+            .Include(x => x.WeekDefinition)
             .AsNoTracking()
-            .Where(x => x.WeekNumber == request.WeekNumber)
+            .Where(x => x.WeekDefinitionId == request.WeekDefinitionId)
             .Select(x => new WeeklyCommissionPoolDto
             {
                 Id = x.Id,
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName=x.WeekDefinition.DisplayName,
                 TotalPoolAmount = x.TotalPoolAmount,
                 TotalBalances = x.TotalBalances,
                 ValuePerBalance = x.ValuePerBalance,
@@ -27,6 +33,11 @@ public class GetWeeklyCommissionPoolQueryHandler : IRequestHandler<GetWeeklyComm
             })
             .FirstOrDefaultAsync(cancellationToken);
 
-        return pool??new WeeklyCommissionPoolDto();
+        // if (pool != null)
+        // {
+        //     pool.WeekDisplayName = _weekDefinitionRepository.GetDisplayNameByGregorianWeekNumber(pool.WeekNumber);
+        // }
+
+        return pool ?? new WeeklyCommissionPoolDto();
     }
 }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeeklyCommissionPool/GetWeeklyCommissionPoolQueryValidator.cs

@@ -4,11 +4,9 @@ public class GetWeeklyCommissionPoolQueryValidator : AbstractValidator<GetWeekly
 {
     public GetWeeklyCommissionPoolQueryValidator()
     {
-        RuleFor(x => x.WeekNumber)
-            .NotEmpty()
-            .WithMessage("شماره هفته نمی‌تواند خالی باشد")
-            .Matches(@"^\d{4}-W\d{2}$")
-            .WithMessage("فرمت شماره هفته باید YYYY-Www باشد");
+        RuleFor(x => x.WeekDefinitionId)
+            .GreaterThan(0)
+            .WithMessage("شماره هفته نمی‌تواند صفر باشد");
     }
 
     public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWeeklyCommissionPool/WeeklyCommissionPoolDto.cs

@@ -6,7 +6,8 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWeeklyCommissionPo
 public class WeeklyCommissionPoolDto
 {
     public long Id { get; set; }
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; } 
+    public string WeekDisplayName { get; set; } = string.Empty;
     public long TotalPoolAmount { get; set; }
     public long TotalBalances { get; set; }
     public decimal ValuePerBalance { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWithdrawalRequests/GetWithdrawalRequestsQuery.cs

@@ -4,7 +4,7 @@ public class GetWithdrawalRequestsQuery : IRequest<GetWithdrawalRequestsResponse
 {
     public int? Status { get; set; } // CommissionPayoutStatus enum
     public long? UserId { get; set; }
-    public string? WeekNumber { get; set; }
+    public long? WeekDefinitionId { get; init; }
     public string? IbanNumber { get; set; }
     public PaginationState? PaginationState { get; set; }
     public string? SortBy { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWithdrawalRequests/GetWithdrawalRequestsQueryHandler.cs

@@ -3,10 +3,14 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWithdrawalRequests
 public class GetWithdrawalRequestsQueryHandler : IRequestHandler<GetWithdrawalRequestsQuery, GetWithdrawalRequestsResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetWithdrawalRequestsQueryHandler(IApplicationDbContext context)
+    public GetWithdrawalRequestsQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetWithdrawalRequestsResponseDto> Handle(GetWithdrawalRequestsQuery request, CancellationToken cancellationToken)
@@ -14,6 +18,7 @@ public class GetWithdrawalRequestsQueryHandler : IRequestHandler<GetWithdrawalRe
         var query = _context.UserCommissionPayouts
             .AsNoTracking()
             .Include(x => x.User)
+            .Include(x => x.WeekDefinition)
             .Where(x => x.WithdrawalMethod != null) // Only requests with withdrawal method
             .AsQueryable();
 
@@ -28,9 +33,9 @@ public class GetWithdrawalRequestsQueryHandler : IRequestHandler<GetWithdrawalRe
             query = query.Where(x => x.UserId == request.UserId.Value);
         }
 
-        if (!string.IsNullOrEmpty(request.WeekNumber))
+        if (request.WeekDefinitionId!= null && request.WeekDefinitionId >0)
         {
-            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+            query = query.Where(x => x.WeekDefinitionId == request.WeekDefinitionId);
         }
 
         if (!string.IsNullOrWhiteSpace(request.IbanNumber))
@@ -51,7 +56,8 @@ public class GetWithdrawalRequestsQueryHandler : IRequestHandler<GetWithdrawalRe
             Id = x.Id,
             UserId = x.UserId,
             UserName = x.User != null ? (x.User.FirstName + " " + x.User.LastName).Trim() : x.User?.Mobile ?? "N/A",
-            WeekNumber = x.WeekNumber,
+            WeekDefinitionId = x.WeekDefinitionId,
+            WeekDisplayName =x.WeekDefinition.DisplayName,
             Amount = x.TotalAmount,
             Status = (int)x.Status,
             WithdrawalMethod = x.WithdrawalMethod.HasValue ? (int)x.WithdrawalMethod.Value : 0,

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWithdrawalRequests/GetWithdrawalRequestsResponseDto.cs

@@ -11,7 +11,8 @@ public class WithdrawalRequestModel
     public long Id { get; set; }
     public long UserId { get; set; }
     public string UserName { get; set; } = string.Empty;
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; } 
+    public string WeekDisplayName { get; set; } = string.Empty;
     public long Amount { get; set; }
     public int Status { get; set; } // CommissionPayoutStatus enum
     public int? WithdrawalMethod { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWorkerExecutionLogs/GetWorkerExecutionLogsQuery.cs

@@ -4,7 +4,7 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWorkerExecutionLog
 
 public record GetWorkerExecutionLogsQuery : IRequest<GetWorkerExecutionLogsResponseDto>
 {
-    public string? WeekNumber { get; init; }
+    public long? WeekDefinitionId { get; init; }
     public string? ExecutionId { get; init; }
     public bool? SuccessOnly { get; init; }
     public bool? FailedOnly { get; init; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWorkerExecutionLogs/GetWorkerExecutionLogsQueryHandler.cs

@@ -6,10 +6,14 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWorkerExecutionLog
 public class GetWorkerExecutionLogsQueryHandler : IRequestHandler<GetWorkerExecutionLogsQuery, GetWorkerExecutionLogsResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetWorkerExecutionLogsQueryHandler(IApplicationDbContext context)
+    public GetWorkerExecutionLogsQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetWorkerExecutionLogsResponseDto> Handle(
@@ -17,12 +21,14 @@ public class GetWorkerExecutionLogsQueryHandler : IRequestHandler<GetWorkerExecu
         CancellationToken cancellationToken)
     {
         // Query from database
-        var query = _context.WorkerExecutionLogs.AsQueryable();
+        var query = _context.WorkerExecutionLogs
+            .Include(i=> i.WeekDefinition)
+            .AsQueryable();
 
         // Apply filters
-        if (!string.IsNullOrEmpty(request.WeekNumber))
+        if (request.WeekDefinitionId!=null && request.WeekDefinitionId > 0)
         {
-            query = query.Where(x => x.WeekNumber == request.WeekNumber);
+            query = query.Where(x => x.WeekDefinitionId == request.WeekDefinitionId);
         }
 
         if (request.SuccessOnly == true)
@@ -49,7 +55,8 @@ public class GetWorkerExecutionLogsQueryHandler : IRequestHandler<GetWorkerExecu
             .Select(x => new WorkerExecutionLogModel
             {
                 ExecutionId = x.ExecutionId.ToString(),
-                WeekNumber = x.WeekNumber,
+                WeekDefinitionId = x.WeekDefinitionId,
+                WeekDisplayName = x.WeekDefinition.DisplayName,
                 Step = "Full", // We only have full execution now
                 Success = x.Status == Domain.Entities.Commission.WorkerExecutionStatus.Success ||
                          x.Status == Domain.Entities.Commission.WorkerExecutionStatus.SuccessWithWarnings,
@@ -62,6 +69,12 @@ public class GetWorkerExecutionLogsQueryHandler : IRequestHandler<GetWorkerExecu
             })
             .ToListAsync(cancellationToken);
 
+        // // Populate WeekDisplayName from cache
+        // foreach (var log in logs)
+        // {
+        //     log.WeekDisplayName = _weekDefinitionRepository.GetDisplayNameByGregorianWeekNumber(log.WeekNumber);
+        // }
+
         return new GetWorkerExecutionLogsResponseDto
         {
             MetaData = new MetaData

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWorkerExecutionLogs/GetWorkerExecutionLogsResponseDto.cs

@@ -11,7 +11,8 @@ public class GetWorkerExecutionLogsResponseDto
 public class WorkerExecutionLogModel
 {
     public string ExecutionId { get; set; } = string.Empty;
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; } 
+    public string WeekDisplayName { get; set; } = string.Empty;
     public string Step { get; set; } = string.Empty; // "Balances" | "Pool" | "Payouts" | "Full"
     public bool Success { get; set; }
     public string? ErrorMessage { get; set; }

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWorkerStatus/GetWorkerStatusQueryHandler.cs

@@ -5,10 +5,14 @@ namespace CMSMicroservice.Application.CommissionCQ.Queries.GetWorkerStatus;
 public class GetWorkerStatusQueryHandler : IRequestHandler<GetWorkerStatusQuery, GetWorkerStatusResponseDto>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetWorkerStatusQueryHandler(IApplicationDbContext context)
+    public GetWorkerStatusQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<GetWorkerStatusResponseDto> Handle(
@@ -20,12 +24,18 @@ public class GetWorkerStatusQueryHandler : IRequestHandler<GetWorkerStatusQuery,
         
         await Task.CompletedTask;
         
+        var currentWeek = _weekDefinitionRepository.GetCurrentWeek();
+        var currentWeekNumber = currentWeek != null 
+            ? $"{currentWeek.GregorianYear}-W{currentWeek.GregorianWeekNumber:D2}" 
+            : null;
+
         return new GetWorkerStatusResponseDto
         {
             IsRunning = false,
             IsEnabled = true,
             CurrentExecutionId = null,
-            CurrentWeekNumber = null,
+            CurrentWeekNumber = currentWeekNumber,
+            CurrentWeekDisplayName = currentWeek?.DisplayName,
             CurrentStep = "Idle",
             LastRunAt = DateTime.Now.AddHours(-24),
             NextScheduledRun = DateTime.Now.AddDays(7),

src/CMSMicroservice.Application/CommissionCQ/Queries/GetWorkerStatus/GetWorkerStatusResponseDto.cs

@@ -6,6 +6,7 @@ public class GetWorkerStatusResponseDto
     public bool IsEnabled { get; set; }
     public string? CurrentExecutionId { get; set; }
     public string? CurrentWeekNumber { get; set; }
+    public string? CurrentWeekDisplayName { get; set; }
     public string? CurrentStep { get; set; } // "Balances" | "Pool" | "Payouts" | "Idle"
     public DateTime? LastRunAt { get; set; }
     public DateTime? NextScheduledRun { get; set; }

src/CMSMicroservice.Application/Common/Interfaces/IApplicationDbContext.cs

@@ -1,6 +1,7 @@
 using CMSMicroservice.Domain.Entities.Payment;
 using CMSMicroservice.Domain.Entities.Order;
 using CMSMicroservice.Domain.Entities.DiscountShop;
+using CMSMicroservice.Domain.Entities.Geography;
 
 namespace CMSMicroservice.Application.Common.Interfaces;
 
@@ -39,6 +40,7 @@ public interface IApplicationDbContext
     DbSet<UserClubFeature> UserClubFeatures { get; }
     DbSet<NetworkWeeklyBalance> NetworkWeeklyBalances { get; }
     DbSet<NetworkMembershipHistory> NetworkMembershipHistories { get; }
+    DbSet<WeekDefinition> WeekDefinitions { get; }
     DbSet<WeeklyCommissionPool> WeeklyCommissionPools { get; }
     DbSet<UserCommissionPayout> UserCommissionPayouts { get; }
     DbSet<CommissionPayoutHistory> CommissionPayoutHistories { get; }
@@ -53,5 +55,10 @@ public interface IApplicationDbContext
     DbSet<DiscountOrder> DiscountOrders { get; }
     DbSet<DiscountOrderDetail> DiscountOrderDetails { get; }
     
+    // ============= Geography =============
+    DbSet<Country> Countries { get; }
+    DbSet<State> States { get; }
+    DbSet<City> Cities { get; }
+    
     Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
 }

src/CMSMicroservice.Application/Common/Interfaces/ICommissionCalculationStrategy.cs

@@ -0,0 +1,48 @@
+namespace CMSMicroservice.Application.Common.Interfaces;
+
+/// <summary>
+/// استراتژی محاسبه کمیسیون هفتگی
+/// دو پیاده‌سازی دارد: ORM و Stored Procedure
+/// </summary>
+public interface ICommissionCalculationStrategy
+{
+    /// <summary>
+    /// محاسبه تعادل‌های هفتگی (مرحله 1)
+    /// </summary>
+    /// <param name="weekDefinitionId">شناسه هفته</param>
+    /// <param name="forceRecalculate">محاسبه مجدد حتی اگر قبلاً محاسبه شده</param>
+    /// <param name="cancellationToken">توکن لغو</param>
+    /// <returns>تعداد رکوردهای محاسبه شده</returns>
+    Task<int> CalculateWeeklyBalancesAsync(
+        long weekDefinitionId, 
+        bool forceRecalculate, 
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// محاسبه استخر کمیسیون و پرداخت‌ها (مرحله 2)
+    /// </summary>
+    /// <param name="weekDefinitionId">شناسه هفته</param>
+    /// <param name="forceRecalculate">محاسبه مجدد حتی اگر قبلاً محاسبه شده</param>
+    /// <param name="cancellationToken">توکن لغو</param>
+    /// <returns>شناسه Pool ایجاد شده</returns>
+    Task<long> CalculateWeeklyCommissionPoolAsync(
+        long weekDefinitionId, 
+        bool forceRecalculate, 
+        CancellationToken cancellationToken = default);
+}
+
+/// <summary>
+/// نوع استراتژی محاسبه کمیسیون
+/// </summary>
+public enum CommissionCalculationStrategyType
+{
+    /// <summary>
+    /// استفاده از Entity Framework (ORM) - پیش‌فرض
+    /// </summary>
+    Orm = 0,
+    
+    /// <summary>
+    /// استفاده از Stored Procedure - بهینه‌تر برای داده‌های زیاد
+    /// </summary>
+    StoredProcedure = 1
+}

src/CMSMicroservice.Application/Common/Interfaces/ICommissionCalculationStrategyFactory.cs

@@ -0,0 +1,20 @@
+namespace CMSMicroservice.Application.Common.Interfaces;
+
+/// <summary>
+/// Factory برای ایجاد Strategy مناسب براساس Config
+/// </summary>
+public interface ICommissionCalculationStrategyFactory
+{
+    /// <summary>
+    /// ایجاد Strategy براساس تنظیمات سیستم
+    /// </summary>
+    /// <returns>استراتژی مناسب (ORM یا SP)</returns>
+    Task<ICommissionCalculationStrategy> CreateStrategyAsync(CancellationToken cancellationToken = default);
+    
+    /// <summary>
+    /// ایجاد Strategy مشخص
+    /// </summary>
+    /// <param name="strategyType">نوع استراتژی</param>
+    /// <returns>استراتژی درخواستی</returns>
+    ICommissionCalculationStrategy CreateStrategy(CommissionCalculationStrategyType strategyType);
+}

src/CMSMicroservice.Application/Common/Interfaces/ITokenNotificationService.cs

@@ -0,0 +1,26 @@
+namespace CMSMicroservice.Application.Common.Interfaces;
+
+/// <summary>
+/// Interface for sending token-related notifications via SignalR
+/// </summary>
+public interface ITokenNotificationService
+{
+    /// <summary>
+    /// Notify that a user's token has been revoked and they should refresh their token
+    /// </summary>
+    /// <param name="userId">The user ID whose token was revoked</param>
+    /// <param name="reason">The reason for revocation</param>
+    Task NotifyTokenRevokedAsync(long userId, string reason);
+
+    /// <summary>
+    /// Notify that a user should refresh their token due to profile changes
+    /// </summary>
+    /// <param name="userId">The user ID whose profile changed</param>
+    Task NotifyForceRefreshAsync(long userId);
+
+    /// <summary>
+    /// Broadcast a message to all connected clients
+    /// </summary>
+    /// <param name="message">The message to broadcast</param>
+    Task BroadcastMessageAsync(string message);
+}

src/CMSMicroservice.Application/Common/Interfaces/IWeekDefinitionRepository.cs

@@ -0,0 +1,163 @@
+using CMSMicroservice.Domain.Entities;
+
+namespace CMSMicroservice.Application.Common.Interfaces;
+
+/// <summary>
+/// اینترفیس ریپازیتوری هفته‌ها با کش در حافظه
+/// این سرویس موقع استارت برنامه از دیتابیس لود می‌شود و در حافظه نگهداری می‌شود
+/// </summary>
+public interface IWeekDefinitionRepository
+{
+    /// <summary>
+    /// گرفتن هفته جاری
+    /// </summary>
+    WeekDefinition? GetCurrentWeek();
+    
+    /// <summary>
+    /// گرفتن هفته جاری (async برای سازگاری)
+    /// </summary>
+    Task<WeekDefinition?> GetCurrentWeekAsync(CancellationToken cancellationToken = default);
+    
+    /// <summary>
+    /// گرفتن هفته بعد
+    /// </summary>
+    WeekDefinition? GetNextWeek();
+    
+    /// <summary>
+    /// گرفتن هفته بعد از هفته مشخص
+    /// </summary>
+    WeekDefinition? GetNextWeek(WeekDefinition currentWeek);
+    
+    /// <summary>
+    /// گرفتن هفته قبل
+    /// </summary>
+    WeekDefinition? GetPreviousWeek();
+    
+    /// <summary>
+    /// گرفتن هفته قبل از هفته مشخص
+    /// </summary>
+    WeekDefinition? GetPreviousWeek(WeekDefinition currentWeek);
+    
+    /// <summary>
+    /// گرفتن هفته بر اساس تاریخ میلادی
+    /// </summary>
+    WeekDefinition? GetWeekByDate(DateTime date);
+    
+    /// <summary>
+    /// گرفتن هفته بر اساس شماره هفته میلادی (مثال: "2025-W46")
+    /// </summary>
+    WeekDefinition? GetWeekByGregorianWeekNumber(string gregorianWeekNumber);
+    
+    /// <summary>
+    /// گرفتن هفته بر اساس شماره هفته شمسی (مثال: "1404-W35")
+    /// </summary>
+    WeekDefinition? GetWeekByPersianWeekNumber(string persianWeekNumber);
+    
+    /// <summary>
+    /// گرفتن هفته بر اساس شماره ترتیبی
+    /// </summary>
+    WeekDefinition? GetWeekByOrder(int weekOrder);
+    
+    /// <summary>
+    /// گرفتن لیست همه هفته‌ها
+    /// </summary>
+    IReadOnlyList<WeekDefinition> GetAllWeeks();
+    
+    /// <summary>
+    /// گرفتن هفته‌های یک سال میلادی خاص
+    /// </summary>
+    IReadOnlyList<WeekDefinition> GetWeeksByGregorianYear(int year);
+    
+    /// <summary>
+    /// گرفتن هفته‌های یک سال شمسی خاص
+    /// </summary>
+    IReadOnlyList<WeekDefinition> GetWeeksByPersianYear(int year);
+    
+    /// <summary>
+    /// گرفتن شماره هفته میلادی جاری (مثال: "2025-W51")
+    /// </summary>
+    string GetCurrentGregorianWeekNumber();
+    
+    /// <summary>
+    /// گرفتن شماره هفته شمسی جاری (مثال: "1404-W39")
+    /// </summary>
+    string GetCurrentPersianWeekNumber();
+    
+    /// <summary>
+    /// گرفتن نام نمایشی هفته جاری (مثال: "هفته ششم")
+    /// </summary>
+    string GetCurrentWeekDisplayName();
+    
+    /// <summary>
+    /// آیا تاریخ مشخص در هفته جاری است؟
+    /// </summary>
+    bool IsDateInCurrentWeek(DateTime date);
+    
+    /// <summary>
+    /// محاسبه شماره هفته میلادی برای یک تاریخ (حتی اگر در کش نباشد)
+    /// </summary>
+    string CalculateGregorianWeekNumber(DateTime date);
+    
+    /// <summary>
+    /// محاسبه شماره هفته شمسی برای یک تاریخ (حتی اگر در کش نباشد)
+    /// </summary>
+    string CalculatePersianWeekNumber(DateTime date);
+    
+    /// <summary>
+    /// بارگذاری مجدد کش از دیتابیس
+    /// </summary>
+    Task ReloadCacheAsync(CancellationToken cancellationToken = default);
+    
+    /// <summary>
+    /// گرفتن بازه تاریخی یک هفته بر اساس شماره هفته میلادی
+    /// </summary>
+    (DateTime startDate, DateTime endDate)? GetWeekDateRange(string gregorianWeekNumber);
+
+    (DateTime startDate, DateTime endDate)? GetWeekDateRange(long WeekDefinitionId);
+    
+    /// <summary>
+    /// گرفتن شماره هفته قبل از هفته مشخص
+    /// </summary>
+    string? GetPreviousWeekNumber(string gregorianWeekNumber);
+    
+    /// <summary>
+    /// گرفتن شماره هفته بعد از هفته مشخص
+    /// </summary>
+    string? GetNextWeekNumber(string gregorianWeekNumber);
+    
+    /// <summary>
+    /// گرفتن DisplayName یک هفته بر اساس شماره هفته میلادی (مثل "هفته یکم")
+    /// </summary>
+    string GetDisplayNameByGregorianWeekNumber(string gregorianWeekNumber);
+    
+    /// <summary>
+    /// جستجوی هفته‌ها بر اساس DisplayName (برای dropdown)
+    /// اگر فیلتر خالی باشد همه هفته‌ها برگردانده می‌شود
+    /// </summary>
+    IEnumerable<WeekDefinition> SearchWeeksByDisplayName(string? filter = null);
+    
+    /// <summary>
+    /// گرفتن WeekDefinitionId از شماره هفته میلادی
+    /// </summary>
+    /// <param name="gregorianWeekNumber">شماره هفته میلادی (مثال: "2025-W46")</param>
+    /// <returns>شناسه WeekDefinition یا null اگر پیدا نشد</returns>
+    long? GetWeekDefinitionId(string gregorianWeekNumber);
+
+    WeekDefinition? GetWeekById(long weekDefinitionId);
+    /// <summary>
+    /// گرفتن شماره هفته میلادی از WeekDefinitionId
+    /// </summary>
+    /// <param name="weekDefinitionId">شناسه WeekDefinition</param>
+    /// <returns>شماره هفته میلادی یا null اگر پیدا نشد</returns>
+    string? GetGregorianWeekNumber(long weekDefinitionId);
+    
+    /// <summary>
+    /// آیا کش لود شده؟
+    /// </summary>
+    bool IsCacheLoaded { get; }
+    
+    /// <summary>
+    /// تعداد هفته‌های موجود در کش
+    /// </summary>
+    int CachedWeeksCount { get; }
+}

src/CMSMicroservice.Application/DayaLoanCQ/Commands/CheckDayaLoanStatus/CheckDayaLoanStatusCommandHandler.cs

@@ -11,6 +11,11 @@ public class CheckDayaLoanStatusCommandHandler : IRequestHandler<CheckDayaLoanSt
     private readonly IDayaLoanApiService _dayaApiService;
     private readonly ILogger<CheckDayaLoanStatusCommandHandler> _logger;
     
+    /// <summary>
+    /// مبلغ وام دایا - 56 میلیون ریال
+    /// </summary>
+    private const long DAYA_LOAN_AMOUNT = 56_000_000;
+
     public CheckDayaLoanStatusCommandHandler(
         IApplicationDbContext context,
         IDayaLoanApiService dayaApiService,
@@ -48,9 +53,24 @@ public class CheckDayaLoanStatusCommandHandler : IRequestHandler<CheckDayaLoanSt
                     
                     if (existingContract != null)
                     {
+                        var previousStatus = existingContract.Status;
                         existingContract.LastCheckDate = DateTime.Now;
                         existingContract.Status = dayaResult.Status;
                         existingContract.ContractNumber = dayaResult.ContractNumber;
+                        
+                        // بررسی تغییر وضعیت به PendingReceive یا Received
+                        // فقط اگر قبلاً پردازش نشده باشد
+                        if (!existingContract.IsProcessed && 
+                            !string.IsNullOrEmpty(dayaResult.ContractNumber) &&
+                            (dayaResult.Status == DayaLoanStatus.PendingReceive || dayaResult.Status == DayaLoanStatus.Received))
+                        {
+                            await ProcessDayaLoanReceivedAsync(existingContract.UserId, dayaResult.ContractNumber, cancellationToken);
+                            existingContract.IsProcessed = true;
+                            
+                            _logger.LogInformation(
+                                "Daya loan processed for User {UserId}, ContractNumber: {ContractNumber}, Amount: {Amount}",
+                                existingContract.UserId, dayaResult.ContractNumber, DAYA_LOAN_AMOUNT);
+                        }
                     }
                     else
                     {
@@ -59,6 +79,20 @@ public class CheckDayaLoanStatusCommandHandler : IRequestHandler<CheckDayaLoanSt
                         
                         if (user != null)
                         {
+                            var isProcessed = false;
+                            
+                            // اگر وضعیت PendingReceive یا Received بود و قرارداد دارد، فوری پردازش کن
+                            if (!string.IsNullOrEmpty(dayaResult.ContractNumber) &&
+                                (dayaResult.Status == DayaLoanStatus.PendingReceive || dayaResult.Status == DayaLoanStatus.Received))
+                            {
+                                await ProcessDayaLoanReceivedAsync(user.Id, dayaResult.ContractNumber, cancellationToken);
+                                isProcessed = true;
+                                
+                                _logger.LogInformation(
+                                    "Daya loan processed for new contract - User {UserId}, ContractNumber: {ContractNumber}, Amount: {Amount}",
+                                    user.Id, dayaResult.ContractNumber, DAYA_LOAN_AMOUNT);
+                            }
+                            
                             var newContract = new DayaLoanContract
                             {
                                 UserId = user.Id,
@@ -66,7 +100,7 @@ public class CheckDayaLoanStatusCommandHandler : IRequestHandler<CheckDayaLoanSt
                                 Status = dayaResult.Status,
                                 ContractNumber = dayaResult.ContractNumber,
                                 LastCheckDate = DateTime.Now,
-                                IsProcessed = false
+                                IsProcessed = isProcessed
                             };
                             
                             await _context.DayaLoanContracts.AddAsync(newContract, cancellationToken);
@@ -105,4 +139,101 @@ public class CheckDayaLoanStatusCommandHandler : IRequestHandler<CheckDayaLoanSt
             SuccessCount = results.Count(r => r.ContractNumber != null)
         };
     }
+    
+    /// <summary>
+    /// پردازش دریافت وام دایا برای کاربر
+    /// 1. شارژ کیف پول (Balance + DiscountBalance)
+    /// 2. ثبت تراکنش
+    /// 3. ثبت لاگ کیف پول
+    /// 4. به‌روزرسانی وضعیت کاربر
+    /// </summary>
+    private async Task ProcessDayaLoanReceivedAsync(long userId, string contractNumber, CancellationToken cancellationToken)
+    {
+        // پیدا کردن کاربر
+        var user = await _context.Users
+            .FirstOrDefaultAsync(u => u.Id == userId, cancellationToken);
+        
+        if (user == null)
+        {
+            _logger.LogWarning("User {UserId} not found for Daya loan processing", userId);
+            return;
+        }
+        
+        // بررسی اینکه قبلاً دریافت نکرده باشد
+        if (user.HasReceivedDayaCredit)
+        {
+            _logger.LogWarning("User {UserId} has already received Daya credit", userId);
+            return;
+        }
+        
+        // پیدا کردن یا ایجاد کیف پول کاربر
+        var wallet = await _context.UserWallets
+            .FirstOrDefaultAsync(w => w.UserId == userId, cancellationToken);
+        
+        if (wallet == null)
+        {
+            wallet = new UserWallet
+            {
+                UserId = userId,
+                Balance = 0,
+                NetworkBalance = 0,
+                DiscountBalance = 0
+            };
+            await _context.UserWallets.AddAsync(wallet, cancellationToken);
+            await _context.SaveChangesAsync(cancellationToken);
+        }
+        
+        // 1. شارژ کیف پول - هم موجودی اصلی و هم موجودی تخفیف
+        var previousBalance = wallet.Balance;
+        var previousDiscountBalance = wallet.DiscountBalance;
+        
+        wallet.Balance += DAYA_LOAN_AMOUNT;
+        wallet.DiscountBalance += DAYA_LOAN_AMOUNT;
+        
+        // 2. ثبت تراکنش - RefId = شماره قرارداد، Status = 0 (Success)، Type = 2 (DepositExternal1)
+        var transaction = new Transaction
+        {
+            Amount = DAYA_LOAN_AMOUNT,
+            Description = $"شارژ کیف پول از وام دایا - قرارداد {contractNumber}",
+            PaymentStatus = PaymentStatus.Success, // 0
+            PaymentDate = DateTime.Now,
+            RefId = contractNumber,
+            Type = TransactionType.DepositExternal1 // 2
+        };
+        
+        await _context.Transactions.AddAsync(transaction, cancellationToken);
+        await _context.SaveChangesAsync(cancellationToken);
+        
+        // 3. ثبت لاگ کیف پول با شناسه تراکنش
+        var walletLog = new UserWalletChangeLog
+        {
+            WalletId = wallet.Id,
+            CurrentBalance = wallet.Balance,
+            ChangeValue = DAYA_LOAN_AMOUNT,
+            CurrentNetworkBalance = wallet.NetworkBalance,
+            ChangeNerworkValue = 0,
+            CurrentDiscountBalance = wallet.DiscountBalance,
+            ChangeDiscountValue = DAYA_LOAN_AMOUNT,
+            IsIncrease = true,
+            RefrenceId = transaction.Id
+        };
+        
+        await _context.UserWalletChangeLogs.AddAsync(walletLog, cancellationToken);
+        
+        // 4. به‌روزرسانی وضعیت کاربر
+        user.HasReceivedDayaCredit = true;
+        user.DayaCreditReceivedAt = DateTime.Now;
+        user.PackagePurchaseMethod = PackagePurchaseMethod.DayaLoan; // 1
+        
+        await _context.SaveChangesAsync(cancellationToken);
+        
+        _logger.LogInformation(
+            "Daya loan fully processed for User {UserId}: " +
+            "Wallet Balance {PreviousBalance} -> {NewBalance}, " +
+            "DiscountBalance {PreviousDiscountBalance} -> {NewDiscountBalance}, " +
+            "Transaction Id: {TransactionId}",
+            userId, previousBalance, wallet.Balance, 
+            previousDiscountBalance, wallet.DiscountBalance, 
+            transaction.Id);
+    }
 }

src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkStatistics/GetNetworkStatisticsQueryHandler.cs

@@ -56,16 +56,20 @@ public class GetNetworkStatisticsQueryHandler : IRequestHandler<GetNetworkStatis
 
         // Monthly growth (last 6 months) - using Created date
         var sixMonthsAgo = DateTime.Now.AddMonths(-6);
-        var monthlyGrowth = await _context.Users
+        var monthlyGrowthRaw = await _context.Users
             .Where(x => x.NetworkParentId != null && x.Created >= sixMonthsAgo)
-            .GroupBy(x => new { x.Created.Year, x.Created.Month })
+            .Select(x => new { x.Created.Year, x.Created.Month })
+            .ToListAsync(cancellationToken);
+
+        var monthlyGrowth = monthlyGrowthRaw
+            .GroupBy(x => new { x.Year, x.Month })
             .Select(g => new MonthlyGrowthModel
             {
                 Month = $"{g.Key.Year}-{g.Key.Month:D2}",
                 NewMembers = g.Count()
             })
             .OrderBy(x => x.Month)
-            .ToListAsync(cancellationToken);
+            .ToList();
 
         // Top users by total children count
         var topUsers = await _context.Users

src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkTree/GetNetworkTreeQuery.cs

@@ -23,5 +23,5 @@ public record GetNetworkTreeQuery : IRequest<NetworkTreeDto?>
     /// <summary>
     /// فیلتر براساس شماره هفته فعالسازی (مثال: 2025-W05)
     /// </summary>
-    public string? ActivationWeekNumber { get; init; }
+    public long? ActivationWeekDefinitionId { get; init; }
 }

src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkTree/GetNetworkTreeQueryHandler.cs

@@ -3,10 +3,14 @@ namespace CMSMicroservice.Application.NetworkMembershipCQ.Queries.GetNetworkTree
 public class GetNetworkTreeQueryHandler : IRequestHandler<GetNetworkTreeQuery, NetworkTreeDto?>
 {
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekDefinitionRepository;
 
-    public GetNetworkTreeQueryHandler(IApplicationDbContext context)
+    public GetNetworkTreeQueryHandler(
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekDefinitionRepository)
     {
         _context = context;
+        _weekDefinitionRepository = weekDefinitionRepository;
     }
 
     public async Task<NetworkTreeDto?> Handle(GetNetworkTreeQuery request, CancellationToken cancellationToken)
@@ -38,17 +42,21 @@ public class GetNetworkTreeQueryHandler : IRequestHandler<GetNetworkTreeQuery, N
         }
 
         // محاسبه شماره هفته فعال‌سازی
-        string? activationWeekNumber = null;
+        long? activationWeekDefinitionId = null;
+        string? activationWeekDisplayName = null;
         bool isActivatedInTargetWeek = false;
         
         if (user.ClubMembership?.ActivatedAt != null)
         {
-            activationWeekNumber = CalculateWeekNumber(user.ClubMembership.ActivatedAt.Value);
+            // activationWeekDefinitionId = CalculateWeekNumber(user.ClubMembership.ActivatedAt.Value);
+            var week = _weekDefinitionRepository.GetWeekByDate(user.ClubMembership.ActivatedAt.Value);
+            activationWeekDefinitionId = week.Id;
+            activationWeekDisplayName = week.DisplayName;
             
             // بررسی آیا در هفته هدف فعال شده است
-            if (!string.IsNullOrEmpty(request.ActivationWeekNumber))
+            if (request.ActivationWeekDefinitionId!=null)
             {
-                isActivatedInTargetWeek = activationWeekNumber == request.ActivationWeekNumber;
+                isActivatedInTargetWeek = activationWeekDefinitionId == request.ActivationWeekDefinitionId;
             }
         }
 
@@ -62,7 +70,8 @@ public class GetNetworkTreeQueryHandler : IRequestHandler<GetNetworkTreeQuery, N
             CurrentDepth = currentDepth,
             ClubActivatedAt = user.ClubMembership?.ActivatedAt,
             IsClubActive = user.ClubMembership?.IsActive ?? false,
-            ActivationWeekNumber = activationWeekNumber,
+            ActivationWeekDefinitionId = activationWeekDefinitionId,
+            ActivationWeekDisplayName = activationWeekDisplayName,
             IsActivatedInTargetWeek = isActivatedInTargetWeek,
             UserCreated = user.Created
         };
@@ -116,64 +125,20 @@ public class GetNetworkTreeQueryHandler : IRequestHandler<GetNetworkTreeQuery, N
     /// <summary>
     /// محاسبه شماره هفته از تاریخ
     /// </summary>
-    private static string CalculateWeekNumber(DateTime date)
-    {
-        var year = date.Year;
-        var jan1 = new DateTime(year, 1, 1);
-        var daysToFirstSaturday = (7 - (int)jan1.DayOfWeek + 7) % 7;
-        if (jan1.DayOfWeek == DayOfWeek.Saturday) 
-            daysToFirstSaturday = 0;
+    // private long CalculateWeekNumber(DateTime date)
+    // {
+    //     // First try to get from repository cache
+    //     var weekDef = _weekDefinitionRepository.GetWeekByDate(date);
+    //     if (weekDef != null)
+    //     {
+    //         return weekDef.Id;
+    //     }
+    //     
+    //     // Fallback: use repository's calculation method
+    //     // return _weekDefinitionRepository.CalculateGregorianWeekNumber(date);
+    //     return 0;
+    // }
 
-        var firstSaturday = jan1.AddDays(daysToFirstSaturday);
-        var weekNum = date < firstSaturday ? 1 : ((date - firstSaturday).Days / 7) + 1;
 
-        return $"{year}-W{weekNum:D2}";
-    }
  
-    /// <summary>
-    /// تبدیل شماره هفته (مثلاً 2025-W05) به تاریخ شروع و پایان هفته
-    /// </summary>
-    private static (DateTime? StartDate, DateTime? EndDate) ParseWeekNumber(string weekNumber)
-    {
-        try
-        {
-            // فرمت: YYYY-W##
-            var parts = weekNumber.Split('-');
-            if (parts.Length != 2 || !parts[1].StartsWith("W"))
-                return (null, null);
-
-            if (!int.TryParse(parts[0], out var year))
-                return (null, null);
-
-            if (!int.TryParse(parts[1].Substring(1), out var weekNum))
-                return (null, null);
-
-            // محاسبه اولین شنبه سال
-            var jan1 = new DateTime(year, 1, 1);
-            var daysToFirstSaturday = (7 - (int)jan1.DayOfWeek + 7) % 7;
-            if (jan1.DayOfWeek == DayOfWeek.Saturday) 
-                daysToFirstSaturday = 0;
-            
-            var firstSaturday = jan1.AddDays(daysToFirstSaturday);
-
-            // محاسبه تاریخ شروع هفته مورد نظر
-            DateTime startDate;
-            if (weekNum == 1)
-            {
-                startDate = firstSaturday;
-            }
-            else
-            {
-                startDate = firstSaturday.AddDays((weekNum - 1) * 7);
-            }
-
-            var endDate = startDate.AddDays(7);
-
-            return (startDate, endDate);
-        }
-        catch
-        {
-            return (null, null);
-        }
-    }
 }

src/CMSMicroservice.Application/NetworkMembershipCQ/Queries/GetNetworkTree/NetworkTreeDto.cs

@@ -25,7 +25,12 @@ public class NetworkTreeDto
     /// <summary>
     /// شماره هفته فعال‌سازی
     /// </summary>
-    public string? ActivationWeekNumber { get; set; }
+    public long? ActivationWeekDefinitionId { get; set; }
+    
+    /// <summary>
+    /// نام نمایشی هفته فعال‌سازی (مثل: هفته یکم)
+    /// </summary>
+    public string? ActivationWeekDisplayName { get; set; }
     
     /// <summary>
     /// آیا کاربر در هفته هدف فعال شده است؟

src/CMSMicroservice.Application/Profiles/CityProfile.cs

@@ -0,0 +1,22 @@
+using CMSMicroservice.Application.CityCQ.Queries.GetAllCitiesByFilter;
+using CMSMicroservice.Domain.Entities.Geography;
+using Mapster;
+
+namespace CMSMicroservice.Application.Profiles;
+
+public class CityProfile : IRegister
+{
+    public void Register(TypeAdapterConfig config)
+    {
+        config.NewConfig<City, GetAllCitiesByFilterResponseModel>()
+            .Map(dest => dest.Id, src => src.Id)
+            .Map(dest => dest.ExternalId, src => src.ExternalId)
+            .Map(dest => dest.Name, src => src.Name)
+            .Map(dest => dest.Native, src => src.Native)
+            .Map(dest => dest.Latitude, src => src.Latitude)
+            .Map(dest => dest.Longitude, src => src.Longitude)
+            .Map(dest => dest.StateId, src => src.StateId)
+            .Map(dest => dest.StateName, src => src.State.Name)
+            .Map(dest => dest.StateNative, src => src.State.Native);
+    }
+}

src/CMSMicroservice.Application/UserAddressCQ/Commands/UpdateUserAddress/UpdateUserAddressCommand.cs

@@ -4,7 +4,7 @@ public record UpdateUserAddressCommand : IRequest<Unit>
     //شناسه 
     public long Id { get; init; }
     //شناسه کاربر 
-    public long UserId { get; init; }
+
     //عنوان 
     public string Title { get; init; }
     //آدرس 

src/CMSMicroservice.Application/UserAddressCQ/Commands/UpdateUserAddress/UpdateUserAddressCommandValidator.cs

@@ -5,8 +5,7 @@ public class UpdateUserAddressCommandValidator : AbstractValidator<UpdateUserAdd
     {
         RuleFor(model => model.Id)
             .NotNull();
-        RuleFor(model => model.UserId)
-            .NotNull();
+     
         RuleFor(model => model.Title)
             .NotEmpty();
         RuleFor(model => model.Address)

src/CMSMicroservice.Application/UserCQ/Commands/RefreshToken/RefreshTokenCommand.cs

@@ -0,0 +1,14 @@
+using MediatR;
+
+namespace CMSMicroservice.Application.UserCQ.Commands.RefreshToken;
+
+/// <summary>
+/// درخواست رفرش توکن JWT
+/// </summary>
+public sealed record RefreshTokenCommand : IRequest<RefreshTokenResponseDto>
+{
+    /// <summary>
+    /// توکن فعلی کاربر
+    /// </summary>
+    public string CurrentToken { get; init; } = null!;
+}

src/CMSMicroservice.Application/UserCQ/Commands/RefreshToken/RefreshTokenCommandHandler.cs

@@ -0,0 +1,82 @@
+using System.IdentityModel.Tokens.Jwt;
+using System.Security.Claims;
+using CMSMicroservice.Application.Common.Interfaces;
+using CMSMicroservice.Domain.Entities;
+using MediatR;
+using Microsoft.EntityFrameworkCore;
+
+namespace CMSMicroservice.Application.UserCQ.Commands.RefreshToken;
+
+/// <summary>
+/// هندلر رفرش توکن - توکن جدید با آخرین اطلاعات کاربر تولید می‌کند
+/// </summary>
+public class RefreshTokenCommandHandler : IRequestHandler<RefreshTokenCommand, RefreshTokenResponseDto>
+{
+    private readonly IApplicationDbContext _context;
+    private readonly IGenerateJwtToken _generateJwt;
+
+    public RefreshTokenCommandHandler(IApplicationDbContext context, IGenerateJwtToken generateJwt)
+    {
+        _context = context;
+        _generateJwt = generateJwt;
+    }
+
+    public async Task<RefreshTokenResponseDto> Handle(RefreshTokenCommand request, CancellationToken cancellationToken)
+    {
+        try
+        {
+            // Extract user id from current token
+            var handler = new JwtSecurityTokenHandler();
+            var jwtToken = handler.ReadJwtToken(request.CurrentToken);
+            
+            var userIdClaim = jwtToken.Claims.FirstOrDefault(c => c.Type == ClaimTypes.NameIdentifier);
+            if (userIdClaim == null || !long.TryParse(userIdClaim.Value, out var userId))
+            {
+                return new RefreshTokenResponseDto
+                {
+                    Success = false,
+                    Message = "توکن نامعتبر است",
+                    Token = string.Empty
+                };
+            }
+
+            // Get user with all required relations
+            var user = await _context.Users
+                .Include(u => u.UserContracts)
+                .ThenInclude(u => u.Contract)
+                .Include(u => u.UserRoles)
+                .ThenInclude(ur => ur.Role)
+                .Include(u => u.ClubMembership)
+                .FirstOrDefaultAsync(x => x.Id == userId, cancellationToken);
+
+            if (user == null)
+            {
+                return new RefreshTokenResponseDto
+                {
+                    Success = false,
+                    Message = "کاربر یافت نشد",
+                    Token = string.Empty
+                };
+            }
+
+            // Generate new token
+            var newToken = await _generateJwt.GenerateJwtToken(user);
+
+            return new RefreshTokenResponseDto
+            {
+                Success = true,
+                Message = "توکن با موفقیت رفرش شد",
+                Token = newToken
+            };
+        }
+        catch (Exception ex)
+        {
+            return new RefreshTokenResponseDto
+            {
+                Success = false,
+                Message = $"خطا در رفرش توکن: {ex.Message}",
+                Token = string.Empty
+            };
+        }
+    }
+}

src/CMSMicroservice.Application/UserCQ/Commands/RefreshToken/RefreshTokenResponseDto.cs

@@ -0,0 +1,22 @@
+namespace CMSMicroservice.Application.UserCQ.Commands.RefreshToken;
+
+/// <summary>
+/// پاسخ رفرش توکن
+/// </summary>
+public class RefreshTokenResponseDto
+{
+    /// <summary>
+    /// توکن جدید
+    /// </summary>
+    public string Token { get; set; } = null!;
+    
+    /// <summary>
+    /// آیا عملیات موفق بود؟
+    /// </summary>
+    public bool Success { get; set; }
+    
+    /// <summary>
+    /// پیام
+    /// </summary>
+    public string Message { get; set; } = null!;
+}

src/CMSMicroservice.Application/UserCQ/EventHandlers/UpdateUserEventHandlers/UpdateUserEventHandler.cs

@@ -1,3 +1,4 @@
+using CMSMicroservice.Application.Common.Interfaces;
 using CMSMicroservice.Domain.Events;
 using Microsoft.Extensions.Logging;
 
@@ -6,16 +7,23 @@ namespace CMSMicroservice.Application.UserCQ.EventHandlers;
 public class UpdateUserEventHandler : INotificationHandler<UpdateUserEvent>
 {
     private readonly ILogger<UpdateUserEventHandler> _logger;
+    private readonly ITokenNotificationService _tokenNotificationService;
 
-    public UpdateUserEventHandler(ILogger<UpdateUserEventHandler> logger)
+    public UpdateUserEventHandler(
+        ILogger<UpdateUserEventHandler> logger,
+        ITokenNotificationService tokenNotificationService)
     {
         _logger = logger;
+        _tokenNotificationService = tokenNotificationService;
     }
 
-    public Task Handle(UpdateUserEvent notification, CancellationToken cancellationToken)
+    public async Task Handle(UpdateUserEvent notification, CancellationToken cancellationToken)
     {
-        _logger.LogInformation("Domain Event: {DomainEvent}", notification.GetType().Name);
+        _logger.LogInformation("Domain Event: {DomainEvent} for User {UserId}", 
+            notification.GetType().Name, 
+            notification.Item.Id);
 
-        return Task.CompletedTask;
+        // Notify connected clients that user profile has changed and token should be refreshed
+        await _tokenNotificationService.NotifyForceRefreshAsync(notification.Item.Id);
     }
 }

src/CMSMicroservice.Application/UserOrderCQ/Commands/SubmitShopBuyOrder/SubmitShopBuyOrderCommandHandler.cs

@@ -10,6 +10,7 @@ public class
 {
     private readonly IApplicationDbContext _context;
     private readonly ILogger<SubmitShopBuyOrderCommandHandler> _logger;
+    private float _vatRate;
 
     public SubmitShopBuyOrderCommandHandler(
         IApplicationDbContext context,
@@ -32,7 +33,57 @@ public class
         if (user.UserCarts.Count == 0)
             throw new NotFoundException("UserCart", request.UserId);
 
-        if (user.UserCarts.Sum(s => s.Count * s.Product.Price) != request.TotalAmount)
+        // چک موجودی محصولات
+        var outOfStockProducts = new List<string>();
+        var insufficientStockProducts = new List<(string Title, int Requested, int Available)>();
+
+        foreach (var cartItem in user.UserCarts)
+        {
+            if (cartItem.Product.RemainingCount <= 0)
+            {
+                outOfStockProducts.Add(cartItem.Product.Title);
+            }
+            else if (cartItem.Product.RemainingCount < cartItem.Count)
+            {
+                insufficientStockProducts.Add((cartItem.Product.Title, cartItem.Count,
+                    cartItem.Product.RemainingCount));
+            }
+        }
+
+        if (outOfStockProducts.Any())
+        {
+            throw new Exception($"محصولات زیر ناموجود شده‌اند: {string.Join("، ", outOfStockProducts)}");
+        }
+
+        if (insufficientStockProducts.Any())
+        {
+            var messages = insufficientStockProducts.Select(p =>
+                $"«{p.Title}»: درخواست {p.Requested} عدد، موجودی {p.Available} عدد");
+            throw new Exception($"موجودی محصولات زیر کافی نیست: {string.Join(" | ", messages)}");
+        }
+
+        long finalAmount = 0;
+        var vatIsEnable =
+            _context.SystemConfigurations
+                           .FirstOrDefault(f => f.Scope == ConfigurationScope.VAT && f.Key == "IsEnabled")?.Value ??
+                       "0";
+        if (vatIsEnable=="1")
+        {
+            _vatRate = float.Parse(
+                _context.SystemConfigurations
+                    .FirstOrDefault(f => f.Scope == ConfigurationScope.VAT && f.Key == "Shop.VAT")?.Value ??
+                throw new InvalidOperationException());
+            finalAmount = AddVAT(user.UserCarts.Sum(s => s.Count * s.Product.Price));
+            _logger.LogInformation(
+                "Calculating final amount with VAT. Base Amount: {BaseAmount}, VAT Rate: {VATRate}, Final Amount: {FinalAmount}",
+                user.UserCarts.Sum(s => s.Count * s.Product.Price), _vatRate, finalAmount);
+        }
+        else
+        {
+            finalAmount = user.UserCarts.Sum(s => s.Count * s.Product.Price);
+        }
+
+        if (finalAmount != request.TotalAmount)
             throw new Exception("مبلغ سفارش با مجموع سبد خرید مطابقت ندارد.");
 
 
@@ -40,7 +91,7 @@ public class
         if (userWallet == null)
             throw new Exception("کیف پول کاربر یافت نشد.");
 
-        if (userWallet.Balance<=0 || userWallet.Balance<request.TotalAmount)
+        if (userWallet.Balance <= 0 || userWallet.Balance < request.TotalAmount)
             throw new Exception("موجودی کیف پول کاربر برای انجام این تراکنش کافی نیست.");
 
         var newTransaction = new Transaction()
@@ -60,7 +111,7 @@ public class
             CurrentBalance = userWallet.Balance,
             CurrentNetworkBalance = userWallet.NetworkBalance,
             WalletId = userWallet.Id,
-            ChangeValue = -1*request.TotalAmount,
+            ChangeValue = -1 * request.TotalAmount,
             IsIncrease = false,
             RefrenceId = newTransaction.Id,
         };
@@ -96,20 +147,38 @@ public class
         {
             ProductId = s.ProductId,
             Count = s.Count,
-            UnitPrice = s.Product.Price,
+            UnitPrice =vatIsEnable=="1" ?AddVAT(s.Product.Price): s.Product.Price,
             OrderId = newOrder.Id
         });
         await _context.FactorDetails.AddRangeAsync(factorDetailsList, cancellationToken);
+
+        // کاهش موجودی محصولات و افزایش تعداد فروش
+        foreach (var cartItem in user.UserCarts)
+        {
+            cartItem.Product.RemainingCount -= cartItem.Count;
+            cartItem.Product.SaleCount += cartItem.Count;
+        }
+
         user.UserCarts.Clear();
         await _context.SaveChangesAsync(cancellationToken);
+
+        _logger.LogInformation("Order {OrderId} completed. Stock updated for {ProductCount} products.",
+            newOrder.Id, factorDetailsList.Count());
+
         var finalResult = new SubmitShopBuyOrderResponseDto()
         {
             Id = newOrder.Id,
-  
         };
         return finalResult;
     }
 
+    public long CalculateVAT(long amount) => (long)(amount * _vatRate);
+
+    /// <summary>
+    /// محاسبه قیمت با احتساب مالیات
+    /// </summary>
+    public long AddVAT(long amount) => amount + CalculateVAT(amount);
+
     private async Task<bool> CalculateAndSaveVAT(long orderId, long orderAmount, CancellationToken cancellationToken)
     {
         try
@@ -126,7 +195,7 @@ public class
 
             // دریافت نرخ VAT
             var vatRateConfig = await _context.SystemConfigurations
-                .FirstOrDefaultAsync(x => x.Scope == ConfigurationScope.VAT && x.Key == "Rate", cancellationToken);
+                .FirstOrDefaultAsync(x => x.Scope == ConfigurationScope.VAT && x.Key == "Shop.VAT", cancellationToken);
 
             if (vatRateConfig == null || !decimal.TryParse(vatRateConfig.Value, out var vatRate))
             {

src/CMSMicroservice.Domain/Entities/Club/ClubFeature.cs

@@ -11,19 +11,17 @@ public class ClubFeature : BaseAuditableEntity
     public string Title { get; set; }
 
     /// <summary>
-    /// توضیحات
+    /// توضیحات کوتاه
     /// </summary>
     public string? Description { get; set; }
     
+    
+
     /// <summary>
     /// وضعیت فعال/غیرفعال
     /// </summary>
     public bool IsActive { get; set; }
 
-    /// <summary>
-    /// امتیاز لازم برای دریافت (اختیاری)
-    /// </summary>
-    public int? RequiredPoints { get; set; }
 
     /// <summary>
     /// ترتیب نمایش

src/CMSMicroservice.Domain/Entities/Commission/UserCommissionPayout.cs

@@ -15,10 +15,16 @@ public class UserCommissionPayout : BaseAuditableEntity
     /// </summary>
     public virtual User User { get; set; }
 
+
     /// <summary>
-    /// شماره هفته
+    /// شناسه تعریف هفته (کلید خارجی به WeekDefinition)
     /// </summary>
-    public string WeekNumber { get; set; }
+    public long WeekDefinitionId { get; set; }
+
+    /// <summary>
+    /// WeekDefinition Navigation Property
+    /// </summary>
+    public virtual WeekDefinition WeekDefinition { get; set; }
 
     /// <summary>
     /// شناسه استخر هفتگی

src/CMSMicroservice.Domain/Entities/Commission/WeeklyCommissionPool.cs

@@ -5,10 +5,16 @@ namespace CMSMicroservice.Domain.Entities.Commission;
 /// </summary>
 public class WeeklyCommissionPool : BaseAuditableEntity
 {
+
     /// <summary>
-    /// شماره هفته (مثال: "2025-W48")
+    /// شناسه تعریف هفته (کلید خارجی به WeekDefinition)
     /// </summary>
-    public string WeekNumber { get; set; }
+    public long WeekDefinitionId { get; set; }
+
+    /// <summary>
+    /// WeekDefinition Navigation Property
+    /// </summary>
+    public virtual WeekDefinition WeekDefinition { get; set; }
 
     /// <summary>
     /// مجموع مبلغ جمع‌شده در استخر (ریال)

src/CMSMicroservice.Domain/Entities/Commission/WorkerExecutionLog.cs

@@ -12,10 +12,17 @@ public class WorkerExecutionLog : BaseAuditableEntity
     /// </summary>
     public Guid ExecutionId { get; set; }
 
+ 
+
     /// <summary>
-    /// شماره هفته (مثلاً 2025-W48)
+    /// شناسه تعریف هفته (کلید خارجی به WeekDefinition)
     /// </summary>
-    public string WeekNumber { get; set; } = string.Empty;
+    public long WeekDefinitionId { get; set; }
+
+    /// <summary>
+    /// WeekDefinition Navigation Property
+    /// </summary>
+    public virtual WeekDefinition WeekDefinition { get; set; }
 
     /// <summary>
     /// زمان شروع اجرا

src/CMSMicroservice.Domain/Entities/Geography/City.cs

@@ -0,0 +1,49 @@
+using CMSMicroservice.Domain.Common;
+
+namespace CMSMicroservice.Domain.Entities.Geography;
+
+/// <summary>
+/// شهر - City
+/// </summary>
+public class City : BaseAuditableEntity
+{
+    /// <summary>
+    /// شناسه یکتا
+    /// </summary>
+    public long Id { get; set; }
+
+    /// <summary>
+    /// شناسه خارجی (External ID)
+    /// </summary>
+    public long ExternalId { get; set; }
+
+    /// <summary>
+    /// نام شهر
+    /// </summary>
+    public required string Name { get; set; }
+
+    /// <summary>
+    /// عرض جغرافیایی
+    /// </summary>
+    public required string Latitude { get; set; }
+
+    /// <summary>
+    /// طول جغرافیایی
+    /// </summary>
+    public required string Longitude { get; set; }
+
+    /// <summary>
+    /// نام بومی شهر (فارسی یا زبان محلی)
+    /// </summary>
+    public required string Native { get; set; }
+
+    /// <summary>
+    /// شناسه استان متعلق
+    /// </summary>
+    public long StateId { get; set; }
+
+    /// <summary>
+    /// استان متعلق
+    /// </summary>
+    public virtual State State { get; set; } = null!;
+}

src/CMSMicroservice.Domain/Entities/Geography/Country.cs

@@ -0,0 +1,109 @@
+using CMSMicroservice.Domain.Common;
+
+namespace CMSMicroservice.Domain.Entities.Geography;
+
+/// <summary>
+/// کشور - Country
+/// </summary>
+public class Country : BaseAuditableEntity
+{
+    /// <summary>
+    /// شناسه یکتا
+    /// </summary>
+    public long Id { get; set; }
+
+    /// <summary>
+    /// شناسه خارجی (External ID)
+    /// </summary>
+    public long ExternalId { get; set; }
+
+    /// <summary>
+    /// نام کشور (انگلیسی)
+    /// </summary>
+    public required string Name { get; set; }
+
+    /// <summary>
+    /// کد ISO3 (3 حرفی)
+    /// </summary>
+    public required string Iso3 { get; set; }
+
+    /// <summary>
+    /// کد ISO2 (2 حرفی)
+    /// </summary>
+    public required string Iso2 { get; set; }
+
+    /// <summary>
+    /// کد عددی کشور
+    /// </summary>
+    public required string NumericCode { get; set; }
+
+    /// <summary>
+    /// کد تلفن کشور (مثلاً 98 برای ایران)
+    /// </summary>
+    public required string PhoneCode { get; set; }
+
+    /// <summary>
+    /// پایتخت
+    /// </summary>
+    public required string Capital { get; set; }
+
+    /// <summary>
+    /// واحد پول (کد ارز)
+    /// </summary>
+    public required string Currency { get; set; }
+
+    /// <summary>
+    /// نام واحد پول
+    /// </summary>
+    public required string CurrencyName { get; set; }
+
+    /// <summary>
+    /// نماد واحد پول
+    /// </summary>
+    public required string CurrencySymbol { get; set; }
+
+    /// <summary>
+    /// Top-Level Domain (مثلاً .ir)
+    /// </summary>
+    public required string Tld { get; set; }
+
+    /// <summary>
+    /// نام بومی کشور (فارسی یا زبان محلی)
+    /// </summary>
+    public required string Native { get; set; }
+
+    /// <summary>
+    /// منطقه جغرافیایی (مثلاً Asia)
+    /// </summary>
+    public required string Region { get; set; }
+
+    /// <summary>
+    /// زیرمنطقه (مثلاً Southern Asia)
+    /// </summary>
+    public required string Subregion { get; set; }
+
+    /// <summary>
+    /// عرض جغرافیایی
+    /// </summary>
+    public required string Latitude { get; set; }
+
+    /// <summary>
+    /// طول جغرافیایی
+    /// </summary>
+    public required string Longitude { get; set; }
+
+    /// <summary>
+    /// ایموجی پرچم کشور
+    /// </summary>
+    public required string Emoji { get; set; }
+
+    /// <summary>
+    /// کد یونیکد ایموجی
+    /// </summary>
+    public required string EmojiU { get; set; }
+
+    /// <summary>
+    /// استان‌های این کشور
+    /// </summary>
+    public virtual ICollection<State> States { get; set; } = new List<State>();
+}

src/CMSMicroservice.Domain/Entities/Geography/State.cs

@@ -0,0 +1,64 @@
+using CMSMicroservice.Domain.Common;
+
+namespace CMSMicroservice.Domain.Entities.Geography;
+
+/// <summary>
+/// استان - State/Province
+/// </summary>
+public class State : BaseAuditableEntity
+{
+    /// <summary>
+    /// شناسه یکتا
+    /// </summary>
+    public long Id { get; set; }
+
+    /// <summary>
+    /// شناسه خارجی (External ID)
+    /// </summary>
+    public long ExternalId { get; set; }
+
+    /// <summary>
+    /// نام استان
+    /// </summary>
+    public required string Name { get; set; }
+
+    /// <summary>
+    /// کد استان
+    /// </summary>
+    public required string StateCode { get; set; }
+
+    /// <summary>
+    /// عرض جغرافیایی
+    /// </summary>
+    public required string Latitude { get; set; }
+
+    /// <summary>
+    /// طول جغرافیایی
+    /// </summary>
+    public required string Longitude { get; set; }
+
+    /// <summary>
+    /// نوع استان (province, state, etc.)
+    /// </summary>
+    public required string Type { get; set; }
+
+    /// <summary>
+    /// نام بومی استان (فارسی یا زبان محلی)
+    /// </summary>
+    public required string Native { get; set; }
+
+    /// <summary>
+    /// شناسه کشور متعلق
+    /// </summary>
+    public long CountryId { get; set; }
+
+    /// <summary>
+    /// کشور متعلق
+    /// </summary>
+    public virtual Country Country { get; set; } = null!;
+
+    /// <summary>
+    /// شهرهای این استان
+    /// </summary>
+    public virtual ICollection<City> Cities { get; set; } = new List<City>();
+}

src/CMSMicroservice.Domain/Entities/History/CommissionPayoutHistory.cs

@@ -20,10 +20,16 @@ public class CommissionPayoutHistory : BaseAuditableEntity
     /// </summary>
     public long UserId { get; set; }
 
+
     /// <summary>
-    /// شماره هفته
+    /// شناسه تعریف هفته (کلید خارجی به WeekDefinition)
     /// </summary>
-    public string WeekNumber { get; set; }
+    public long WeekDefinitionId { get; set; }
+
+    /// <summary>
+    /// WeekDefinition Navigation Property
+    /// </summary>
+    public virtual WeekDefinition WeekDefinition { get; set; }
 
     /// <summary>
     /// مبلغ قبل از تغییر

src/CMSMicroservice.Domain/Entities/Network/NetworkWeeklyBalance.cs

@@ -16,9 +16,14 @@ public class NetworkWeeklyBalance : BaseAuditableEntity
     public virtual User User { get; set; }
 
     /// <summary>
-    /// شماره هفته (مثال: "2025-W48")
+    /// شناسه تعریف هفته (کلید خارجی به WeekDefinition)
     /// </summary>
-    public string WeekNumber { get; set; }
+    public long WeekDefinitionId { get; set; }
+
+    /// <summary>
+    /// WeekDefinition Navigation Property
+    /// </summary>
+    public virtual WeekDefinition WeekDefinition { get; set; }
 
     /// <summary>
     /// تعداد اعضای جدید شاخه چپ در این هفته

src/CMSMicroservice.Domain/Entities/WeekDefinition.cs

@@ -0,0 +1,67 @@
+using CMSMicroservice.Domain.Entities.Commission;
+using CMSMicroservice.Domain.Entities.History;
+using CMSMicroservice.Domain.Entities.Network;
+
+namespace CMSMicroservice.Domain.Entities;
+
+/// <summary>
+/// تعریف هفته‌ها برای نمایش در سیستم
+/// این جدول شامل اطلاعات کامل هر هفته شامل شماره نمایشی، شماره میلادی، شماره شمسی و بازه تاریخی است
+/// </summary>
+public class WeekDefinition : BaseAuditableEntity
+{
+    /// <summary>
+    /// شماره ترتیبی هفته (1، 2، 3، ...)
+    /// برای مرتب‌سازی و محاسبات استفاده می‌شود
+    /// </summary>
+    public int WeekOrder { get; set; }
+    
+    /// <summary>
+    /// نام نمایشی هفته (مثال: "هفته یکم"، "هفته دوم"، "هفته سوم")
+    /// این متن برای نمایش به کاربر نهایی (ادمین و مشتری) استفاده می‌شود
+    /// </summary>
+    public string DisplayName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// شماره هفته میلادی (مثال: "2025-W01", "2025-W02")
+    /// فرمت ISO 8601
+    /// </summary>
+    public string GregorianWeekNumber { get; set; } = string.Empty;
+
+    /// <summary>
+    /// شماره هفته شمسی (مثال: "1403-W01", "1403-W02")
+    /// </summary>
+    public string PersianWeekNumber { get; set; } = string.Empty;
+
+    /// <summary>
+    /// تاریخ شروع هفته (میلادی) - شنبه
+    /// </summary>
+    public DateTime StartDate { get; set; }
+
+    /// <summary>
+    /// تاریخ پایان هفته (میلادی) - جمعه
+    /// </summary>
+    public DateTime EndDate { get; set; }
+
+    /// <summary>
+    /// سال میلادی
+    /// </summary>
+    public int GregorianYear { get; set; }
+
+    /// <summary>
+    /// سال شمسی
+    /// </summary>
+    public int PersianYear { get; set; }
+
+    /// <summary>
+    /// آیا این هفته فعال است؟
+    /// </summary>
+    public bool IsActive { get; set; } = true;
+
+    // Navigation Properties
+    public virtual ICollection<NetworkWeeklyBalance>? NetworkWeeklyBalances { get; set; }
+    public virtual ICollection<WeeklyCommissionPool>? WeeklyCommissionPools { get; set; }
+    public virtual ICollection<UserCommissionPayout>? UserCommissionPayouts { get; set; }
+    public virtual ICollection<WorkerExecutionLog>? WorkerExecutionLogs { get; set; }
+    public virtual ICollection<CommissionPayoutHistory>? CommissionPayoutHistories { get; set; }
+}

src/CMSMicroservice.Domain/Enums/ContractType.cs

@@ -2,6 +2,6 @@ namespace CMSMicroservice.Domain.Enums;
 //قراردادها
 public enum ContractType
 {
-    Main = 0,
-    CMS = 1,
+    Main = 0,           // قرارداد ثبت‌نام اولیه
+    ClubMembership = 1, // قرارداد باشگاه مشتریان
 }

src/CMSMicroservice.Infrastructure/BackgroundJobs/WeeklyCommissionJob.cs

@@ -21,16 +21,19 @@ public class WeeklyCommissionJob
     private readonly IMediator _mediator;
     private readonly ILogger<WeeklyCommissionJob> _logger;
     private readonly IApplicationDbContext _context;
+    private readonly IWeekDefinitionRepository _weekRepository;
     private readonly ResiliencePipeline _retryPipeline;
 
     public WeeklyCommissionJob(
         IMediator mediator,
         ILogger<WeeklyCommissionJob> logger,
-        IApplicationDbContext context)
+        IApplicationDbContext context,
+        IWeekDefinitionRepository weekRepository)
     {
         _mediator = mediator;
         _logger = logger;
         _context = context;
+        _weekRepository = weekRepository;
 
         // Polly Retry: 3 attempts, exponential backoff (5min → 10min → 20min)
         _retryPipeline = new ResiliencePipelineBuilder()
@@ -57,38 +60,42 @@ public class WeeklyCommissionJob
     /// Execute weekly commission calculation with retry logic
     /// Called by Hangfire scheduler or manually triggered
     /// </summary>
-    /// <param name="weekNumber">Week number in YYYY-Www format (e.g., 2025-W48). If null, uses previous week.</param>
+    /// <param name="weekDefinitionId">شناسه هفته. اگر null باشد، هفته قبلی محاسبه می‌شود</param>
     /// <param name="cancellationToken">Cancellation token</param>
-    public async Task ExecuteAsync(string? weekNumber = null, CancellationToken cancellationToken = default)
+    public async Task ExecuteAsync(long? weekDefinitionId = null, CancellationToken cancellationToken = default)
     {
         var executionId = Guid.NewGuid();
         var startTime = DateTime.Now;
 
-        // Use provided week number or calculate for PREVIOUS week (completed week)
-        string targetWeekNumber;
-        if (!string.IsNullOrWhiteSpace(weekNumber))
+        // Use provided WeekDefinitionId or calculate for PREVIOUS week (completed week)
+        long targetWeekDefinitionId;
+        if (weekDefinitionId.HasValue && weekDefinitionId.Value > 0)
         {
-            targetWeekNumber = weekNumber;
-            _logger.LogInformation("📅 Using manually specified week: {WeekNumber}", targetWeekNumber);
+            targetWeekDefinitionId = weekDefinitionId.Value;
+            _logger.LogInformation("📅 Using manually specified WeekDefinitionId: {WeekDefinitionId}", targetWeekDefinitionId);
         }
         else
         {
             var previousWeek = DateTime.Now.AddDays(-7);
-            targetWeekNumber = GetWeekNumber(previousWeek);
-            _logger.LogInformation("📅 Using previous week (auto-calculated): {WeekNumber}", targetWeekNumber);
+            var weekDef = _weekRepository.GetWeekByDate(previousWeek);
+            if (weekDef == null)
+            {
+                throw new InvalidOperationException($"هفته برای تاریخ {previousWeek:yyyy-MM-dd} تعریف نشده است");
+            }
+            targetWeekDefinitionId = weekDef.Id;
+            _logger.LogInformation("📅 Using previous week (auto-calculated): WeekDefinitionId={WeekDefinitionId}, WeekNumber={WeekNumber}", 
+                targetWeekDefinitionId, weekDef.GregorianWeekNumber);
         }
 
-        var previousWeekNumber = targetWeekNumber;
-
         _logger.LogInformation(
-            "🚀 [{ExecutionId}] Starting weekly commission calculation for {WeekNumber}",
-            executionId, previousWeekNumber);
+            "🚀 [{ExecutionId}] Starting weekly commission calculation for WeekDefinitionId={WeekDefinitionId}",
+            executionId, targetWeekDefinitionId);
 
         // Create execution log entry
         var log = new WorkerExecutionLog
         {
             ExecutionId = executionId,
-            WeekNumber = previousWeekNumber,
+            WeekDefinitionId = targetWeekDefinitionId,
             StartedAt = startTime,
             Status = WorkerExecutionStatus.Running
         };
@@ -100,7 +107,7 @@ public class WeeklyCommissionJob
             // Execute with retry pipeline
             await _retryPipeline.ExecuteAsync(async ct =>
             {
-                await ExecuteWeeklyCalculationAsync(executionId, previousWeekNumber, ct);
+                await ExecuteWeeklyCalculationAsync(executionId, targetWeekDefinitionId, ct);
             }, cancellationToken);
 
             // Update log on success
@@ -113,9 +120,9 @@ public class WeeklyCommissionJob
 
             // Get counts from database
             var balancesCount = await _context.NetworkWeeklyBalances
-                .CountAsync(x => x.WeekNumber == previousWeekNumber, cancellationToken);
+                .CountAsync(x => x.WeekDefinitionId == targetWeekDefinitionId, cancellationToken);
             var payoutsCount = await _context.UserCommissionPayouts
-                .CountAsync(x => x.WeekNumber == previousWeekNumber, cancellationToken);
+                .CountAsync(x => x.WeekDefinitionId == targetWeekDefinitionId, cancellationToken);
 
             log.ProcessedCount = balancesCount + payoutsCount;
 
@@ -149,21 +156,28 @@ public class WeeklyCommissionJob
 
     private async Task ExecuteWeeklyCalculationAsync(
         Guid executionId,
-        string weekNumber,
+        long weekDefinitionId,
         CancellationToken cancellationToken)
     {
         // Check idempotency: Skip if already calculated
         var existingPool = await _context.WeeklyCommissionPools
-            .FirstOrDefaultAsync(x => x.WeekNumber == weekNumber, cancellationToken);
+            .FirstOrDefaultAsync(x => x.WeekDefinitionId == weekDefinitionId, cancellationToken);
 
         if (existingPool != null && existingPool.IsCalculated)
         {
             _logger.LogWarning(
-                "⚠️ [{ExecutionId}] Week {WeekNumber} already calculated. Skipping.",
-                executionId, weekNumber);
+                "⚠️ [{ExecutionId}] WeekDefinitionId={WeekDefinitionId} already calculated. Skipping.",
+                executionId, weekDefinitionId);
             return;
         }
 
+        // دریافت WeekNumber برای command ها (فعلاً هنوز از WeekNumber استفاده می‌کنند)
+        var GregorianWeekNumber = _weekRepository.GetGregorianWeekNumber(weekDefinitionId);
+        if (string.IsNullOrEmpty(GregorianWeekNumber))
+        {
+            throw new InvalidOperationException($"WeekDefinitionId={weekDefinitionId} یافت نشد");
+        }
+
         using var transaction = new System.Transactions.TransactionScope(
             System.Transactions.TransactionScopeOption.Required,
             new System.Transactions.TransactionOptions
@@ -182,41 +196,14 @@ public class WeeklyCommissionJob
 
             await _mediator.Send(new TriggerWeeklyCalculationCommand
             {
-                WeekNumber = weekNumber,
+                WeekDefinitionId = weekDefinitionId,
                 ForceRecalculate = false
             }, cancellationToken);
-      // await _mediator.Send(new CalculateWeeklyBalancesCommand
-      //       {
-      //           WeekNumber = weekNumber,
-      //           ForceRecalculate = false
-      //       }, cancellationToken);
-      //
-      //       // Step 2: Calculate global commission pool
-      //       _logger.LogInformation(
-      //           "💰 [{ExecutionId}] Step 2/3: Calculating commission pool...",
-      //           executionId);
-      //
-      //       await _mediator.Send(new CalculateWeeklyCommissionPoolCommand
-      //       {
-      //           WeekNumber = weekNumber,
-      //           ForceRecalculate = false
-      //       }, cancellationToken);
-      //
-      //       // Step 3: Distribute commissions to users
-      //       _logger.LogInformation(
-      //           "💸 [{ExecutionId}] Step 3/3: Processing user payouts...",
-      //           executionId);
-      //
-      //       await _mediator.Send(new ProcessUserPayoutsCommand
-      //       {
-      //           WeekNumber = weekNumber,
-      //           ForceReprocess = false
-      //       }, cancellationToken);
 
             transaction.Complete();
 
             _logger.LogInformation(
-                "✅ [{ExecutionId}] All 2 steps completed successfully",
+                "✅ [{ExecutionId}] All steps completed successfully",
                 executionId);
         }
         catch (Exception ex)
@@ -227,24 +214,4 @@ public class WeeklyCommissionJob
             throw;
         }
     }
-
-    /// <summary>
-    /// Get ISO 8601 week number (YYYY-Www format)
-    /// </summary>
-    private static string GetWeekNumber(DateTime date)
-    {
-        var calendar = System.Globalization.CultureInfo.InvariantCulture.Calendar;
-        var weekNumber = calendar.GetWeekOfYear(
-            date,
-            System.Globalization.CalendarWeekRule.FirstDay,
-            DayOfWeek.Saturday);
-
-        var year = date.Year;
-        if (weekNumber >= 52 && date.Month == 1)
-            year--;
-        else if (weekNumber == 1 && date.Month == 12)
-            year++;
-
-        return $"{year}-W{weekNumber:D2}";
-    }
 }

src/CMSMicroservice.Infrastructure/ConfigureServices.cs

@@ -6,6 +6,8 @@ using CMSMicroservice.Infrastructure.BackgroundJobs;
 using CMSMicroservice.Infrastructure.Services.Monitoring;
 using CMSMicroservice.Infrastructure.Configuration;
 using CMSMicroservice.Infrastructure.Services.Payment;
+using CMSMicroservice.Infrastructure.Services.Commission;
+using CMSMicroservice.Infrastructure.Repositories;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Configuration;
 using Microsoft.AspNetCore.Authentication.JwtBearer;
@@ -83,6 +85,13 @@ public static class ConfigureServices
         
         services.AddScoped<IApplicationDbContext>(p => p.GetRequiredService<ApplicationDbContext>());
         
+        // Week Definition Repository - کش در حافظه برای هفته‌ها (Singleton برای کش، با IServiceScopeFactory برای دسترسی به DbContext)
+        services.AddSingleton<WeekDefinitionRepository>();
+        services.AddSingleton<IWeekDefinitionRepository>(sp => sp.GetRequiredService<WeekDefinitionRepository>());
+        
+        // Commission Calculation Strategy Factory - برای سوییچ بین ORM و SP
+        services.AddScoped<ICommissionCalculationStrategyFactory, CommissionCalculationStrategyFactory>();
+        
         // Background Workers - Deprecated: Using Hangfire instead
         // services.AddHostedService<WeeklyNetworkCommissionWorker>();
         services.AddScoped<WeeklyCommissionJob>(); // Hangfire Job (Scoped for DI)

src/CMSMicroservice.Infrastructure/Data/Seeding/WeekDefinitionSeeder.cs

@@ -0,0 +1,255 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Logging;
+using CMSMicroservice.Domain.Entities;
+using CMSMicroservice.Infrastructure.Persistence;
+using System.Globalization;
+using System.Collections.Generic;
+
+namespace CMSMicroservice.Infrastructure.Data.Seeding;
+
+/// <summary>
+/// Seeder برای پر کردن جدول WeekDefinitions
+/// هفته اول سیستم: 2025-W46 میلادی = 1404-W35 شمسی
+/// شروع هفته شمسی: شنبه | شروع هفته میلادی ISO: دوشنبه
+/// </summary>
+public class WeekDefinitionSeeder
+{
+    private readonly ApplicationDbContext _context;
+    private readonly ILogger<WeekDefinitionSeeder> _logger;
+    private readonly PersianCalendar _persianCalendar;
+    
+    /// <summary>
+    /// تاریخ شروع هفته اول سیستم (شنبه 17 آبان 1404 = 8 نوامبر 2025)
+    /// این شنبه در هفته 46 میلادی (ISO) و هفته 35 شمسی قرار دارد
+    /// </summary>
+    private static readonly DateTime BaseWeekStartDate = new DateTime(2025, 11, 8); // شنبه 8 نوامبر 2025
+
+    public WeekDefinitionSeeder(
+        ApplicationDbContext context,
+        ILogger<WeekDefinitionSeeder> logger)
+    {
+        _context = context;
+        _logger = logger;
+        _persianCalendar = new PersianCalendar();
+    }
+
+    /// <summary>
+    /// Seed هفته‌ها از هفته مبدأ تا یک سال بعد
+    /// </summary>
+    public async Task SeedAsync(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("=== WeekDefinitionSeeder: Starting ===");
+        _logger.LogInformation("Base week starts at: {BaseDate:yyyy-MM-dd} (Saturday)", BaseWeekStartDate);
+
+        try
+        {
+            var existingCount = await _context.WeekDefinitions.CountAsync(cancellationToken);
+            
+            if (existingCount > 0)
+            {
+                _logger.LogInformation("WeekDefinitions already has {Count} records. Checking for missing weeks...", existingCount);
+            }
+
+            // شروع از هفته مبدأ
+            var startDate = BaseWeekStartDate;
+            // پایان تا یک سال بعد از الان
+            var endDate = GetEndOfWeek(DateTime.Today.AddYears(1));
+
+            var currentDate = startDate;
+            var addedCount = 0;
+
+            while (currentDate <= endDate)
+            {
+                var weekStart = currentDate; // شنبه
+                var weekEnd = currentDate.AddDays(6).Date.AddHours(23).AddMinutes(59).AddSeconds(59); // جمعه 23:59:59
+
+                // محاسبه شماره ترتیبی هفته (از 1 شروع می‌شود)
+                var weekOrder = CalculateWeekOrder(weekStart);
+                
+                // نام نمایشی: هفته یکم، هفته دوم، ...
+                var displayName = GetPersianOrdinalWeekName(weekOrder);
+                
+                // شماره هفته میلادی ISO (بر اساس دوشنبه)
+                var gregorianWeekNumber = GetISOWeekNumber(weekStart);
+                
+                // شماره هفته شمسی (بر اساس شنبه)
+                var persianWeekNumber = GetPersianWeekNumber(weekStart);
+
+                // چک کنیم که این هفته قبلاً ثبت نشده باشه
+                var exists = await _context.WeekDefinitions
+                    .AnyAsync(w => w.StartDate == weekStart, cancellationToken);
+
+                if (!exists)
+                {
+                    var weekDefinition = new WeekDefinition
+                    {
+                        WeekOrder = weekOrder,
+                        DisplayName = displayName,
+                        GregorianWeekNumber = gregorianWeekNumber,
+                        PersianWeekNumber = persianWeekNumber,
+                        StartDate = weekStart,
+                        EndDate = weekEnd,
+                        GregorianYear = weekStart.Year,
+                        PersianYear = _persianCalendar.GetYear(weekStart),
+                        IsActive = true
+                    };
+
+                    _context.WeekDefinitions.Add(weekDefinition);
+                    addedCount++;
+
+                    _logger.LogDebug("Added: {DisplayName} | {GregorianWeek} | {PersianWeek} | {Start:yyyy-MM-dd} - {End:yyyy-MM-dd}",
+                        displayName, gregorianWeekNumber, persianWeekNumber, weekStart, weekEnd);
+                }
+
+                // رفتن به هفته بعد (7 روز)
+                currentDate = currentDate.AddDays(7);
+            }
+
+            if (addedCount > 0)
+            {
+                await _context.SaveChangesAsync(cancellationToken);
+                _logger.LogInformation("Successfully added {Count} week definitions", addedCount);
+            }
+            else
+            {
+                _logger.LogInformation("No new week definitions needed");
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "Error seeding WeekDefinitions");
+            throw;
+        }
+
+        _logger.LogInformation("=== WeekDefinitionSeeder: Completed ===");
+    }
+    
+    /// <summary>
+    /// محاسبه شماره ترتیبی هفته بر اساس فاصله از هفته مبدأ
+    /// هفته مبدأ = 1، هفته بعد = 2، ...
+    /// </summary>
+    private static int CalculateWeekOrder(DateTime weekStartDate)
+    {
+        var daysDiff = (weekStartDate - BaseWeekStartDate).Days;
+        var weeksDiff = daysDiff / 7;
+        return weeksDiff + 1;
+    }
+    
+    /// <summary>
+    /// تبدیل عدد به نام ترتیبی فارسی
+    /// 1 -> هفته یکم، 2 -> هفته دوم، ...
+    /// </summary>
+    private static string GetPersianOrdinalWeekName(int weekOrder)
+    {
+        var ordinals = new Dictionary<int, string>
+        {
+            { 1, "یکم" }, { 2, "دوم" }, { 3, "سوم" }, { 4, "چهارم" }, { 5, "پنجم" },
+            { 6, "ششم" }, { 7, "هفتم" }, { 8, "هشتم" }, { 9, "نهم" }, { 10, "دهم" },
+            { 11, "یازدهم" }, { 12, "دوازدهم" }, { 13, "سیزدهم" }, { 14, "چهاردهم" }, { 15, "پانزدهم" },
+            { 16, "شانزدهم" }, { 17, "هفدهم" }, { 18, "هجدهم" }, { 19, "نوزدهم" }, { 20, "بیستم" },
+            { 21, "بیست و یکم" }, { 22, "بیست و دوم" }, { 23, "بیست و سوم" }, { 24, "بیست و چهارم" }, { 25, "بیست و پنجم" },
+            { 26, "بیست و ششم" }, { 27, "بیست و هفتم" }, { 28, "بیست و هشتم" }, { 29, "بیست و نهم" }, { 30, "سی‌ام" },
+            { 31, "سی و یکم" }, { 32, "سی و دوم" }, { 33, "سی و سوم" }, { 34, "سی و چهارم" }, { 35, "سی و پنجم" },
+            { 36, "سی و ششم" }, { 37, "سی و هفتم" }, { 38, "سی و هشتم" }, { 39, "سی و نهم" }, { 40, "چهلم" },
+            { 41, "چهل و یکم" }, { 42, "چهل و دوم" }, { 43, "چهل و سوم" }, { 44, "چهل و چهارم" }, { 45, "چهل و پنجم" },
+            { 46, "چهل و ششم" }, { 47, "چهل و هفتم" }, { 48, "چهل و هشتم" }, { 49, "چهل و نهم" }, { 50, "پنجاهم" },
+            { 51, "پنجاه و یکم" }, { 52, "پنجاه و دوم" }, { 53, "پنجاه و سوم" }, { 54, "پنجاه و چهارم" }, { 55, "پنجاه و پنجم" },
+            { 56, "پنجاه و ششم" }, { 57, "پنجاه و هفتم" }, { 58, "پنجاه و هشتم" }, { 59, "پنجاه و نهم" }, { 60, "شصتم" }
+        };
+
+        if (ordinals.TryGetValue(weekOrder, out var ordinal))
+        {
+            return $"هفته {ordinal}";
+        }
+        
+        // برای اعداد بزرگتر از 60
+        return $"هفته {weekOrder}";
+    }
+
+    /// <summary>
+    /// پیدا کردن شنبه این هفته (شروع هفته شمسی)
+    /// </summary>
+    private static DateTime GetStartOfWeek(DateTime date)
+    {
+        var diff = (7 + (date.DayOfWeek - DayOfWeek.Saturday)) % 7;
+        return date.AddDays(-diff).Date;
+    }
+
+    /// <summary>
+    /// پیدا کردن جمعه این هفته (پایان هفته شمسی)
+    /// </summary>
+    private static DateTime GetEndOfWeek(DateTime date)
+    {
+        return GetStartOfWeek(date).AddDays(6);
+    }
+
+    /// <summary>
+    /// شماره هفته میلادی ISO 8601
+    /// هفته ISO از دوشنبه شروع می‌شود
+    /// برای تاریخ شنبه، باید دوشنبه همان هفته را پیدا کنیم (2 روز بعد)
+    /// </summary>
+    private static string GetISOWeekNumber(DateTime saturdayDate)
+    {
+        // شنبه + 2 روز = دوشنبه همان هفته ISO
+        var mondayOfWeek = saturdayDate.AddDays(2);
+        
+        // محاسبه شماره هفته ISO
+        var cal = CultureInfo.InvariantCulture.Calendar;
+        var weekNumber = cal.GetWeekOfYear(mondayOfWeek, CalendarWeekRule.FirstFourDayWeek, DayOfWeek.Monday);
+        var year = mondayOfWeek.Year;
+        
+        // تصحیح سال برای هفته‌های لبه‌ای
+        if (weekNumber == 1 && mondayOfWeek.Month == 12)
+        {
+            year++;
+        }
+        else if (weekNumber >= 52 && mondayOfWeek.Month == 1)
+        {
+            year--;
+        }
+        
+        return $"{year}-W{weekNumber:D2}";
+    }
+
+    /// <summary>
+    /// شماره هفته شمسی
+    /// هفته شمسی از شنبه شروع می‌شود
+    /// </summary>
+    private string GetPersianWeekNumber(DateTime saturdayDate)
+    {
+        var persianYear = _persianCalendar.GetYear(saturdayDate);
+        var dayOfYear = _persianCalendar.GetDayOfYear(saturdayDate);
+        
+        // اول فروردین این سال
+        var firstDayOfYear = _persianCalendar.ToDateTime(persianYear, 1, 1, 0, 0, 0, 0);
+        
+        // پیدا کردن اولین شنبه سال
+        var daysUntilFirstSaturday = ((int)DayOfWeek.Saturday - (int)firstDayOfYear.DayOfWeek + 7) % 7;
+        
+        // اگر اول فروردین شنبه باشه، daysUntilFirstSaturday = 0
+        // در غیر این صورت روزهای قبل از اولین شنبه، هفته 0 یا هفته آخر سال قبل هستند
+        
+        int weekNumber;
+        if (daysUntilFirstSaturday == 0)
+        {
+            // اول فروردین شنبه است
+            weekNumber = ((dayOfYear - 1) / 7) + 1;
+        }
+        else
+        {
+            // روزهای قبل از اولین شنبه
+            if (dayOfYear <= daysUntilFirstSaturday)
+            {
+                // این روزها متعلق به آخرین هفته سال قبل هستند
+                // اما برای سادگی، هفته 1 در نظر می‌گیریم
+                weekNumber = 1;
+            }
+            else
+            {
+                weekNumber = ((dayOfYear - daysUntilFirstSaturday - 1) / 7) + 1;
+            }
+        }
+        
+        return $"{persianYear}-W{weekNumber:D2}";
+    }
+}

src/CMSMicroservice.Infrastructure/Persistence/ApplicationDbContext.cs

@@ -3,7 +3,7 @@ using CMSMicroservice.Application.Common.Interfaces;
 using Microsoft.EntityFrameworkCore.Diagnostics;
 using CMSMicroservice.Domain.Entities;
 using CMSMicroservice.Domain.Entities.Payment;
-
+using CMSMicroservice.Domain.Entities.Geography;
 using CMSMicroservice.Domain.Entities.Order;
 using CMSMicroservice.Domain.Entities.DiscountShop;
 using CMSMicroservice.Infrastructure.Persistence.Interceptors;
@@ -98,6 +98,9 @@ public class ApplicationDbContext :  DbContext, IApplicationDbContext
     public DbSet<NetworkWeeklyBalance> NetworkWeeklyBalances => Set<NetworkWeeklyBalance>();
     public DbSet<NetworkMembershipHistory> NetworkMembershipHistories => Set<NetworkMembershipHistory>();
     
+    // Week Definitions
+    public DbSet<WeekDefinition> WeekDefinitions => Set<WeekDefinition>();
+    
     // Commission
     public DbSet<WeeklyCommissionPool> WeeklyCommissionPools => Set<WeeklyCommissionPool>();
     public DbSet<UserCommissionPayout> UserCommissionPayouts => Set<UserCommissionPayout>();
@@ -111,4 +114,9 @@ public class ApplicationDbContext :  DbContext, IApplicationDbContext
     public DbSet<DiscountShoppingCart> DiscountShoppingCarts => Set<DiscountShoppingCart>();
     public DbSet<DiscountOrder> DiscountOrders => Set<DiscountOrder>();
     public DbSet<DiscountOrderDetail> DiscountOrderDetails => Set<DiscountOrderDetail>();
+    
+    // ============= Geography DbSets =============
+    public DbSet<Country> Countries => Set<Country>();
+    public DbSet<State> States => Set<State>();
+    public DbSet<City> Cities => Set<City>();
 }

src/CMSMicroservice.Infrastructure/Persistence/Configurations/ClubFeatureConfiguration.cs

@@ -19,7 +19,6 @@ public class ClubFeatureConfiguration : IEntityTypeConfiguration<ClubFeature>
         builder.Property(entity => entity.Title).IsRequired().HasMaxLength(200);
         builder.Property(entity => entity.Description).IsRequired(false).HasMaxLength(1000);
         builder.Property(entity => entity.IsActive).IsRequired();
-        builder.Property(entity => entity.RequiredPoints).IsRequired(false);
         builder.Property(entity => entity.SortOrder).IsRequired();
         
         // Index برای IsActive و SortOrder

src/CMSMicroservice.Infrastructure/Persistence/Configurations/CommissionPayoutHistoryConfiguration.cs

@@ -18,7 +18,7 @@ public class CommissionPayoutHistoryConfiguration : IEntityTypeConfiguration<Com
         
         builder.Property(entity => entity.UserCommissionPayoutId).IsRequired();
         builder.Property(entity => entity.UserId).IsRequired();
-        builder.Property(entity => entity.WeekNumber).IsRequired().HasMaxLength(20);
+        builder.Property(entity => entity.WeekDefinitionId).IsRequired();
         builder.Property(entity => entity.AmountBefore).IsRequired();
         builder.Property(entity => entity.AmountAfter).IsRequired();
         builder.Property(entity => entity.OldStatus).IsRequired();
@@ -33,6 +33,13 @@ public class CommissionPayoutHistoryConfiguration : IEntityTypeConfiguration<Com
             .HasForeignKey(entity => entity.UserCommissionPayoutId)
             .OnDelete(DeleteBehavior.Restrict);
         
+        // رابطه با WeekDefinition (Required FK)
+        builder.HasOne(entity => entity.WeekDefinition)
+            .WithMany(wd => wd.CommissionPayoutHistories)
+            .HasForeignKey(entity => entity.WeekDefinitionId)
+            .IsRequired()
+            .OnDelete(DeleteBehavior.Restrict);
+        
         // Index برای UserId و Created
         builder.HasIndex(e => new { e.UserId, e.Created })
             .HasDatabaseName("IX_CommissionPayoutHistory_UserId_Created");
@@ -41,9 +48,9 @@ public class CommissionPayoutHistoryConfiguration : IEntityTypeConfiguration<Com
         builder.HasIndex(e => e.UserCommissionPayoutId)
             .HasDatabaseName("IX_CommissionPayoutHistory_PayoutId");
         
-        // Index برای WeekNumber
-        builder.HasIndex(e => e.WeekNumber)
-            .HasDatabaseName("IX_CommissionPayoutHistory_WeekNumber");
+        // Index برای WeekDefinitionId
+        builder.HasIndex(e => e.WeekDefinitionId)
+            .HasDatabaseName("IX_CommissionPayoutHistory_WeekDefinitionId");
         
         // Index برای Action
         builder.HasIndex(e => e.Action)

src/CMSMicroservice.Infrastructure/Persistence/Configurations/Geography/CityConfiguration.cs

@@ -0,0 +1,59 @@
+using CMSMicroservice.Domain.Entities.Geography;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace CMSMicroservice.Infrastructure.Persistence.Configurations.Geography;
+
+public class CityConfiguration : IEntityTypeConfiguration<City>
+{
+    public void Configure(EntityTypeBuilder<City> builder)
+    {
+        builder.ToTable("Cities", "GMS");
+
+        builder.HasKey(c => c.Id);
+
+        builder.Property(c => c.Id)
+            .ValueGeneratedOnAdd();
+
+        builder.Property(c => c.ExternalId)
+            .IsRequired();
+
+        builder.Property(c => c.Name)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+            ;
+
+        builder.Property(c => c.Latitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(c => c.Longitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(c => c.Native)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+            
+            .HasDefaultValue("");
+
+        builder.Property(c => c.IsDeleted)
+            .IsRequired()
+            .HasDefaultValue(false);
+
+        builder.Property(c => c.StateId)
+            .IsRequired();
+
+        // Index
+        builder.HasIndex(c => c.StateId)
+            .HasDatabaseName("IX_Cities_StateId");
+
+        // Relationships
+        builder.HasOne(c => c.State)
+            .WithMany(s => s.Cities)
+            .HasForeignKey(c => c.StateId)
+            .OnDelete(DeleteBehavior.Cascade);
+    }
+}

src/CMSMicroservice.Infrastructure/Persistence/Configurations/Geography/CountryConfiguration.cs

@@ -0,0 +1,111 @@
+using CMSMicroservice.Domain.Entities.Geography;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace CMSMicroservice.Infrastructure.Persistence.Configurations.Geography;
+
+public class CountryConfiguration : IEntityTypeConfiguration<Country>
+{
+    public void Configure(EntityTypeBuilder<Country> builder)
+    {
+        builder.ToTable("Countries", "GMS");
+
+        builder.HasKey(c => c.Id);
+
+        builder.Property(c => c.Id)
+            .ValueGeneratedOnAdd();
+
+        builder.Property(c => c.ExternalId)
+            .IsRequired();
+
+        builder.Property(c => c.Name)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+           ;
+
+        builder.Property(c => c.Iso3)
+            .IsRequired()
+            .HasMaxLength(3);
+
+        builder.Property(c => c.Iso2)
+            .IsRequired()
+            .HasMaxLength(2);
+
+        builder.Property(c => c.NumericCode)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.PhoneCode)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.Capital)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+            ;
+
+        builder.Property(c => c.Currency)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.CurrencyName)
+            .IsRequired()
+            .HasMaxLength(100)
+            .HasColumnType("nvarchar(100)")
+            ;
+
+        builder.Property(c => c.CurrencySymbol)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.Tld)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.Native)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+           ;
+
+        builder.Property(c => c.Region)
+            .IsRequired()
+            .HasMaxLength(100)
+            .HasColumnType("nvarchar(100)")
+            ;
+
+        builder.Property(c => c.Subregion)
+            .IsRequired()
+            .HasMaxLength(100)
+            .HasColumnType("nvarchar(100)")
+           ;
+
+        builder.Property(c => c.Latitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(c => c.Longitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(c => c.Emoji)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(c => c.EmojiU)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(c => c.IsDeleted)
+            .IsRequired()
+            .HasDefaultValue(false);
+
+        // Relationships
+        builder.HasMany(c => c.States)
+            .WithOne(s => s.Country)
+            .HasForeignKey(s => s.CountryId)
+            .OnDelete(DeleteBehavior.Cascade);
+    }
+}

src/CMSMicroservice.Infrastructure/Persistence/Configurations/Geography/StateConfiguration.cs

@@ -0,0 +1,74 @@
+using CMSMicroservice.Domain.Entities.Geography;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace CMSMicroservice.Infrastructure.Persistence.Configurations.Geography;
+
+public class StateConfiguration : IEntityTypeConfiguration<State>
+{
+    public void Configure(EntityTypeBuilder<State> builder)
+    {
+        builder.ToTable("States", "GMS");
+
+        builder.HasKey(s => s.Id);
+
+        builder.Property(s => s.Id)
+            .ValueGeneratedOnAdd();
+
+        builder.Property(s => s.ExternalId)
+            .IsRequired();
+
+        builder.Property(s => s.Name)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+            ;
+
+        builder.Property(s => s.StateCode)
+            .IsRequired()
+            .HasMaxLength(10);
+
+        builder.Property(s => s.Latitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(s => s.Longitude)
+            .IsRequired()
+            .HasMaxLength(50);
+
+        builder.Property(s => s.Type)
+            .IsRequired()
+            .HasMaxLength(100)
+            .HasColumnType("nvarchar(100)")
+         ;
+
+        builder.Property(s => s.Native)
+            .IsRequired()
+            .HasMaxLength(500)
+            .HasColumnType("nvarchar(500)")
+           
+            .HasDefaultValue("");
+
+        builder.Property(s => s.IsDeleted)
+            .IsRequired()
+            .HasDefaultValue(false);
+
+        builder.Property(s => s.CountryId)
+            .IsRequired();
+
+        // Index
+        builder.HasIndex(s => s.CountryId)
+            .HasDatabaseName("IX_States_CountryId");
+
+        // Relationships
+        builder.HasOne(s => s.Country)
+            .WithMany(c => c.States)
+            .HasForeignKey(s => s.CountryId)
+            .OnDelete(DeleteBehavior.Cascade);
+
+        builder.HasMany(s => s.Cities)
+            .WithOne(c => c.State)
+            .HasForeignKey(c => c.StateId)
+            .OnDelete(DeleteBehavior.Cascade);
+    }
+}

src/CMSMicroservice.Infrastructure/Persistence/Configurations/NetworkWeeklyBalanceConfiguration.cs

@@ -17,7 +17,7 @@ public class NetworkWeeklyBalanceConfiguration : IEntityTypeConfiguration<Networ
         builder.Property(entity => entity.Id).UseIdentityColumn();
         
         builder.Property(entity => entity.UserId).IsRequired();
-        builder.Property(entity => entity.WeekNumber).IsRequired().HasMaxLength(20);
+        builder.Property(entity => entity.WeekDefinitionId).IsRequired();
         builder.Property(entity => entity.LeftLegBalances).IsRequired();
         builder.Property(entity => entity.RightLegBalances).IsRequired();
         builder.Property(entity => entity.TotalBalances).IsRequired();
@@ -31,14 +31,20 @@ public class NetworkWeeklyBalanceConfiguration : IEntityTypeConfiguration<Networ
             .HasForeignKey(entity => entity.UserId)
             .OnDelete(DeleteBehavior.Restrict);
         
-        // Composite Index برای UserId و WeekNumber
-        builder.HasIndex(e => new { e.UserId, e.WeekNumber })
-            .IsUnique()
-            .HasDatabaseName("IX_NetworkWeeklyBalance_UserId_WeekNumber");
+        // رابطه با WeekDefinition
+        builder.HasOne(entity => entity.WeekDefinition)
+            .WithMany(wd => wd.NetworkWeeklyBalances)
+            .HasForeignKey(entity => entity.WeekDefinitionId)
+            .OnDelete(DeleteBehavior.Restrict);
         
-        // Index برای WeekNumber
-        builder.HasIndex(e => e.WeekNumber)
-            .HasDatabaseName("IX_NetworkWeeklyBalance_WeekNumber");
+        // Composite Index برای UserId و WeekDefinitionId
+        builder.HasIndex(e => new { e.UserId, e.WeekDefinitionId })
+            .IsUnique()
+            .HasDatabaseName("IX_NetworkWeeklyBalance_UserId_WeekDefinitionId");
+        
+        // Index برای WeekDefinitionId
+        builder.HasIndex(e => e.WeekDefinitionId)
+            .HasDatabaseName("IX_NetworkWeeklyBalance_WeekDefinitionId");
         
         // Index برای IsExpired
         builder.HasIndex(e => e.IsExpired)

src/CMSMicroservice.Infrastructure/Persistence/Configurations/UserCommissionPayoutConfiguration.cs

@@ -17,7 +17,7 @@ public class UserCommissionPayoutConfiguration : IEntityTypeConfiguration<UserCo
         builder.Property(entity => entity.Id).UseIdentityColumn();
         
         builder.Property(entity => entity.UserId).IsRequired();
-        builder.Property(entity => entity.WeekNumber).IsRequired().HasMaxLength(20);
+        builder.Property(entity => entity.WeekDefinitionId).IsRequired();
         builder.Property(entity => entity.WeeklyPoolId).IsRequired();
         builder.Property(entity => entity.BalancesEarned).IsRequired();
         builder.Property(entity => entity.ValuePerBalance).IsRequired();
@@ -43,10 +43,17 @@ public class UserCommissionPayoutConfiguration : IEntityTypeConfiguration<UserCo
             .HasForeignKey(entity => entity.WeeklyPoolId)
             .OnDelete(DeleteBehavior.Restrict);
         
-        // Composite Index برای UserId و WeekNumber
-        builder.HasIndex(e => new { e.UserId, e.WeekNumber })
+        // رابطه با WeekDefinition (Required FK)
+        builder.HasOne(entity => entity.WeekDefinition)
+            .WithMany(wd => wd.UserCommissionPayouts)
+            .HasForeignKey(entity => entity.WeekDefinitionId)
+            .IsRequired()
+            .OnDelete(DeleteBehavior.Restrict);
+        
+        // Composite Index برای UserId و WeekDefinitionId
+        builder.HasIndex(e => new { e.UserId, e.WeekDefinitionId })
             .IsUnique()
-            .HasDatabaseName("IX_UserCommissionPayout_UserId_WeekNumber");
+            .HasDatabaseName("IX_UserCommissionPayout_UserId_WeekDefinitionId");
         
         // Index برای WeeklyPoolId
         builder.HasIndex(e => e.WeeklyPoolId)
@@ -56,8 +63,5 @@ public class UserCommissionPayoutConfiguration : IEntityTypeConfiguration<UserCo
         builder.HasIndex(e => e.Status)
             .HasDatabaseName("IX_UserCommissionPayout_Status");
         
-        // Index برای WeekNumber
-        builder.HasIndex(e => e.WeekNumber)
-            .HasDatabaseName("IX_UserCommissionPayout_WeekNumber");
     }
 }

src/CMSMicroservice.Infrastructure/Persistence/Configurations/WeekDefinitionConfiguration.cs

@@ -0,0 +1,51 @@
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+
+namespace CMSMicroservice.Infrastructure.Persistence.Configurations;
+
+/// <summary>
+/// تنظیمات جدول تعریف هفته‌ها
+/// </summary>
+public class WeekDefinitionConfiguration : IEntityTypeConfiguration<WeekDefinition>
+{
+    public void Configure(EntityTypeBuilder<WeekDefinition> builder)
+    {
+        builder.HasQueryFilter(p => !p.IsDeleted);
+        builder.Ignore(entity => entity.DomainEvents);
+        
+        builder.HasKey(entity => entity.Id);
+        builder.Property(entity => entity.Id).UseIdentityColumn();
+        
+        builder.Property(entity => entity.WeekOrder).IsRequired();
+        builder.Property(entity => entity.DisplayName).IsRequired().HasMaxLength(50);
+        builder.Property(entity => entity.GregorianWeekNumber).IsRequired().HasMaxLength(20);
+        builder.Property(entity => entity.PersianWeekNumber).IsRequired().HasMaxLength(20);
+        builder.Property(entity => entity.StartDate).IsRequired();
+        builder.Property(entity => entity.EndDate).IsRequired();
+        builder.Property(entity => entity.GregorianYear).IsRequired();
+        builder.Property(entity => entity.PersianYear).IsRequired();
+        builder.Property(entity => entity.IsActive).IsRequired().HasDefaultValue(true);
+        
+        // Unique Index برای GregorianWeekNumber
+        builder.HasIndex(e => e.GregorianWeekNumber)
+            .IsUnique()
+            .HasDatabaseName("IX_WeekDefinition_GregorianWeekNumber");
+        
+        // Index برای PersianWeekNumber
+        builder.HasIndex(e => e.PersianWeekNumber)
+            .HasDatabaseName("IX_WeekDefinition_PersianWeekNumber");
+        
+        // Index برای StartDate
+        builder.HasIndex(e => e.StartDate)
+            .HasDatabaseName("IX_WeekDefinition_StartDate");
+        
+        // Index برای سال‌ها
+        builder.HasIndex(e => e.GregorianYear)
+            .HasDatabaseName("IX_WeekDefinition_GregorianYear");
+        
+        builder.HasIndex(e => e.PersianYear)
+            .HasDatabaseName("IX_WeekDefinition_PersianYear");
+        
+        builder.ToTable("WeekDefinitions");
+    }
+}