Csag.Blueprint.Application 0.1.0

Csag.Blueprint.Application

Overview

This package provides application-layer abstractions for CSAG Blueprint-based applications: service interfaces, claim type constants, tenant context management, and a full table view query system. It sits between Domain and Infrastructure, defining contracts that infrastructure and app layers implement.

Claims

• IdentityClaimTypes: Static constants for identity claim types used across the application (TenantId, PreferredLanguage). Stored in the authentication ticket so they are available on every request without a database lookup.

Tenant Context

• TenantContext: Ambient AsyncLocal-backed storage for the current tenant ID. Set by middleware, read by query filters, save interceptors, and application code via SetTenant(), Current, and Clear().

Service Abstractions

All service contracts are defined as interfaces for dependency injection and testability.

Table View System

A generic, permission-aware system for server-side filtered, sorted, and paginated data grids. Application code defines views using a fluent API; infrastructure executes them against EF Core.

Defining a table view

Subclass TableViewDefinition<TEntity, TDto> and configure columns in the constructor:

public sealed class UserTableViewDefinition : TableViewDefinition<UserEntity, UserDto>
{
    public UserTableViewDefinition()
    {
        Column(dto => dto.Name)
            .Filterable(TableViewFilterOperator.Contains)
            .Sortable();

        Column(dto => dto.Email)
            .Filterable(TableViewFilterOperator.Contains)
            .Sortable();

        ComputedColumn("FullName", entity => entity.FirstName + " " + entity.LastName, dto => dto.FullName)
            .Sortable();
    }
}

Key components

Filter operators

Request / Result models

• TableViewDataRequest: Incoming request with filters, sort, page, and page size.
• TableViewQueryRequest<TEntity, TDto>: Internal request that pairs a base IQueryable with a ITableViewDefinition and pagination parameters.
• TableViewDataResult<TDto>: Response with column metadata, data, total count, and computed page info.
• TableViewPreferencesModel: Serializable user preferences for a specific view.