# sara-h-samara/dor-smart-queue architecture

> Architecture diagram of the GitHub repository sara-h-samara/dor-smart-queue, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sara-h-samara/dor-smart-queue
- Repository: https://github.com/sara-h-samara/dor-smart-queue

## Overview

Dor is a university Student Affairs queue system: students authenticate, choose a service, take and track a ticket, and can leave the queue; staff manage a desk and admins maintain services and counters. The graph includes the Angular role-specific interface and the Spring API/service/persistence layers. Some controller-to-service and service-to-repository links are supported by indexed references; frontend-to-backend links and unsampled feature wiring are left dashed where not directly evidenced.

Main entry points: [`backend/src/main/java/com/sara/backend/service/TicketService.java`](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/TicketService.java) (Ticket lifecycle), [`frontend/src/app/app.routes.ts`](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/app.routes.ts) (Role routing), [`frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts`](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts) (Student ticket page), [`backend/src/main/java/com/sara/backend/service/AuthService.java`](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_users["User experiences"]
  node_auth_ui["Login and register<br/>[login.ts]"]
  node_student_ui["Student ticket page"]
  node_staff_ui["Staff desk page<br/>[staff-desk-page.ts]"]
  node_admin_ui["Admin home<br/>[admin-home.ts]"]
end

subgraph group_frontend["Frontend access"]
  node_routes["Role routing<br/>[app.routes.ts]"]
  node_auth_client["Auth client<br/>[auth.service.ts]"]
  node_catalog_client["Catalog client<br/>[catalog.service.ts]"]
  node_ticket_client["Ticket client<br/>[ticket.service.ts]"]
  node_desk_client["Desk client"]
end

subgraph group_backend["Queue operations"]
  node_auth_api["Authentication API"]
  node_ticket_api["Ticket API"]
  node_staff_api["Staff desk API"]
  node_service_api["Service catalog API"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_ticket_service["Ticket lifecycle<br/>[TicketService.java]"]
  node_desk_service["Desk operations"]
  node_counter_service["Counter management"]
  node_jwt["JWT issuance<br/>[JwtService.java]"]
end

subgraph group_data["Domain and persistence"]
  node_ticket_store[("Ticket records<br/>[Ticket.java]")]
  node_user_store[("User records<br/>[User.java]")]
  node_service_store[("Service types<br/>[ServiceType.java]")]
  node_counter_store[("Counters<br/>[Counter.java]")]
  node_ticket_repo["Ticket queries"]
  node_user_repo["User queries"]
  node_service_repo["Service queries"]
  node_counter_repo["Counter queries"]
end

node_student(("Student"))
node_staff(("Staff"))
node_admin(("Admin"))

node_student -->|"registers or logs in"| node_auth_ui
node_student -->|"takes and tracks tickets"| node_student_ui
node_staff -->|"uses desk"| node_staff_ui
node_admin -->|"manages services"| node_admin_ui
node_routes -->|"loads"| node_auth_ui
node_routes -->|"role-routes"| node_student_ui
node_routes -->|"role-routes"| node_staff_ui
node_routes -->|"role-routes"| node_admin_ui
node_auth_ui -.->|"uses"| node_auth_client
node_student_ui -.->|"requests tickets"| node_ticket_client
node_student_ui -.->|"loads services"| node_catalog_client
node_staff_ui -.->|"requests desk actions"| node_desk_client
node_admin_ui -.->|"manages catalog"| node_catalog_client
node_auth_client -.->|"HTTP authentication"| node_auth_api
node_ticket_client -.->|"HTTP ticket actions"| node_ticket_api
node_desk_client -.->|"HTTP desk actions"| node_staff_api
node_catalog_client -.->|"HTTP catalog requests"| node_service_api
node_auth_api -->|"delegates to"| node_auth_service
node_ticket_api -->|"delegates to"| node_ticket_service
node_staff_api -->|"delegates to"| node_desk_service
node_service_api -.->|"manages services"| node_service_repo
node_ticket_service -->|"queries tickets"| node_ticket_repo
node_ticket_service -->|"looks up students"| node_user_repo
node_ticket_service -->|"checks service"| node_service_repo
node_ticket_service -->|"creates ticket"| node_ticket_store
node_desk_service -->|"selects and updates"| node_ticket_repo
node_desk_service -->|"checks counter"| node_counter_repo
node_counter_service -->|"manages counters"| node_counter_repo
node_counter_service -->|"checks service"| node_service_repo
node_auth_service -->|"reads and saves"| node_user_repo
node_auth_service -->|"issues token"| node_jwt

click node_auth_ui "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/auth/login/login.ts"
click node_student_ui "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts"
click node_staff_ui "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/staff/staff-desk-page/staff-desk-page.ts"
click node_admin_ui "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/admin/admin-home/admin-home.ts"
click node_routes "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/app.routes.ts"
click node_auth_client "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/auth.service.ts"
click node_catalog_client "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/catalog.service.ts"
click node_ticket_client "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/ticket.service.ts"
click node_desk_client "https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/staff-desk.service.ts"
click node_auth_api "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/AuthController.java"
click node_ticket_api "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/TicketController.java"
click node_staff_api "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/StaffDeskController.java"
click node_service_api "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/ServiceTypeController.java"
click node_auth_service "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/AuthService.java"
click node_ticket_service "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/TicketService.java"
click node_desk_service "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/StaffDeskService.java"
click node_counter_service "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/CounterService.java"
click node_jwt "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/security/JwtService.java"
click node_ticket_store "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/Ticket.java"
click node_user_store "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/User.java"
click node_service_store "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/ServiceType.java"
click node_counter_store "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/Counter.java"
click node_ticket_repo "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/TicketRepository.java"
click node_user_repo "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/UserRepository.java"
click node_service_repo "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/ServiceTypeRepository.java"
click node_counter_repo "https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/CounterRepository.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_auth_ui,node_student_ui,node_staff_ui,node_admin_ui toneBlue
class node_routes,node_auth_client,node_catalog_client,node_ticket_client,node_desk_client toneAmber
class node_auth_api,node_ticket_api,node_staff_api,node_service_api,node_auth_service,node_ticket_service,node_desk_service,node_counter_service,node_jwt toneMint
class node_ticket_store,node_user_store,node_service_store,node_counter_store,node_ticket_repo,node_user_repo,node_service_repo,node_counter_repo toneRose
class node_student,node_staff,node_admin toneIndigo
```

## Components

### User experiences

- [Login and register](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/auth/login/login.ts): `frontend/src/app/features/auth/login/login.ts`
- [Student ticket page](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts): `frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts`
- [Staff desk page](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/staff/staff-desk-page/staff-desk-page.ts): `frontend/src/app/features/staff/staff-desk-page/staff-desk-page.ts`
- [Admin home](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/features/admin/admin-home/admin-home.ts): `frontend/src/app/features/admin/admin-home/admin-home.ts`

### Frontend access

- [Role routing](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Auth client](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/auth.service.ts): `frontend/src/app/core/services/auth.service.ts`
- [Catalog client](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/catalog.service.ts): `frontend/src/app/core/services/catalog.service.ts`
- [Ticket client](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/ticket.service.ts): `frontend/src/app/core/services/ticket.service.ts`
- [Desk client](https://github.com/sara-h-samara/dor-smart-queue/blob/main/frontend/src/app/core/services/staff-desk.service.ts): `frontend/src/app/core/services/staff-desk.service.ts`

### Queue operations

- [Authentication API](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/AuthController.java): `backend/src/main/java/com/sara/backend/controller/AuthController.java`
- [Ticket API](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/TicketController.java): `backend/src/main/java/com/sara/backend/controller/TicketController.java`
- [Staff desk API](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/StaffDeskController.java): `backend/src/main/java/com/sara/backend/controller/StaffDeskController.java`
- [Service catalog API](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/controller/ServiceTypeController.java): `backend/src/main/java/com/sara/backend/controller/ServiceTypeController.java`
- [Authentication service](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/AuthService.java): `backend/src/main/java/com/sara/backend/service/AuthService.java`
- [Ticket lifecycle](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/TicketService.java): `backend/src/main/java/com/sara/backend/service/TicketService.java`
- [Desk operations](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/StaffDeskService.java): `backend/src/main/java/com/sara/backend/service/StaffDeskService.java`
- [Counter management](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/service/CounterService.java): `backend/src/main/java/com/sara/backend/service/CounterService.java`
- [JWT issuance](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/security/JwtService.java): `backend/src/main/java/com/sara/backend/security/JwtService.java`

### Domain and persistence

- [Ticket records](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/Ticket.java): `backend/src/main/java/com/sara/backend/entity/Ticket.java`
- [User records](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/User.java): `backend/src/main/java/com/sara/backend/entity/User.java`
- [Service types](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/ServiceType.java): `backend/src/main/java/com/sara/backend/entity/ServiceType.java`
- [Counters](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/entity/Counter.java): `backend/src/main/java/com/sara/backend/entity/Counter.java`
- [Ticket queries](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/TicketRepository.java): `backend/src/main/java/com/sara/backend/repository/TicketRepository.java`
- [User queries](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/UserRepository.java): `backend/src/main/java/com/sara/backend/repository/UserRepository.java`
- [Service queries](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/ServiceTypeRepository.java): `backend/src/main/java/com/sara/backend/repository/ServiceTypeRepository.java`
- [Counter queries](https://github.com/sara-h-samara/dor-smart-queue/blob/main/backend/src/main/java/com/sara/backend/repository/CounterRepository.java): `backend/src/main/java/com/sara/backend/repository/CounterRepository.java`

### Other components

- **Student**
- **Staff**
- **Admin**

## Connections

- Student → Login and register: registers or logs in
- Student → Student ticket page: takes and tracks tickets
- Staff → Staff desk page: uses desk
- Admin → Admin home: manages services
- Role routing → Login and register: loads (evidence: `frontend/src/app/app.routes.ts`)
- Role routing → Student ticket page: role-routes (evidence: `frontend/src/app/app.routes.ts`)
- Role routing → Staff desk page: role-routes (evidence: `frontend/src/app/app.routes.ts`)
- Role routing → Admin home: role-routes (evidence: `frontend/src/app/app.routes.ts`)
- Login and register → Auth client: uses
- Student ticket page → Ticket client: requests tickets
- Student ticket page → Catalog client: loads services
- Staff desk page → Desk client: requests desk actions
- Admin home → Catalog client: manages catalog
- Auth client → Authentication API: HTTP authentication
- Ticket client → Ticket API: HTTP ticket actions
- Desk client → Staff desk API: HTTP desk actions
- Catalog client → Service catalog API: HTTP catalog requests
- Authentication API → Authentication service: delegates to (evidence: `backend/src/main/java/com/sara/backend/service/AuthService.java`)
- Ticket API → Ticket lifecycle: delegates to (evidence: `backend/src/main/java/com/sara/backend/controller/TicketController.java`)
- Staff desk API → Desk operations: delegates to (evidence: `backend/src/main/java/com/sara/backend/controller/StaffDeskController.java`)
- Service catalog API → Service queries: manages services
- Ticket lifecycle → Ticket queries: queries tickets (evidence: `backend/src/main/java/com/sara/backend/service/TicketService.java`)
- Ticket lifecycle → User queries: looks up students (evidence: `backend/src/main/java/com/sara/backend/service/TicketService.java`)
- Ticket lifecycle → Service queries: checks service (evidence: `backend/src/main/java/com/sara/backend/service/TicketService.java`)
- Ticket lifecycle → Ticket records: creates ticket (evidence: `backend/src/main/java/com/sara/backend/service/TicketService.java`)
- Desk operations → Ticket queries: selects and updates (evidence: `backend/src/main/java/com/sara/backend/service/StaffDeskService.java`)
- Desk operations → Counter queries: checks counter (evidence: `backend/src/main/java/com/sara/backend/service/StaffDeskService.java`)
- Counter management → Counter queries: manages counters (evidence: `backend/src/main/java/com/sara/backend/service/CounterService.java`)
- Counter management → Service queries: checks service (evidence: `backend/src/main/java/com/sara/backend/service/CounterService.java`)
- Authentication service → User queries: reads and saves (evidence: `backend/src/main/java/com/sara/backend/service/AuthService.java`)
- Authentication service → JWT issuance: issues token (evidence: `backend/src/main/java/com/sara/backend/service/AuthService.java`)
