# aliahsan9/businessos architecture

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

- Interactive diagram: https://gitdiagram.com/aliahsan9/businessos
- Repository: https://github.com/aliahsan9/businessos

## Overview

BusinessOS is a multi-tenant business management API spanning workspace administration, CRM, sales and procurement, inventory, finance, reporting, and AI assistance. The documented main request path is client → API endpoints → MediatR/CQRS → application and domain logic → persistence. Its major branches include permission-based authorization, SignalR notifications, AI agent planning and RAG, and tenant-aware data access. The README documents these broad relationships; sampled source confirms tenant-aware persistence and cache-backed query behavior. Several feature implementations were not sampled, so their internal calls are not inferred.

Main entry points: [`BusinessOS.Application/DependencyInjection.cs`](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/DependencyInjection.cs) (MediatR CQRS), [`BusinessOS.API/Program.cs`](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Program.cs) (Web API), [`BusinessOS.API/Endpoints`](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.API/Endpoints) (Endpoint modules), [`BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs`](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs) (EF Core context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_api["Web API<br/>[Program.cs]"]
  node_endpoints["Endpoint modules<br/>[Endpoints]"]
  node_auth["Authentication<br/>[AuthEndpoints.cs]"]
  node_rbac["Permission policies"]
end

subgraph group_business["Business workflows"]
  node_cqrs["MediatR CQRS"]
  node_crm["CRM and customers<br/>[Customers]"]
  node_sales["Orders and invoices<br/>[Orders]"]
  node_procurement["Procurement<br/>[PurchaseOrders]"]
  node_inventory["Inventory control<br/>[Inventory]"]
  node_finance["Finance and billing<br/>[Finance]"]
end

subgraph group_insight["Insights and AI"]
  node_analytics["Analytics and reports"]
  node_ai["AI agent and copilot"]
  node_rag["RAG retrieval"]
end

subgraph group_platform["Platform services"]
  node_realtime["Realtime notifications"]
  node_tenant["Tenant context<br/>[ITenantProvider.cs]"]
  node_cache["Query cache<br/>[ICacheService.cs]"]
end

subgraph group_data["Tenant data"]
  node_dbcontext["EF Core context"]
  node_vectorsync["Vector outbox sync"]
end

node_client(("Web/mobile clients"))
node_openai["OpenAI API"]
node_qdrant[("Qdrant vector store")]
node_signalr(("SignalR clients"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_api
node_api -->|"routes requests"| node_endpoints
node_endpoints -->|"dispatches commands"| node_cqrs
node_cqrs -->|"handles requests"| node_crm
node_cqrs -->|"handles requests"| node_sales
node_cqrs -->|"handles requests"| node_procurement
node_cqrs -->|"handles requests"| node_inventory
node_cqrs -->|"handles requests"| node_finance
node_cqrs -->|"handles queries"| node_analytics
node_endpoints -->|"includes auth routes"| node_auth
node_api -->|"authorizes requests"| node_rbac
node_ai -->|"calls model"| node_openai
node_ai -->|"uses retrieval"| node_rag
node_rag -->|"searches vectors"| node_qdrant
node_api -->|"serves SignalR"| node_realtime
node_realtime -->|"pushes updates"| node_signalr
node_api -->|"resolves tenant"| node_tenant
node_tenant -->|"scopes data"| node_dbcontext
node_dbcontext -->|"persists entities"| node_postgres
node_vectorsync -->|"syncs vectors"| node_qdrant
node_cqrs -->|"caches query results"| node_cache
node_inventory -.->|"reads tenant data"| node_dbcontext

click node_api "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Program.cs"
click node_endpoints "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.API/Endpoints"
click node_auth "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Endpoints/AuthEndpoints.cs"
click node_rbac "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Authorization/PermissionAuthorizationHandler.cs"
click node_cqrs "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/DependencyInjection.cs"
click node_crm "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Customers"
click node_sales "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Orders"
click node_procurement "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/PurchaseOrders"
click node_inventory "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Inventory"
click node_finance "https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Finance"
click node_analytics "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Features/Dashboard/Services/ReportingService.cs"
click node_ai "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/AI/Agents/AgentEmployeeService.cs"
click node_rag "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/AI/Copilot/AiVectorRagService.cs"
click node_realtime "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Services/SignalRRealtimeNotificationService.cs"
click node_tenant "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Common/Interfaces/ITenantProvider.cs"
click node_cache "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Common/Caching/ICacheService.cs"
click node_dbcontext "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs"
click node_vectorsync "https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/VectorSearch/VectorSyncBackgroundService.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_api,node_endpoints,node_auth,node_rbac,node_client,node_signalr toneBlue
class node_cqrs,node_crm,node_sales,node_procurement,node_inventory,node_finance,node_qdrant,node_postgres toneAmber
class node_analytics,node_ai,node_rag,node_openai toneMint
class node_realtime,node_tenant,node_cache toneRose
class node_dbcontext,node_vectorsync toneIndigo
```

## Components

### API and access

- [Web API](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Program.cs): `BusinessOS.API/Program.cs`
- [Endpoint modules](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.API/Endpoints): `BusinessOS.API/Endpoints`
- [Authentication](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Endpoints/AuthEndpoints.cs): `BusinessOS.API/Endpoints/AuthEndpoints.cs`
- [Permission policies](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Authorization/PermissionAuthorizationHandler.cs): `BusinessOS.API/Authorization/PermissionAuthorizationHandler.cs`

### Business workflows

- [MediatR CQRS](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/DependencyInjection.cs): `BusinessOS.Application/DependencyInjection.cs`
- [CRM and customers](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Customers): `BusinessOS.Application/Features/Customers`
- [Orders and invoices](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Orders): `BusinessOS.Application/Features/Orders`
- [Procurement](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/PurchaseOrders): `BusinessOS.Application/Features/PurchaseOrders`
- [Inventory control](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Inventory): `BusinessOS.Application/Features/Inventory`
- [Finance and billing](https://github.com/aliahsan9/businessos/tree/master/BusinessOS.Application/Features/Finance): `BusinessOS.Application/Features/Finance`

### Insights and AI

- [Analytics and reports](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Features/Dashboard/Services/ReportingService.cs): `BusinessOS.Application/Features/Dashboard/Services/ReportingService.cs`
- [AI agent and copilot](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/AI/Agents/AgentEmployeeService.cs): `BusinessOS.Infrastructure/AI/Agents/AgentEmployeeService.cs`
- [RAG retrieval](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/AI/Copilot/AiVectorRagService.cs): `BusinessOS.Infrastructure/AI/Copilot/AiVectorRagService.cs`

### Platform services

- [Realtime notifications](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.API/Services/SignalRRealtimeNotificationService.cs): `BusinessOS.API/Services/SignalRRealtimeNotificationService.cs`
- [Tenant context](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Common/Interfaces/ITenantProvider.cs): `BusinessOS.Application/Common/Interfaces/ITenantProvider.cs`
- [Query cache](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Application/Common/Caching/ICacheService.cs): `BusinessOS.Application/Common/Caching/ICacheService.cs`

### Tenant data

- [EF Core context](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs): `BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs`
- [Vector outbox sync](https://github.com/aliahsan9/businessos/blob/master/BusinessOS.Infrastructure/VectorSearch/VectorSyncBackgroundService.cs): `BusinessOS.Infrastructure/VectorSearch/VectorSyncBackgroundService.cs`

### Other components

- **Web/mobile clients**
- **OpenAI API**
- **Qdrant vector store**
- **SignalR clients**
- **PostgreSQL**

## Connections

- Web/mobile clients → Web API: sends requests (evidence: `README.md`)
- Web API → Endpoint modules: routes requests (evidence: `README.md`)
- Endpoint modules → MediatR CQRS: dispatches commands (evidence: `README.md`)
- MediatR CQRS → CRM and customers: handles requests (evidence: `README.md`)
- MediatR CQRS → Orders and invoices: handles requests (evidence: `README.md`)
- MediatR CQRS → Procurement: handles requests (evidence: `README.md`)
- MediatR CQRS → Inventory control: handles requests (evidence: `README.md`)
- MediatR CQRS → Finance and billing: handles requests (evidence: `README.md`)
- MediatR CQRS → Analytics and reports: handles queries (evidence: `README.md`)
- Endpoint modules → Authentication: includes auth routes (evidence: `README.md`)
- Web API → Permission policies: authorizes requests (evidence: `README.md`)
- AI agent and copilot → OpenAI API: calls model (evidence: `README.md`)
- AI agent and copilot → RAG retrieval: uses retrieval (evidence: `README.md`)
- RAG retrieval → Qdrant vector store: searches vectors (evidence: `README.md`)
- Web API → Realtime notifications: serves SignalR (evidence: `README.md`)
- Realtime notifications → SignalR clients: pushes updates (evidence: `README.md`)
- Web API → Tenant context: resolves tenant (evidence: `README.md`)
- Tenant context → EF Core context: scopes data (evidence: `BusinessOS.Infrastructure/Data/BusinessOSDbContext.cs`)
- EF Core context → PostgreSQL: persists entities (evidence: `README.md`)
- Vector outbox sync → Qdrant vector store: syncs vectors (evidence: `README.md`)
- MediatR CQRS → Query cache: caches query results
- Inventory control → EF Core context: reads tenant data
