Csag.Blueprint.Infrastructure 0.1.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Csag.Blueprint.Infrastructure --version 0.1.1
                    


                    

                
NuGet\Install-Package Csag.Blueprint.Infrastructure -Version 0.1.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Csag.Blueprint.Infrastructure" Version="0.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Csag.Blueprint.Infrastructure" Version="0.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Csag.Blueprint.Infrastructure" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Csag.Blueprint.Infrastructure --version 0.1.1
                    


                    

                
#r "nuget: Csag.Blueprint.Infrastructure, 0.1.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Csag.Blueprint.Infrastructure@0.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Csag.Blueprint.Infrastructure&version=0.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Csag.Blueprint.Infrastructure&version=0.1.1
                    


                            Install as a Cake Tool

Csag.Blueprint.Infrastructure

Overview

This package provides the shared infrastructure implementation layer for CSAG Blueprint-based applications.

It contains the reusable EF Core persistence backbone, session/auth infrastructure, localization infrastructure, tenancy helpers, authorization transformation, and table-view execution components that consuming applications compose into their own host.

What this package owns

Persistence backbone

Component Purpose
BlueprintDbContext<TAppTenant, TAppUser, TAppRole> Shared EF Core base context that owns the blueprint persistence model.
Blueprint*Configuration classes EF Core mappings for blueprint-owned entities and inheritance roots.
MultiTenancyModelBuilderExtensions Applies tenant filters/indexing/model conventions for tenant-scoped entities. See Data isolation topology for the database-per-tenant option.

Data isolation topology

ConfigureBlueprintMultiTenancy implements the pooled topology: every entity implementing IMustHaveTenant gets a global query filter on TenantId, an index on that column, and a foreign key to the tenant table.

modelBuilder.ConfigureBlueprintMultiTenancy<ApplicationTenant, ApplicationDbContext>(this);

Because isolation is enforced by the filter and not the database, any table that cannot carry a tenant discriminator — the user table, since identity is shared — is a permanent sharp edge that must be scoped by membership on every query.

Moving to database-per-tenant. Pass addTenantForeignKey: false when tenant-owned data lives in a different database from the tenant table; a foreign key cannot cross databases, so emitting one there produces an invalid model. The filter and index still apply — only referential integrity moves from the database to the application.

modelBuilder.ConfigureBlueprintMultiTenancy<ApplicationTenant, BusinessDbContext>(
    this, addTenantForeignKey: false);

Note that IMustHaveTenant is not a synonym for "shardable". Some tenant-owned entities are identity concerns — a service account is tenant-scoped but authentication needs it, so it must stay in the central database. Classify each entity by plane before splitting anything.

Interceptors

Interceptor Purpose
AuditableTimestampInterceptor Sets CreatedAt/UpdatedAt automatically for IAuditable entities.
TenantSaveInterceptor Assigns and protects TenantId for IMustHaveTenant entities.

Session and authorization infrastructure

Component Purpose
DistributedCacheTicketStore ASP.NET Core ITicketStore implementation for server-side session storage.
TicketCacheService Serialization/cache wrapper for authentication tickets.
PostConfigureCookieAuthenticationOptions Injects the ticket store into cookie authentication options.
SessionManager Shared session revocation/refresh management.
PermissionClaimsTransformation Expands role claims into permission claims after authentication.
UserManagerAuthorizationExtensions Loads roles and permissions for users.

Tenancy and localization infrastructure

Component Purpose
TenantService / TenantManager Reusable tenant access and membership logic.
BlueprintDbStringLocalizer / BlueprintDbStringLocalizerFactory Database-backed localization infrastructure.
PassThroughStringLocalizer Generation-mode localizer that returns keys as-is.
TranslationCacheKeys Cache key helpers for localization caching.
MigrationBuilderExtensions Translation seeding helpers for migrations.

Table view infrastructure

Component Purpose
TableViewExecutor Executes filtering, sorting, counting, pagination, and projection for table-view queries.
TableViewCatalogService Discovers and filters registered table views by permission.
BlueprintTableViewPreferencesService Persists per-user table view preferences.

Ownership Boundary

This package owns reusable infrastructure, not application composition.

The consuming application still owns:

  • the concrete ApplicationDbContext
  • DI composition and host setup
  • app-specific options and policies
  • app-specific entities and migrations
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Csag.Blueprint.Infrastructure:

Package Downloads
Csag.Blueprint.Web

ASP.NET Core middleware, validated options, security configuration, and FastEndpoints extensions for CSAG Blueprint applications.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1 49 8/13/2026
0.1.0 130 7/3/2026