How aligadhi2/shsamp works
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: Program.cs API host · IStorageService.cs File storage · admin/src Admin console · dashboard/src Tenant dashboard
Components 20
User surfaces
- Admin console
clients/admin/src - Tenant dashboard
clients/dashboard/src
API and access
- API host
src/Host/FSHSAMP.Api/Program.cs - Identity
src/Modules/Identity/Modules.Identity - Tenant management
src/Modules/Multitenancy/Modules.Multitenancy
Tenant capabilities
Shared services
- Building blocks
src/BuildingBlocks - Audit records
src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs - File storage
src/BuildingBlocks/Storage/Services/IStorageService.cs
Operations and events
- Auditing
src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs - Notifications
src/Modules/Notifications - Webhooks
src/Modules/Webhooks
Other components
- Operator
- Tenant user
- S3-compatible storage
- PostgreSQL
Connections 21
- 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
src/Host/FSHSAMP.Api/Program.cs - API host → Tenant management: hosts modules
src/Host/FSHSAMP.Api/Program.cs - API host → Catalog: hosts modules
src/Host/FSHSAMP.Api/Program.cs - API host → Billing: hosts modules
src/Host/FSHSAMP.Api/Program.cs - Identity → Tenant management: tenant access
- API host → Chat: hosts modules
- API host → Tickets: hosts modules
src/Host/FSHSAMP.Api/Program.cs - API host → Files: hosts modules
src/Host/FSHSAMP.Api/Program.cs - API host → Auditing: hosts modules
- API host → Notifications: hosts modules
src/Host/FSHSAMP.Api/Program.cs - API host → Webhooks: hosts modules
src/Host/FSHSAMP.Api/Program.cs - Chat → File storage: resolves attachments
src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs - Files → File storage: stores files
src/BuildingBlocks/Storage/Services/IStorageService.cs - File storage → S3-compatible storage: presigns access
- Auditing → Audit records: queries records
src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs - Audit records → PostgreSQL: persists records
src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs - Building blocks → API host: supports runtime
src/Host/FSHSAMP.Api/Program.cs