How sara-h-samara/dor-smart-queue works
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: TicketService.java Ticket lifecycle · app.routes.ts Role routing · student-ticket-page.ts Student ticket page · AuthService.java Authentication service
Components 29
User experiences
- Login and register
frontend/src/app/features/auth/login/login.ts - Student ticket page
frontend/src/app/features/student/student-ticket-page/student-ticket-page.ts - Staff desk page
frontend/src/app/features/staff/staff-desk-page/staff-desk-page.ts - Admin home
frontend/src/app/features/admin/admin-home/admin-home.ts
Frontend access
- Role routing
frontend/src/app/app.routes.ts - Auth client
frontend/src/app/core/services/auth.service.ts - Catalog client
frontend/src/app/core/services/catalog.service.ts - Ticket client
frontend/src/app/core/services/ticket.service.ts - Desk client
frontend/src/app/core/services/staff-desk.service.ts
Queue operations
- Authentication API
backend/src/main/java/com/sara/backend/controller/AuthController.java - Ticket API
backend/src/main/java/com/sara/backend/controller/TicketController.java - Staff desk API
backend/src/main/java/com/sara/backend/controller/StaffDeskController.java - Service catalog API
backend/src/main/java/com/sara/backend/controller/ServiceTypeController.java - Authentication service
backend/src/main/java/com/sara/backend/service/AuthService.java - Ticket lifecycle
backend/src/main/java/com/sara/backend/service/TicketService.java - Desk operations
backend/src/main/java/com/sara/backend/service/StaffDeskService.java - Counter management
backend/src/main/java/com/sara/backend/service/CounterService.java - JWT issuance
backend/src/main/java/com/sara/backend/security/JwtService.java
Domain and persistence
- Ticket records
backend/src/main/java/com/sara/backend/entity/Ticket.java - User records
backend/src/main/java/com/sara/backend/entity/User.java - Service types
backend/src/main/java/com/sara/backend/entity/ServiceType.java - Counters
backend/src/main/java/com/sara/backend/entity/Counter.java - Ticket queries
backend/src/main/java/com/sara/backend/repository/TicketRepository.java - User queries
backend/src/main/java/com/sara/backend/repository/UserRepository.java - Service queries
backend/src/main/java/com/sara/backend/repository/ServiceTypeRepository.java - Counter queries
backend/src/main/java/com/sara/backend/repository/CounterRepository.java
Other components
- Student
- Staff
- Admin
Connections 31
- 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
frontend/src/app/app.routes.ts - Role routing → Student ticket page: role-routes
frontend/src/app/app.routes.ts - Role routing → Staff desk page: role-routes
frontend/src/app/app.routes.ts - Role routing → Admin home: role-routes
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
backend/src/main/java/com/sara/backend/service/AuthService.java - Ticket API → Ticket lifecycle: delegates to
backend/src/main/java/com/sara/backend/controller/TicketController.java - Staff desk API → Desk operations: delegates to
backend/src/main/java/com/sara/backend/controller/StaffDeskController.java - Service catalog API → Service queries: manages services
- Ticket lifecycle → Ticket queries: queries tickets
backend/src/main/java/com/sara/backend/service/TicketService.java - Ticket lifecycle → User queries: looks up students
backend/src/main/java/com/sara/backend/service/TicketService.java - Ticket lifecycle → Service queries: checks service
backend/src/main/java/com/sara/backend/service/TicketService.java - Ticket lifecycle → Ticket records: creates ticket
backend/src/main/java/com/sara/backend/service/TicketService.java - Desk operations → Ticket queries: selects and updates
backend/src/main/java/com/sara/backend/service/StaffDeskService.java - Desk operations → Counter queries: checks counter
backend/src/main/java/com/sara/backend/service/StaffDeskService.java - Counter management → Counter queries: manages counters
backend/src/main/java/com/sara/backend/service/CounterService.java - Counter management → Service queries: checks service
backend/src/main/java/com/sara/backend/service/CounterService.java - Authentication service → User queries: reads and saves
backend/src/main/java/com/sara/backend/service/AuthService.java - Authentication service → JWT issuance: issues token
backend/src/main/java/com/sara/backend/service/AuthService.java