How finnalbrecht/bma-ai-ticket-system works
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: TicketsController.cs Ticket API · SqliteTicketRepository.cs Ticket repository · ClassifyTicketCommandHandler.cs Classification workflow · api.ts API client
Components 24
User interface
- Ticket interface
frontend/src/App.tsx - API client
frontend/src/api.ts
API and identity
- Auth API
backend/src/TicketSystem.Api/Controllers/AuthController.cs - Ticket API
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Dashboard API
backend/src/TicketSystem.Api/Controllers/DashboardController.cs
Ticket workflows
- Ticket operations
backend/src/TicketSystem.Application/Tickets/Commands - Ticket queries
backend/src/TicketSystem.Application/Tickets/Queries - Similar solutions
backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs - Classification workflow
backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs - Classification history
backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs - Dashboard metrics
backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs - Ticket chat
backend/src/TicketSystem.Infrastructure/Ai/Clients/TicketChatService.cs
Domain and persistence
- Ticket model
backend/src/TicketSystem.Domain/Tickets/Entities/Ticket.cs - Classification model
backend/src/TicketSystem.Domain/Classification/Entities/TicketClassification.cs - Ticket repository
backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs - Classification repository
backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketClassificationRepository.cs - Chat repository
backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs - Ticket database
backend/src/TicketSystem.Infrastructure/Persistence/TicketDbContext.cs - User records
backend/src/TicketSystem.Infrastructure/Persistence/UserRecord.cs
AI and integrations
- Provider resolver
backend/src/TicketSystem.Infrastructure/Ai/Clients/ClassificationServiceResolver.cs - Classification providers
backend/src/TicketSystem.Infrastructure/Ai/Clients - OpenRouter chat
backend/src/TicketSystem.Infrastructure/Ai/Clients/OpenRouterMessageClient.cs - AI services
Other components
- Team member
Connections 34
- Team member → Ticket interface: uses
- Ticket interface → API client: requests data
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
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Ticket API → Ticket queries: dispatches
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Ticket API → Classification workflow: dispatches
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Ticket API → Classification history: dispatches
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Ticket API → Similar solutions: dispatches
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Ticket API → Ticket chat: calls
backend/src/TicketSystem.Api/Controllers/TicketsController.cs - Dashboard API → Dashboard metrics: dispatches
backend/src/TicketSystem.Api/Controllers/DashboardController.cs - Auth API → Ticket database: uses
backend/src/TicketSystem.Api/Controllers/AuthController.cs - Auth API → User records: reads and writes
backend/src/TicketSystem.Api/Controllers/AuthController.cs - Classification workflow → Ticket repository: loads and updates
backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs - Classification workflow → Provider resolver: resolves provider
- Classification workflow → Classification repository: records result
backend/src/TicketSystem.Application/Classification/Commands/ClassifyTicketCommandHandler.cs - Classification workflow → Ticket model: changes state
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
backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs - Classification history → Classification repository: reads history
backend/src/TicketSystem.Application/Classification/Queries/GetTicketClassificationHistoryQueryHandler.cs - Dashboard metrics → Ticket repository: reads tickets
backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs - Dashboard metrics → Classification repository: reads classifications
backend/src/TicketSystem.Application/Tickets/Queries/GetTicketDashboardMetricsQueryHandler.cs - Similar solutions → Ticket repository: loads and updates
backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs - Similar solutions → Ticket model: suggests solution
backend/src/TicketSystem.Application/Tickets/Commands/FindSimilarSolutionCommandHandler.cs - Ticket queries → Ticket repository: reads tickets
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
backend/src/TicketSystem.Infrastructure/Persistence/Repositories/SqliteTicketRepository.cs - Classification repository → Ticket database: stores results
- Chat repository → Ticket database: stores messages
backend/src/TicketSystem.Infrastructure/Persistence/Repositories/TicketChatMessageRepository.cs