# nttlinh100205-ctrl/student-support-ticketing-system architecture

> Architecture diagram of the GitHub repository nttlinh100205-ctrl/student-support-ticketing-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nttlinh100205-ctrl/student-support-ticketing-system
- Repository: https://github.com/nttlinh100205-ctrl/student-support-ticketing-system

## Overview

This Laravel application supports student help requests: users submit requests, and staff, department heads, or administrators assign and move them through a status workflow. It exposes both API and session-backed web interfaces, with account/profile administration alongside request handling. The workflow service centralizes request creation, assignment, status transitions, and cancellation. The graph reflects sampled controllers and service code plus the source index; unsampled route and view details are represented only where indexed or explicitly shown.

Main entry points: [`app/Http/Controllers/Api/RequestController.php`](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/RequestController.php) (Request API), [`app/Models/SupportRequest.php`](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/SupportRequest.php) (Support requests), [`routes/api.php`](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/routes/api.php) (API routes), [`app/Http/Controllers/Web/RequestWebController.php`](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Web/RequestWebController.php) (Request web UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Interfaces"]
  node_api_routes["API routes<br/>[api.php]"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_request_views["Request pages"]
end

subgraph group_identity["Identity &amp; access"]
  node_api_auth["Authentication API<br/>[AuthController.php]"]
  node_profile["User profile API"]
  node_auth_context["Auth context<br/>[AuthContext.php]"]
  node_sanctum_auth["Sanctum identity"]
  node_auth_binding["Auth binding"]
  node_users["User accounts<br/>[User.php]"]
end

subgraph group_requests["Request workflow"]
  node_api_requests["Request API"]
  node_web_requests["Request web UI"]
  node_workflow["Workflow service"]
  node_support_request["Support requests<br/>[SupportRequest.php]"]
  node_status_history["Status history"]
  node_status_enum["Request states<br/>[RequestStatus.php]"]
  node_priority_enum["Request priorities"]
  node_request_resource["Request response resource"]
  node_api_response["API response helper<br/>[ApiResponse.php]"]
end

subgraph group_accounts["Account administration"]
  node_admin_users["Admin user controls"]
end

node_client(("API client"))
node_browser(("Web user"))

node_client -->|"calls"| node_api_routes
node_api_routes -->|"routes to"| node_api_auth
node_api_routes -->|"routes to"| node_profile
node_api_routes -->|"routes to"| node_admin_users
node_api_routes -->|"routes to"| node_api_requests
node_browser -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_web_requests
node_api_auth -->|"creates and reads"| node_users
node_admin_users -->|"manages"| node_users
node_auth_binding -->|"binds"| node_auth_context
node_auth_binding -->|"binds"| node_sanctum_auth
node_sanctum_auth -->|"implements"| node_auth_context
node_sanctum_auth -->|"resolves user"| node_users
node_api_requests -->|"checks identity"| node_auth_context
node_api_requests -->|"delegates changes"| node_workflow
node_api_requests -->|"queries requests"| node_support_request
node_api_requests -->|"formats results"| node_request_resource
node_api_requests -->|"wraps responses"| node_api_response
node_web_requests -->|"delegates changes"| node_workflow
node_web_requests -->|"queries requests"| node_support_request
node_web_requests -->|"renders"| node_request_views
node_workflow -->|"creates and updates"| node_support_request
node_workflow -->|"records changes"| node_status_history
node_support_request -->|"has histories"| node_status_history
node_support_request -->|"casts status"| node_status_enum
node_support_request -->|"casts priority"| node_priority_enum

click node_api_routes "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/routes/api.php"
click node_web_routes "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/routes/web.php"
click node_api_auth "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_profile "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/ProfileController.php"
click node_auth_context "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Contracts/AuthContext.php"
click node_sanctum_auth "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Services/Auth/SanctumAuthContext.php"
click node_auth_binding "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Providers/AuthContextServiceProvider.php"
click node_users "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/User.php"
click node_admin_users "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/AdminUserController.php"
click node_api_requests "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/RequestController.php"
click node_web_requests "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Web/RequestWebController.php"
click node_request_views "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/tree/main/resources/views/requests"
click node_workflow "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Services/RequestWorkflowService.php"
click node_support_request "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/SupportRequest.php"
click node_status_history "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/RequestStatusHistory.php"
click node_status_enum "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Enums/RequestStatus.php"
click node_priority_enum "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Enums/RequestPriority.php"
click node_request_resource "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Resources/SupportRequestResource.php"
click node_api_response "https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Responses/ApiResponse.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_api_routes,node_web_routes,node_request_views,node_client,node_browser toneBlue
class node_api_auth,node_profile,node_auth_context,node_sanctum_auth,node_auth_binding,node_users toneAmber
class node_api_requests,node_web_requests,node_workflow,node_support_request,node_status_history,node_status_enum,node_priority_enum,node_request_resource,node_api_response toneMint
class node_admin_users toneRose
```

## Components

### Interfaces

- [API routes](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/routes/api.php): `routes/api.php`
- [Web routes](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/routes/web.php): `routes/web.php`
- [Request pages](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/tree/main/resources/views/requests): `resources/views/requests`

### Identity & access

- [Authentication API](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [User profile API](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/ProfileController.php): `app/Http/Controllers/Api/ProfileController.php`
- [Auth context](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Contracts/AuthContext.php): `app/Contracts/AuthContext.php`
- [Sanctum identity](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Services/Auth/SanctumAuthContext.php): `app/Services/Auth/SanctumAuthContext.php`
- [Auth binding](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Providers/AuthContextServiceProvider.php): `app/Providers/AuthContextServiceProvider.php`
- [User accounts](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/User.php): `app/Models/User.php`

### Request workflow

- [Request API](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/RequestController.php): `app/Http/Controllers/Api/RequestController.php`
- [Request web UI](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Web/RequestWebController.php): `app/Http/Controllers/Web/RequestWebController.php`
- [Workflow service](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Services/RequestWorkflowService.php): `app/Services/RequestWorkflowService.php`
- [Support requests](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/SupportRequest.php): `app/Models/SupportRequest.php`
- [Status history](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Models/RequestStatusHistory.php): `app/Models/RequestStatusHistory.php`
- [Request states](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Enums/RequestStatus.php): `app/Enums/RequestStatus.php`
- [Request priorities](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Enums/RequestPriority.php): `app/Enums/RequestPriority.php`
- [Request response resource](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Resources/SupportRequestResource.php): `app/Http/Resources/SupportRequestResource.php`
- [API response helper](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Responses/ApiResponse.php): `app/Http/Responses/ApiResponse.php`

### Account administration

- [Admin user controls](https://github.com/nttlinh100205-ctrl/student-support-ticketing-system/blob/main/app/Http/Controllers/Api/AdminUserController.php): `app/Http/Controllers/Api/AdminUserController.php`

### Other components

- **API client**
- **Web user**

## Connections

- API client → API routes: calls (evidence: `routes/api.php`)
- API routes → Authentication API: routes to (evidence: `routes/api.php`)
- API routes → User profile API: routes to (evidence: `routes/api.php`)
- API routes → Admin user controls: routes to (evidence: `routes/api.php`)
- API routes → Request API: routes to (evidence: `routes/api.php`)
- Web user → Web routes: uses (evidence: `routes/web.php`)
- Web routes → Request web UI: routes to (evidence: `routes/web.php`)
- Authentication API → User accounts: creates and reads (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Admin user controls → User accounts: manages (evidence: `app/Http/Controllers/Api/AdminUserController.php`)
- Auth binding → Auth context: binds (evidence: `app/Providers/AuthContextServiceProvider.php`)
- Auth binding → Sanctum identity: binds (evidence: `app/Providers/AuthContextServiceProvider.php`)
- Sanctum identity → Auth context: implements (evidence: `app/Services/Auth/SanctumAuthContext.php`)
- Sanctum identity → User accounts: resolves user (evidence: `app/Services/Auth/SanctumAuthContext.php`)
- Request API → Auth context: checks identity (evidence: `app/Http/Controllers/Api/RequestController.php`)
- Request API → Workflow service: delegates changes (evidence: `app/Http/Controllers/Api/RequestController.php`)
- Request API → Support requests: queries requests (evidence: `app/Http/Controllers/Api/RequestController.php`)
- Request API → Request response resource: formats results (evidence: `app/Http/Controllers/Api/RequestController.php`)
- Request API → API response helper: wraps responses (evidence: `app/Http/Controllers/Api/RequestController.php`)
- Request web UI → Workflow service: delegates changes (evidence: `app/Http/Controllers/Web/RequestWebController.php`)
- Request web UI → Support requests: queries requests (evidence: `app/Http/Controllers/Web/RequestWebController.php`)
- Request web UI → Request pages: renders (evidence: `app/Http/Controllers/Web/RequestWebController.php`)
- Workflow service → Support requests: creates and updates (evidence: `app/Services/RequestWorkflowService.php`)
- Workflow service → Status history: records changes (evidence: `app/Services/RequestWorkflowService.php`)
- Support requests → Status history: has histories (evidence: `app/Models/SupportRequest.php`)
- Support requests → Request states: casts status (evidence: `app/Models/SupportRequest.php`)
- Support requests → Request priorities: casts priority (evidence: `app/Models/SupportRequest.php`)
