Svrnty.CQRS

Modern CQRS framework for .NET with gRPC source generation and HTTP Minimal API support.

Where This Fits

Layer: libs Depends on: Nothing (standalone .NET framework) Depended on by: a-gent-app (backend services), flutter-cqrs-datasource (client) Git: git.openharbor.io/svrnty/dotnet-cqrs.git

Tech Stack

• Language: C# 14 / .NET 10
• Framework: ASP.NET Core Minimal API, gRPC
• Key Dependencies: FluentValidation 11.x, Grpc.AspNetCore, PoweredSoft.DynamicQuery

Quick Start

# Build
dotnet build

# Run
dotnet run --project Svrnty.Sample

# Test
dotnet test

Architecture

10 NuGet packages organized by concern:

• Abstractions: Core interfaces (ICommandHandler, IQueryHandler)
• Core: Discovery, registration, handler execution
• MinimalApi: HTTP endpoint mapping with RFC 7807 validation
• Grpc: gRPC service support with Google Rich Error Model
• Grpc.Generators: Source generator for .proto files and service implementations
• DynamicQuery: PoweredSoft integration for filtering, sorting, paging
• FluentValidation: Validator registration helpers

Configuration

// Register handlers
builder.Services.AddCommand<CreateUserCommand, int, CreateUserCommandHandler>();
builder.Services.AddQuery<GetUserQuery, User, GetUserQueryHandler>();

// Configure CQRS with gRPC + HTTP
builder.Services.AddSvrntyCqrs(cqrs =>
{
    cqrs.AddGrpc(grpc => grpc.EnableReflection());
    cqrs.AddMinimalApi();
});

app.UseSvrntyCqrs();

Contributing

See CLAUDE.md for development guidelines.

License

MIT OR Apache-2.0