Schemata.Mapping.Foundation 10.0.0-preview.26305.37

Schemata

A .NET application framework for building modular, extensible business applications.

Quick Start

dotnet new web
dotnet add package --prerelease Schemata.Application.Complex.Targets

var builder = WebApplication.CreateBuilder(args)
    .UseSchemata(schema => {
        schema.UseLogging();
        schema.UseRouting();
        schema.UseControllers();
    });

var app = builder.Build();
app.Run();

Add more capabilities from the Feature Domains below.

Documentation

• Guides — step-by-step tutorials building a complete application from scratch
• Documents — technical reference for framework internals and all subsystems
• Modeling — SKM language reference for entity code generation

Feature Domains

• Authorization — OAuth 2.0 / OpenID Connect server
• Caching — distributed cache abstraction; Redis and IDistributedCache adapters
• DSL — .skm source generator
• Event — in-process / RabbitMQ event bus
• Flow — BPMN process engine, HTTP/gRPC transports, event/scheduling bridges
• Identity — ASP.NET Core Identity integration
• Mapping — unified object-mapper abstraction (AutoMapper / Mapster)
• Modular — module discovery and loading
• Repository — EF Core / LinqToDB providers with advisor pipeline, unit of work, ownership, query caching
• Resource — Google AIP-compliant CRUD service over HTTP and gRPC
• Scheduling — persistent cron / periodic / one-time job scheduler
• Tenancy — multi-tenant resolution and per-tenant DI
• Validation — FluentValidation integration

Features

Features are modular components that can be integrated at startup.

Features are characterized by Order and Priority, both of which are Int32 values. Order controls the sequence of ConfigureServices calls; Priority controls the sequence of ConfigureApplication and ConfigureEndpoints calls.

The range [100_000_000, 900_000_000] for Order and Priority is reserved for built-in features and Schemata extensions.

Built-in Features

A built-in feature can be activated by calling the UseXXX method on the SchemataBuilder instance. These features may also have additional configuration methods.

Extension Features

An extension feature can be activated in the same way as a built-in feature.

Compliance

Schemata targets the latest .NET Long-Term Support (LTS) version and the most recent .NET release. All runtime packages target net8.0;net10.0. Source generators target netstandard2.0 so Roslyn can load them.

Package	Compliance
Schemata.Advice.Generator
Schemata.Modeling.Generator
All other packages

Schemata.Authorization.Foundation

Schemata Authorization Foundation complies with the OpenID Connect Core 1.0 specification.

Schemata.Identity.Foundation

Schemata Identity Foundation is compatible with ASP.NET Core Identity.

Schemata.Mapping.Foundation

The Schemata Mapping Foundation is compatible with various mapping libraries, including AutoMapper and Mapster, among others.

It provides a unified interface for these libraries, enabling developers to switch between them without modifying application code.

Schemata.Resource.Foundation

The Schemata Resource Foundation complies with the API Improvement Proposals - General AIPs proposals.

Schemata.Flow.Foundation

The default StateMachineEngine in Schemata.Flow.StateMachine runs a subset of BPMN 2.0.2: one start event, at least one end event, plain activities (no SubProcess / CallActivity / loop characteristics), ExclusiveGateway, EventBasedGateway (exclusive mode only), interrupting boundary events, and intermediate catch events reachable from an EventBasedGateway. The full BPMN AST in Schemata.Flow.Skeleton covers more (parallel / inclusive / complex gateways, subprocesses, multi-instance loops) and is intended for alternate engines plugged in via a keyed IFlowRuntime.

Intermediate catch events bridge to runtime infrastructure: Schemata.Flow.Event correlates Message and Signal catches with the event bus, and Schemata.Flow.Scheduling fires Timer catches through the scheduler.

The process graph is built with a strongly-typed C# DSL in Schemata.Flow.Skeleton.Builders (ProcessBuilder, ActivityBehavior, BoundaryCatch, EventBranch, FlowBranch, InclusiveBranch, InclusiveMerge, ParallelFork, ParallelJoin, StartFlow).