# neozhu/cleanarchitecturewithblazorserver architecture

> Architecture diagram of the GitHub repository neozhu/cleanarchitecturewithblazorserver, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/neozhu/cleanarchitecturewithblazorserver
- Repository: https://github.com/neozhu/cleanarchitecturewithblazorserver

## Overview

This is a Clean Architecture Blazor Server application template for building enterprise business systems. Its principal runtime workflow is a user interacting with the UI, which invokes application use cases; those use application-owned interfaces to access infrastructure services and persistence, with results returned for display or export. The graph also preserves the documented identity, tenant, real-time, and data-export capabilities, plus the sampled document OCR worker. Evidence is limited to the README and supplied source excerpts/index; unsampled links are omitted or marked unverified.

Main entry points: [`src/Server.UI`](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Server.UI) (Blazor Server UI), [`src/Application/Common/Interfaces/IApplicationDbContextFactory.cs`](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IApplicationDbContextFactory.cs) (Database context contract), [`src/Application/Features/Contacts`](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Contacts) (Contact use cases), [`src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs`](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs) (Contact pagination query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Blazor UI"]
  node_serverui["Blazor Server UI<br/>[Server.UI]"]
  node_hub["SignalR hubs<br/>[Hubs]"]
end

subgraph group_app["Application use cases"]
  node_contacts["Contact use cases"]
  node_products["Product use cases"]
  node_documents["Document use cases"]
  node_audit["Audit trail queries"]
  node_picklists["Picklist management"]
  node_tenants["Tenant management"]
  node_logs["System log queries"]
  node_pipeline["Request pipeline"]
  node_contactquery["Contact pagination query"]
  node_contactexport["Contact export query"]
  node_dbcontract["Database context contract"]
  node_ocrqueue["OCR queue contract"]
  node_ocrjob["OCR job contract<br/>[IDocumentOcrJob.cs]"]
end

subgraph group_domain["Domain model"]
  node_contactentity["Contact entity<br/>[Contact.cs]"]
  node_userentity["Application user entity<br/>[ApplicationUser.cs]"]
end

subgraph group_infra["Infrastructure adapters"]
  node_db[("Application database")]
  node_excel["Excel service<br/>[ExcelService.cs]"]
  node_ocrworker["Document OCR worker"]
end

subgraph group_security["Identity and realtime"]
  node_permissionquery["Permission queries"]
end

node_user(("Application user"))

node_user -->|"uses"| node_serverui
node_serverui -.->|"invokes use cases"| node_contacts
node_serverui -.->|"invokes use cases"| node_products
node_serverui -.->|"invokes use cases"| node_documents
node_serverui -.->|"invokes use cases"| node_tenants
node_serverui -.->|"dispatches requests"| node_pipeline
node_contactquery -->|"creates context"| node_dbcontract
node_contactquery -->|"queries"| node_contactentity
node_contactexport -->|"creates context"| node_dbcontract
node_contactexport -->|"exports rows"| node_excel
node_contacts -.->|"includes query"| node_contactquery
node_contacts -.->|"includes export"| node_contactexport
node_dbcontract -.->|"implemented by"| node_db
node_excel -.->|"returns file data"| node_serverui
node_permissionquery -->|"loads user claims"| node_userentity
node_ocrworker -->|"dequeues requests"| node_ocrqueue
node_ocrworker -->|"runs recognition"| node_ocrjob
node_serverui -.->|"uses realtime updates"| node_hub
node_audit -.->|"reads through"| node_dbcontract
node_picklists -.->|"reads through"| node_dbcontract
node_logs -.->|"reads through"| node_dbcontract

click node_serverui "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Server.UI"
click node_hub "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Server.UI/Hubs"
click node_contacts "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Contacts"
click node_products "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Products"
click node_documents "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Documents"
click node_audit "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/AuditTrails"
click node_picklists "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/PicklistSets"
click node_tenants "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Tenants"
click node_logs "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/SystemLogs"
click node_pipeline "https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Pipeline"
click node_contactquery "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs"
click node_contactexport "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs"
click node_dbcontract "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IApplicationDbContextFactory.cs"
click node_contactentity "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Domain/Entities/Contact.cs"
click node_userentity "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Domain/Identity/ApplicationUser.cs"
click node_db "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Persistence/ApplicationDbContext.cs"
click node_excel "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/ExcelService.cs"
click node_permissionquery "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/Identity/PermissionQueryService.cs"
click node_ocrworker "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/OpenAI/DocumentOcrBackgroundService.cs"
click node_ocrqueue "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IDocumentOcrQueue.cs"
click node_ocrjob "https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IDocumentOcrJob.cs"

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_serverui,node_hub,node_user toneBlue
class node_contacts,node_products,node_documents,node_audit,node_picklists,node_tenants,node_logs,node_pipeline,node_contactquery,node_contactexport,node_dbcontract,node_ocrqueue,node_ocrjob toneAmber
class node_contactentity,node_userentity toneMint
class node_db,node_excel,node_ocrworker toneRose
class node_permissionquery toneIndigo
```

## Components

### Blazor UI

- [Blazor Server UI](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Server.UI): `src/Server.UI`
- [SignalR hubs](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Server.UI/Hubs): `src/Server.UI/Hubs`

### Application use cases

- [Contact use cases](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Contacts): `src/Application/Features/Contacts`
- [Product use cases](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Products): `src/Application/Features/Products`
- [Document use cases](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Documents): `src/Application/Features/Documents`
- [Audit trail queries](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/AuditTrails): `src/Application/Features/AuditTrails`
- [Picklist management](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/PicklistSets): `src/Application/Features/PicklistSets`
- [Tenant management](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/Tenants): `src/Application/Features/Tenants`
- [System log queries](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Features/SystemLogs): `src/Application/Features/SystemLogs`
- [Request pipeline](https://github.com/neozhu/cleanarchitecturewithblazorserver/tree/main/src/Application/Pipeline): `src/Application/Pipeline`
- [Contact pagination query](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs): `src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs`
- [Contact export query](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs): `src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs`
- [Database context contract](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IApplicationDbContextFactory.cs): `src/Application/Common/Interfaces/IApplicationDbContextFactory.cs`
- [OCR queue contract](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IDocumentOcrQueue.cs): `src/Application/Common/Interfaces/IDocumentOcrQueue.cs`
- [OCR job contract](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Application/Common/Interfaces/IDocumentOcrJob.cs): `src/Application/Common/Interfaces/IDocumentOcrJob.cs`

### Domain model

- [Contact entity](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Domain/Entities/Contact.cs): `src/Domain/Entities/Contact.cs`
- [Application user entity](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Domain/Identity/ApplicationUser.cs): `src/Domain/Identity/ApplicationUser.cs`

### Infrastructure adapters

- [Application database](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Persistence/ApplicationDbContext.cs): `src/Infrastructure/Persistence/ApplicationDbContext.cs`
- [Excel service](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/ExcelService.cs): `src/Infrastructure/Services/ExcelService.cs`
- [Document OCR worker](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/OpenAI/DocumentOcrBackgroundService.cs): `src/Infrastructure/Services/OpenAI/DocumentOcrBackgroundService.cs`

### Identity and realtime

- [Permission queries](https://github.com/neozhu/cleanarchitecturewithblazorserver/blob/main/src/Infrastructure/Services/Identity/PermissionQueryService.cs): `src/Infrastructure/Services/Identity/PermissionQueryService.cs`

### Other components

- **Application user**

## Connections

- Application user → Blazor Server UI: uses
- Blazor Server UI → Contact use cases: invokes use cases
- Blazor Server UI → Product use cases: invokes use cases
- Blazor Server UI → Document use cases: invokes use cases
- Blazor Server UI → Tenant management: invokes use cases
- Blazor Server UI → Request pipeline: dispatches requests
- Contact pagination query → Database context contract: creates context (evidence: `src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs`)
- Contact pagination query → Contact entity: queries (evidence: `src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs`)
- Contact export query → Database context contract: creates context (evidence: `src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs`)
- Contact export query → Excel service: exports rows (evidence: `src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs`)
- Contact use cases → Contact pagination query: includes query (evidence: `src/Application/Features/Contacts/Queries/Pagination/ContactsPaginationQuery.cs`)
- Contact use cases → Contact export query: includes export (evidence: `src/Application/Features/Contacts/Queries/Export/ExportContactsQuery.cs`)
- Database context contract → Application database: implemented by
- Excel service → Blazor Server UI: returns file data
- Permission queries → Application user entity: loads user claims (evidence: `src/Infrastructure/Services/Identity/PermissionQueryService.cs`)
- Document OCR worker → OCR queue contract: dequeues requests (evidence: `src/Infrastructure/Services/OpenAI/DocumentOcrBackgroundService.cs`)
- Document OCR worker → OCR job contract: runs recognition (evidence: `src/Infrastructure/Services/OpenAI/DocumentOcrBackgroundService.cs`)
- Blazor Server UI → SignalR hubs: uses realtime updates (evidence: `src/Server.UI/Hubs/HubClient.cs`)
- Audit trail queries → Database context contract: reads through (evidence: `src/Application/Features/AuditTrails/Queries/Export/ExportAuditTrailsQuery.cs`)
- Picklist management → Database context contract: reads through (evidence: `src/Application/Features/PicklistSets/Queries/Export/ExportPicklistSetsQuery.cs`)
- System log queries → Database context contract: reads through (evidence: `src/Application/Features/SystemLogs/Queries/Export/ExportSystemLogsQuery.cs`)
