# teguhoktian/laravel11api architecture

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

- Interactive diagram: https://gitdiagram.com/teguhoktian/laravel11api
- Repository: https://github.com/teguhoktian/laravel11api

## Overview

This repository is a Laravel API starter application. Clients use authentication endpoints to register, sign in, verify email, and reset passwords; authenticated API routes then expose user, role, activity-log, general-setting, and backup operations. Controllers perform domain work and shape JSON through a shared response builder. The README also identifies Sanctum, permissions, backups, settings, and activity logging as product capabilities. Some integrations are package-provided and their internal wiring is not shown in the sampled source, so the graph limits itself to documented routes and visible calls.

Main entry points: [`routes/api.php`](https://github.com/teguhoktian/laravel11api/blob/master/routes/api.php) (API routes), [`app/APIResponseBuilder.php`](https://github.com/teguhoktian/laravel11api/blob/master/app/APIResponseBuilder.php) (JSON response builder), [`app/Http/Controllers/UserController.php`](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/UserController.php) (User management), [`app/Http/Controllers/RoleController.php`](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/RoleController.php) (Role management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_api_routes["API routes<br/>[api.php]"]
  node_auth_routes["Auth routes<br/>[auth.php]"]
  node_app_bootstrap["Laravel bootstrap<br/>[app.php]"]
  node_response_builder["JSON response builder"]
end

subgraph group_identity["Identity and access"]
  node_auth_handlers["Auth handlers"]
  node_registration["Registration"]
  node_login_request["Login validation<br/>[LoginRequest.php]"]
  node_user_model["User model<br/>[User.php]"]
  node_email_middleware["Email verification"]
end

subgraph group_admin["Administration"]
  node_user_controller["User management<br/>[UserController.php]"]
  node_role_controller["Role management<br/>[RoleController.php]"]
  node_role_model["Role model<br/>[Role.php]"]
  node_permission_model["Permission model<br/>[Permission.php]"]
  node_settings_controller["Settings API"]
  node_settings_model["General settings<br/>[GeneralSetting.php]"]
end

subgraph group_operations["Operations"]
  node_activity_controller["Activity log API"]
  node_activity_model["Activity log model<br/>[LogActivity.php]"]
  node_backup_controller["Backup API"]
  node_backup_job["Backup job"]
  node_backup_storage[("Backup destinations")]
end

node_client(("API client"))

node_client -->|"calls API"| node_api_routes
node_client -->|"calls auth"| node_auth_routes
node_app_bootstrap -->|"registers routes"| node_api_routes
node_app_bootstrap -.->|"loads via web routes"| node_auth_routes
node_auth_routes -->|"routes registration"| node_registration
node_auth_routes -->|"routes auth actions"| node_auth_handlers
node_registration -->|"creates user"| node_user_model
node_auth_handlers -->|"uses validation"| node_login_request
node_api_routes -->|"routes user operations"| node_user_controller
node_api_routes -->|"routes role operations"| node_role_controller
node_api_routes -->|"routes settings"| node_settings_controller
node_api_routes -->|"routes activity"| node_activity_controller
node_api_routes -->|"routes backups"| node_backup_controller
node_user_controller -->|"manages users"| node_user_model
node_user_controller -->|"reads pagination setting"| node_settings_model
node_role_controller -->|"manages roles"| node_role_model
node_role_controller -->|"queries permissions"| node_permission_model
node_settings_controller -->|"reads and saves"| node_settings_model
node_activity_controller -->|"queries activity"| node_activity_model
node_activity_controller -->|"uses settings"| node_settings_model
node_backup_controller -->|"dispatches job"| node_backup_job
node_backup_controller -->|"lists and streams backups"| node_backup_storage
node_user_controller -->|"formats responses"| node_response_builder
node_role_controller -->|"formats responses"| node_response_builder
node_settings_controller -->|"formats responses"| node_response_builder
node_backup_controller -->|"formats responses"| node_response_builder
node_app_bootstrap -->|"formats exceptions"| node_response_builder
node_user_model -->|"uses role permissions"| node_permission_model

click node_api_routes "https://github.com/teguhoktian/laravel11api/blob/master/routes/api.php"
click node_auth_routes "https://github.com/teguhoktian/laravel11api/blob/master/routes/auth.php"
click node_app_bootstrap "https://github.com/teguhoktian/laravel11api/blob/master/bootstrap/app.php"
click node_response_builder "https://github.com/teguhoktian/laravel11api/blob/master/app/APIResponseBuilder.php"
click node_auth_handlers "https://github.com/teguhoktian/laravel11api/tree/master/app/Http/Controllers/Auth"
click node_registration "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_login_request "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Requests/Auth/LoginRequest.php"
click node_user_model "https://github.com/teguhoktian/laravel11api/blob/master/app/Models/User.php"
click node_email_middleware "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Middleware/EnsureEmailIsVerified.php"
click node_user_controller "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/UserController.php"
click node_role_controller "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/RoleController.php"
click node_role_model "https://github.com/teguhoktian/laravel11api/blob/master/app/Models/Role.php"
click node_permission_model "https://github.com/teguhoktian/laravel11api/blob/master/app/Models/Permission.php"
click node_settings_controller "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Settings/GeneralSettingController.php"
click node_settings_model "https://github.com/teguhoktian/laravel11api/blob/master/app/Settings/GeneralSetting.php"
click node_activity_controller "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/LogActivityController.php"
click node_activity_model "https://github.com/teguhoktian/laravel11api/blob/master/app/Models/LogActivity.php"
click node_backup_controller "https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Settings/BackupController.php"
click node_backup_job "https://github.com/teguhoktian/laravel11api/blob/master/app/Jobs/CreateBackupJob.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_auth_routes,node_app_bootstrap,node_response_builder,node_client toneBlue
class node_auth_handlers,node_registration,node_login_request,node_user_model,node_email_middleware toneAmber
class node_user_controller,node_role_controller,node_role_model,node_permission_model,node_settings_controller,node_settings_model toneMint
class node_activity_controller,node_activity_model,node_backup_controller,node_backup_job,node_backup_storage toneRose
```

## Components

### API entry

- [API routes](https://github.com/teguhoktian/laravel11api/blob/master/routes/api.php): `routes/api.php`
- [Auth routes](https://github.com/teguhoktian/laravel11api/blob/master/routes/auth.php): `routes/auth.php`
- [Laravel bootstrap](https://github.com/teguhoktian/laravel11api/blob/master/bootstrap/app.php): `bootstrap/app.php`
- [JSON response builder](https://github.com/teguhoktian/laravel11api/blob/master/app/APIResponseBuilder.php): `app/APIResponseBuilder.php`

### Identity and access

- [Auth handlers](https://github.com/teguhoktian/laravel11api/tree/master/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [Registration](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Login validation](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Requests/Auth/LoginRequest.php): `app/Http/Requests/Auth/LoginRequest.php`
- [User model](https://github.com/teguhoktian/laravel11api/blob/master/app/Models/User.php): `app/Models/User.php`
- [Email verification](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Middleware/EnsureEmailIsVerified.php): `app/Http/Middleware/EnsureEmailIsVerified.php`

### Administration

- [User management](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [Role management](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/RoleController.php): `app/Http/Controllers/RoleController.php`
- [Role model](https://github.com/teguhoktian/laravel11api/blob/master/app/Models/Role.php): `app/Models/Role.php`
- [Permission model](https://github.com/teguhoktian/laravel11api/blob/master/app/Models/Permission.php): `app/Models/Permission.php`
- [Settings API](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Settings/GeneralSettingController.php): `app/Http/Controllers/Settings/GeneralSettingController.php`
- [General settings](https://github.com/teguhoktian/laravel11api/blob/master/app/Settings/GeneralSetting.php): `app/Settings/GeneralSetting.php`

### Operations

- [Activity log API](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/LogActivityController.php): `app/Http/Controllers/LogActivityController.php`
- [Activity log model](https://github.com/teguhoktian/laravel11api/blob/master/app/Models/LogActivity.php): `app/Models/LogActivity.php`
- [Backup API](https://github.com/teguhoktian/laravel11api/blob/master/app/Http/Controllers/Settings/BackupController.php): `app/Http/Controllers/Settings/BackupController.php`
- [Backup job](https://github.com/teguhoktian/laravel11api/blob/master/app/Jobs/CreateBackupJob.php): `app/Jobs/CreateBackupJob.php`
- **Backup destinations**

### Other components

- **API client**

## Connections

- API client → API routes: calls API (evidence: `routes/api.php`)
- API client → Auth routes: calls auth (evidence: `routes/auth.php`)
- Laravel bootstrap → API routes: registers routes (evidence: `bootstrap/app.php`)
- Laravel bootstrap → Auth routes: loads via web routes
- Auth routes → Registration: routes registration (evidence: `routes/auth.php`)
- Auth routes → Auth handlers: routes auth actions (evidence: `routes/auth.php`)
- Registration → User model: creates user (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Auth handlers → Login validation: uses validation (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- API routes → User management: routes user operations (evidence: `routes/api.php`)
- API routes → Role management: routes role operations (evidence: `routes/api.php`)
- API routes → Settings API: routes settings (evidence: `routes/api.php`)
- API routes → Activity log API: routes activity (evidence: `routes/api.php`)
- API routes → Backup API: routes backups (evidence: `routes/api.php`)
- User management → User model: manages users (evidence: `app/Http/Controllers/UserController.php`)
- User management → General settings: reads pagination setting (evidence: `app/Http/Controllers/UserController.php`)
- Role management → Role model: manages roles (evidence: `app/Http/Controllers/RoleController.php`)
- Role management → Permission model: queries permissions (evidence: `app/Http/Controllers/RoleController.php`)
- Settings API → General settings: reads and saves (evidence: `app/Http/Controllers/Settings/GeneralSettingController.php`)
- Activity log API → Activity log model: queries activity (evidence: `app/Http/Controllers/LogActivityController.php`)
- Activity log API → General settings: uses settings (evidence: `app/Http/Controllers/LogActivityController.php`)
- Backup API → Backup job: dispatches job (evidence: `app/Http/Controllers/Settings/BackupController.php`)
- Backup API → Backup destinations: lists and streams backups (evidence: `app/Http/Controllers/Settings/BackupController.php`)
- User management → JSON response builder: formats responses (evidence: `app/Http/Controllers/UserController.php`)
- Role management → JSON response builder: formats responses (evidence: `app/Http/Controllers/RoleController.php`)
- Settings API → JSON response builder: formats responses (evidence: `app/Http/Controllers/Settings/GeneralSettingController.php`)
- Backup API → JSON response builder: formats responses (evidence: `app/Http/Controllers/Settings/BackupController.php`)
- Laravel bootstrap → JSON response builder: formats exceptions (evidence: `bootstrap/app.php`)
- User model → Permission model: uses role permissions (evidence: `app/Models/User.php`)
