feat: Add ConfigurationCQ - Phase 2 Application Layer

Implemented complete CQRS pattern for System Configuration management: Commands: - SetConfigurationValueCommand: Create or update configurations with history tracking - DeactivateConfigurationCommand: Deactivate configurations with audit trail Queries: - GetConfigurationByKeyQuery: Retrieve configuration by Scope and Key - GetAllConfigurationsQuery: List all configurations with filters and pagination - GetConfigurationHistoryQuery: View complete audit history for any configuration Features: - All commands include FluentValidation validators - History recording to SystemConfigurationHistory table - Pagination support for list queries - DTOs for clean data transfer - Null-safe implementations Updated: - IApplicationDbContext: Added 11 new DbSets for network-club entities - GlobalUsings: Added new entity namespaces Build Status: ✅ Success (0 errors, 184 warnings in legacy code)
2025-11-29 04:02:02 +03:30
parent 0d52515be4
commit f6fa070067
20 changed files with 612 additions and 0 deletions
@@ -0,0 +1,17 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.DeactivateConfiguration;
+
+/// <summary>
+/// Command برای غیرفعال کردن یک Configuration
+/// </summary>
+public record DeactivateConfigurationCommand : IRequest<Unit>
+{
+    /// <summary>
+    /// شناسه Configuration
+    /// </summary>
+    public long ConfigurationId { get; init; }
+
+    /// <summary>
+    /// دلیل غیرفعال‌سازی
+    /// </summary>
+    public string? Reason { get; init; }
+}
@@ -0,0 +1,47 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.DeactivateConfiguration;
+
+public class DeactivateConfigurationCommandHandler : IRequestHandler<DeactivateConfigurationCommand, Unit>
+{
+    private readonly IApplicationDbContext _context;
+
+    public DeactivateConfigurationCommandHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<Unit> Handle(DeactivateConfigurationCommand request, CancellationToken cancellationToken)
+    {
+        var entity = await _context.SystemConfigurations
+            .FirstOrDefaultAsync(x => x.Id == request.ConfigurationId, cancellationToken)
+            ?? throw new NotFoundException(nameof(SystemConfiguration), request.ConfigurationId);
+
+        // اگر از قبل غیرفعال است، خطا ندهیم
+        if (!entity.IsActive)
+        {
+            return Unit.Value;
+        }
+
+        var oldValue = entity.Value;
+        entity.IsActive = false;
+
+        _context.SystemConfigurations.Update(entity);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        // ثبت تاریخچه
+        var history = new SystemConfigurationHistory
+        {
+            ConfigurationId = entity.Id,
+            Scope = entity.Scope,
+            Key = entity.Key,
+            OldValue = oldValue,
+            NewValue = entity.Value,
+            Reason = request.Reason ?? "Configuration deactivated",
+            PerformedBy = "System" // TODO: باید از Current User گرفته شود
+        };
+
+        await _context.SystemConfigurationHistories.AddAsync(history, cancellationToken);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        return Unit.Value;
+    }
+}
@@ -0,0 +1,29 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.DeactivateConfiguration;
+
+public class DeactivateConfigurationCommandValidator : AbstractValidator<DeactivateConfigurationCommand>
+{
+    public DeactivateConfigurationCommandValidator()
+    {
+        RuleFor(x => x.ConfigurationId)
+            .GreaterThan(0)
+            .WithMessage("شناسه Configuration معتبر نیست");
+
+        RuleFor(x => x.Reason)
+            .MaximumLength(500)
+            .WithMessage("دلیل غیرفعال‌سازی نمی‌تواند بیشتر از 500 کاراکتر باشد")
+            .When(x => !string.IsNullOrEmpty(x.Reason));
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<DeactivateConfigurationCommand>.CreateWithOptions(
+                (DeactivateConfigurationCommand)model, 
+                x => x.IncludeProperties(propertyName)));
+        
+        if (result.IsValid)
+            return Array.Empty<string>();
+        
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}
@@ -0,0 +1,32 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.SetConfigurationValue;
+
+/// <summary>
+/// Command برای تنظیم یا به‌روزرسانی یک Configuration
+/// </summary>
+public record SetConfigurationValueCommand : IRequest<long>
+{
+    /// <summary>
+    /// محدوده تنظیمات (System, Network, Club, Commission)
+    /// </summary>
+    public ConfigurationScope Scope { get; init; }
+
+    /// <summary>
+    /// کلید یکتا برای تنظیمات
+    /// </summary>
+    public string Key { get; init; }
+
+    /// <summary>
+    /// مقدار تنظیمات (JSON format)
+    /// </summary>
+    public string Value { get; init; }
+
+    /// <summary>
+    /// توضیحات تنظیمات
+    /// </summary>
+    public string? Description { get; init; }
+
+    /// <summary>
+    /// دلیل تغییر (برای History)
+    /// </summary>
+    public string? ChangeReason { get; init; }
+}
@@ -0,0 +1,74 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.SetConfigurationValue;
+
+public class SetConfigurationValueCommandHandler : IRequestHandler<SetConfigurationValueCommand, long>
+{
+    private readonly IApplicationDbContext _context;
+
+    public SetConfigurationValueCommandHandler(IApplicationDbContext context)
+    {
+        _context = context;
+    }
+
+    public async Task<long> Handle(SetConfigurationValueCommand request, CancellationToken cancellationToken)
+    {
+        // بررسی وجود Configuration با همین Scope و Key
+        var existingConfig = await _context.SystemConfigurations
+            .FirstOrDefaultAsync(x => 
+                x.Scope == request.Scope && 
+                x.Key == request.Key, 
+                cancellationToken);
+
+        SystemConfiguration entity;
+        bool isNewRecord = existingConfig == null;
+        string oldValue = null;
+
+        if (isNewRecord)
+        {
+            // ایجاد Configuration جدید
+            entity = new SystemConfiguration
+            {
+                Scope = request.Scope,
+                Key = request.Key,
+                Value = request.Value,
+                Description = request.Description,
+                IsActive = true
+            };
+
+            await _context.SystemConfigurations.AddAsync(entity, cancellationToken);
+        }
+        else
+        {
+            // به‌روزرسانی Configuration موجود
+            entity = existingConfig;
+            oldValue = entity.Value;
+
+            entity.Value = request.Value;
+            
+            if (!string.IsNullOrEmpty(request.Description))
+            {
+                entity.Description = request.Description;
+            }
+
+            _context.SystemConfigurations.Update(entity);
+        }
+
+        await _context.SaveChangesAsync(cancellationToken);
+
+        // ثبت تاریخچه
+        var history = new SystemConfigurationHistory
+        {
+            ConfigurationId = entity.Id,
+            Scope = entity.Scope,
+            Key = entity.Key,
+            OldValue = oldValue,
+            NewValue = entity.Value,
+            Reason = request.ChangeReason ?? (isNewRecord ? "Initial creation" : "Value updated"),
+            PerformedBy = "System" // TODO: باید از Current User گرفته شود
+        };
+
+        await _context.SystemConfigurationHistories.AddAsync(history, cancellationToken);
+        await _context.SaveChangesAsync(cancellationToken);
+
+        return entity.Id;
+    }
+}
@@ -0,0 +1,48 @@
+namespace CMSMicroservice.Application.ConfigurationCQ.Commands.SetConfigurationValue;
+
+public class SetConfigurationValueCommandValidator : AbstractValidator<SetConfigurationValueCommand>
+{
+    public SetConfigurationValueCommandValidator()
+    {
+        RuleFor(x => x.Scope)
+            .IsInEnum()
+            .WithMessage("محدوده تنظیمات معتبر نیست");
+
+        RuleFor(x => x.Key)
+            .NotEmpty()
+            .WithMessage("کلید تنظیمات الزامی است")
+            .MaximumLength(100)
+            .WithMessage("کلید تنظیمات نمی‌تواند بیشتر از 100 کاراکتر باشد")
+            .Matches(@"^[a-zA-Z0-9_\.]+$")
+            .WithMessage("کلید تنظیمات فقط می‌تواند شامل حروف انگلیسی، اعداد، نقطه و آندرلاین باشد");
+
+        RuleFor(x => x.Value)
+            .NotEmpty()
+            .WithMessage("مقدار تنظیمات الزامی است")
+            .MaximumLength(2000)
+            .WithMessage("مقدار تنظیمات نمی‌تواند بیشتر از 2000 کاراکتر باشد");
+
+        RuleFor(x => x.Description)
+            .MaximumLength(500)
+            .WithMessage("توضیحات نمی‌تواند بیشتر از 500 کاراکتر باشد")
+            .When(x => !string.IsNullOrEmpty(x.Description));
+
+        RuleFor(x => x.ChangeReason)
+            .MaximumLength(500)
+            .WithMessage("دلیل تغییر نمی‌تواند بیشتر از 500 کاراکتر باشد")
+            .When(x => !string.IsNullOrEmpty(x.ChangeReason));
+    }
+
+    public Func<object, string, Task<IEnumerable<string>>> ValidateValue => async (model, propertyName) =>
+    {
+        var result = await ValidateAsync(
+            ValidationContext<SetConfigurationValueCommand>.CreateWithOptions(
+                (SetConfigurationValueCommand)model, 
+                x => x.IncludeProperties(propertyName)));
+        
+        if (result.IsValid)
+            return Array.Empty<string>();
+        
+        return result.Errors.Select(e => e.ErrorMessage);
+    };
+}