# diegojrq/laravued architecture

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

- Interactive diagram: https://gitdiagram.com/diegojrq/laravued
- Repository: https://github.com/diegojrq/laravued

## Overview

LaraVueD is a Vue frontend backed by a Laravel REST API. Users navigate the interface to register or log in, obtain OAuth tokens, and access the home and user-management areas; the API also supports user listing, search, editing, and deletion. The backend separates request handling, authentication and user services, repositories, and the User model. The README documents logout and PostgreSQL; some frontend-to-feature wiring is not visible in the sampled source, so those links are omitted or marked unverified.

Main entry points: [`backend/routes/api-v1.php`](https://github.com/diegojrq/laravued/blob/master/backend/routes/api-v1.php) (API routes), [`backend/app/Http/Controllers/Auth/AuthController.php`](https://github.com/diegojrq/laravued/blob/master/backend/app/Http/Controllers/Auth/AuthController.php) (Auth controller), [`backend/app/Services/AuthService.php`](https://github.com/diegojrq/laravued/blob/master/backend/app/Services/AuthService.php) (Auth service), [`backend/app/Repositories/UserRepository.php`](https://github.com/diegojrq/laravued/blob/master/backend/app/Repositories/UserRepository.php) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Vue frontend"]
  node_vue_app["Vue app<br/>[main.js]"]
  node_navigation["Navigation<br/>[index.js]"]
  node_auth_views["Auth screens"]
  node_user_views["User screens"]
  node_home_view["Home screen<br/>[Home.vue]"]
  node_auth_store["Auth state<br/>[auth.js]"]
  node_auth_client["Auth client<br/>[auth.service.js]"]
  node_user_client["User client<br/>[user.service.js]"]
  node_http_client["HTTP client<br/>[api.js]"]
end

subgraph group_api["Laravel API"]
  node_api_routes["API routes<br/>[api-v1.php]"]
  node_auth_controller["Auth controller<br/>[AuthController.php]"]
  node_auth_requests["Auth requests"]
  node_user_controller["User controller<br/>[UserController.php]"]
end

subgraph group_domain["User domain"]
  node_auth_service["Auth service<br/>[AuthService.php]"]
  node_user_service["User service<br/>[UserService.php]"]
  node_user_repository["User repository<br/>[UserRepository.php]"]
  node_repository_base["Repository base<br/>[BaseRepository.php]"]
  node_user_model["User model<br/>[User.php]"]
end

subgraph group_infra["External services"]
  node_passport{{"Laravel Passport"}}
  node_postgres[("PostgreSQL")]
end

node_visitor(("User"))

node_visitor -->|"uses"| node_vue_app
node_vue_app -->|"installs"| node_navigation
node_visitor -.->|"navigates"| node_navigation
node_auth_views -.->|"uses"| node_auth_client
node_user_views -.->|"uses"| node_user_client
node_auth_views -.->|"updates"| node_auth_store
node_auth_client -->|"uses"| node_http_client
node_user_client -->|"calls"| node_http_client
node_http_client -.->|"sends API requests"| node_api_routes
node_api_routes -->|"routes to"| node_auth_controller
node_api_routes -->|"routes to"| node_user_controller
node_auth_controller -->|"validates with"| node_auth_requests
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"creates and queries"| node_user_model
node_auth_service -->|"requests OAuth tokens"| node_passport
node_user_controller -->|"delegates to"| node_user_service
node_user_service -->|"queries users"| node_user_repository
node_user_repository -->|"extends"| node_repository_base
node_user_repository -->|"builds queries"| node_user_model
node_user_model -.->|"persists through ORM"| node_postgres
node_home_view -.->|"shown by"| node_navigation

click node_vue_app "https://github.com/diegojrq/laravued/blob/master/frontend/src/main.js"
click node_navigation "https://github.com/diegojrq/laravued/blob/master/frontend/src/router/index.js"
click node_auth_views "https://github.com/diegojrq/laravued/tree/master/frontend/src/components/auth"
click node_user_views "https://github.com/diegojrq/laravued/tree/master/frontend/src/components/admin/users"
click node_home_view "https://github.com/diegojrq/laravued/blob/master/frontend/src/components/Home.vue"
click node_auth_store "https://github.com/diegojrq/laravued/blob/master/frontend/src/stores/auth.js"
click node_auth_client "https://github.com/diegojrq/laravued/blob/master/frontend/src/services/auth.service.js"
click node_user_client "https://github.com/diegojrq/laravued/blob/master/frontend/src/services/user.service.js"
click node_http_client "https://github.com/diegojrq/laravued/blob/master/frontend/src/services/api.js"
click node_api_routes "https://github.com/diegojrq/laravued/blob/master/backend/routes/api-v1.php"
click node_auth_controller "https://github.com/diegojrq/laravued/blob/master/backend/app/Http/Controllers/Auth/AuthController.php"
click node_auth_requests "https://github.com/diegojrq/laravued/tree/master/backend/app/Http/Requests"
click node_user_controller "https://github.com/diegojrq/laravued/blob/master/backend/app/Http/Controllers/UserController.php"
click node_auth_service "https://github.com/diegojrq/laravued/blob/master/backend/app/Services/AuthService.php"
click node_user_service "https://github.com/diegojrq/laravued/blob/master/backend/app/Services/UserService.php"
click node_user_repository "https://github.com/diegojrq/laravued/blob/master/backend/app/Repositories/UserRepository.php"
click node_repository_base "https://github.com/diegojrq/laravued/blob/master/backend/app/Repositories/BaseRepository.php"
click node_user_model "https://github.com/diegojrq/laravued/blob/master/backend/app/Models/User.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_vue_app,node_navigation,node_auth_views,node_user_views,node_home_view,node_auth_store,node_auth_client,node_user_client,node_http_client,node_visitor toneBlue
class node_api_routes,node_auth_controller,node_auth_requests,node_user_controller toneAmber
class node_auth_service,node_user_service,node_user_repository,node_repository_base,node_user_model toneMint
class node_passport,node_postgres toneRose
```

## Components

### Vue frontend

- [Vue app](https://github.com/diegojrq/laravued/blob/master/frontend/src/main.js): `frontend/src/main.js`
- [Navigation](https://github.com/diegojrq/laravued/blob/master/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Auth screens](https://github.com/diegojrq/laravued/tree/master/frontend/src/components/auth): `frontend/src/components/auth`
- [User screens](https://github.com/diegojrq/laravued/tree/master/frontend/src/components/admin/users): `frontend/src/components/admin/users`
- [Home screen](https://github.com/diegojrq/laravued/blob/master/frontend/src/components/Home.vue): `frontend/src/components/Home.vue`
- [Auth state](https://github.com/diegojrq/laravued/blob/master/frontend/src/stores/auth.js): `frontend/src/stores/auth.js`
- [Auth client](https://github.com/diegojrq/laravued/blob/master/frontend/src/services/auth.service.js): `frontend/src/services/auth.service.js`
- [User client](https://github.com/diegojrq/laravued/blob/master/frontend/src/services/user.service.js): `frontend/src/services/user.service.js`
- [HTTP client](https://github.com/diegojrq/laravued/blob/master/frontend/src/services/api.js): `frontend/src/services/api.js`

### Laravel API

- [API routes](https://github.com/diegojrq/laravued/blob/master/backend/routes/api-v1.php): `backend/routes/api-v1.php`
- [Auth controller](https://github.com/diegojrq/laravued/blob/master/backend/app/Http/Controllers/Auth/AuthController.php): `backend/app/Http/Controllers/Auth/AuthController.php`
- [Auth requests](https://github.com/diegojrq/laravued/tree/master/backend/app/Http/Requests): `backend/app/Http/Requests`
- [User controller](https://github.com/diegojrq/laravued/blob/master/backend/app/Http/Controllers/UserController.php): `backend/app/Http/Controllers/UserController.php`

### User domain

- [Auth service](https://github.com/diegojrq/laravued/blob/master/backend/app/Services/AuthService.php): `backend/app/Services/AuthService.php`
- [User service](https://github.com/diegojrq/laravued/blob/master/backend/app/Services/UserService.php): `backend/app/Services/UserService.php`
- [User repository](https://github.com/diegojrq/laravued/blob/master/backend/app/Repositories/UserRepository.php): `backend/app/Repositories/UserRepository.php`
- [Repository base](https://github.com/diegojrq/laravued/blob/master/backend/app/Repositories/BaseRepository.php): `backend/app/Repositories/BaseRepository.php`
- [User model](https://github.com/diegojrq/laravued/blob/master/backend/app/Models/User.php): `backend/app/Models/User.php`

### External services

- **Laravel Passport**
- **PostgreSQL**

### Other components

- **User**

## Connections

- User → Vue app: uses
- Vue app → Navigation: installs (evidence: `frontend/src/main.js`)
- User → Navigation: navigates
- Auth screens → Auth client: uses
- User screens → User client: uses
- Auth screens → Auth state: updates
- Auth client → HTTP client: uses (evidence: `frontend/src/services/auth.service.js`)
- User client → HTTP client: calls (evidence: `frontend/src/services/user.service.js`)
- HTTP client → API routes: sends API requests
- API routes → Auth controller: routes to (evidence: `backend/routes/api-v1.php`)
- API routes → User controller: routes to (evidence: `backend/routes/api-v1.php`)
- Auth controller → Auth requests: validates with (evidence: `backend/app/Http/Controllers/Auth/AuthController.php`)
- Auth controller → Auth service: delegates to (evidence: `backend/app/Http/Controllers/Auth/AuthController.php`)
- Auth service → User model: creates and queries (evidence: `backend/app/Services/AuthService.php`)
- Auth service → Laravel Passport: requests OAuth tokens (evidence: `backend/app/Services/AuthService.php`)
- User controller → User service: delegates to (evidence: `backend/app/Http/Controllers/UserController.php`)
- User service → User repository: queries users (evidence: `backend/app/Services/UserService.php`)
- User repository → Repository base: extends (evidence: `backend/app/Repositories/UserRepository.php`)
- User repository → User model: builds queries (evidence: `backend/app/Repositories/UserRepository.php`)
- User model → PostgreSQL: persists through ORM
- Home screen → Navigation: shown by
