# snikitha-v/ticketing_system architecture

> Architecture diagram of the GitHub repository snikitha-v/ticketing_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snikitha-v/ticketing_system
- Repository: https://github.com/snikitha-v/ticketing_system

## Overview

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: [`frontend/src/lib/api.ts`](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/lib/api.ts) (API client), [`backend/src/main/java/com/ticketing/controller/TicketController.java`](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/TicketController.java) (Ticket endpoints), [`backend/src/main/java/com/ticketing/repository/TicketRepository.java`](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/TicketRepository.java) (Ticket repository), [`backend/src/main/java/com/ticketing/repository/UserRepository.java`](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Role-aware pages<br/>[page.tsx]"]
  node_ticketdetail["Ticket detail<br/>[page.tsx]"]
  node_adminpage["Admin console<br/>[page.tsx]"]
  node_authpages["Login and registration<br/>[page.tsx]"]
  node_apiclient["API client<br/>[api.ts]"]
end

subgraph group_api["REST API"]
  node_ticketapi["Ticket endpoints"]
  node_commentapi["Comment endpoints"]
  node_adminapi["Admin endpoints"]
  node_authapi["Auth endpoints"]
end

subgraph group_identity["Identity and access"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT issuance<br/>[JwtService.java]"]
  node_userdetails["User lookup"]
end

subgraph group_ticketing["Ticket workflows"]
  node_ticketservice["Ticket operations<br/>[TicketService.java]"]
  node_commentservice["Comment operations"]
  node_attachments["Attachment operations"]
  node_ratings["Rating operations"]
  node_adminservice["User administration<br/>[AdminService.java]"]
end

subgraph group_state["Persistence"]
  node_ticketmodel["Ticket and lifecycle<br/>[Ticket.java]"]
  node_usermodel["User and roles<br/>[User.java]"]
  node_ticketrepo["Ticket repository"]
  node_userrepo["User repository"]
end

node_requester(("Users and staff"))
node_database[("PostgreSQL")]

node_requester -.->|"uses"| node_webapp
node_requester -.->|"signs in"| node_authpages
node_webapp -.->|"requests data"| node_apiclient
node_ticketdetail -.->|"requests data"| node_apiclient
node_adminpage -.->|"requests data"| node_apiclient
node_authpages -.->|"requests auth"| node_apiclient
node_apiclient -.->|"calls API"| node_ticketapi
node_apiclient -.->|"calls API"| node_adminapi
node_apiclient -.->|"calls API"| node_authapi
node_ticketapi -->|"delegates"| node_ticketservice
node_ticketapi -->|"delegates"| node_attachments
node_ticketapi -->|"delegates"| node_ratings
node_commentapi -->|"delegates"| node_commentservice
node_adminapi -->|"delegates"| node_adminservice
node_authapi -.->|"delegates"| node_authservice
node_authservice -->|"issues token"| node_jwt
node_authservice -->|"reads and saves"| node_userrepo
node_userdetails -->|"loads users"| node_userrepo
node_ticketrepo -->|"persists"| node_ticketmodel
node_userrepo -->|"persists"| node_usermodel
node_ticketservice -.->|"uses"| node_ticketrepo
node_adminservice -.->|"searches tickets"| node_ticketrepo
node_database -.->|"stores records"| node_ticketrepo
node_database -.->|"stores records"| node_userrepo

click node_webapp "https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/dashboard/page.tsx"
click node_ticketdetail "https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/tickets/%5Bid%5D/page.tsx"
click node_adminpage "https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/admin/page.tsx"
click node_authpages "https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/login/page.tsx"
click node_apiclient "https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/lib/api.ts"
click node_ticketapi "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/TicketController.java"
click node_commentapi "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/CommentController.java"
click node_adminapi "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/AdminController.java"
click node_authapi "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/AuthController.java"
click node_ticketservice "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/TicketService.java"
click node_commentservice "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/CommentService.java"
click node_attachments "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AttachmentService.java"
click node_ratings "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/TicketRatingService.java"
click node_adminservice "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AdminService.java"
click node_authservice "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AuthService.java"
click node_jwt "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/security/JwtService.java"
click node_userdetails "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java"
click node_ticketmodel "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/model/Ticket.java"
click node_usermodel "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/model/User.java"
click node_ticketrepo "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/TicketRepository.java"
click node_userrepo "https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/UserRepository.java"

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_webapp,node_ticketdetail,node_adminpage,node_authpages,node_apiclient,node_requester toneBlue
class node_ticketapi,node_commentapi,node_adminapi,node_authapi,node_database toneAmber
class node_authservice,node_jwt,node_userdetails toneMint
class node_ticketservice,node_commentservice,node_attachments,node_ratings,node_adminservice toneRose
class node_ticketmodel,node_usermodel,node_ticketrepo,node_userrepo toneIndigo
```

## Components

### Web application

- [Role-aware pages](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/dashboard/page.tsx): `frontend/src/app/dashboard/page.tsx`
- [Ticket detail](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/tickets/%5Bid%5D/page.tsx): `frontend/src/app/tickets/[id]/page.tsx`
- [Admin console](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/admin/page.tsx): `frontend/src/app/admin/page.tsx`
- [Login and registration](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/app/login/page.tsx): `frontend/src/app/login/page.tsx`
- [API client](https://github.com/snikitha-v/ticketing_system/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### REST API

- [Ticket endpoints](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/TicketController.java): `backend/src/main/java/com/ticketing/controller/TicketController.java`
- [Comment endpoints](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/CommentController.java): `backend/src/main/java/com/ticketing/controller/CommentController.java`
- [Admin endpoints](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/AdminController.java): `backend/src/main/java/com/ticketing/controller/AdminController.java`
- [Auth endpoints](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/controller/AuthController.java): `backend/src/main/java/com/ticketing/controller/AuthController.java`

### Identity and access

- [Authentication service](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AuthService.java): `backend/src/main/java/com/ticketing/service/AuthService.java`
- [JWT issuance](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/security/JwtService.java): `backend/src/main/java/com/ticketing/security/JwtService.java`
- [User lookup](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java): `backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java`

### Ticket workflows

- [Ticket operations](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/TicketService.java): `backend/src/main/java/com/ticketing/service/TicketService.java`
- [Comment operations](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/CommentService.java): `backend/src/main/java/com/ticketing/service/CommentService.java`
- [Attachment operations](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AttachmentService.java): `backend/src/main/java/com/ticketing/service/AttachmentService.java`
- [Rating operations](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/TicketRatingService.java): `backend/src/main/java/com/ticketing/service/TicketRatingService.java`
- [User administration](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/service/AdminService.java): `backend/src/main/java/com/ticketing/service/AdminService.java`

### Persistence

- [Ticket and lifecycle](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/model/Ticket.java): `backend/src/main/java/com/ticketing/model/Ticket.java`
- [User and roles](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/model/User.java): `backend/src/main/java/com/ticketing/model/User.java`
- [Ticket repository](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/TicketRepository.java): `backend/src/main/java/com/ticketing/repository/TicketRepository.java`
- [User repository](https://github.com/snikitha-v/ticketing_system/blob/main/backend/src/main/java/com/ticketing/repository/UserRepository.java): `backend/src/main/java/com/ticketing/repository/UserRepository.java`

### Other components

- **Users and staff**
- **PostgreSQL**

## Connections

- 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 (evidence: `backend/src/main/java/com/ticketing/controller/TicketController.java`)
- Ticket endpoints → Attachment operations: delegates (evidence: `backend/src/main/java/com/ticketing/controller/TicketController.java`)
- Ticket endpoints → Rating operations: delegates (evidence: `backend/src/main/java/com/ticketing/controller/TicketController.java`)
- Comment endpoints → Comment operations: delegates (evidence: `backend/src/main/java/com/ticketing/controller/CommentController.java`)
- Admin endpoints → User administration: delegates (evidence: `backend/src/main/java/com/ticketing/controller/AdminController.java`)
- Auth endpoints → Authentication service: delegates
- Authentication service → JWT issuance: issues token (evidence: `backend/src/main/java/com/ticketing/service/impl/AuthServiceImpl.java`)
- Authentication service → User repository: reads and saves (evidence: `backend/src/main/java/com/ticketing/service/impl/AuthServiceImpl.java`)
- User lookup → User repository: loads users (evidence: `backend/src/main/java/com/ticketing/security/CustomUserDetailsService.java`)
- Ticket repository → Ticket and lifecycle: persists (evidence: `backend/src/main/java/com/ticketing/repository/TicketRepository.java`)
- User repository → User and roles: persists (evidence: `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
