A quick map of everything. New here? Start with Getting Started. Otherwise, pick the section that matches what you’re trying to do.
-
Getting Started
Install the template, run it locally, and understand the project layout.
-
Architecture
Modular monolith, vertical slice architecture, module governance, cross-cutting pipelines, and the composition root.
-
Architecture Diagrams
Visual diagram collection for the BitzOrcas.Modern system architecture.
-
Modules
Platform modules — Files, Notifications, Webhooks, PlatformBilling, Catalog, Tickets, Chat.
-
Building Blocks
Shared framework libraries — Domain, Application, Infrastructure, ORM adapters, Modularity, CodeGeneration, Persistence Models.
-
Cross-Cutting Concerns
Cross-cutting concerns in BitzOrcas — error handling, rate limiting, observability, audit pipeline, idempotency, health checks, caching, and background jobs.
-
Security & Authorization
Security architecture — three-scheme authentication (JWT/HMAC/API Key), multi-strategy authorization, HMAC nonce anti-replay, webhook signing, and delegation (impersonation).
-
Testing
Testing strategy — unit tests, integration tests, architecture tests, application tests, and code generation tests with the Vertical Slice Architecture testing approach.
-
Guides
Practical guides — add a module, add a feature, template project structure, and upgrade instructions.
-
Deployment
Deployment guide — Aspire orchestration for local development, container deployment for production, and CI/CD configuration.
-
Contributing
How to contribute to BitzOrcas — code style, commit conventions, PR process, and project structure.
-
Changelog
Release notes and version history for BitzOrcas.Modern.