dknet-overview

DKNet Framework Overview Skill

This skill helps GitHub Copilot understand the DKNet Framework architecture, patterns, and conventions when generating code for applications using DKNet NuGet packages.

🎯 Framework Purpose

DKNet is a comprehensive .NET framework for building enterprise applications with:

• Clean Architecture - Onion Architecture with Domain-Driven Design
• EF Core Extensions - Specifications, dynamic predicates, repositories, audit logs
• ASP.NET Core Features - Idempotency, background tasks, API extensions
• Messaging - Event-driven architecture with SlimBus
• Quality First - Zero warnings, nullable types, comprehensive testing

🏗️ Architecture Layers

Domain Layer (Core)

// Entities with business logic
public class Order : EntityBase
{
    public Guid CustomerId { get; private set; }
    public OrderStatus Status { get; private set; }
    
    public void PlaceOrder()
    {
        if (Status != OrderStatus.Draft)
            throw new DomainException("Only draft orders can be placed");
            
        Status = OrderStatus.Placed;
        AddDomainEvent(new OrderPlacedEvent(Id));
    }
}

Application Layer

// CQRS Command Handler
public class PlaceOrderHandler : ICommandHandler<PlaceOrderCommand, OrderResult>
{
    private readonly IOrderRepository _repository;
    
    public async Task<OrderResult> Handle(
        PlaceOrderCommand command,
        CancellationToken cancellationToken)
    {
        var spec = new OrderByIdSpec(command.OrderId);
        var order = await _repository.FirstOrDefaultAsync(spec, cancellationToken);
        
        order.PlaceOrder();
        await _repository.UpdateAsync(order, cancellationToken);
        
        return OrderResult.FromEntity(order);
    }
}

Infrastructure Layer

// Repository implementation
public class OrderRepository : RepositoryBase<Order>, IOrderRepository
{
    public OrderRepository(AppDbContext context) : base(context)
    {
    }
}