# gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado architecture

> Architecture diagram of the GitHub repository gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado
- Repository: https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado

## Overview

Sistema web Laravel para gestionar la juguetería Mundo del Juguete: autenticación por roles y operaciones de inventario, ventas, caja, abastecimiento, devoluciones y administración. El flujo principal registra un ticket de venta pendiente en el POS, luego caja lo cobra y ajusta existencias; también hay ramas de reposición y devolución. Las relaciones entre controladores y modelos se incluyen cuando el índice de fuentes o los extractos las muestran; enlaces de módulos no muestreados se documentan sin afirmar llamadas específicas.

Main entry points: [`app/Models/Venta.php`](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Venta.php) (Ventas), [`app/Models/Producto.php`](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Producto.php) (Productos y existencias), [`app/Http/Controllers/VentaController.php`](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/VentaController.php) (Punto de venta), [`app/Http/Controllers/AbastecimientoController.php`](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/AbastecimientoController.php) (Abastecimiento y recepción)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Acceso y administración"]
  node_routes["Rutas web<br/>[web.php]"]
  node_authroutes["Rutas de acceso<br/>[auth.php]"]
  node_login["Inicio de sesión"]
  node_loginrequest["Validación de acceso<br/>[LoginRequest.php]"]
  node_roles["Control por roles<br/>[CheckRole.php]"]
  node_active["Cuentas activas"]
  node_security["Cabeceras seguras"]
  node_users["Usuarios y códigos"]
  node_user[("Cuenta de usuario<br/>[User.php]")]
  node_resetmodel[("Token de restablecimiento")]
  node_dashboard["Panel y alertas"]
end

subgraph group_sales["Ventas y caja"]
  node_pos["Punto de venta"]
  node_clients[("Clientes<br/>[Cliente.php]")]
  node_salesmodel[("Ventas<br/>[Venta.php]")]
  node_saledetail[("Detalle de venta<br/>[DetalleVenta.php]")]
  node_cash["Caja y cobros<br/>[CajaController.php]"]
end

subgraph group_stock["Inventario y abastecimiento"]
  node_catalog["Catálogo e inventario"]
  node_product[("Productos y existencias<br/>[Producto.php]")]
  node_category[("Categorías<br/>[Categoria.php]")]
  node_supplier["Proveedores"]
  node_supply["Abastecimiento y recepción"]
  node_purchase[("Órdenes de compra<br/>[Compra.php]")]
  node_purchasedetail[("Detalle de compra<br/>[DetalleCompra.php]")]
  node_suppliermodel[("Proveedor registrado<br/>[Proveedor.php]")]
end

subgraph group_returns["Devoluciones"]
  node_returns["Gestión de devoluciones"]
  node_returnmodel[("Registro de devolución<br/>[Devolucion.php]")]
end

node_worker(("Personal de tienda"))
node_public(("Visitante"))

node_public -->|"solicita acceso"| node_authroutes
node_worker -->|"inicia sesión"| node_authroutes
node_authroutes -->|"dirige solicitud"| node_login
node_login -->|"autentica mediante"| node_loginrequest
node_loginrequest -.->|"valida cuenta"| node_user
node_worker -.->|"opera módulos"| node_routes
node_routes -->|"aplica rol"| node_roles
node_routes -->|"verifica actividad"| node_active
node_routes -->|"añade cabeceras"| node_security
node_users -->|"administra cuentas"| node_user
node_users -->|"gestiona códigos"| node_resetmodel
node_authroutes -.->|"redirige al panel"| node_dashboard
node_pos -->|"consulta y registra"| node_clients
node_pos -->|"consulta stock"| node_product
node_pos -->|"crea ticket pendiente"| node_salesmodel
node_pos -->|"registra líneas"| node_saledetail
node_salesmodel -->|"asocia cliente"| node_clients
node_salesmodel -->|"contiene detalles"| node_saledetail
node_cash -.->|"cobra ticket"| node_salesmodel
node_cash -.->|"actualiza existencias"| node_product
node_catalog -.->|"administra catálogo"| node_product
node_product -->|"pertenece a categoría"| node_category
node_supplier -.->|"gestiona proveedores"| node_suppliermodel
node_supply -->|"crea y recibe órdenes"| node_purchase
node_supply -->|"gestiona partidas"| node_purchasedetail
node_supply -->|"actualiza stock recibido"| node_product
node_supply -->|"consulta proveedor"| node_suppliermodel
node_purchase -->|"contiene partidas"| node_purchasedetail
node_purchase -->|"referencia proveedor"| node_suppliermodel
node_returns -->|"busca venta y valida"| node_salesmodel
node_returns -->|"ajusta existencias"| node_product
node_returns -->|"registra resolución"| node_returnmodel
node_salesmodel -->|"relaciona devoluciones"| node_returnmodel

click node_routes "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/routes/web.php"
click node_authroutes "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/routes/auth.php"
click node_login "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_loginrequest "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Requests/Auth/LoginRequest.php"
click node_roles "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/CheckRole.php"
click node_active "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/EnsureUserIsActive.php"
click node_security "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/SecurityHeaders.php"
click node_users "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/UsuarioController.php"
click node_user "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/User.php"
click node_resetmodel "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/TokenRestablecimiento.php"
click node_dashboard "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/DashboardController.php"
click node_pos "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/VentaController.php"
click node_clients "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Cliente.php"
click node_salesmodel "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Venta.php"
click node_saledetail "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/DetalleVenta.php"
click node_cash "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/CajaController.php"
click node_catalog "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/InventarioController.php"
click node_product "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Producto.php"
click node_category "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Categoria.php"
click node_supplier "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/ProveedorController.php"
click node_supply "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/AbastecimientoController.php"
click node_purchase "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Compra.php"
click node_purchasedetail "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/DetalleCompra.php"
click node_suppliermodel "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Proveedor.php"
click node_returns "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/DevolucionController.php"
click node_returnmodel "https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Devolucion.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_routes,node_authroutes,node_login,node_loginrequest,node_roles,node_active,node_security,node_users,node_user,node_resetmodel,node_dashboard toneBlue
class node_pos,node_clients,node_salesmodel,node_saledetail,node_cash toneAmber
class node_catalog,node_product,node_category,node_supplier,node_supply,node_purchase,node_purchasedetail,node_suppliermodel toneMint
class node_returns,node_returnmodel toneRose
class node_worker,node_public toneIndigo
```

## Components

### Acceso y administración

- [Rutas web](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/routes/web.php): `routes/web.php`
- [Rutas de acceso](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/routes/auth.php): `routes/auth.php`
- [Inicio de sesión](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Validación de acceso](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Requests/Auth/LoginRequest.php): `app/Http/Requests/Auth/LoginRequest.php`
- [Control por roles](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/CheckRole.php): `app/Http/Middleware/CheckRole.php`
- [Cuentas activas](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/EnsureUserIsActive.php): `app/Http/Middleware/EnsureUserIsActive.php`
- [Cabeceras seguras](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Middleware/SecurityHeaders.php): `app/Http/Middleware/SecurityHeaders.php`
- [Usuarios y códigos](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/UsuarioController.php): `app/Http/Controllers/UsuarioController.php`
- [Cuenta de usuario](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/User.php): `app/Models/User.php`
- [Token de restablecimiento](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/TokenRestablecimiento.php): `app/Models/TokenRestablecimiento.php`
- [Panel y alertas](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`

### Ventas y caja

- [Punto de venta](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/VentaController.php): `app/Http/Controllers/VentaController.php`
- [Clientes](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Cliente.php): `app/Models/Cliente.php`
- [Ventas](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Venta.php): `app/Models/Venta.php`
- [Detalle de venta](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/DetalleVenta.php): `app/Models/DetalleVenta.php`
- [Caja y cobros](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/CajaController.php): `app/Http/Controllers/CajaController.php`

### Inventario y abastecimiento

- [Catálogo e inventario](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/InventarioController.php): `app/Http/Controllers/InventarioController.php`
- [Productos y existencias](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Producto.php): `app/Models/Producto.php`
- [Categorías](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Categoria.php): `app/Models/Categoria.php`
- [Proveedores](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/ProveedorController.php): `app/Http/Controllers/ProveedorController.php`
- [Abastecimiento y recepción](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/AbastecimientoController.php): `app/Http/Controllers/AbastecimientoController.php`
- [Órdenes de compra](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Compra.php): `app/Models/Compra.php`
- [Detalle de compra](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/DetalleCompra.php): `app/Models/DetalleCompra.php`
- [Proveedor registrado](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Proveedor.php): `app/Models/Proveedor.php`

### Devoluciones

- [Gestión de devoluciones](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Http/Controllers/DevolucionController.php): `app/Http/Controllers/DevolucionController.php`
- [Registro de devolución](https://github.com/gerargram2006/sistema-de-gestion-de-para-inventario-juegeteria-avanzado/blob/main/app/Models/Devolucion.php): `app/Models/Devolucion.php`

### Other components

- **Personal de tienda**
- **Visitante**

## Connections

- Visitante → Rutas de acceso: solicita acceso (evidence: `routes/auth.php`)
- Personal de tienda → Rutas de acceso: inicia sesión (evidence: `routes/auth.php`)
- Rutas de acceso → Inicio de sesión: dirige solicitud (evidence: `routes/auth.php`)
- Inicio de sesión → Validación de acceso: autentica mediante (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Validación de acceso → Cuenta de usuario: valida cuenta
- Personal de tienda → Rutas web: opera módulos
- Rutas web → Control por roles: aplica rol
- Rutas web → Cuentas activas: verifica actividad
- Rutas web → Cabeceras seguras: añade cabeceras
- Usuarios y códigos → Cuenta de usuario: administra cuentas (evidence: `app/Http/Controllers/UsuarioController.php`)
- Usuarios y códigos → Token de restablecimiento: gestiona códigos (evidence: `app/Http/Controllers/UsuarioController.php`)
- Rutas de acceso → Panel y alertas: redirige al panel
- Punto de venta → Clientes: consulta y registra (evidence: `app/Http/Controllers/VentaController.php`)
- Punto de venta → Productos y existencias: consulta stock (evidence: `app/Http/Controllers/VentaController.php`)
- Punto de venta → Ventas: crea ticket pendiente (evidence: `app/Http/Controllers/VentaController.php`)
- Punto de venta → Detalle de venta: registra líneas (evidence: `app/Http/Controllers/VentaController.php`)
- Ventas → Clientes: asocia cliente (evidence: `app/Models/Venta.php`)
- Ventas → Detalle de venta: contiene detalles (evidence: `app/Models/Venta.php`)
- Caja y cobros → Ventas: cobra ticket
- Caja y cobros → Productos y existencias: actualiza existencias
- Catálogo e inventario → Productos y existencias: administra catálogo
- Productos y existencias → Categorías: pertenece a categoría (evidence: `app/Models/Producto.php`)
- Proveedores → Proveedor registrado: gestiona proveedores
- Abastecimiento y recepción → Órdenes de compra: crea y recibe órdenes (evidence: `app/Http/Controllers/AbastecimientoController.php`)
- Abastecimiento y recepción → Detalle de compra: gestiona partidas (evidence: `app/Http/Controllers/AbastecimientoController.php`)
- Abastecimiento y recepción → Productos y existencias: actualiza stock recibido (evidence: `app/Http/Controllers/AbastecimientoController.php`)
- Abastecimiento y recepción → Proveedor registrado: consulta proveedor (evidence: `app/Http/Controllers/AbastecimientoController.php`)
- Órdenes de compra → Detalle de compra: contiene partidas (evidence: `app/Models/Compra.php`)
- Órdenes de compra → Proveedor registrado: referencia proveedor (evidence: `app/Models/Compra.php`)
- Gestión de devoluciones → Ventas: busca venta y valida (evidence: `app/Http/Controllers/DevolucionController.php`)
- Gestión de devoluciones → Productos y existencias: ajusta existencias (evidence: `app/Http/Controllers/DevolucionController.php`)
- Gestión de devoluciones → Registro de devolución: registra resolución (evidence: `app/Http/Controllers/DevolucionController.php`)
- Ventas → Registro de devolución: relaciona devoluciones (evidence: `app/Models/Venta.php`)
