Skip to content

GEMINI.md

Latest commit

 

History

History
139 lines (109 loc) · 4.71 KB

GEMINI.md

File metadata and controls

139 lines (109 loc) · 4.71 KB

FSH .NET Starter Kit — Gemini AI Assistant Guide

Modular Monolith · CQRS · DDD · Multi-Tenant · .NET 10

Quick Start

dotnet build src/FSH.Starter.slnx              # Build (0 warnings required)
dotnet test src/FSH.Starter.slnx               # Run tests
dotnet run --project src/Playground/FSH.Starter.AppHost  # Run with Aspire

Project Layout

src/
├── BuildingBlocks/     # Framework (11 packages) — ⚠️ Protected
├── Modules/            # Business features — Add code here
│   ├── Identity/       # Auth, users, roles, permissions
│   ├── Multitenancy/   # Tenant management (Finbuckle)
│   └── Auditing/       # Audit logging
├── Playground/         # Reference application
└── Tests/              # Architecture + unit tests

The Pattern

Every feature = vertical slice:

Modules/{Module}/Features/v1/{Feature}/
├── {Action}{Entity}Command.cs      # ICommand<T>
├── {Action}{Entity}Handler.cs      # ICommandHandler<T,R>
├── {Action}{Entity}Validator.cs    # AbstractValidator<T>
└── {Action}{Entity}Endpoint.cs     # MapPost/Get/Put/Delete

Critical Rules

⚠️ Rule Why
Use Mediator not MediatR Different library, different interfaces
ICommand<T> / IQuery<T> NOT IRequest<T>
ValueTask<T> return type NOT Task<T>
Every command needs validator FluentValidation, no exceptions
.RequirePermission() on endpoints Explicit authorization
Zero build warnings CI blocks merges

Available Skills

Invoke with /skill-name in your prompt.

Skill Purpose
/add-feature Create complete CQRS feature (command/handler/validator/endpoint)
/add-entity Add domain entity with base class inheritance
/add-module Scaffold new bounded context module
/query-patterns Implement paginated/filtered queries
/testing-guide Write architecture + unit tests
/mediator-reference Mediator vs MediatR interface reference

Available Workflows

Delegate complex tasks to specialized workflows.

Workflow Expertise
/code-reviewer Review changes against FSH patterns + architecture rules
/feature-scaffolder Generate complete feature slices from requirements
/module-creator Create new modules with contracts, persistence, DI setup
/architecture-guard Verify layering, dependencies, module boundaries
/migration-helper Generate and apply EF Core migrations

Example: Create Feature

// Command
public sealed record CreateProductCommand(string Name, decimal Price)
    : ICommand<Guid>;

// Handler
public sealed class CreateProductHandler(IRepository<Product> repo)
    : ICommandHandler<CreateProductCommand, Guid>
{
    public async ValueTask<Guid> Handle(CreateProductCommand cmd, CancellationToken ct)
    {
        var product = Product.Create(cmd.Name, cmd.Price);
        await repo.AddAsync(product, ct);
        return product.Id;
    }
}

// Validator
public sealed class CreateProductValidator : AbstractValidator<CreateProductCommand>
{
    public CreateProductValidator()
    {
        RuleFor(x => x.Name).NotEmpty().MaximumLength(200);
        RuleFor(x => x.Price).GreaterThan(0);
    }
}

// Endpoint
public static RouteHandlerBuilder Map(this IEndpointRouteBuilder endpoints) =>
    endpoints.MapPost("/", async (CreateProductCommand cmd, IMediator mediator, CancellationToken ct) =>
        TypedResults.Created($"/api/v1/products/{await mediator.Send(cmd, ct)}"))
    .WithName(nameof(CreateProductCommand))
    .WithSummary("Create a new product")
    .RequirePermission(CatalogPermissions.Products.Create);

Architecture

  • Pattern: Modular Monolith (not microservices)
  • CQRS: Mediator library (commands/queries)
  • DDD: Rich domain models, aggregates, value objects
  • Multi-Tenancy: Finbuckle.MultiTenant (shared DB, tenant isolation)
  • Modules: 3 core (Identity, Multitenancy, Auditing) + your features
  • BuildingBlocks: 11 packages (Core, Persistence, Caching, Jobs, Web, etc.)

Details: See .agents/rules/architecture.md

Before Committing

dotnet build src/FSH.Starter.slnx  # Must pass with 0 warnings
dotnet test src/FSH.Starter.slnx   # All tests must pass

Documentation

  • Architecture: See ARCHITECTURE_ANALYSIS.md (19KB deep-dive)
  • Rules: See .agents/rules/*.md (API conventions, testing, modules)
  • Skills: See .agents/skills/*/SKILL.md (step-by-step guides)
  • Workflows: See .agents/workflows/*.md (specialized assistants)

Philosophy: This is a production-ready starter kit. Every pattern is battle-tested. Follow the conventions, and you'll ship faster.