System Architecture

// Example Controller
[ApiController]
[Route("api/app/product")]
[Authorize]
public class ProductController : ShopController
{
    private readonly IProductAppService _productService;

    [HttpGet]
    public Task<PagedResultDto<ProductDto>> GetListAsync(
        PagedAndSortedResultRequestDto input)
    {
        return _productService.GetListAsync(input);
    }
}

// Example Application Service
public class ProductAppService : ShopAppService, IProductAppService
{
    private readonly IRepository<Product, Guid> _productRepository;
    private readonly CacheService _cacheService;

    public async Task<ProductDto> CreateAsync(CreateProductDto input)
    {
        // Validate
        await ValidateProductAsync(input);

        // Create entity
        var product = new Product(
            GuidGenerator.Create(),
            input.Name,
            input.Slug,
            input.Price
        );

        // Save to database
        await _productRepository.InsertAsync(product);

        // Invalidate cache
        await _cacheService.RemoveAsync(CacheKeys.FeaturedProductsKey);

        // Return DTO
        return ObjectMapper.Map<Product, ProductDto>(product);
    }
}

// Example Domain Entity with Business Logic
public class Product : FullAuditedAggregateRoot<Guid>
{
    public string Name { get; private set; }
    public decimal Price { get; private set; }
    public int StockQuantity { get; private set; }

    // Business method - encapsulates logic
    public void DecreaseStock(int quantity)
    {
        if (quantity <= 0)
            throw new BusinessException("Quantity must be positive");

        if (StockQuantity < quantity)
            throw new BusinessException("Insufficient stock");

        StockQuantity -= quantity;
    }

    // Business rule
    public bool IsInStock() => StockQuantity > 0;

    // Calculated property
    public decimal GetEffectivePrice()
    {
        return DiscountPrice.HasValue && DiscountPrice > 0
            ? DiscountPrice.Value
            : Price;
    }
}

// Example DbContext Configuration
public class ShopDbContext : AbpDbContext<ShopDbContext>
{
    public DbSet<Product> Products { get; set; }
    public DbSet<Order> Orders { get; set; }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);

        builder.Entity<Product>(b =>
        {
            b.ToTable("AppProducts");
            b.HasIndex(x => x.Slug).IsUnique();
            b.HasIndex(x => x.IsActive);
            b.HasIndex(x => x.IsFeatured);
            b.Property(x => x.Price).HasPrecision(18, 2);
        });
    }
}

Shirinzad.Shop/
├── src/
│   ├── Shirinzad.Shop.Domain.Shared/          # Shared constants, enums
│   ├── Shirinzad.Shop.Domain/                 # Domain entities & logic
│   ├── Shirinzad.Shop.Application.Contracts/  # Service interfaces & DTOs
│   ├── Shirinzad.Shop.Application/            # Application services
│   ├── Shirinzad.Shop.EntityFrameworkCore/    # EF Core, repositories
│   ├── Shirinzad.Shop.HttpApi/                # API controllers
│   ├── Shirinzad.Shop.HttpApi.Client/         # HTTP client proxies
│   └── Shirinzad.Shop.Web/                    # Web host & UI
├── test/
│   ├── Shirinzad.Shop.Application.Tests/      # Application tests
│   ├── Shirinzad.Shop.Domain.Tests/           # Domain tests
│   ├── Shirinzad.Shop.EntityFrameworkCore.Tests/ # EF Core tests
│   └── Shirinzad.Shop.TestBase/               # Test utilities
└── docs/                                      # Documentation