# drayer-dm/techsolutiongroups architecture

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

- Interactive diagram: https://gitdiagram.com/drayer-dm/techsolutiongroups
- Repository: https://github.com/drayer-dm/techsolutiongroups

## Overview

TechSolutionGroups is a Laravel web application for presenting IT services and managing customer projects, with session-based web accounts and a JWT-protected project REST API. Visitors browse the public site, register or sign in, then create and manage their own projects; API clients use documented CRUD endpoints. The graph also preserves the catalog, service showcase, locale handling, and API documentation capabilities. Sampled controller and route excerpts support the main web and API links; other links are included only where the README explicitly documents them.

Main entry points: [`routes/web.php`](https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/web.php) (Web routes), [`bootstrap/app.php`](https://github.com/drayer-dm/techsolutiongroups/blob/main/bootstrap/app.php) (App bootstrap), [`app/Http/Controllers/ProyectoController.php`](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/ProyectoController.php) (Web project manager), [`routes/api.php`](https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/api.php) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_marketing_pages["Marketing pages"]
  node_product_catalog["Product catalog<br/>[web.php]"]
  node_service_showcase["Services showcase"]
  node_showcase_view["Showcase view"]
end

subgraph group_accounts["Accounts and projects"]
  node_register["Registration"]
  node_session_auth["Session auth"]
  node_auth_views["Auth forms"]
  node_web_projects["Web project manager"]
  node_project_views["Project pages"]
end

subgraph group_api["Project API"]
  node_api_routes["API routes<br/>[api.php]"]
  node_api_projects["Project CRUD API"]
  node_jwt_middleware["JWT validation<br/>[JwtMiddleware.php]"]
  node_swagger["OpenAPI docs<br/>[l5-swagger.php]"]
end

subgraph group_platform["Runtime and data"]
  node_bootstrap["App bootstrap<br/>[app.php]"]
  node_locale["Locale selection<br/>[SetLocale.php]"]
  node_users["User model<br/>[Usuario.php]"]
  node_projects["Project model<br/>[Proyecto.php]"]
  node_database[("SQLite database<br/>[database.php]")]
end

node_visitor(("Visitor"))
node_api_client(("API client"))

node_visitor -->|"requests pages"| node_web_routes
node_web_routes -->|"renders pages"| node_marketing_pages
node_web_routes -->|"routes catalog"| node_product_catalog
node_web_routes -->|"dispatches services"| node_service_showcase
node_service_showcase -->|"renders showcase"| node_showcase_view
node_web_routes -->|"routes registration"| node_register
node_web_routes -->|"routes sessions"| node_session_auth
node_register -->|"renders form"| node_auth_views
node_session_auth -->|"renders form"| node_auth_views
node_register -->|"creates account"| node_users
node_web_routes -->|"routes project actions"| node_web_projects
node_web_projects -->|"renders project page"| node_project_views
node_web_projects -->|"reads and changes"| node_projects
node_web_projects -->|"uses signed-in user"| node_users
node_api_client -->|"calls endpoints"| node_api_routes
node_api_routes -->|"dispatches CRUD"| node_api_projects
node_api_projects -->|"reads and changes"| node_projects
node_api_routes -->|"protects endpoints"| node_jwt_middleware
node_jwt_middleware -->|"validates identity"| node_users
node_api_projects -->|"documents endpoints"| node_swagger
node_bootstrap -->|"loads routes"| node_web_routes
node_bootstrap -->|"loads routes"| node_api_routes
node_bootstrap -->|"registers alias"| node_jwt_middleware
node_bootstrap -->|"runs middleware"| node_locale
node_projects -.->|"persists records"| node_database
node_users -.->|"persists accounts"| node_database

click node_web_routes "https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/web.php"
click node_marketing_pages "https://github.com/drayer-dm/techsolutiongroups/tree/main/resources/views"
click node_product_catalog "https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/web.php"
click node_service_showcase "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/ServiceProjectController.php"
click node_showcase_view "https://github.com/drayer-dm/techsolutiongroups/blob/main/resources/views/servicios-proyectos.blade.php"
click node_register "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Auth/RegisterController.php"
click node_session_auth "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Auth/SessionController.php"
click node_auth_views "https://github.com/drayer-dm/techsolutiongroups/tree/main/resources/views/auth"
click node_web_projects "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/ProyectoController.php"
click node_project_views "https://github.com/drayer-dm/techsolutiongroups/blob/main/resources/views/registro-proyecto.blade.php"
click node_api_routes "https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/api.php"
click node_api_projects "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Api/ProyectoController.php"
click node_jwt_middleware "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Middleware/JwtMiddleware.php"
click node_swagger "https://github.com/drayer-dm/techsolutiongroups/blob/main/config/l5-swagger.php"
click node_bootstrap "https://github.com/drayer-dm/techsolutiongroups/blob/main/bootstrap/app.php"
click node_locale "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Middleware/SetLocale.php"
click node_users "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Models/Usuario.php"
click node_projects "https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Models/Proyecto.php"
click node_database "https://github.com/drayer-dm/techsolutiongroups/blob/main/config/database.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_routes,node_marketing_pages,node_product_catalog,node_service_showcase,node_showcase_view,node_api_client toneBlue
class node_register,node_session_auth,node_auth_views,node_web_projects,node_project_views toneAmber
class node_api_routes,node_api_projects,node_jwt_middleware,node_swagger toneMint
class node_bootstrap,node_locale,node_users,node_projects,node_database toneRose
class node_visitor toneIndigo
```

## Components

### Public site

- [Web routes](https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/web.php): `routes/web.php`
- [Marketing pages](https://github.com/drayer-dm/techsolutiongroups/tree/main/resources/views): `resources/views`
- [Product catalog](https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/web.php): `routes/web.php`
- [Services showcase](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/ServiceProjectController.php): `app/Http/Controllers/ServiceProjectController.php`
- [Showcase view](https://github.com/drayer-dm/techsolutiongroups/blob/main/resources/views/servicios-proyectos.blade.php): `resources/views/servicios-proyectos.blade.php`

### Accounts and projects

- [Registration](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Auth/RegisterController.php): `app/Http/Controllers/Auth/RegisterController.php`
- [Session auth](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Auth/SessionController.php): `app/Http/Controllers/Auth/SessionController.php`
- [Auth forms](https://github.com/drayer-dm/techsolutiongroups/tree/main/resources/views/auth): `resources/views/auth`
- [Web project manager](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/ProyectoController.php): `app/Http/Controllers/ProyectoController.php`
- [Project pages](https://github.com/drayer-dm/techsolutiongroups/blob/main/resources/views/registro-proyecto.blade.php): `resources/views/registro-proyecto.blade.php`

### Project API

- [API routes](https://github.com/drayer-dm/techsolutiongroups/blob/main/routes/api.php): `routes/api.php`
- [Project CRUD API](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Controllers/Api/ProyectoController.php): `app/Http/Controllers/Api/ProyectoController.php`
- [JWT validation](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Middleware/JwtMiddleware.php): `app/Http/Middleware/JwtMiddleware.php`
- [OpenAPI docs](https://github.com/drayer-dm/techsolutiongroups/blob/main/config/l5-swagger.php): `config/l5-swagger.php`

### Runtime and data

- [App bootstrap](https://github.com/drayer-dm/techsolutiongroups/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Locale selection](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Http/Middleware/SetLocale.php): `app/Http/Middleware/SetLocale.php`
- [User model](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Models/Usuario.php): `app/Models/Usuario.php`
- [Project model](https://github.com/drayer-dm/techsolutiongroups/blob/main/app/Models/Proyecto.php): `app/Models/Proyecto.php`
- [SQLite database](https://github.com/drayer-dm/techsolutiongroups/blob/main/config/database.php): `config/database.php`

### Other components

- **Visitor**
- **API client**

## Connections

- Visitor → Web routes: requests pages (evidence: `routes/web.php`)
- Web routes → Marketing pages: renders pages (evidence: `routes/web.php`)
- Web routes → Product catalog: routes catalog (evidence: `routes/web.php`)
- Web routes → Services showcase: dispatches services (evidence: `routes/web.php`)
- Services showcase → Showcase view: renders showcase (evidence: `app/Http/Controllers/ServiceProjectController.php`)
- Web routes → Registration: routes registration (evidence: `routes/web.php`)
- Web routes → Session auth: routes sessions (evidence: `routes/web.php`)
- Registration → Auth forms: renders form (evidence: `app/Http/Controllers/Auth/RegisterController.php`)
- Session auth → Auth forms: renders form (evidence: `app/Http/Controllers/Auth/SessionController.php`)
- Registration → User model: creates account (evidence: `app/Http/Controllers/Auth/RegisterController.php`)
- Web routes → Web project manager: routes project actions (evidence: `routes/web.php`)
- Web project manager → Project pages: renders project page (evidence: `app/Http/Controllers/ProyectoController.php`)
- Web project manager → Project model: reads and changes (evidence: `app/Http/Controllers/ProyectoController.php`)
- Web project manager → User model: uses signed-in user (evidence: `app/Http/Controllers/ProyectoController.php`)
- API client → API routes: calls endpoints (evidence: `README.md`)
- API routes → Project CRUD API: dispatches CRUD (evidence: `routes/api.php`)
- Project CRUD API → Project model: reads and changes (evidence: `app/Http/Controllers/Api/ProyectoController.php`)
- API routes → JWT validation: protects endpoints (evidence: `README.md`)
- JWT validation → User model: validates identity (evidence: `app/Http/Middleware/JwtMiddleware.php`)
- Project CRUD API → OpenAPI docs: documents endpoints (evidence: `app/Http/Controllers/Api/ProyectoController.php`)
- App bootstrap → Web routes: loads routes (evidence: `bootstrap/app.php`)
- App bootstrap → API routes: loads routes (evidence: `bootstrap/app.php`)
- App bootstrap → JWT validation: registers alias (evidence: `bootstrap/app.php`)
- App bootstrap → Locale selection: runs middleware (evidence: `bootstrap/app.php`)
- Project model → SQLite database: persists records
- User model → SQLite database: persists accounts
