# aligadhi2/shsamp architecture

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

- Interactive diagram: https://gitdiagram.com/aligadhi2/shsamp
- Repository: https://github.com/aligadhi2/shsamp

## Overview

FSHSAMP is a modular .NET monolith with an operator console and a tenant-facing React dashboard. The main user journey is through either client to the API, where identity and tenant context govern domain operations such as catalog, tickets, chat, and files; supporting capabilities include billing, notifications, auditing, and webhooks. The README documents the product surfaces and bounded contexts, while sampled handlers show concrete audit and chat query behavior and storage implementations. Most module internals and API routing were not sampled, so those links are documented at subsystem level.

Main entry points: [`src/Host/FSHSAMP.Api/Program.cs`](https://github.com/aligadhi2/shsamp/blob/main/src/Host/FSHSAMP.Api/Program.cs) (API host), [`src/BuildingBlocks/Storage/Services/IStorageService.cs`](https://github.com/aligadhi2/shsamp/blob/main/src/BuildingBlocks/Storage/Services/IStorageService.cs) (File storage), [`clients/admin/src`](https://github.com/aligadhi2/shsamp/tree/main/clients/admin/src) (Admin console), [`clients/dashboard/src`](https://github.com/aligadhi2/shsamp/tree/main/clients/dashboard/src) (Tenant dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["User surfaces"]
  node_admin_app["Admin console"]
  node_dashboard_app["Tenant dashboard"]
end

subgraph group_backend["API and access"]
  node_api_host["API host<br/>[Program.cs]"]
  node_identity["Identity<br/>[Modules.Identity]"]
  node_multitenancy["Tenant management"]
end

subgraph group_domains["Tenant capabilities"]
  node_catalog["Catalog"]
  node_tickets["Tickets"]
  node_chat["Chat"]
  node_files["Files"]
  node_billing["Billing"]
end

subgraph group_platform["Shared services"]
  node_shared["Building blocks"]
  node_audit_store[("Audit records<br/>[AuditDbContext.cs]")]
  node_storage_service["File storage<br/>[IStorageService.cs]"]
end

subgraph group_operations["Operations and events"]
  node_auditing["Auditing"]
  node_notifications["Notifications"]
  node_webhooks["Webhooks"]
end

node_operator(("Operator"))
node_tenant_user(("Tenant user"))
node_s3[("S3-compatible storage")]
node_postgres[("PostgreSQL")]

node_operator -->|"uses"| node_admin_app
node_tenant_user -->|"uses"| node_dashboard_app
node_admin_app -->|"calls API"| node_api_host
node_dashboard_app -->|"calls API"| node_api_host
node_api_host -->|"hosts modules"| node_identity
node_api_host -->|"hosts modules"| node_multitenancy
node_api_host -->|"hosts modules"| node_catalog
node_api_host -->|"hosts modules"| node_billing
node_identity -.->|"tenant access"| node_multitenancy
node_api_host -->|"hosts modules"| node_chat
node_api_host -->|"hosts modules"| node_tickets
node_api_host -->|"hosts modules"| node_files
node_api_host -->|"hosts modules"| node_auditing
node_api_host -->|"hosts modules"| node_notifications
node_api_host -->|"hosts modules"| node_webhooks
node_chat -->|"resolves attachments"| node_storage_service
node_files -->|"stores files"| node_storage_service
node_storage_service -.->|"presigns access"| node_s3
node_auditing -->|"queries records"| node_audit_store
node_audit_store -->|"persists records"| node_postgres
node_shared -.->|"supports runtime"| node_api_host

click node_admin_app "https://github.com/aligadhi2/shsamp/tree/main/clients/admin/src"
click node_dashboard_app "https://github.com/aligadhi2/shsamp/tree/main/clients/dashboard/src"
click node_api_host "https://github.com/aligadhi2/shsamp/blob/main/src/Host/FSHSAMP.Api/Program.cs"
click node_identity "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Identity/Modules.Identity"
click node_multitenancy "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Multitenancy/Modules.Multitenancy"
click node_catalog "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Catalog"
click node_tickets "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Tickets"
click node_chat "https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs"
click node_files "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Files"
click node_billing "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Billing"
click node_auditing "https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs"
click node_notifications "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Notifications"
click node_webhooks "https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Webhooks"
click node_shared "https://github.com/aligadhi2/shsamp/tree/main/src/BuildingBlocks"
click node_audit_store "https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs"
click node_storage_service "https://github.com/aligadhi2/shsamp/blob/main/src/BuildingBlocks/Storage/Services/IStorageService.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_admin_app,node_dashboard_app,node_tenant_user toneBlue
class node_api_host,node_identity,node_multitenancy,node_s3,node_postgres toneAmber
class node_catalog,node_tickets,node_chat,node_files,node_billing toneMint
class node_shared,node_audit_store,node_storage_service toneRose
class node_auditing,node_notifications,node_webhooks,node_operator toneIndigo
```

## Components

### User surfaces

- [Admin console](https://github.com/aligadhi2/shsamp/tree/main/clients/admin/src): `clients/admin/src`
- [Tenant dashboard](https://github.com/aligadhi2/shsamp/tree/main/clients/dashboard/src): `clients/dashboard/src`

### API and access

- [API host](https://github.com/aligadhi2/shsamp/blob/main/src/Host/FSHSAMP.Api/Program.cs): `src/Host/FSHSAMP.Api/Program.cs`
- [Identity](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Identity/Modules.Identity): `src/Modules/Identity/Modules.Identity`
- [Tenant management](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Multitenancy/Modules.Multitenancy): `src/Modules/Multitenancy/Modules.Multitenancy`

### Tenant capabilities

- [Catalog](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Catalog): `src/Modules/Catalog`
- [Tickets](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Tickets): `src/Modules/Tickets`
- [Chat](https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs): `src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs`
- [Files](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Files): `src/Modules/Files`
- [Billing](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Billing): `src/Modules/Billing`

### Shared services

- [Building blocks](https://github.com/aligadhi2/shsamp/tree/main/src/BuildingBlocks): `src/BuildingBlocks`
- [Audit records](https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs): `src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs`
- [File storage](https://github.com/aligadhi2/shsamp/blob/main/src/BuildingBlocks/Storage/Services/IStorageService.cs): `src/BuildingBlocks/Storage/Services/IStorageService.cs`

### Operations and events

- [Auditing](https://github.com/aligadhi2/shsamp/blob/main/src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs): `src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs`
- [Notifications](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Notifications): `src/Modules/Notifications`
- [Webhooks](https://github.com/aligadhi2/shsamp/tree/main/src/Modules/Webhooks): `src/Modules/Webhooks`

### Other components

- **Operator**
- **Tenant user**
- **S3-compatible storage**
- **PostgreSQL**

## Connections

- Operator → Admin console: uses
- Tenant user → Tenant dashboard: uses
- Admin console → API host: calls API
- Tenant dashboard → API host: calls API
- API host → Identity: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Tenant management: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Catalog: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Billing: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- Identity → Tenant management: tenant access
- API host → Chat: hosts modules
- API host → Tickets: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Files: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Auditing: hosts modules
- API host → Notifications: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- API host → Webhooks: hosts modules (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
- Chat → File storage: resolves attachments (evidence: `src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs`)
- Files → File storage: stores files (evidence: `src/BuildingBlocks/Storage/Services/IStorageService.cs`)
- File storage → S3-compatible storage: presigns access
- Auditing → Audit records: queries records (evidence: `src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs`)
- Audit records → PostgreSQL: persists records (evidence: `src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs`)
- Building blocks → API host: supports runtime (evidence: `src/Host/FSHSAMP.Api/Program.cs`)
