Jean-Philippe Brule 697b36900b docs: standardize documentation structure

- CLAUDE.md: universal development guidelines
- README.md: project description (consistent template)
- CONTRIBUTING.md: contribution workflow
- CHANGELOG.md: version history

Co-Authored-By: Svrnty Inc. <eng@svrnty.com>

2026-03-05 05:53:27 -05:00

1.6 KiB

Raw Blame History

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

1.6 KiB Raw Blame History