# naveesha99/service-request-tracker architecture

> Architecture diagram of the GitHub repository naveesha99/service-request-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/naveesha99/service-request-tracker
- Repository: https://github.com/naveesha99/service-request-tracker

## Overview

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: [`backend/app/Http/Controllers/Api/ServiceRequestController.php`](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Controllers/Api/ServiceRequestController.php) (Request API), [`backend/app/Services/RequestStatusService.php`](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Services/RequestStatusService.php) (Status workflow), [`backend/app/Models/ServiceRequest.php`](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/ServiceRequest.php) (Service request), [`backend/routes/api.php`](https://github.com/naveesha99/service-request-tracker/blob/master/backend/routes/api.php) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_web["Next.js app<br/>[api.ts]"]
  node_login["Login page<br/>[page.tsx]"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_request_list["Request list<br/>[page.tsx]"]
  node_request_create["Create request<br/>[page.tsx]"]
  node_request_detail["Request detail<br/>[page.tsx]"]
end

subgraph group_api["Laravel API"]
  node_routes["API routes<br/>[api.php]"]
  node_auth["Authentication API<br/>[AuthController.php]"]
  node_requests["Request API"]
  node_list_validation["List validation"]
  node_create_validation["Create validation"]
  node_status_validation["Status validation"]
  node_request_resource["Request serializer"]
  node_history_resource["History serializer"]
end

subgraph group_domain["Request domain"]
  node_status_service["Status workflow"]
  node_status_rules["Status and priority"]
  node_priority_rules["Priority values"]
  node_conflict["Conflict errors"]
end

subgraph group_persistence["Persistence"]
  node_user_model["User model<br/>[User.php]"]
  node_request_model["Service request<br/>[ServiceRequest.php]"]
  node_history_model["Status history"]
  node_database[("SQLite database")]
end

node_user(("User"))

node_user -->|"uses"| node_web
node_web -->|"credentialed API calls"| node_routes
node_routes -->|"routes auth"| node_auth
node_routes -->|"routes requests"| node_requests
node_auth -->|"authenticates"| node_user_model
node_requests -->|"validates listing"| node_list_validation
node_requests -->|"validates creation"| node_create_validation
node_requests -->|"validates status"| node_status_validation
node_requests -->|"queries and saves"| node_request_model
node_requests -->|"delegates transition"| node_status_service
node_requests -->|"serializes request"| node_request_resource
node_requests -->|"serializes history"| node_history_resource
node_status_service -->|"updates status"| node_request_model
node_status_service -->|"inserts history"| node_history_model
node_status_service -->|"checks transitions"| node_status_rules
node_status_service -->|"raises conflicts"| node_conflict
node_request_model -->|"has histories"| node_history_model
node_user_model -->|"owns requests"| node_request_model
node_request_model -->|"persists records"| node_database
node_history_model -->|"persists history"| node_database
node_user_model -->|"persists users"| node_database

click node_web "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/lib/api.ts"
click node_login "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/login/page.tsx"
click node_dashboard "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/dashboard/page.tsx"
click node_request_list "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/page.tsx"
click node_request_create "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/create/page.tsx"
click node_request_detail "https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/%5Bid%5D/page.tsx"
click node_routes "https://github.com/naveesha99/service-request-tracker/blob/master/backend/routes/api.php"
click node_auth "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Controllers/Api/AuthController.php"
click node_requests "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Controllers/Api/ServiceRequestController.php"
click node_list_validation "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/ListServiceRequestsRequest.php"
click node_create_validation "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/StoreServiceRequestRequest.php"
click node_status_validation "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/UpdateRequestStatusRequest.php"
click node_request_resource "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Resources/ServiceRequestResource.php"
click node_history_resource "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Resources/RequestStatusHistoryResource.php"
click node_status_service "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Services/RequestStatusService.php"
click node_status_rules "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Enums/ServiceRequestStatus.php"
click node_priority_rules "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Enums/ServiceRequestPriority.php"
click node_conflict "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Exceptions/RequestStatusConflictException.php"
click node_user_model "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/User.php"
click node_request_model "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/ServiceRequest.php"
click node_history_model "https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/RequestStatusHistory.php"

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_web,node_login,node_dashboard,node_request_list,node_request_create,node_request_detail,node_user toneBlue
class node_routes,node_auth,node_requests,node_list_validation,node_create_validation,node_status_validation,node_request_resource,node_history_resource toneAmber
class node_status_service,node_status_rules,node_priority_rules,node_conflict toneMint
class node_user_model,node_request_model,node_history_model,node_database toneRose
```

## Components

### Web interface

- [Next.js app](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Login page](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/login/page.tsx): `frontend/src/app/login/page.tsx`
- [Dashboard](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/dashboard/page.tsx): `frontend/src/app/dashboard/page.tsx`
- [Request list](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/page.tsx): `frontend/src/app/requests/page.tsx`
- [Create request](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/create/page.tsx): `frontend/src/app/requests/create/page.tsx`
- [Request detail](https://github.com/naveesha99/service-request-tracker/blob/master/frontend/src/app/requests/%5Bid%5D/page.tsx): `frontend/src/app/requests/[id]/page.tsx`

### Laravel API

- [API routes](https://github.com/naveesha99/service-request-tracker/blob/master/backend/routes/api.php): `backend/routes/api.php`
- [Authentication API](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Controllers/Api/AuthController.php): `backend/app/Http/Controllers/Api/AuthController.php`
- [Request API](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Controllers/Api/ServiceRequestController.php): `backend/app/Http/Controllers/Api/ServiceRequestController.php`
- [List validation](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/ListServiceRequestsRequest.php): `backend/app/Http/Requests/ListServiceRequestsRequest.php`
- [Create validation](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/StoreServiceRequestRequest.php): `backend/app/Http/Requests/StoreServiceRequestRequest.php`
- [Status validation](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Requests/UpdateRequestStatusRequest.php): `backend/app/Http/Requests/UpdateRequestStatusRequest.php`
- [Request serializer](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Resources/ServiceRequestResource.php): `backend/app/Http/Resources/ServiceRequestResource.php`
- [History serializer](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Http/Resources/RequestStatusHistoryResource.php): `backend/app/Http/Resources/RequestStatusHistoryResource.php`

### Request domain

- [Status workflow](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Services/RequestStatusService.php): `backend/app/Services/RequestStatusService.php`
- [Status and priority](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Enums/ServiceRequestStatus.php): `backend/app/Enums/ServiceRequestStatus.php`
- [Priority values](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Enums/ServiceRequestPriority.php): `backend/app/Enums/ServiceRequestPriority.php`
- [Conflict errors](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Exceptions/RequestStatusConflictException.php): `backend/app/Exceptions/RequestStatusConflictException.php`

### Persistence

- [User model](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/User.php): `backend/app/Models/User.php`
- [Service request](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/ServiceRequest.php): `backend/app/Models/ServiceRequest.php`
- [Status history](https://github.com/naveesha99/service-request-tracker/blob/master/backend/app/Models/RequestStatusHistory.php): `backend/app/Models/RequestStatusHistory.php`
- **SQLite database**

### Other components

- **User**

## Connections

- User → Next.js app: uses (evidence: `README.md`)
- Next.js app → API routes: credentialed API calls (evidence: `README.md`)
- API routes → Authentication API: routes auth (evidence: `backend/routes/api.php`)
- API routes → Request API: routes requests (evidence: `backend/routes/api.php`)
- Authentication API → User model: authenticates (evidence: `backend/app/Http/Controllers/Api/AuthController.php`)
- Request API → List validation: validates listing (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → Create validation: validates creation (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → Status validation: validates status (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → Service request: queries and saves (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → Status workflow: delegates transition (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → Request serializer: serializes request (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Request API → History serializer: serializes history (evidence: `backend/app/Http/Controllers/Api/ServiceRequestController.php`)
- Status workflow → Service request: updates status (evidence: `backend/app/Services/RequestStatusService.php`)
- Status workflow → Status history: inserts history (evidence: `backend/app/Services/RequestStatusService.php`)
- Status workflow → Status and priority: checks transitions (evidence: `backend/app/Services/RequestStatusService.php`)
- Status workflow → Conflict errors: raises conflicts (evidence: `backend/app/Services/RequestStatusService.php`)
- Service request → Status history: has histories (evidence: `backend/app/Models/ServiceRequest.php`)
- User model → Service request: owns requests (evidence: `backend/app/Models/User.php`)
- Service request → SQLite database: persists records (evidence: `README.md`)
- Status history → SQLite database: persists history (evidence: `README.md`)
- User model → SQLite database: persists users (evidence: `README.md`)
