# finnalbrecht/bma-ai-ticket-system architecture

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

- Interactive diagram: https://gitdiagram.com/finnalbrecht/bma-ai-ticket-system
- Repository: https://github.com/finnalbrecht/bma-ai-ticket-system

## Overview

This is a React/.NET IT-ticket system: users register or sign in, submit tickets, and can view, classify, resolve, or reuse solutions for them; ticket creators also have AI chat on resolved tickets. The backend exposes ticket, auth, and dashboard APIs, with persisted users, tickets, classifications, and chat. Classification can use keyword or external AI providers. The sampled code confirms several controller-to-handler and handler-to-repository calls; some frontend, dashboard, chat, and provider wiring is documented or represented only by unsampled paths, so uncertain links are omitted or dashed.

Main entry points: [`backend/src/TicketSystem.Api/Controllers/TicketsController.cs`](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/TicketsController.cs) (Ticket API), [`backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs`](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs) (Ticket repository), [`backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs`](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs) (Classification workflow), [`frontend/src/api.ts`](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/frontend/src/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_app["Ticket interface<br/>[App.tsx]"]
  node_frontend_api["API client<br/>[api.ts]"]
end

subgraph group_api["API and identity"]
  node_auth_api["Auth API<br/>[AuthController.cs]"]
  node_tickets_api["Ticket API"]
  node_dashboard_api["Dashboard API"]
end

subgraph group_workflow["Ticket workflows"]
  node_ticket_ops["Ticket operations<br/>[Commands]"]
  node_ticket_queries["Ticket queries<br/>[Queries]"]
  node_similarity["Similar solutions"]
  node_classification["Classification workflow"]
  node_history["Classification history"]
  node_metrics["Dashboard metrics"]
  node_chat["Ticket chat"]
end

subgraph group_domain["Domain and persistence"]
  node_ticket_domain["Ticket model<br/>[Ticket.cs]"]
  node_classification_domain["Classification model"]
  node_ticket_store["Ticket repository"]
  node_classification_store["Classification repository"]
  node_chat_store["Chat repository"]
  node_database[("Ticket database<br/>[TicketDbContext.cs]")]
  node_auth_store["User records<br/>[UserRecord.cs]"]
end

subgraph group_ai["AI and integrations"]
  node_provider_resolver["Provider resolver"]
  node_classification_providers["Classification providers<br/>[Clients]"]
  node_chat_ai["OpenRouter chat"]
  node_ai_services(("AI services"))
end

node_user(("Team member"))

node_user -->|"uses"| node_app
node_app -->|"requests data"| node_frontend_api
node_frontend_api -.->|"calls API"| node_tickets_api
node_frontend_api -.->|"authenticates"| node_auth_api
node_frontend_api -.->|"loads dashboard"| node_dashboard_api
node_tickets_api -->|"dispatches"| node_ticket_ops
node_tickets_api -->|"dispatches"| node_ticket_queries
node_tickets_api -->|"dispatches"| node_classification
node_tickets_api -->|"dispatches"| node_history
node_tickets_api -->|"dispatches"| node_similarity
node_tickets_api -->|"calls"| node_chat
node_dashboard_api -.->|"dispatches"| node_metrics
node_auth_api -->|"uses"| node_database
node_auth_api -->|"reads and writes"| node_auth_store
node_classification -->|"loads and updates"| node_ticket_store
node_classification -.->|"resolves provider"| node_provider_resolver
node_classification -->|"records result"| node_classification_store
node_classification -->|"changes state"| node_ticket_domain
node_provider_resolver -.->|"selects"| node_classification_providers
node_classification_providers -.->|"requests classification"| node_ai_services
node_history -->|"checks ticket"| node_ticket_store
node_history -->|"reads history"| node_classification_store
node_metrics -->|"reads tickets"| node_ticket_store
node_metrics -->|"reads classifications"| node_classification_store
node_similarity -->|"loads and updates"| node_ticket_store
node_similarity -->|"suggests solution"| node_ticket_domain
node_ticket_queries -->|"reads tickets"| node_ticket_store
node_ticket_ops -.->|"persists tickets"| node_ticket_store
node_chat -.->|"persists messages"| node_chat_store
node_chat -.->|"requests responses"| node_chat_ai
node_chat_ai -.->|"sends prompts"| node_ai_services
node_ticket_store -.->|"stores tickets"| node_database
node_classification_store -.->|"stores results"| node_database
node_chat_store -->|"stores messages"| node_database

click node_app "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/frontend/src/App.tsx"
click node_frontend_api "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/frontend/src/api.ts"
click node_auth_api "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/AuthController.cs"
click node_tickets_api "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/TicketsController.cs"
click node_dashboard_api "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/DashboardController.cs"
click node_ticket_ops "https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Application/Tickets/Commands"
click node_ticket_queries "https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Application/Tickets/Queries"
click node_similarity "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs"
click node_classification "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs"
click node_history "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs"
click node_metrics "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs"
click node_chat "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/TicketChatService.cs"
click node_ticket_domain "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Domain/Tickets/Entities/Ticket.cs"
click node_classification_domain "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Domain/Classification/Entities/TicketClassification.cs"
click node_ticket_store "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs"
click node_classification_store "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketClassificationRepository.cs"
click node_chat_store "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs"
click node_database "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/TicketDbContext.cs"
click node_auth_store "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/UserRecord.cs"
click node_provider_resolver "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/ClassificationServiceResolver.cs"
click node_classification_providers "https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Infrastructure/Ai/Clients"
click node_chat_ai "https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/OpenRouterMessageClient.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_app,node_frontend_api toneBlue
class node_auth_api,node_tickets_api,node_dashboard_api toneAmber
class node_ticket_ops,node_ticket_queries,node_similarity,node_classification,node_history,node_metrics,node_chat toneMint
class node_ticket_domain,node_classification_domain,node_ticket_store,node_classification_store,node_chat_store,node_database,node_auth_store toneRose
class node_provider_resolver,node_classification_providers,node_chat_ai,node_ai_services,node_user toneIndigo
```

## Components

### User interface

- [Ticket interface](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/frontend/src/api.ts): `frontend/src/api.ts`

### API and identity

- [Auth API](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/AuthController.cs): `backend/src/TicketSystem.Api/Controllers/AuthController.cs`
- [Ticket API](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/TicketsController.cs): `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`
- [Dashboard API](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Api/Controllers/DashboardController.cs): `backend/src/TicketSystem.Api/Controllers/DashboardController.cs`

### Ticket workflows

- [Ticket operations](https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Application/Tickets/Commands): `backend/src/TicketSystem.Application/Tickets/Commands`
- [Ticket queries](https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Application/Tickets/Queries): `backend/src/TicketSystem.Application/Tickets/Queries`
- [Similar solutions](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs): `backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs`
- [Classification workflow](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs): `backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs`
- [Classification history](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs): `backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs`
- [Dashboard metrics](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs): `backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs`
- [Ticket chat](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/TicketChatService.cs): `backend/src/TicketSystem.Infrastructure/Ai/Clients/TicketChatService.cs`

### Domain and persistence

- [Ticket model](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Domain/Tickets/Entities/Ticket.cs): `backend/src/TicketSystem.Domain/Tickets/Entities/Ticket.cs`
- [Classification model](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Domain/Classification/Entities/TicketClassification.cs): `backend/src/TicketSystem.Domain/Classification/Entities/TicketClassification.cs`
- [Ticket repository](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs): `backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs`
- [Classification repository](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketClassificationRepository.cs): `backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketClassificationRepository.cs`
- [Chat repository](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs): `backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs`
- [Ticket database](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/TicketDbContext.cs): `backend/src/TicketSystem.Infrastructure/Persistence/TicketDbContext.cs`
- [User records](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Persistence/UserRecord.cs): `backend/src/TicketSystem.Infrastructure/Persistence/UserRecord.cs`

### AI and integrations

- [Provider resolver](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/ClassificationServiceResolver.cs): `backend/src/TicketSystem.Infrastructure/Ai/Clients/ClassificationServiceResolver.cs`
- [Classification providers](https://github.com/finnalbrecht/bma-ai-ticket-system/tree/main/backend/src/TicketSystem.Infrastructure/Ai/Clients): `backend/src/TicketSystem.Infrastructure/Ai/Clients`
- [OpenRouter chat](https://github.com/finnalbrecht/bma-ai-ticket-system/blob/main/backend/src/TicketSystem.Infrastructure/Ai/Clients/OpenRouterMessageClient.cs): `backend/src/TicketSystem.Infrastructure/Ai/Clients/OpenRouterMessageClient.cs`
- **AI services**

### Other components

- **Team member**

## Connections

- Team member → Ticket interface: uses
- Ticket interface → API client: requests data (evidence: `frontend/src/App.tsx`)
- API client → Ticket API: calls API
- API client → Auth API: authenticates
- API client → Dashboard API: loads dashboard
- Ticket API → Ticket operations: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Ticket API → Ticket queries: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Ticket API → Classification workflow: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Ticket API → Classification history: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Ticket API → Similar solutions: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Ticket API → Ticket chat: calls (evidence: `backend/src/TicketSystem.Api/Controllers/TicketsController.cs`)
- Dashboard API → Dashboard metrics: dispatches (evidence: `backend/src/TicketSystem.Api/Controllers/DashboardController.cs`)
- Auth API → Ticket database: uses (evidence: `backend/src/TicketSystem.Api/Controllers/AuthController.cs`)
- Auth API → User records: reads and writes (evidence: `backend/src/TicketSystem.Api/Controllers/AuthController.cs`)
- Classification workflow → Ticket repository: loads and updates (evidence: `backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs`)
- Classification workflow → Provider resolver: resolves provider
- Classification workflow → Classification repository: records result (evidence: `backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs`)
- Classification workflow → Ticket model: changes state (evidence: `backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs`)
- Provider resolver → Classification providers: selects
- Classification providers → AI services: requests classification
- Classification history → Ticket repository: checks ticket (evidence: `backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs`)
- Classification history → Classification repository: reads history (evidence: `backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs`)
- Dashboard metrics → Ticket repository: reads tickets (evidence: `backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs`)
- Dashboard metrics → Classification repository: reads classifications (evidence: `backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs`)
- Similar solutions → Ticket repository: loads and updates (evidence: `backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs`)
- Similar solutions → Ticket model: suggests solution (evidence: `backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs`)
- Ticket queries → Ticket repository: reads tickets (evidence: `backend/src/TicketSystem.Application/Tickets/Queries/GetAllTicketsQueryHandler.cs`)
- Ticket operations → Ticket repository: persists tickets
- Ticket chat → Chat repository: persists messages
- Ticket chat → OpenRouter chat: requests responses
- OpenRouter chat → AI services: sends prompts
- Ticket repository → Ticket database: stores tickets (evidence: `backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs`)
- Classification repository → Ticket database: stores results
- Chat repository → Ticket database: stores messages (evidence: `backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs`)
