# esquitef/senderosdepiel architecture

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

- Interactive diagram: https://gitdiagram.com/esquitef/senderosdepiel
- Repository: https://github.com/esquitef/senderosdepiel

## Overview

This is a Laravel handbag catalog and inventory/sales application, with public browsing, administrator inventory management and sales-economy reporting, plus account registration, login and profile management. The public flow is a visitor reaching catalog or category pages; the admin flow manages Bolsa records, uploads images to Cloudinary, records sold items as Venta records, and calculates sales totals. Laravel routes dispatch to controllers, which use Eloquent models and return Blade views. Route declarations and some view/controller relationships are supported by the index or excerpts; other unsampled details are omitted.

Main entry points: [`app/Http/Controllers/AdminBolsaController.php`](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/AdminBolsaController.php) (Inventory admin), [`routes/auth.php`](https://github.com/esquitef/senderosdepiel/blob/master/routes/auth.php) (Auth routes), [`app/Http/Controllers/BolsaController.php`](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/BolsaController.php) (Catalog controller), [`routes/web.php`](https://github.com/esquitef/senderosdepiel/blob/master/routes/web.php) (Web routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Catalog browsing"]
  node_catalog["Catalog controller"]
  node_catalog_views["Catalog pages<br/>[index.blade.php]"]
  node_category_view["Category pages"]
  node_sections_view["Section pages"]
end

subgraph group_admin["Inventory and sales"]
  node_bolsa_model[("Bag inventory<br/>[Bolsa.php]")]
  node_admin_controller["Inventory admin"]
  node_admin_views["Admin pages<br/>[index.blade.php]"]
  node_economy_view["Sales report<br/>[economia.blade.php]"]
  node_venta_model[("Sales records<br/>[Venta.php]")]
  node_cloudinary["Cloudinary images"]
end

subgraph group_accounts["Accounts and profiles"]
  node_registration["Registration"]
  node_login["Session login"]
  node_login_request["Login validation<br/>[LoginRequest.php]"]
  node_email_notice["Verification prompt"]
  node_email_verify["Verify email"]
  node_email_notify["Verification notice"]
  node_user_model[("User account<br/>[User.php]")]
  node_profile["Profile management"]
  node_profile_request["Profile validation"]
  node_profile_view["Profile page<br/>[edit.blade.php]"]
  node_auth_views["Account pages<br/>[login.blade.php]"]
end

subgraph group_runtime["Laravel runtime"]
  node_web_entry["Web routes<br/>[web.php]"]
  node_auth_routes["Auth routes<br/>[auth.php]"]
  node_public_entry["HTTP entry<br/>[index.php]"]
  node_bootstrap["App bootstrap<br/>[app.php]"]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))

node_visitor -->|"requests pages"| node_public_entry
node_administrator -->|"requests admin"| node_public_entry
node_public_entry -->|"loads app"| node_bootstrap
node_bootstrap -->|"registers routes"| node_web_entry
node_web_entry -->|"dispatches catalog"| node_catalog
node_web_entry -->|"dispatches admin"| node_admin_controller
node_catalog -->|"queries inventory"| node_bolsa_model
node_catalog -->|"renders catalog"| node_catalog_views
node_catalog -->|"renders category"| node_category_view
node_catalog -->|"renders sections"| node_sections_view
node_admin_controller -->|"manages inventory"| node_bolsa_model
node_admin_controller -->|"records sales"| node_venta_model
node_admin_controller -->|"renders admin"| node_admin_views
node_admin_controller -->|"renders report"| node_economy_view
node_admin_controller -->|"uploads images"| node_cloudinary
node_auth_routes -->|"dispatches registration"| node_registration
node_auth_routes -->|"dispatches login"| node_login
node_auth_routes -->|"dispatches prompt"| node_email_notice
node_auth_routes -->|"dispatches verification"| node_email_verify
node_auth_routes -->|"dispatches notice"| node_email_notify
node_web_entry -->|"loads auth routes"| node_auth_routes
node_registration -->|"creates account"| node_user_model
node_login -->|"authenticates through"| node_login_request
node_login -->|"renders login"| node_auth_views
node_profile -->|"validates update"| node_profile_request
node_profile -->|"renders profile"| node_profile_view
node_profile_request -->|"validates account data"| node_user_model

click node_web_entry "https://github.com/esquitef/senderosdepiel/blob/master/routes/web.php"
click node_auth_routes "https://github.com/esquitef/senderosdepiel/blob/master/routes/auth.php"
click node_public_entry "https://github.com/esquitef/senderosdepiel/blob/master/public/index.php"
click node_bootstrap "https://github.com/esquitef/senderosdepiel/blob/master/bootstrap/app.php"
click node_catalog "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/BolsaController.php"
click node_catalog_views "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/index.blade.php"
click node_category_view "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/categoria.blade.php"
click node_sections_view "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/secciones.blade.php"
click node_bolsa_model "https://github.com/esquitef/senderosdepiel/blob/master/app/Models/Bolsa.php"
click node_admin_controller "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/AdminBolsaController.php"
click node_admin_views "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/admin/index.blade.php"
click node_economy_view "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/admin/economia.blade.php"
click node_venta_model "https://github.com/esquitef/senderosdepiel/blob/master/app/Models/Venta.php"
click node_registration "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_login "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_login_request "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Requests/Auth/LoginRequest.php"
click node_email_notice "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/EmailVerificationPromptController.php"
click node_email_verify "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/VerifyEmailController.php"
click node_email_notify "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/EmailVerificationNotificationController.php"
click node_user_model "https://github.com/esquitef/senderosdepiel/blob/master/app/Models/User.php"
click node_profile "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/ProfileController.php"
click node_profile_request "https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Requests/ProfileUpdateRequest.php"
click node_profile_view "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/profile/edit.blade.php"
click node_auth_views "https://github.com/esquitef/senderosdepiel/blob/master/resources/views/auth/login.blade.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_catalog,node_catalog_views,node_category_view,node_sections_view toneBlue
class node_bolsa_model,node_admin_controller,node_admin_views,node_economy_view,node_venta_model,node_cloudinary toneAmber
class node_registration,node_login,node_login_request,node_email_notice,node_email_verify,node_email_notify,node_user_model,node_profile,node_profile_request,node_profile_view,node_auth_views toneMint
class node_web_entry,node_auth_routes,node_public_entry,node_bootstrap toneRose
class node_visitor,node_administrator toneIndigo
```

## Components

### Catalog browsing

- [Catalog controller](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/BolsaController.php): `app/Http/Controllers/BolsaController.php`
- [Catalog pages](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/index.blade.php): `resources/views/index.blade.php`
- [Category pages](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/categoria.blade.php): `resources/views/categoria.blade.php`
- [Section pages](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/secciones.blade.php): `resources/views/secciones.blade.php`

### Inventory and sales

- [Bag inventory](https://github.com/esquitef/senderosdepiel/blob/master/app/Models/Bolsa.php): `app/Models/Bolsa.php`
- [Inventory admin](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/AdminBolsaController.php): `app/Http/Controllers/AdminBolsaController.php`
- [Admin pages](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/admin/index.blade.php): `resources/views/admin/index.blade.php`
- [Sales report](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/admin/economia.blade.php): `resources/views/admin/economia.blade.php`
- [Sales records](https://github.com/esquitef/senderosdepiel/blob/master/app/Models/Venta.php): `app/Models/Venta.php`
- **Cloudinary images**

### Accounts and profiles

- [Registration](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/RegisteredUserController.php): `app/Http/Controllers/Auth/RegisteredUserController.php`
- [Session login](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Login validation](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Requests/Auth/LoginRequest.php): `app/Http/Requests/Auth/LoginRequest.php`
- [Verification prompt](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/EmailVerificationPromptController.php): `app/Http/Controllers/Auth/EmailVerificationPromptController.php`
- [Verify email](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/VerifyEmailController.php): `app/Http/Controllers/Auth/VerifyEmailController.php`
- [Verification notice](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/Auth/EmailVerificationNotificationController.php): `app/Http/Controllers/Auth/EmailVerificationNotificationController.php`
- [User account](https://github.com/esquitef/senderosdepiel/blob/master/app/Models/User.php): `app/Models/User.php`
- [Profile management](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Controllers/ProfileController.php): `app/Http/Controllers/ProfileController.php`
- [Profile validation](https://github.com/esquitef/senderosdepiel/blob/master/app/Http/Requests/ProfileUpdateRequest.php): `app/Http/Requests/ProfileUpdateRequest.php`
- [Profile page](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/profile/edit.blade.php): `resources/views/profile/edit.blade.php`
- [Account pages](https://github.com/esquitef/senderosdepiel/blob/master/resources/views/auth/login.blade.php): `resources/views/auth/login.blade.php`

### Laravel runtime

- [Web routes](https://github.com/esquitef/senderosdepiel/blob/master/routes/web.php): `routes/web.php`
- [Auth routes](https://github.com/esquitef/senderosdepiel/blob/master/routes/auth.php): `routes/auth.php`
- [HTTP entry](https://github.com/esquitef/senderosdepiel/blob/master/public/index.php): `public/index.php`
- [App bootstrap](https://github.com/esquitef/senderosdepiel/blob/master/bootstrap/app.php): `bootstrap/app.php`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → HTTP entry: requests pages (evidence: `public/index.php`)
- Administrator → HTTP entry: requests admin (evidence: `public/index.php`)
- HTTP entry → App bootstrap: loads app (evidence: `public/index.php`)
- App bootstrap → Web routes: registers routes (evidence: `bootstrap/app.php`)
- Web routes → Catalog controller: dispatches catalog (evidence: `routes/web.php`)
- Web routes → Inventory admin: dispatches admin (evidence: `routes/web.php`)
- Catalog controller → Bag inventory: queries inventory (evidence: `app/Http/Controllers/BolsaController.php`)
- Catalog controller → Catalog pages: renders catalog (evidence: `app/Http/Controllers/BolsaController.php`)
- Catalog controller → Category pages: renders category (evidence: `app/Http/Controllers/BolsaController.php`)
- Catalog controller → Section pages: renders sections (evidence: `app/Http/Controllers/BolsaController.php`)
- Inventory admin → Bag inventory: manages inventory (evidence: `app/Http/Controllers/AdminBolsaController.php`)
- Inventory admin → Sales records: records sales (evidence: `app/Http/Controllers/AdminBolsaController.php`)
- Inventory admin → Admin pages: renders admin (evidence: `app/Http/Controllers/AdminBolsaController.php`)
- Inventory admin → Sales report: renders report (evidence: `app/Http/Controllers/AdminBolsaController.php`)
- Inventory admin → Cloudinary images: uploads images (evidence: `app/Http/Controllers/AdminBolsaController.php`)
- Auth routes → Registration: dispatches registration (evidence: `routes/auth.php`)
- Auth routes → Session login: dispatches login (evidence: `routes/auth.php`)
- Auth routes → Verification prompt: dispatches prompt (evidence: `routes/auth.php`)
- Auth routes → Verify email: dispatches verification (evidence: `routes/auth.php`)
- Auth routes → Verification notice: dispatches notice (evidence: `routes/auth.php`)
- Web routes → Auth routes: loads auth routes (evidence: `routes/web.php`)
- Registration → User account: creates account (evidence: `app/Http/Controllers/Auth/RegisteredUserController.php`)
- Session login → Login validation: authenticates through (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Session login → Account pages: renders login (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Profile management → Profile validation: validates update (evidence: `app/Http/Controllers/ProfileController.php`)
- Profile management → Profile page: renders profile (evidence: `app/Http/Controllers/ProfileController.php`)
- Profile validation → User account: validates account data (evidence: `app/Http/Requests/ProfileUpdateRequest.php`)
