How dracula-5/ai-ticketing-system works
AI Ticketing System combines tenant-scoped support ticketing and AI triage with SLA monitoring, negotiation, and a vendor marketplace. Users enter through the React application to create and manage tickets or browse products; the FastAPI backend handles requests, persists domain state, and supports real-time notifications and negotiation. The README also documents authentication, analytics, and marketplace workflows. Several routes and frontend pages are unsampled, so their connections are shown only where supported by the README or source index.
Main entry points: main.py FastAPI app · database.py SQL database · ticket.py Ticket routes · App.js React routes
Components 23
Web application
- React routes
ai-ticketing-system/frontend/src/App.js - Ticket screens
ai-ticketing-system/frontend/src/pages - Marketplace screens
ai-ticketing-system/frontend/src/pages - API client
ai-ticketing-system/frontend/src/api/axios.js - Auth session
ai-ticketing-system/frontend/src/utils/authSession.js
Ticket operations
- Ticket routes
ai-ticketing-system/backend/app/routers/ticket.py - AI classification
ai-ticketing-system/backend/app/ai/priority.py - Team routing
ai-ticketing-system/backend/app/services/auto_router.py - SLA monitoring
ai-ticketing-system/backend/app/services/sla_monitor.py - Ticket bargaining
ai-ticketing-system/backend/app/routers/ticket.py
Marketplace
- Marketplace routes
ai-ticketing-system/backend/app/routers/products.py - Vendor management
ai-ticketing-system/backend/app/routers/vendors.py - Orders
ai-ticketing-system/backend/app/routers/orders.py - Live negotiation
ai-ticketing-system/backend/app/routers/negotiations.py
API and platform
- FastAPI app
ai-ticketing-system/backend/app/main.py - Authentication
ai-ticketing-system/backend/app/routers/auth.py - JWT and tenancy
ai-ticketing-system/backend/app/core/security.py - Notification service
ai-ticketing-system/backend/app/services/notification_service.py - Notification WebSocket
ai-ticketing-system/backend/app/services/notification_ws.py - Live metrics
ai-ticketing-system/backend/app/main.py - Domain models
ai-ticketing-system/backend/app/db/models.py - SQL database
ai-ticketing-system/backend/app/db/database.py
Other components
- Customers, staff
Connections 29
- Customers, staff → React routes: uses
- React routes → Ticket screens: routes to
ai-ticketing-system/frontend/src/App.js - React routes → Marketplace screens: routes to
ai-ticketing-system/frontend/src/App.js - Ticket screens → API client: calls API
ai-ticketing-system/frontend/src/pages/TicketDetails.js - Marketplace screens → API client: calls API
ai-ticketing-system/frontend/src/pages/TicketDetails.js - API client → FastAPI app: REST requests
- React routes → Auth session: stores session
- FastAPI app → Authentication: mounts routes
ai-ticketing-system/backend/app/main.py - FastAPI app → Ticket routes: mounts routes
ai-ticketing-system/backend/app/main.py - FastAPI app → Marketplace routes: mounts routes
ai-ticketing-system/backend/app/main.py - FastAPI app → Vendor management: mounts routes
ai-ticketing-system/backend/app/main.py - FastAPI app → Orders: mounts routes
ai-ticketing-system/backend/app/main.py - FastAPI app → Live negotiation: mounts routes
ai-ticketing-system/backend/app/main.py - Customers, staff → Authentication: registers or logs in
- Authentication → JWT and tenancy: creates tokens
ai-ticketing-system/backend/app/routers/auth.py - Ticket routes → AI classification: classifies tickets
ai-ticketing-system/backend/app/routers/ticket.py - Ticket routes → Team routing: routes tickets
ai-ticketing-system/backend/app/routers/ticket.py - FastAPI app → SLA monitoring: starts monitor
ai-ticketing-system/backend/app/main.py - Ticket routes → Ticket bargaining: handles bargaining
ai-ticketing-system/backend/app/routers/ticket.py - Live negotiation → Notification service: triggers alerts
ai-ticketing-system/backend/app/routers/negotiations.py - Notification service → Notification WebSocket: broadcasts
ai-ticketing-system/backend/app/services/notification_service.py - FastAPI app → Live metrics: serves metrics
ai-ticketing-system/backend/app/main.py - Authentication → SQL database: queries users
ai-ticketing-system/backend/app/routers/auth.py - Ticket routes → SQL database: reads and writes
ai-ticketing-system/backend/app/routers/ticket.py - Marketplace routes → SQL database: persists listings
- Orders → SQL database: persists orders
ai-ticketing-system/backend/app/routers/orders.py - Live negotiation → SQL database: persists sessions
ai-ticketing-system/backend/app/routers/negotiations.py - Notification service → Domain models: creates notifications
ai-ticketing-system/backend/app/services/notification_service.py - SQL database → Domain models: maps entities
ai-ticketing-system/backend/app/db/database.py