How naveesha99/service-request-tracker works
Service Request Tracker is a session-authenticated request-management application. Users sign in, create and browse their own requests, search and filter paginated results, inspect request details and history, and advance status through an enforced, version-checked workflow. The Next.js client communicates with Laravel’s API; Laravel validates and serializes requests, while Eloquent-backed records persist requests, users, and status history. The README documents the browser-to-API boundary and major capabilities; source-index references and excerpts support the shown backend calls. Frontend page-to-client wiring is not shown, so it is not expanded into speculative edges.
Main entry points: ServiceRequestController.php Request API · RequestStatusService.php Status workflow · ServiceRequest.php Service request · api.php API routes
Components 23
Web interface
- Next.js app
frontend/src/lib/api.ts - Login page
frontend/src/app/login/page.tsx - Dashboard
frontend/src/app/dashboard/page.tsx - Request list
frontend/src/app/requests/page.tsx - Create request
frontend/src/app/requests/create/page.tsx - Request detail
frontend/src/app/requests/[id]/page.tsx
Laravel API
- API routes
backend/routes/api.php - Authentication API
backend/app/Http/Controllers/Api/AuthController.php - Request API
backend/app/Http/Controllers/Api/ServiceRequestController.php - List validation
backend/app/Http/Requests/ListServiceRequestsRequest.php - Create validation
backend/app/Http/Requests/StoreServiceRequestRequest.php - Status validation
backend/app/Http/Requests/UpdateRequestStatusRequest.php - Request serializer
backend/app/Http/Resources/ServiceRequestResource.php - History serializer
backend/app/Http/Resources/RequestStatusHistoryResource.php
Request domain
- Status workflow
backend/app/Services/RequestStatusService.php - Status and priority
backend/app/Enums/ServiceRequestStatus.php - Priority values
backend/app/Enums/ServiceRequestPriority.php - Conflict errors
backend/app/Exceptions/RequestStatusConflictException.php
Persistence
- User model
backend/app/Models/User.php - Service request
backend/app/Models/ServiceRequest.php - Status history
backend/app/Models/RequestStatusHistory.php - SQLite database
Other components
- User
Connections 21
- User → Next.js app: uses
README.md - Next.js app → API routes: credentialed API calls
README.md - API routes → Authentication API: routes auth
backend/routes/api.php - API routes → Request API: routes requests
backend/routes/api.php - Authentication API → User model: authenticates
backend/app/Http/Controllers/Api/AuthController.php - Request API → List validation: validates listing
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → Create validation: validates creation
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → Status validation: validates status
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → Service request: queries and saves
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → Status workflow: delegates transition
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → Request serializer: serializes request
backend/app/Http/Controllers/Api/ServiceRequestController.php - Request API → History serializer: serializes history
backend/app/Http/Controllers/Api/ServiceRequestController.php - Status workflow → Service request: updates status
backend/app/Services/RequestStatusService.php - Status workflow → Status history: inserts history
backend/app/Services/RequestStatusService.php - Status workflow → Status and priority: checks transitions
backend/app/Services/RequestStatusService.php - Status workflow → Conflict errors: raises conflicts
backend/app/Services/RequestStatusService.php - Service request → Status history: has histories
backend/app/Models/ServiceRequest.php - User model → Service request: owns requests
backend/app/Models/User.php - Service request → SQLite database: persists records
README.md - Status history → SQLite database: persists history
README.md - User model → SQLite database: persists users
README.md