# wankhadepranav/queueless architecture

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

- Interactive diagram: https://gitdiagram.com/wankhadepranav/queueless
- Repository: https://github.com/wankhadepranav/queueless

## Overview

Queueless is a Spring Boot REST backend for customer and staff queue operations, with administrator management. Customers register or log in, join a service queue, and track or cancel tickets; staff call the next customer and complete or cancel service. The main runtime layers are REST controllers, domain services, and JPA-backed data access, with JWT authentication and role-based authorization across the API. Major admin capabilities are documented, though their detailed implementation was not sampled; edges show only relationships supported by excerpts, the source index, or README.

Main entry points: [`src/main/java/com/queueless/repository`](https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/repository) (JPA repositories), [`src/main/java/com/queueless/service/TicketService.java`](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/TicketService.java) (Ticket lifecycle), [`src/main/java/com/queueless/service/AuthService.java`](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/AuthService.java) (Authentication), [`src/main/java/com/queueless/controller/TicketController.java`](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/TicketController.java) (Ticket endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Auth endpoints"]
  node_ticket_api["Ticket endpoints"]
  node_queue_api["Queue endpoints"]
  node_service_api["Service endpoints"]
  node_user_api["User endpoints"]
  node_responses["API DTOs"]
end

subgraph group_domain["Queue Operations"]
  node_ticket_service["Ticket lifecycle<br/>[TicketService.java]"]
  node_queue_service["Queue management<br/>[QueueService.java]"]
  node_service_service["Service management"]
  node_user_service["User management<br/>[UserService.java]"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt_service["JWT tokens<br/>[JwtService.java]"]
  node_security["Request security"]
  node_jwt_filter["JWT filter"]
end

subgraph group_persistence["Persistence"]
  node_domain_entities["Queue domain"]
  node_repositories["JPA repositories"]
  node_mysql[("MySQL")]
end

node_customer(("Customer"))
node_staff_admin(("Staff &amp; Admin"))

node_customer -->|"registers or logs in"| node_auth_api
node_customer -->|"joins and tracks"| node_ticket_api
node_staff_admin -->|"operates tickets"| node_ticket_api
node_staff_admin -->|"manages queues"| node_queue_api
node_staff_admin -->|"manages services"| node_service_api
node_staff_admin -->|"manages users"| node_user_api
node_auth_api -->|"delegates"| node_auth_service
node_ticket_api -->|"delegates"| node_ticket_service
node_queue_api -->|"delegates"| node_queue_service
node_service_api -->|"delegates"| node_service_service
node_user_api -->|"delegates"| node_user_service
node_auth_service -->|"generates token"| node_jwt_service
node_security -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates token"| node_jwt_service
node_ticket_service -->|"reads and writes tickets"| node_repositories
node_ticket_service -->|"loads queues and users"| node_repositories
node_queue_service -->|"accesses queues"| node_repositories
node_service_service -->|"accesses services"| node_repositories
node_user_service -->|"accesses users"| node_repositories
node_auth_service -->|"looks up and saves users"| node_repositories
node_auth_service -->|"uses login DTOs"| node_responses
node_ticket_service -->|"builds queue status"| node_responses
node_ticket_service -->|"updates ticket state"| node_domain_entities
node_repositories -->|"persists application data"| node_mysql

click node_auth_api "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/AuthController.java"
click node_ticket_api "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/TicketController.java"
click node_queue_api "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/QueueController.java"
click node_service_api "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/ServiceController.java"
click node_user_api "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/UserController.java"
click node_auth_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/AuthService.java"
click node_jwt_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/JwtService.java"
click node_security "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/security/SecurityConfig.java"
click node_jwt_filter "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/security/JwtAuthenticationFilter.java"
click node_ticket_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/TicketService.java"
click node_queue_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/QueueService.java"
click node_service_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/ServiceService.java"
click node_user_service "https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/UserService.java"
click node_responses "https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/dto"
click node_domain_entities "https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/entity"
click node_repositories "https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/repository"

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_auth_api,node_ticket_api,node_queue_api,node_service_api,node_user_api,node_responses toneBlue
class node_ticket_service,node_queue_service,node_service_service,node_user_service toneAmber
class node_auth_service,node_jwt_service,node_security,node_jwt_filter toneMint
class node_domain_entities,node_repositories,node_mysql toneRose
class node_customer,node_staff_admin toneIndigo
```

## Components

### REST API

- [Auth endpoints](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/AuthController.java): `src/main/java/com/queueless/controller/AuthController.java`
- [Ticket endpoints](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/TicketController.java): `src/main/java/com/queueless/controller/TicketController.java`
- [Queue endpoints](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/QueueController.java): `src/main/java/com/queueless/controller/QueueController.java`
- [Service endpoints](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/ServiceController.java): `src/main/java/com/queueless/controller/ServiceController.java`
- [User endpoints](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/controller/UserController.java): `src/main/java/com/queueless/controller/UserController.java`
- [API DTOs](https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/dto): `src/main/java/com/queueless/dto`

### Queue Operations

- [Ticket lifecycle](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/TicketService.java): `src/main/java/com/queueless/service/TicketService.java`
- [Queue management](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/QueueService.java): `src/main/java/com/queueless/service/QueueService.java`
- [Service management](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/ServiceService.java): `src/main/java/com/queueless/service/ServiceService.java`
- [User management](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/UserService.java): `src/main/java/com/queueless/service/UserService.java`

### Identity & Access

- [Authentication](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/AuthService.java): `src/main/java/com/queueless/service/AuthService.java`
- [JWT tokens](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/service/JwtService.java): `src/main/java/com/queueless/service/JwtService.java`
- [Request security](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/security/SecurityConfig.java): `src/main/java/com/queueless/security/SecurityConfig.java`
- [JWT filter](https://github.com/wankhadepranav/queueless/blob/main/src/main/java/com/queueless/security/JwtAuthenticationFilter.java): `src/main/java/com/queueless/security/JwtAuthenticationFilter.java`

### Persistence

- [Queue domain](https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/entity): `src/main/java/com/queueless/entity`
- [JPA repositories](https://github.com/wankhadepranav/queueless/tree/main/src/main/java/com/queueless/repository): `src/main/java/com/queueless/repository`
- **MySQL**

### Other components

- **Customer**
- **Staff & Admin**

## Connections

- Customer → Auth endpoints: registers or logs in (evidence: `README.md`)
- Customer → Ticket endpoints: joins and tracks (evidence: `README.md`)
- Staff & Admin → Ticket endpoints: operates tickets (evidence: `README.md`)
- Staff & Admin → Queue endpoints: manages queues (evidence: `README.md`)
- Staff & Admin → Service endpoints: manages services (evidence: `README.md`)
- Staff & Admin → User endpoints: manages users (evidence: `README.md`)
- Auth endpoints → Authentication: delegates (evidence: `src/main/java/com/queueless/controller/AuthController.java`)
- Ticket endpoints → Ticket lifecycle: delegates (evidence: `src/main/java/com/queueless/controller/TicketController.java`)
- Queue endpoints → Queue management: delegates (evidence: `src/main/java/com/queueless/controller/QueueController.java`)
- Service endpoints → Service management: delegates (evidence: `src/main/java/com/queueless/controller/ServiceController.java`)
- User endpoints → User management: delegates (evidence: `src/main/java/com/queueless/controller/UserController.java`)
- Authentication → JWT tokens: generates token (evidence: `src/main/java/com/queueless/service/AuthService.java`)
- Request security → JWT filter: registers filter (evidence: `src/main/java/com/queueless/security/SecurityConfig.java`)
- JWT filter → JWT tokens: validates token (evidence: `src/main/java/com/queueless/security/JwtAuthenticationFilter.java`)
- Ticket lifecycle → JPA repositories: reads and writes tickets (evidence: `src/main/java/com/queueless/service/TicketService.java`)
- Ticket lifecycle → JPA repositories: loads queues and users (evidence: `src/main/java/com/queueless/service/TicketService.java`)
- Queue management → JPA repositories: accesses queues (evidence: `src/main/java/com/queueless/service/QueueService.java`)
- Service management → JPA repositories: accesses services (evidence: `src/main/java/com/queueless/service/ServiceService.java`)
- User management → JPA repositories: accesses users (evidence: `src/main/java/com/queueless/service/UserService.java`)
- Authentication → JPA repositories: looks up and saves users (evidence: `src/main/java/com/queueless/service/AuthService.java`)
- Authentication → API DTOs: uses login DTOs (evidence: `src/main/java/com/queueless/service/AuthService.java`)
- Ticket lifecycle → API DTOs: builds queue status (evidence: `src/main/java/com/queueless/service/TicketService.java`)
- Ticket lifecycle → Queue domain: updates ticket state (evidence: `src/main/java/com/queueless/service/TicketService.java`)
- JPA repositories → MySQL: persists application data (evidence: `README.md`)
