How snikitha-v/ticketing_system works
Ticketing Service is a full-stack support-ticket platform. Users and staff authenticate, create and manage tickets through a role-aware web app; agents handle assignment and lifecycle changes, while users can add comments and attachments and rate resolved work. Administrators manage accounts and search tickets. The backend separates REST controllers, services, persistence, and JWT security. The README documents the frontend/API and database architecture; unexcerpted service implementations and frontend API wiring limit verified cross-layer detail, so uncertain links are dashed.
Main entry points: api.ts API client · TicketController.java Ticket endpoints · TicketRepository.java Ticket repository · UserRepository.java User repository
Components 23
Web application
- Role-aware pages
frontend/src/app/dashboard/page.tsx - Ticket detail
frontend/src/app/tickets/[id]/page.tsx - Admin console
frontend/src/app/admin/page.tsx - Login and registration
frontend/src/app/login/page.tsx - API client
frontend/src/lib/api.ts
REST API
- Ticket endpoints
backend/src/main/java/com/ticketing/controller/TicketController.java - Comment endpoints
backend/src/main/java/com/ticketing/controller/CommentController.java - Admin endpoints
backend/src/main/java/com/ticketing/controller/AdminController.java - Auth endpoints
backend/src/main/java/com/ticketing/controller/AuthController.java
Identity and access
- Authentication service
backend/src/main/java/com/ticketing/service/AuthService.java - JWT issuance
backend/src/main/java/com/ticketing/security/JwtService.java - User lookup
backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java
Ticket workflows
- Ticket operations
backend/src/main/java/com/ticketing/service/TicketService.java - Comment operations
backend/src/main/java/com/ticketing/service/CommentService.java - Attachment operations
backend/src/main/java/com/ticketing/service/AttachmentService.java - Rating operations
backend/src/main/java/com/ticketing/service/TicketRatingService.java - User administration
backend/src/main/java/com/ticketing/service/AdminService.java
Persistence
- Ticket and lifecycle
backend/src/main/java/com/ticketing/model/Ticket.java - User and roles
backend/src/main/java/com/ticketing/model/User.java - Ticket repository
backend/src/main/java/com/ticketing/repository/TicketRepository.java - User repository
backend/src/main/java/com/ticketing/repository/UserRepository.java
Other components
- Users and staff
- PostgreSQL
Connections 24
- Users and staff → Role-aware pages: uses
- Users and staff → Login and registration: signs in
- Role-aware pages → API client: requests data
- Ticket detail → API client: requests data
- Admin console → API client: requests data
- Login and registration → API client: requests auth
- API client → Ticket endpoints: calls API
- API client → Admin endpoints: calls API
- API client → Auth endpoints: calls API
- Ticket endpoints → Ticket operations: delegates
backend/src/main/java/com/ticketing/controller/TicketController.java - Ticket endpoints → Attachment operations: delegates
backend/src/main/java/com/ticketing/controller/TicketController.java - Ticket endpoints → Rating operations: delegates
backend/src/main/java/com/ticketing/controller/TicketController.java - Comment endpoints → Comment operations: delegates
backend/src/main/java/com/ticketing/controller/CommentController.java - Admin endpoints → User administration: delegates
backend/src/main/java/com/ticketing/controller/AdminController.java - Auth endpoints → Authentication service: delegates
- Authentication service → JWT issuance: issues token
backend/src/main/java/com/ticketing/service/impl/AuthServiceImpl.java - Authentication service → User repository: reads and saves
backend/src/main/java/com/ticketing/service/impl/AuthServiceImpl.java - User lookup → User repository: loads users
backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java - Ticket repository → Ticket and lifecycle: persists
backend/src/main/java/com/ticketing/repository/TicketRepository.java - User repository → User and roles: persists
backend/src/main/java/com/ticketing/repository/UserRepository.java - Ticket operations → Ticket repository: uses
- User administration → Ticket repository: searches tickets
- PostgreSQL → Ticket repository: stores records
- PostgreSQL → User repository: stores records