Cosmos.MultiTenancy 3.0.0

Cosmos.MultiTenancy

Contrato del contexto de tenancy para aplicaciones distribuidas .NET 10 del ecosistema Cosmos.

Descripción

Este paquete provee únicamente la abstracción ITenantContext. No incluye implementaciones concretas — éstas viven en paquetes separados según el origen de la identidad (HTTP headers, JWT claims, etc.):

• Cosmos.MultiTenancy.AspNetCore — TrustedHeadersTenantContext que lee el TenantId del header HTTP confiable X-Tenant-Id, el UserId de X-User-Id y el OrganizationMembershipId de X-Organization-Membership-Id.

La separación entre contrato e implementación permite que las aplicaciones consuman el contrato sin depender de infraestructura concreta (HTTP, DB, JWT, etc.) y que los tests puedan registrar implementaciones in-memory.

Instalación

dotnet add package Cosmos.MultiTenancy

Se instala como dependencia transitiva al usar Cosmos.EventSourcing.CritterStack u otros paquetes del ecosistema que requieran ITenantContext.

Contrato

namespace Cosmos.MultiTenancy;

public interface ITenantContext
{
    string TenantId { get; }
    string UserId { get; }
    string OrganizationMembershipId { get; }
}

Tres propiedades del request o contexto actual: el identificador del tenant, el del usuario, y el de la membresía de ese usuario en la organización con la que está actuando.

Las tres son obligatorias: las implementaciones lanzan InvalidOperationException cuando el dato no está disponible, en vez de devolver null. Un flujo sin identidad completa es un error de configuración del borde, no un caso válido.

Headers de propagación

TenancyHeaders publica los nombres de los headers con los que la identidad viaja servicio-a-servicio en el envelope de Wolverine:

TenancyHeaders.UserId                    // "user_id"
TenancyHeaders.OrganizationMembershipId  // "organization_membership_id"

El TenantId no figura ahí porque Wolverine lo propaga de forma nativa (DeliveryOptions.TenantId → IMessageContext.TenantId).

Uso

El consumidor inyecta ITenantContext y consulta TenantId:

public class OrderService(ITenantContext tenantContext, ICommandRouter commandRouter)
{
    public Task CreateOrderAsync(CreateOrderCommand command, CancellationToken ct)
    {
        var tenantId = tenantContext.TenantId;
        // ...
        return commandRouter.InvokeAsync(command, ct);
    }
}

Registro en DI

El contrato no se registra automáticamente. El consumidor elige qué implementación usar:

// Para servicios ASP.NET Core con headers confiables emitidos por el gateway
builder.Services.AgregarTenantContextConHeadersConfiables();

Para escenarios sin HTTP (jobs, consoles, tests) hay que implementar ITenantContext propio y registrarlo manualmente:

public class FixedTenantContext(string tenantId, string userId, string organizationMembershipId)
    : ITenantContext
{
    public string TenantId { get; } = tenantId;
    public string UserId { get; } = userId;
    public string OrganizationMembershipId { get; } = organizationMembershipId;
}

services.AddSingleton<ITenantContext>(
    new FixedTenantContext("dev-tenant", "dev-user", "dev-membership"));

Integración con Wolverine

Cosmos.EventSourcing.CritterStack consume ITenantContext en sus routers (WolverineCommandRouter, WolverineQueryRouter) para invocar Wolverine con el TenantId del request actual:

public class WolverineCommandRouter(IMessageBus messageBus, ITenantContext tenantContext)
    : ICommandRouter
{
    public Task InvokeAsync<TCommand>(TCommand command, CancellationToken ct) where TCommand : class
        => messageBus.InvokeForTenantAsync(tenantContext.TenantId, command, ct);
}

El consumidor debe registrar una implementación de ITenantContext antes de usar los routers — sin eso, la resolución de DI fallará en runtime.

Casos de uso

• Multi-tenancy en event sourcing: prefijar IDs de agregado con el TenantId para aislar streams.
• Logging con contexto: enriquecer logs con el TenantId del request actual.
• Marten multi-tenant: pasar tenantContext.TenantId a IDocumentStore.OpenSession(tenantId).

Consideraciones de diseño

• Scope: se recomienda registrar como Scoped para web apps — un contexto por request.
• Aislamiento de datos: este paquete identifica el tenant; el aislamiento real (DB-per-tenant, schema-per-tenant, columna discriminator) lo implementan capas superiores.
• Contexto no encontrado: si IServiceProvider no tiene ITenantContext registrado, los routers de CritterStack fallarán con InvalidOperationException al inyectar la dependencia.

Requisitos

• .NET 10.0 o superior

Dependencias

Sin dependencias externas.

Paquetes relacionados

• Cosmos.MultiTenancy.AspNetCore — contexto basado en headers HTTP confiables.
• Cosmos.EventSourcing.CritterStack — routers Wolverine que consumen ITenantContext.

Licencia

Copyright © Cosmos. Todos los derechos reservados.