# qurtuba-team/bookorbit-backend architecture

> Architecture diagram of the GitHub repository qurtuba-team/bookorbit-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/qurtuba-team/bookorbit-backend
- Repository: https://github.com/qurtuba-team/bookorbit-backend

## Overview

1. **Overall shape**
   - This is a layered ASP.NET Core 9 backend organized as **Clean Architecture + DDD + CQRS**.
   - The solution is split into four main runtime projects: **Api**, **Application**, **Domain**, and **Infrastructure**.
   - Dependencies point inward: the API depends on Application/Infrastructure, Infrastructure depends on Application/Domain, and Domain stays framework-light.

2. **Request entry point**
   - HTTP traffic enters **BookOrbit.Api** through feature-based controllers under `/api/v1/...`.
   - Controllers are thin: they accept request contracts, send commands/queries through **MediatR**, and translate `Result<T>` responses into HTTP results.
   - Presentation-specific concerns live here: request DTOs, OpenAPI transformers, exception middleware, request logging middleware, rate limiting, and error-to-ProblemDetails mapping.

3. **Application layer as use-case orchestration**
   - **BookOrbit.Application** contains the actual use cases, organized by feature folders such as Books, Students, BorrowingRequests, BorrowingTransactions, Identity, Chat, Notifications, and OTPs.
   - Each feature follows CQRS: commands change state, queries read projections.
   - Most features have handlers, validators, DTOs, and optional event handlers.
   - Cross-cutting MediatR pipeline behaviors handle validation, caching, logging, performance timing, and unhandled exception capture.

4. **Domain model boundaries**
   - **BookOrbit.Domain** holds the business model: aggregates, value objects, enums, domain errors, and domain events.
   - Main aggregates include **Student**, **Book**, **BookCopy**, **LendingListRecord**, **BorrowingRequest**, **BorrowingTransaction**, **BorrowingReview**, **PointTransaction**, **ChatGroup**, **ChatMessage**, **Notification**, **Otp**, **OutboxMessage**, and **RefreshToken**.
   - The model emphasizes explicit state machines and factory methods so invalid state is hard to create.

5. **Core business flow**
   - The main domain flow is: **book cataloging → copy registration → lending listing → borrowing request → transaction → review → point settlement**.
   - Book and student lifecycles are managed through state transitions in application commands.
   - Borrowing requests and transactions drive most of the system’s business rules, including expiration, return/lost handling, and points changes.

6. **Persistence and data access**
   - **BookOrbit.Infrastructure** owns **EF Core**, SQL Server persistence, entity configuration, migrations, and the `AppDbContext`.
   - The application layer depends on `IAppDbContext`; Infrastructure provides the concrete DbContext implementation.
   - Domain events are dispatched during `SaveChanges`, so persistence is also the handoff point from state changes to side effects.

7. **Side effects and integration services**
   - Infrastructure implements the ports defined by Application: identity, email, image handling, OTP generation/verification, masking, route building, serialization, student queries, system notifications, and caching.
   - External integrations include **SMTP email**, **JWT signing**, and **file storage** for book/student images under the API’s upload/static folders.
   - The chat subsystem also includes a real-time service and SignalR hub, so chat messages are not just stored; they can be pushed live.

8. **AuthN/AuthZ architecture**
   - Authentication is JWT-based with **refresh token rotation** backed by the database.
   - Authorization is policy-driven and based on roles, user/student state, ownership, and entity relationships.
   - Policies are implemented as dedicated requirements/handlers in Infrastructure and applied at controller action level.

9. **Caching and query optimization**
   - Read-heavy use cases use a caching pipeline with **HybridCache** and tag-based invalidation.
   - Cached queries define cache keys, TTLs, and tags; mutation commands invalidate by tag after successful writes.
   - List endpoints use a shared paged-query pattern with filtering, searching, sorting, and projection into DTOs.

10. **Consistency, events, and background jobs**
   - The system uses **domain events** for internal reactions such as student creation, borrowing request changes, transaction state changes, and review creation.
   - There is also an **outbox message** subsystem, with a background service that processes pending messages.
   - Another background job marks expirable entities, supporting time-based lifecycle transitions.

11. **Operational boundaries**
   - The repo is prepared for containerized deployment with **Docker Compose**.
   - The compose stack includes the API, **SQL Server**, **Seq** for logs, **Prometheus** for metrics, **Grafana** for dashboards, and **Jaeger** for traces.
   - The API exposes `/health` and `/metrics`, and OpenTelemetry/Serilog are wired for observability and correlation.

12. **Testing structure**
   - Tests are split into **Domain unit tests**, **Application unit tests**, and **Application subcutaneous tests**.
   - Domain tests focus on invariants and state transitions.
   - Subcutaneous tests exercise feature flows through MediatR and the application pipeline, which makes them useful for validating architecture-level behavior.

13. **Key diagram boundaries to draw**
   - Draw a hard boundary around **Domain** for pure business rules.
   - Draw **Application** as the orchestration layer between HTTP and persistence.
   - Draw **Infrastructure** as the adapter layer to SQL Server, email, files, auth, caching, real-time chat, and background processing.
   - Draw **API** as the thin presentation edge that handles transport, auth, routing, rate limits, and error formatting.

Main entry points: [`Code/BookOrbit.Application`](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application) (BookOrbit.Application), [`Code/BookOrbit.Infrastructure`](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure) (BookOrbit.Infrastructure), [`Code/BookOrbit.Api`](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api) (BookOrbit.Api), [`Code/BookOrbit.Domain`](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain) (BookOrbit.Domain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["API"]
  node_api["BookOrbit.Api<br/>ASP.NET Core API<br/>[BookOrbit.Api]"]
  node_api_controllers["Controllers<br/>feature endpoints<br/>[Controllers]"]
  node_api_middleware["Middleware<br/>transport cross-cutting<br/>[Middlewares]"]
  node_api_contracts["Contracts<br/>request DTOs<br/>[Requests]"]
  node_api_openapi["OpenAPI<br/>schema transforms<br/>[Transformers]"]
end

subgraph group_application["Application"]
  node_app["BookOrbit.Application<br/>CQRS application"]
  node_app_pipeline["Pipeline<br/>MediatR behaviors<br/>[Behaviours]"]
  node_app_ports["Ports<br/>service interfaces<br/>[Interfaces]"]
  node_app_books["Books<br/>feature slice<br/>[Books]"]
  node_app_borrowing["Borrowing<br/>feature slice"]
  node_app_students["Students<br/>feature slice<br/>[Students]"]
  node_app_identity["Identity<br/>feature slice<br/>[Identity]"]
  node_app_chat["Chat<br/>feature slice<br/>[Chat]"]
  node_app_notifications["Notifications<br/>feature slice<br/>[Notifications]"]
end

subgraph group_domain["Domain"]
  node_domain["BookOrbit.Domain<br/>domain model<br/>[BookOrbit.Domain]"]
  node_domain_core_flow{{"Core Flow<br/>aggregate flow<br/>[BookOrbit.Domain]"}}
  node_domain_events["Domain Events<br/>business events<br/>[BookOrbit.Domain]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_infra["BookOrbit.Infrastructure<br/>EF Core + adapters"]
  node_infra_data[("Data<br/>EF Core persistence<br/>[Data]")]
  node_infra_services["Services<br/>adapter implementations<br/>[Services]"]
  node_infra_identity["AuthZ<br/>JWT + policies<br/>[Identity]"]
  node_infra_jobs["Background Jobs<br/>workers<br/>[BackgroundJobs]"]
  node_infra_realtime["Realtime Chat<br/>SignalR<br/>[ChatServices]"]
end

subgraph group_tests["Tests"]
  node_tests_domain["Domain Tests<br/>unit tests"]
  node_tests_app["App Tests<br/>unit tests"]
  node_tests_subcutaneous["Subcutaneous<br/>feature tests"]
end

node_api -->|"hosts"| node_api_controllers
node_api -->|"uses"| node_api_middleware
node_api -->|"binds"| node_api_contracts
node_api -->|"describes"| node_api_openapi
node_api_controllers -->|"sends"| node_app
node_api_middleware -.->|"normalizes errors"| node_app
node_app -->|"wraps"| node_app_pipeline
node_app -->|"depends on"| node_app_ports
node_app -->|"models rules"| node_domain
node_app -.->|"implemented by"| node_infra
node_app -->|"contains"| node_app_books
node_app -->|"contains"| node_app_borrowing
node_app -->|"contains"| node_app_students
node_app -->|"contains"| node_app_identity
node_app -->|"contains"| node_app_chat
node_app -->|"contains"| node_app_notifications
node_domain -->|"encodes"| node_domain_core_flow
node_domain -->|"emits"| node_domain_events
node_infra -->|"persists"| node_infra_data
node_infra -->|"adapts"| node_infra_services
node_infra -->|"secures"| node_infra_identity
node_infra -->|"processes"| node_infra_jobs
node_infra -->|"pushes"| node_infra_realtime
node_infra_data -.->|"dispatches"| node_domain_events
node_app_borrowing -->|"drives"| node_domain_core_flow
node_app_students -.->|"reacts to"| node_domain_events
node_app_borrowing -.->|"reacts to"| node_domain_events
node_app_identity -.->|"uses"| node_infra_identity
node_app_chat -.->|"publishes"| node_infra_realtime
node_tests_domain -.->|"verifies"| node_domain
node_tests_app -.->|"verifies"| node_app
node_tests_subcutaneous -.->|"exercises"| node_app

click node_api "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api"
click node_api_controllers "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Controllers"
click node_api_middleware "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Middlewares"
click node_api_contracts "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Contracts/Requests"
click node_api_openapi "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/OpenApi/Transformers"
click node_app "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application"
click node_app_pipeline "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Common/Behaviours"
click node_app_ports "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Common/Interfaces"
click node_app_books "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Books"
click node_app_borrowing "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/BorrowingTransactions"
click node_app_students "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Students"
click node_app_identity "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Identity"
click node_app_chat "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Chat"
click node_app_notifications "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Notifications"
click node_domain "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain"
click node_domain_core_flow "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain"
click node_domain_events "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain"
click node_infra "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure"
click node_infra_data "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Data"
click node_infra_services "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Services"
click node_infra_identity "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Identity"
click node_infra_jobs "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/BackgroundJobs"
click node_infra_realtime "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Services/ChatServices"
click node_tests_domain "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Domain.UnitTests"
click node_tests_app "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Application.UnitTests"
click node_tests_subcutaneous "https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Application.SubcutaneousTests"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_api_controllers,node_api_middleware,node_api_contracts,node_api_openapi toneBlue
class node_app,node_app_pipeline,node_app_ports,node_app_books,node_app_borrowing,node_app_students,node_app_identity,node_app_chat,node_app_notifications toneAmber
class node_domain,node_domain_core_flow,node_domain_events toneMint
class node_infra,node_infra_data,node_infra_services,node_infra_identity,node_infra_jobs,node_infra_realtime toneRose
class node_tests_domain,node_tests_app,node_tests_subcutaneous toneIndigo
```

## Components

### API

HTTP edge, transport concerns, and request/response mapping.

- [BookOrbit.Api](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api): ASP.NET Core API · Thin HTTP presentation layer with controllers, middleware, OpenAPI, and request contracts. · `Code/BookOrbit.Api`
- [Controllers](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Controllers): feature endpoints · Feature-based controllers for books, students, borrowing, chat, identity, images, and notifications. · `Code/BookOrbit.Api/Controllers`
- [Middleware](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Middlewares): transport cross-cutting · Exception handling, request logging, rate limiting, and ProblemDetails mapping. · `Code/BookOrbit.Api/Middlewares`
- [Contracts](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/Contracts/Requests): request DTOs · API request models and paging/filter contracts used by controllers. · `Code/BookOrbit.Api/Contracts/Requests`
- [OpenAPI](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Api/OpenApi/Transformers): schema transforms · Swagger/OpenAPI transformers for bearer auth and version metadata. · `Code/BookOrbit.Api/OpenApi/Transformers`

### Application

CQRS use-case orchestration, policies, and pipeline behaviors.

- [BookOrbit.Application](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application): CQRS application · Use-case orchestration layer built around MediatR, validation, caching, and event handlers. · `Code/BookOrbit.Application`
- [Pipeline](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Common/Behaviours): MediatR behaviors · Validation, caching, logging, performance timing, and unhandled exception behaviors. · `Code/BookOrbit.Application/Common/Behaviours`
- [Ports](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Common/Interfaces): service interfaces · Abstractions for DB, cache, identity, email, images, OTPs, routes, serialization, chat, and notifications. · `Code/BookOrbit.Application/Common/Interfaces`
- [Books](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Books): feature slice · Book catalog use cases with commands, queries, and DTO projections. · `Code/BookOrbit.Application/Features/Books`
- [Borrowing](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/BorrowingTransactions): feature slice · Borrowing requests, transactions, reviews, and transaction events orchestration. · `Code/BookOrbit.Application/Features/BorrowingTransactions`
- [Students](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Students): feature slice · Student lifecycle, public/profile queries, and state transitions. · `Code/BookOrbit.Application/Features/Students`
- [Identity](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Identity): feature slice · Tokens, password reset, email confirmation, and authentication workflows. · `Code/BookOrbit.Application/Features/Identity`
- [Chat](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Chat): feature slice · Chat commands and queries for groups, history, and message state. · `Code/BookOrbit.Application/Features/Chat`
- [Notifications](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Application/Features/Notifications): feature slice · Notification queries and read-state commands. · `Code/BookOrbit.Application/Features/Notifications`

### Domain

Framework-light business model and invariants.

- [BookOrbit.Domain](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain): domain model · Pure business model with aggregates, value objects, enums, errors, and domain events. · `Code/BookOrbit.Domain`
- [Core Flow](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain): aggregate flow · Cataloging books, registering copies, listing for lending, requesting, transacting, reviewing, and settling points. · `Code/BookOrbit.Domain`
- [Domain Events](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Domain): business events · Student, borrowing, review, transaction, and outbox events used for internal reactions and side effects. · `Code/BookOrbit.Domain`

### Infrastructure

Persistence, integrations, auth, caching, real-time, and background processing.

- [BookOrbit.Infrastructure](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure): EF Core + adapters · Persistence and external service adapters, plus policies and background services. · `Code/BookOrbit.Infrastructure`
- [Data](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Data): EF Core persistence · AppDbContext, entity configurations, migrations, and save-time interception. · `Code/BookOrbit.Infrastructure/Data`
- [Services](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Services): adapter implementations · Email, image, OTP, cache, chat, masking, routing, serialization, student query, and system notification services. · `Code/BookOrbit.Infrastructure/Services`
- [AuthZ](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Identity): JWT + policies · Identity service, token provider, refresh tokens, and policy requirements/handlers. · `Code/BookOrbit.Infrastructure/Identity`
- [Background Jobs](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/BackgroundJobs): workers · Outbox processing and expirable-entity marking jobs. · `Code/BookOrbit.Infrastructure/BackgroundJobs`
- [Realtime Chat](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Code/BookOrbit.Infrastructure/Services/ChatServices): SignalR · Chat hub and real-time delivery service for live message push. · `Code/BookOrbit.Infrastructure/Services/ChatServices`

### Tests

Unit and subcutaneous verification layers.

- [Domain Tests](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Domain.UnitTests): unit tests · Invariant and state-transition tests for aggregates and value objects. · `Tests/BookOrbit.Domain.UnitTests`
- [App Tests](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Application.UnitTests): unit tests · Application-level mapper and orchestration tests. · `Tests/BookOrbit.Application.UnitTests`
- [Subcutaneous](https://github.com/qurtuba-team/bookorbit-backend/blob/main/Tests/BookOrbit.Application.SubcutaneousTests): feature tests · End-to-end feature tests through MediatR and the application pipeline. · `Tests/BookOrbit.Application.SubcutaneousTests`

## Connections

- BookOrbit.Api → Controllers: hosts · Controllers implement the HTTP entry points.
- BookOrbit.Api → Middleware: uses · Central request/error handling is wired at the API edge.
- BookOrbit.Api → Contracts: binds · Incoming requests are mapped from transport DTOs.
- BookOrbit.Api → OpenAPI: describes · OpenAPI transformers shape the published contract.
- Controllers → BookOrbit.Application: sends · Controllers dispatch commands and queries through MediatR.
- Middleware → BookOrbit.Application: normalizes errors · Exception handling translates failures into HTTP problems.
- BookOrbit.Application → Pipeline: wraps · MediatR behaviors apply across all use cases.
- BookOrbit.Application → Ports: depends on · Use cases target abstractions rather than concrete services.
- BookOrbit.Application → BookOrbit.Domain: models rules · Application logic coordinates domain entities and state transitions.
- BookOrbit.Application → BookOrbit.Infrastructure: implemented by · Infrastructure provides concrete implementations of application ports.
- BookOrbit.Application → Books: contains · Book-related commands, queries, and DTOs.
- BookOrbit.Application → Borrowing: contains · Borrowing workflows and transaction/review logic.
- BookOrbit.Application → Students: contains · Student lifecycle and profile use cases.
- BookOrbit.Application → Identity: contains · Authentication, password, and token workflows.
- BookOrbit.Application → Chat: contains · Chat messaging and history use cases.
- BookOrbit.Application → Notifications: contains · Notification retrieval and read-state use cases.
- BookOrbit.Domain → Core Flow: encodes · The main business journey is captured in aggregates and state machines.
- BookOrbit.Domain → Domain Events: emits · Aggregates raise domain events for internal reactions.
- BookOrbit.Infrastructure → Data: persists · EF Core stores aggregates, projections, refresh tokens, and outbox records.
- BookOrbit.Infrastructure → Services: adapts · Concrete adapters implement application service ports.
- BookOrbit.Infrastructure → AuthZ: secures · JWT, refresh rotation, and policy requirements live here.
- BookOrbit.Infrastructure → Background Jobs: processes · Background services handle outbox and time-based lifecycle jobs.
- BookOrbit.Infrastructure → Realtime Chat: pushes · SignalR hub and real-time delivery support chat.
- Data → Domain Events: dispatches · Domain events are handed off around SaveChanges.
- Borrowing → Core Flow: drives · Borrowing commands coordinate the core lending lifecycle.
- Students → Domain Events: reacts to · Student event handlers respond to domain changes.
- Borrowing → Domain Events: reacts to · Borrowing event handlers coordinate follow-up actions.
- Identity → AuthZ: uses · Token and identity workflows depend on infrastructure services.
- Chat → Realtime Chat: publishes · Chat commands can trigger real-time message delivery.
- Domain Tests → BookOrbit.Domain: verifies · Unit tests validate pure business rules.
- App Tests → BookOrbit.Application: verifies · Unit tests cover application mappings and orchestration.
- Subcutaneous → BookOrbit.Application: exercises · Subcutaneous tests run feature flows through the full application stack.
