Hexalith.Tenants.Contracts 3.15.1

Hexalith.Tenants

👁 CI
👁 NuGet

Multi-tenant management for the Hexalith ecosystem. Built on event sourcing, DAPR, and .NET Aspire, this service provides a complete tenant lifecycle — from creation and user-role assignment to configuration and cross-tenant discovery — through a command-driven API that publishes domain events for downstream integration.

Features

• Tenant Lifecycle Management — Create, update, enable, and disable tenants through commands that produce auditable domain events
• User-Role Management — Add and remove users from tenants with role-based access (Owner, Contributor, Reader) and role behavior enforcement
• Global Administration — Bootstrap a global administrator to authorize initial tenant operations
• Tenant Configuration — Set and manage per-tenant key-value configuration with domain events for every change
• Event-Driven Integration — Subscribe to tenant domain events (TenantCreated, UserAddedToTenant, etc.) in consuming services via DAPR pub/sub
• In-Memory Testing Fakes — Production-parity domain logic with in-memory stores for fast, reliable tests without infrastructure dependencies

Quickstart

Get from clone to your first tenant in about 15 minutes:

— ~15 minutes with prerequisites installed, ~45 minutes including first-time prerequisite setup.

See It In Action

Watch reactive cross-service access revocation in action: add a user to a tenant, then remove them — and see the consuming service automatically revoke access via DAPR pub/sub events, with zero custom integration code.

— Step-by-step walkthrough with automated scripts in .

NuGet Packages

Project Structure

src/
 Hexalith.Tenants.AppHost/ # .NET Aspire AppHost — orchestrates the full topology
 Hexalith.Tenants.Aspire/ # Aspire hosting extensions for consuming AppHosts
 Hexalith.Tenants.Client/ # Client DI registration and event handling
 Hexalith.Tenants.CommandApi/ # REST API, auth, validation, DAPR actors
 Hexalith.Tenants.Contracts/ # Commands, events, enums, identities
 Hexalith.Tenants.Server/ # Aggregates, projections, domain logic
 Hexalith.Tenants.ServiceDefaults/ # Shared service config, OpenTelemetry
 Hexalith.Tenants.Testing/ # In-memory fakes and test helpers

tests/
 Hexalith.Tenants.Client.Tests/
 Hexalith.Tenants.Contracts.Tests/
 Hexalith.Tenants.IntegrationTests/
 Hexalith.Tenants.Server.Tests/
 Hexalith.Tenants.Testing.Tests/

samples/
 Hexalith.Tenants.Sample/ # Example consuming service with event subscription
 Hexalith.Tenants.Sample.Tests/

docs/
 quickstart.md # Getting started guide
 demo.md # "Aha Moment" demo walkthrough
 event-contract-reference.md # Event schemas and audit patterns
 idempotent-event-processing.md # Event handling patterns

scripts/
 demo.ps1 # PowerShell demo automation
 demo.sh # Bash demo automation

Contributing

Branch Naming

• feat/<description> — Features and enhancements
• fix/<description> — Bug fixes
• docs/<description> — Documentation changes

Development Workflow

1. Fork and clone with --recurse-submodules (the Hexalith.EventStore submodule is required)
2. Create a feature branch from main
3. Make changes following the code style defined in
4. Ensure all tests pass: dotnet test Hexalith.Tenants.slnx
5. Submit a pull request against main

Test Requirements

All pull requests must pass the existing test suite. New functionality should include appropriate unit tests. Integration tests require DAPR initialization (dapr init).

License

This project is licensed under the MIT License — see the file for details.