# 2004sachinsharma/ticket-orbit architecture

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

- Interactive diagram: https://gitdiagram.com/2004sachinsharma/ticket-orbit
- Repository: https://github.com/2004sachinsharma/ticket-orbit

## Overview

Ticket Orbit is a role-based support-ticket application: customers register, create and follow tickets; administrators assign work; agents respond and update ticket status. Its Java backend exposes authentication, category, user, ticket and message APIs, while a React client provides role-specific screens. Ticket state, assignment, filtering and message visibility are implemented in services and repositories. The README also describes SLA escalation, audit, Redis, Kafka and WebSocket capabilities as planned, not built; those are omitted from runtime flows. Only the shown excerpts and README support the edges below.

Main entry points: [`src/main/java/com/ticketorbit/ticket/service/TicketService.java`](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketService.java) (Ticket workflow), [`src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java`](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java) (Ticket messages), [`src/main/java/com/ticketorbit/user/repository/UserRepository.java`](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/repository/UserRepository.java) (User records), [`ticketorbit-frontend/src/App.jsx`](https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/App.jsx) (Route shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route shell<br/>[App.jsx]"]
  node_authctx["Auth context<br/>[AuthContext.jsx]"]
  node_http["API client<br/>[axios.js]"]
  node_adminui["Assignment workspace"]
end

subgraph group_identity["Identity and access"]
  node_authapi["Auth API"]
  node_authservice["Authentication"]
  node_security["JWT security"]
end

subgraph group_ticket["Ticket operations"]
  node_ticketapi["Ticket API"]
  node_ticketsvc["Ticket workflow<br/>[TicketService.java]"]
  node_ticketrepo[("Ticket records")]
  node_messageapi["Message API"]
  node_messagesvc["Ticket messages"]
  node_messagerepo[("Message records")]
end

subgraph group_backend["Backend services and data"]
  node_usersvc["User directory<br/>[UserService.java]"]
  node_userrepo[("User records")]
  node_categories["Category service"]
  node_catrepo[("Category records")]
  node_categoriesapi["Category API"]
  node_userapi["User API"]
end

node_actor(("Users"))
node_store[("PostgreSQL")]

node_actor -->|"uses"| node_app
node_app -->|"provides auth"| node_authctx
node_authctx -->|"checks session"| node_http
node_adminui -->|"calls API"| node_http
node_app -->|"routes to"| node_adminui
node_http -.->|"HTTP requests"| node_authapi
node_authapi -->|"delegates to"| node_authservice
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"creates JWT"| node_security
node_userapi -->|"delegates to"| node_usersvc
node_usersvc -->|"queries users"| node_userrepo
node_categoriesapi -->|"delegates to"| node_categories
node_categories -->|"reads categories"| node_catrepo
node_ticketapi -->|"delegates to"| node_ticketsvc
node_ticketsvc -->|"queries and saves"| node_ticketrepo
node_ticketsvc -->|"looks up category"| node_catrepo
node_ticketsvc -->|"looks up agent"| node_userrepo
node_messageapi -->|"delegates to"| node_messagesvc
node_messagesvc -->|"reads and saves"| node_messagerepo
node_messagesvc -->|"updates ticket"| node_ticketrepo
node_messagesvc -->|"resolves users"| node_userrepo
node_authapi -.->|"persists via JPA"| node_store
node_ticketrepo -.->|"persists via JPA"| node_store
node_messagerepo -.->|"persists via JPA"| node_store
node_catrepo -.->|"persists via JPA"| node_store

click node_app "https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/App.jsx"
click node_authctx "https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/auth/AuthContext.jsx"
click node_http "https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/api/axios.js"
click node_adminui "https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/pages/AdminTicketAssignmentPage.jsx"
click node_authapi "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/controller/AuthController.java"
click node_authservice "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/service/AuthenticationService.java"
click node_security "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/security/CustomSecurityConfig.java"
click node_usersvc "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/service/UserService.java"
click node_userrepo "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/repository/UserRepository.java"
click node_categories "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/service/CategoryService.java"
click node_catrepo "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/repository/CategoryRepository.java"
click node_ticketapi "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/controller/TicketController.java"
click node_ticketsvc "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketService.java"
click node_ticketrepo "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/repository/TicketRepository.java"
click node_messageapi "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/controller/TicketMessageController.java"
click node_messagesvc "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java"
click node_messagerepo "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/repository/TicketMessageRepository.java"
click node_categoriesapi "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/controller/CategoryController.java"
click node_userapi "https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/controller/UserController.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_app,node_authctx,node_http,node_adminui,node_actor toneBlue
class node_authapi,node_authservice,node_security,node_store toneAmber
class node_ticketapi,node_ticketsvc,node_ticketrepo,node_messageapi,node_messagesvc,node_messagerepo toneMint
class node_usersvc,node_userrepo,node_categories,node_catrepo,node_categoriesapi,node_userapi toneRose
```

## Components

### React client

- [Route shell](https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/App.jsx): `ticketorbit-frontend/src/App.jsx`
- [Auth context](https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/auth/AuthContext.jsx): `ticketorbit-frontend/src/auth/AuthContext.jsx`
- [API client](https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/api/axios.js): `ticketorbit-frontend/src/api/axios.js`
- [Assignment workspace](https://github.com/2004sachinsharma/ticket-orbit/blob/main/ticketorbit-frontend/src/pages/AdminTicketAssignmentPage.jsx): `ticketorbit-frontend/src/pages/AdminTicketAssignmentPage.jsx`

### Identity and access

- [Auth API](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/controller/AuthController.java): `src/main/java/com/ticketorbit/auth/controller/AuthController.java`
- [Authentication](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/service/AuthenticationService.java): `src/main/java/com/ticketorbit/auth/service/AuthenticationService.java`
- [JWT security](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/auth/security/CustomSecurityConfig.java): `src/main/java/com/ticketorbit/auth/security/CustomSecurityConfig.java`

### Ticket operations

- [Ticket API](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/controller/TicketController.java): `src/main/java/com/ticketorbit/ticket/controller/TicketController.java`
- [Ticket workflow](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketService.java): `src/main/java/com/ticketorbit/ticket/service/TicketService.java`
- [Ticket records](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/repository/TicketRepository.java): `src/main/java/com/ticketorbit/ticket/repository/TicketRepository.java`
- [Message API](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/controller/TicketMessageController.java): `src/main/java/com/ticketorbit/ticket/controller/TicketMessageController.java`
- [Ticket messages](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java): `src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java`
- [Message records](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/ticket/repository/TicketMessageRepository.java): `src/main/java/com/ticketorbit/ticket/repository/TicketMessageRepository.java`

### Backend services and data

- [User directory](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/service/UserService.java): `src/main/java/com/ticketorbit/user/service/UserService.java`
- [User records](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/repository/UserRepository.java): `src/main/java/com/ticketorbit/user/repository/UserRepository.java`
- [Category service](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/service/CategoryService.java): `src/main/java/com/ticketorbit/category/service/CategoryService.java`
- [Category records](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/repository/CategoryRepository.java): `src/main/java/com/ticketorbit/category/repository/CategoryRepository.java`
- [Category API](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/category/controller/CategoryController.java): `src/main/java/com/ticketorbit/category/controller/CategoryController.java`
- [User API](https://github.com/2004sachinsharma/ticket-orbit/blob/main/src/main/java/com/ticketorbit/user/controller/UserController.java): `src/main/java/com/ticketorbit/user/controller/UserController.java`

### Other components

- **Users**
- **PostgreSQL**

## Connections

- Users → Route shell: uses (evidence: `ticketorbit-frontend/src/App.jsx`)
- Route shell → Auth context: provides auth (evidence: `ticketorbit-frontend/src/App.jsx`)
- Auth context → API client: checks session (evidence: `ticketorbit-frontend/src/auth/AuthContext.jsx`)
- Assignment workspace → API client: calls API (evidence: `ticketorbit-frontend/src/pages/AdminTicketAssignmentPage.jsx`)
- Route shell → Assignment workspace: routes to (evidence: `ticketorbit-frontend/src/App.jsx`)
- API client → Auth API: HTTP requests
- Auth API → Authentication: delegates to (evidence: `src/main/java/com/ticketorbit/auth/controller/AuthController.java`)
- Authentication → User records: reads and saves (evidence: `src/main/java/com/ticketorbit/auth/service/AuthenticationService.java`)
- Authentication → JWT security: creates JWT (evidence: `src/main/java/com/ticketorbit/auth/service/AuthenticationService.java`)
- User API → User directory: delegates to (evidence: `src/main/java/com/ticketorbit/user/controller/UserController.java`)
- User directory → User records: queries users (evidence: `src/main/java/com/ticketorbit/user/service/UserService.java`)
- Category API → Category service: delegates to (evidence: `src/main/java/com/ticketorbit/category/controller/CategoryController.java`)
- Category service → Category records: reads categories (evidence: `src/main/java/com/ticketorbit/category/service/CategoryService.java`)
- Ticket API → Ticket workflow: delegates to (evidence: `src/main/java/com/ticketorbit/ticket/controller/TicketController.java`)
- Ticket workflow → Ticket records: queries and saves (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketService.java`)
- Ticket workflow → Category records: looks up category (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketService.java`)
- Ticket workflow → User records: looks up agent (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketService.java`)
- Message API → Ticket messages: delegates to (evidence: `src/main/java/com/ticketorbit/ticket/controller/TicketMessageController.java`)
- Ticket messages → Message records: reads and saves (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java`)
- Ticket messages → Ticket records: updates ticket (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java`)
- Ticket messages → User records: resolves users (evidence: `src/main/java/com/ticketorbit/ticket/service/TicketMessageService.java`)
- Auth API → PostgreSQL: persists via JPA
- Ticket records → PostgreSQL: persists via JPA
- Message records → PostgreSQL: persists via JPA
- Category records → PostgreSQL: persists via JPA
