Concept

Architecture Diagrams

Visual diagram collection for the BitzOrcas.Modern system architecture.

Last updated Jun 22, 2026

Visual diagram collection for the BitzOrcas.Modern architecture. Each diagram has its own dedicated sub-page — click a card to view it at full size.

Core Architecture

System Overview

The complete system: three hosts, ten building-block libraries, seven platform modules, and three external infrastructure dependencies

Module Dependencies

18 bounded contexts in a four-tier dependency structure with red-line annotations

Layer Stack

The five-layer architecture inside each module: Endpoints → Application → Domain → Infrastructure → Persistence Models

Pipelines & Flows

Mediator Pipeline

The 7-behavior Mediator request processing chain

Auth & Authorization

Three-scheme authentication and the unified authorization decision service

Event-Driven Architecture

CAP Outbox pattern for transactional event publishing

Infrastructure

ORM Adapter Pattern

Three-tier adapter switching strategy: SqlSugar / EF Core / Dapper

Audit Sharding

Six audit categories with sharded storage and retention policies

Lifecycle & Flows

Request Lifecycle

HTTP request flow through the API middleware pipeline from exception handler to endpoint

CAP Event Publish Sequence

Transactional outbox pattern with CAP dispatcher for reliable event publishing

Order Workflow State Machine

Workflow entity state transitions from draft through approval to completion

Application Startup Sequence

API host boot sequence from WebApplicationBuilder to health-check ready

Domain & Data

Entity Inheritance Hierarchy

Four-level entity tree with domain contract interfaces for tenant isolation, soft delete, and auditing

Multi-Tenant Resolution Chain

Eight-step priority-ordered chain of responsibility for tenant resolution

CQRS Command/Query Segregation

Parallel command and query processing flows with shared and dedicated pipeline behaviors

Exception Handling Hierarchy

Layered error handling from domain exceptions through to HTTP status code mapping

Structure & Organization

Building Blocks Responsibility Matrix

Ten building blocks positioned by Infrastructure vs Application and Cross-cutting vs Core

Module Internal Structure

Nested containment structure within a module showing layers and boundaries

Dependency Injection Tree

DI registration hierarchy across the four composition root groups

Module Ownership Map

Platform module bounded context ownership and responsibility grouping

Host Technology Stack

Six-layer technology stack from HTTP endpoints down to external resources

ORM Adapter Concerns

Overlap and unique features across three ORM adapters: SqlSugar, EF Core, and Dapper

Design system

All diagrams follow the same visual design system:

Token	Value	Usage
Paper	`#f5f5f5`	Warm white-smoke background
Ink	`#2d3142`	Primary text and strokes
Accent	`#eb6c36`	Focal elements (max 2 per diagram)
Muted	`#4f5d75`	Secondary text and default arrows
Link	`#2e5aa8`	HTTP/API calls, external systems

Architecture overview — detailed prose documentation
Modular monolith — module governance system
Vertical Slice — internal module structure