‫Domain-Driven Design (DDD)؛ بخش دوازهم: سرویس‌های دامنه

// در namespace Domain.Entities
public class Apartment
{
    public Guid Id { get; private set; }
    public double Area { get; private set; } // متراژ واحد
    public List<Charge> Charges { get; private set; } = new List<Charge>();

    public Apartment(double area)
    {
        Id = Guid.NewGuid();
        Area = area;
    }

    public void AddCharge(Charge charge)
    {
        Charges.Add(charge);
    }
}

public class Charge
{
    public Guid Id { get; private set; }
    public DateTime Month { get; private set; }
    public double Amount { get; private set; } // مبلغ شارژ
    public bool IsPaid { get; private set; }

    public Charge(DateTime month, double amount)
    {
        Id = Guid.NewGuid();
        Month = month;
        Amount = amount;
        IsPaid = false;
    }

    public void MarkAsPaid()
    {
        IsPaid = true;
    }
}

// حالا Domain Service: ChargeCalculationService
// این سرویس منطق محاسبه شارژ را مدیریت می‌کند، بدون وابستگی به ذخیره‌سازی
public interface IChargeCalculationService
{
    double CalculateMonthlyCharge(Apartment apartment, double commonCosts, double penaltyRate);
}

public class ChargeCalculationService : IChargeCalculationService
{
    public double CalculateMonthlyCharge(Apartment apartment, double commonCosts, double penaltyRate)
    {
        // منطق دامنه: شارژ = (متراژ * نرخ پایه) + سهم هزینه‌های مشترک + جریمه اگر دیرکرد داشته باشد
        double baseCharge = apartment.Area * 1000; // فرض نرخ پایه 1000 تومان per متر
        double shareOfCommon = commonCosts / /* تعداد واحدها، که می‌تواند از repository بیاید اما اینجا ساده */ 10;
        double penalty = apartment.Charges.Any(c => !c.IsPaid && c.Month < DateTime.Now.AddMonths(-1)) ? baseCharge * penaltyRate : 0;
        
        return baseCharge + shareOfCommon + penalty;
    }
}

// در namespace Infrastructure.Persistence (با EF-Core)
public class ApartmentRepository : IApartmentRepository
{
    private readonly ApartmentDbContext _context; // DbContext EF-Core

    public ApartmentRepository(ApartmentDbContext context)
    {
        _context = context;
    }

    public async Task<Apartment> GetByIdAsync(Guid id)
    {
        return await _context.Apartments.Include(a => a.Charges).FirstOrDefaultAsync(a => a.Id == id);
    }

    public async Task SaveChangesAsync()
    {
        await _context.SaveChangesAsync();
    }
}

// DbContext نمونه:
public class ApartmentDbContext : DbContext
{
    public DbSet<Apartment> Apartments { get; set; }
    public DbSet<Charge> Charges { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("your-connection-string"); // یا هر دیتابیس دیگر
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // Config برای mapping، مثل Owned Types اگر لازم
        modelBuilder.Entity<Apartment>().OwnsMany(a => a.Charges);
    }
}

// در namespace Application.Services
public interface IPaymentApplicationService
{
    Task ProcessPaymentAsync(Guid apartmentId, double paymentAmount);
}

public class PaymentApplicationService : IPaymentApplicationService
{
    private readonly IApartmentRepository _repository;
    private readonly IChargeCalculationService _chargeCalculator; // تزریق Domain Service

    public PaymentApplicationService(IApartmentRepository repository, IChargeCalculationService chargeCalculator)
    {
        _repository = repository;
        _chargeCalculator = chargeCalculator;
    }

    public async Task ProcessPaymentAsync(Guid apartmentId, double paymentAmount)
    {
        var apartment = await _repository.GetByIdAsync(apartmentId);
        if (apartment == null) throw new Exception("واحد یافت نشد!");

        // استفاده از Domain Service برای محاسبه
        double dueCharge = _chargeCalculator.CalculateMonthlyCharge(apartment, 500000, 0.05); // commonCosts=500k, penalty=5%

        if (paymentAmount < dueCharge) throw new Exception("مبلغ ناکافی!");

        // ایجاد Charge جدید و مارک پرداخت
        var newCharge = new Charge(DateTime.Now, dueCharge);
        newCharge.MarkAsPaid();
        apartment.AddCharge(newCharge);

        // ذخیره با EF-Core
        await _repository.SaveChangesAsync();
    }
}

• نه در Entity (چون مربوط به یک واحد نیست، بلکه به کل ساختمان مربوط است).
• نه در Application Service (چون بخشی از منطق دامنه است، نه صرفاً هماهنگی).

• اگر کل ساختمان فقط یک قانون ساده «تقسیم مساوی» داشت، آیا باز هم Domain Service لازم بود؟
• اگر قرار بود علاوه بر محاسبه شارژ، پیامکی هم برای ساکنان ارسال شود، این وظیفه در Application Service قرار می‌گیرد یا Domain Service؟

• هر جا منطق «دامنه» بود (مثل فرمول تقسیم شارژ)، باید در Domain Service بماند.
• هر جا «هماهنگی با جهان بیرون» بود (مثل دیتابیس یا SMS)، در Application Service است.

• Domain Service = مغز محاسباتی و منطقی دامنه.
• Application Service = هماهنگ‌کننده عملیات و استفاده از Domain.