Welcome to the BitzOrcas.Modern hands-on tutorial series! Whether you are onboarding as a new engineer or leading architectural evolution, this guide uses real-world LegalTech domain use cases to take you from local setup to production-grade module delivery.
Progressive Developer Mastery Roadmap
Hands-on Quest Matrix
| Stage & Tutorial | Domain Business Scenario | Key Takeaway & Artifacts | Est. Time | Difficulty |
|---|---|---|---|---|
| Stage 1: Build Your First Vertical Slice | Civil Litigation Intake (CreateMatterIntakeCommand) | Master “One Use Case, One File”, 10-stage pipeline, and compile-time dual ORM | 15 mins | Starter |
| Stage 2: Add a Module Step-by-Step | Legal Contract Management (BitzOrcas.Modules.LegalContract) | Define Contracts, Domain, and Application layers with ArchUnit boundary rules | 25 mins | Intermediate |
| Stage 3: Add Multi-Tenant Validation | Law Firm Matter Intake & Conflict Checks | Implement universal invariants, cascading conflict strategies, and regex rule engines | 20 mins | Intermediate |
| Stage 4: Configure Your First Workflow | $50M+ High-Value Matter Partner Approval | Write declarative DSL, configure conditional routing gateways, and manage audit trails | 20 mins | Intermediate |
| Stage 5: Add Real-Time Notifications | Matter Intake & Pending Approval Alerts | Adhere to “Persistence First, Push Second” with high-throughput Server-Sent Events | 15 mins | Practical |
| Stage 6: Write Integration Tests | Full Matter Intake Container Regression | Spin up SQL Server 2022 and Redis via Testcontainers and verify EF Core / SqlSugar parity | 20 mins | Production |
Prerequisites Before You Start
Ensure you have completed these foundation steps:
- Toolchain Ready: .NET 10 SDK, Node.js 22 LTS, and Docker installed, see Prerequisites & Tooling;
- Aspire AppHost Running: Start backing containers via
dotnet run --project src/Hosts/BitzOrcas.AppHost, see 5-Minute Quick Start; - Architecture Mindset: Review the 10-stage pipeline and module collaboration rules, see Understanding BitzOrcas.
Ready? Click below to build your first vertical slice!
Chapter Navigation
- 01/06
Building Your First Vertical Slice: LegalTech Matter Intake Hands-on Tutorial
Master BitzOrcas.Modern Vertical Slice Architecture through a real-world civil litigation matter intake use case: inheriting TenantAggregateRoot, [BitzTable] metadata, [GenerateEndpoint] route binding, IAuthorizedRequest policy declaration, and ICommandRepository persistence.
- 02/06
Creating a Business Module from Scratch: Building High-Cohesion Domains Like Lego
Follow BitzOrcas.Modern modular monolith standards to build a Legal Contract Management module from scratch: partitioning physical boundaries across Contracts/Domain/Application, declaring IAppModule governance metadata, inheriting TenantAggregateRoot, and guarding boundaries with ArchUnitNET fitness functions.
- 03/06
Matter Intake & Conflicts: Hands-on Multi-Tenant 4-Tier Dynamic Validation
Master enterprise multi-tenant validation grounded in LegalTech: from universal base invariants and composite conflict strategies to tenant hot-configs and no-code field delivery rules.
- 04/06
Configuring Your First Approval Workflow: High-Stakes Matter Countersigning Hands-on
Leverage BitzOrcas.Modern's proprietary lightweight DAG state machine workflow engine to configure an approval workflow for major legal matters (claims exceeding 50M) with conditional gateways, partner countersigning, and immutable audit trails.
- 05/06
Integrating Real-Time Notifications: Server-Sent Events (SSE) High-Performance Streaming
Adhering to the architectural invariant 'Persistence First, Streaming Second,' leverage Server-Sent Events (SSE) to deliver high-performance streaming alerts for litigation approvals and conflict of interest warnings with automatic reconnection.
- 06/06
Writing Integration Tests and Behavior Parity: Testcontainers Hands-on
Leverage Testcontainers to spin up real SQL Server 2022 and Redis containers, write end-to-end integration tests for litigation matter intake slices, and assert 100% behavioral parity between EF Core and SqlSugar dual ORM adapters.