carilloandrei9264/university-queue-system

How carilloandrei9264/university-queue-system works

NU Queue-It is a Laravel queue-management MVP for university offices. Students select a service, receive and track or cancel a ticket; staff operate assigned service windows to call, complete, skip, or recall tickets; a public display shows queue status. Administrators configure offices, services, accounts, windows, and breaks, import/export student rosters, and review activity. The graph reflects documented product capabilities and sampled controller/service calls; several admin and display details are documented in the README but their implementation excerpts were not provided.

Main entry points: web.php Web routes · TicketQueueService.php Queue rules · ActivityLogger.php Activity logger · Department.php Departments

Components 28

Web entry and access

Web routes routes/web.php
Sign-in app/Http/Controllers/Auth/AuthenticatedSessionController.php
Role guard app/Http/Middleware/EnsureUserHasRole.php
Role dashboard app/Http/Controllers/DashboardController.php

Administration

Office setup app/Http/Controllers/Admin/DepartmentController.php
Service setup app/Http/Controllers/Admin/ServiceController.php
Staff and windows app/Http/Controllers/Admin/StaffController.php
Student accounts app/Http/Controllers/Admin/StudentController.php
Roster CSV app/Services/StudentRosterCsv.php
Activity log view app/Http/Controllers/Admin/ActivityLogController.php

Ticket operations

Student tickets app/Http/Controllers/Student/TicketController.php
Staff queue app/Http/Controllers/Staff/QueueController.php
Public display app/Http/Controllers/Display/QueueDisplayController.php
Queue rules app/Services/TicketQueueService.php
Ticket states app/Domain/TicketStatus.php

Domain and records

Activity logger app/Services/ActivityLogger.php
Departments app/Models/Department.php
Services app/Models/Service.php
Service windows app/Models/ServiceWindow.php
Ticket records app/Models/Ticket.php
User accounts app/Models/User.php
Daily counter app/Models/DailyCounter.php
Audit records app/Models/AuditLog.php

Other components

Students
Office staff
Administrators
Public visitors
SQL database

Connections 48

Students → Web routes: use README.md
Office staff → Web routes: use README.md
Administrators → Web routes: use README.md
Public visitors → Web routes: view README.md
Web routes → Sign-in: routes to routes/web.php
Web routes → Student tickets: routes to routes/web.php
Web routes → Staff queue: routes to routes/web.php
Web routes → Public display: routes to routes/web.php
Web routes → Office setup: routes to routes/web.php
Web routes → Service setup: routes to routes/web.php
Web routes → Staff and windows: routes to routes/web.php
Web routes → Student accounts: routes to routes/web.php
Web routes → Activity log view: routes to routes/web.php
Web routes → Role guard: guards routes
Student tickets → Queue rules: invokes app/Http/Controllers/Student/TicketController.php
Staff queue → Queue rules: invokes app/Http/Controllers/Staff/QueueController.php
Student tickets → Departments: queries app/Http/Controllers/Student/TicketController.php
Student tickets → Ticket records: queries app/Http/Controllers/Student/TicketController.php
Staff queue → Service windows: queries app/Http/Controllers/Staff/QueueController.php
Staff queue → Ticket records: queries app/Http/Controllers/Staff/QueueController.php
Public display → Departments: queries app/Http/Controllers/Display/QueueDisplayController.php
Public display → Service windows: queries app/Http/Controllers/Display/QueueDisplayController.php
Public display → Ticket records: queries app/Http/Controllers/Display/QueueDisplayController.php
Queue rules → Ticket states: checks transitions app/Services/TicketQueueService.php
Queue rules → Daily counter: allocates numbers app/Services/TicketQueueService.php
Queue rules → Departments: locks and reads app/Services/TicketQueueService.php
Queue rules → Services: locks and reads app/Services/TicketQueueService.php
Queue rules → Service windows: checks assignment app/Services/TicketQueueService.php
Queue rules → Ticket records: creates and updates app/Services/TicketQueueService.php
Queue rules → User accounts: checks accounts app/Services/TicketQueueService.php
Queue rules → Activity logger: records actions app/Services/TicketQueueService.php
Office setup → Departments: manages app/Http/Controllers/Admin/DepartmentController.php
Office setup → Activity logger: records actions app/Http/Controllers/Admin/DepartmentController.php
Service setup → Services: manages app/Http/Controllers/Admin/ServiceController.php
Service setup → Activity logger: records actions app/Http/Controllers/Admin/ServiceController.php
Staff and windows → Service windows: manages assignments app/Http/Controllers/Admin/StaffController.php
Staff and windows → User accounts: manages accounts app/Http/Controllers/Admin/StaffController.php
Staff and windows → Activity logger: records actions app/Http/Controllers/Admin/StaffController.php
Student accounts → User accounts: manages accounts app/Http/Controllers/Admin/StudentController.php
Student accounts → Roster CSV: previews and imports app/Http/Controllers/Admin/StudentController.php
Student accounts → Activity logger: records actions app/Http/Controllers/Admin/StudentController.php
Roster CSV → User accounts: creates accounts app/Services/StudentRosterCsv.php
Roster CSV → Activity logger: records imports app/Services/StudentRosterCsv.php
Activity log view → Audit records: reads log app/Http/Controllers/Admin/ActivityLogController.php
Activity logger → Audit records: writes records app/Services/ActivityLogger.php
Departments → SQL database: persists via ORM
Services → SQL database: persists via ORM
Service windows → SQL database: persists via ORM

Drawn by GitDiagram on November 12, 2026 from the repository's file tree, README and source files. Read as Markdown ·