# benjaminotalora222/panapp architecture

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

- Interactive diagram: https://gitdiagram.com/benjaminotalora222/panapp
- Repository: https://github.com/benjaminotalora222/panapp

## Overview

1. **Arquitectura general**
   - PanApp es una **aplicación web PHP monolítica** con estructura tipo **MVC artesanal**: `controllers/`, `models/`, `views/`, más un front controller en `public/index.php`.
   - No se ve un framework pesado; la lógica está organizada por módulos de negocio, con una separación clara entre acceso HTTP, lógica de aplicación y presentación.

2. **Punto de entrada y flujo principal**
   - El navegador entra por `public/index.php`, que funciona como **puerta de entrada** de la aplicación.
   - Desde ahí se delega a los controladores según la acción solicitada, y estos devuelven vistas dentro de `views/`.
   - Este patrón hace que el flujo típico sea: **request → controller → base de datos/lógica → view → response**.

3. **Capa de configuración y persistencia**
   - La conexión a datos se centraliza en `config/database.php`.
   - La base de datos está respaldada por el script `sql/panaderia2.sql`, lo que indica que el sistema depende de una BD relacional para usuarios, ventas, inventario, productos y demás entidades.
   - El diseño parece orientado a operaciones CRUD y transacciones simples sobre tablas del dominio de panadería.

4. **Autenticación y gestión de usuarios**
   - Los componentes principales de identidad son `AuthController`, `RegistroController`, `UsuarioController` y `AdminUsuarioController`.
   - Existe un modelo explícito en `models/usuario.php`, lo que sugiere que al menos la entidad usuario tiene una capa de modelo dedicada.
   - Las vistas `views/usuarios/login.php` y `views/usuarios/registre.php` soportan el acceso y el alta de cuentas.
   - El sistema maneja **roles**, especialmente **Administrador** y **Cajero**, con dashboards diferenciados.

5. **Dashboards y control por rol**
   - `views/dashboard/admin.php` y `views/dashboard/cajero.php` muestran que la navegación y la experiencia de usuario cambian según permisos.
   - Esto implica una frontera funcional importante: el controlador de autenticación define sesión/rol, y la vista de dashboard actúa como punto de entrada operativo para cada perfil.

6. **Ventas como núcleo operativo**
   - El módulo de ventas está dividido en `VentaController` y `VentaDetalleController`.
   - Las vistas `views/ventas/crear.php`, `detalle.php` e `index.php` sugieren un flujo de venta en dos niveles: cabecera de venta y detalle de ítems.
   - Arquitectónicamente, ventas es un proceso transaccional que probablemente impacta inventario y reportes, por lo que es uno de los principales puntos de integración entre módulos.

7. **Inventario e insumos**
   - `InventarioController` y `InsumoController` manejan el control de stock y materia prima.
   - Las vistas `views/inventario/index.php` y `ajuste.php` indican que el sistema contempla **ajustes de inventario**, no solo consulta.
   - Este subsistema es clave para el control de entradas y salidas de insumos, uno de los objetivos centrales del proyecto.

8. **Catálogos maestros**
   - `ProductoController` y `ProveedorController` administran los datos base que alimentan ventas e inventario.
   - Las vistas CRUD en `views/productos/` y `views/proveedores/` muestran que estas entidades funcionan como catálogos operativos.
   - En la arquitectura, estos módulos son dependencias de otros procesos: una venta requiere productos; el inventario depende de insumos y proveedores.

9. **Reportes y salida documental**
   - `views/reportes/index.php` y `exportar_pdf.php` indican un subsistema de **consulta y exportación de reportes**.
   - Aunque no se ve la librería concreta, el enfoque es generar salidas documentales para análisis o archivo, probablemente usando datos consolidados de ventas e inventario.

10. **Interfaz compartida y composición de vistas**
   - `views/layouts/header.php`, `sidebar.php`, `footer.php` y `chatbot.php` forman una capa común de UI reutilizable.
   - Esto sugiere un layout base con navegación persistente y componentes compartidos entre módulos, reduciendo duplicación visual.
   - `ChatbotController` y su layout asociado apuntan a un asistente o ayuda contextual integrada en la interfaz, aunque no parece ser el núcleo del negocio.

11. **Documentación técnica y trazabilidad**
   - La carpeta `Documentacion/tecnica/` contiene documentos por módulo (`controller_auth`, `controller_venta`, `controller_inventario`, etc.), lo que refuerza la organización por dominios.
   - También hay historias de usuario y un documento de arquitectura, señal de que el sistema fue diseñado con trazabilidad funcional y técnica.
   - Para un diagrama arquitectónico, esta documentación sirve para validar límites de subsistemas y responsabilidades.

12. **Nota sobre tecnologías**
   - Aunque el README menciona “Python”, el árbol del repositorio muestra claramente una implementación en **PHP** con estructura MVC y SQL.
   - La tecnología de base de datos parece relacional; no se observan servicios externos ni microservicios. La arquitectura es principalmente **interna, modular y centrada en una sola aplicación web**.

Main entry points: [`public/index.php`](https://github.com/benjaminotalora222/panapp/blob/main/public/index.php) (Front controller), [`config/database.php`](https://github.com/benjaminotalora222/panapp/blob/main/config/database.php) (DB config), [`views/layouts/header.php`](https://github.com/benjaminotalora222/panapp/blob/main/views/layouts/header.php) (Layout), [`controllers/VentaController.php`](https://github.com/benjaminotalora222/panapp/blob/main/controllers/VentaController.php) (Ventas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entrada web"]
  node_public_index["Front controller<br/>entrypoint PHP<br/>[index.php]"]
end

subgraph group_app["Aplicación"]
  node_auth_controller["Auth<br/>controller<br/>[AuthController.php]"]
  node_registro_controller["Registro<br/>controller"]
  node_usuario_controller["Usuarios<br/>controller"]
  node_admin_usuario_controller["Admin usuarios<br/>controller"]
  node_usuario_model[("Usuario<br/>model<br/>[usuario.php]")]
  node_venta_controller["Ventas<br/>controller"]
  node_venta_detalle_controller["Detalle venta<br/>controller"]
  node_inventario_controller["Inventario<br/>controller"]
  node_insumo_controller["Insumos<br/>controller"]
  node_producto_controller["Productos<br/>controller"]
  node_proveedor_controller["Proveedores<br/>controller"]
  node_chatbot_controller["Chatbot<br/>controller"]
end

subgraph group_ui["Presentación"]
  node_layout_shell["Layout<br/>shared views<br/>[header.php]"]
  node_auth_views["Auth views<br/>[login.php]"]
  node_dashboard_views["Dashboards<br/>views<br/>[admin.php]"]
  node_sales_views["Sales views<br/>[crear.php]"]
  node_catalog_views["Catalog views<br/>[index.php]"]
  node_inventory_views["Inventory views<br/>[index.php]"]
  node_reports_views["Reports<br/>views<br/>[index.php]"]
end

subgraph group_data["Datos"]
  node_db_config["DB config<br/>database config<br/>[database.php]"]
  node_db_schema["Schema<br/>[panaderia2.sql]"]
end

node_public_index -->|"dispatch"| node_auth_controller
node_public_index -->|"dispatch"| node_registro_controller
node_public_index -->|"dispatch"| node_usuario_controller
node_public_index -->|"dispatch"| node_admin_usuario_controller
node_public_index -->|"dispatch"| node_venta_controller
node_public_index -->|"dispatch"| node_venta_detalle_controller
node_public_index -->|"dispatch"| node_inventario_controller
node_public_index -->|"dispatch"| node_insumo_controller
node_public_index -->|"dispatch"| node_producto_controller
node_public_index -->|"dispatch"| node_proveedor_controller
node_public_index -->|"dispatch"| node_chatbot_controller
node_auth_controller -->|"uses"| node_db_config
node_registro_controller -->|"uses"| node_db_config
node_usuario_controller -->|"uses"| node_usuario_model
node_admin_usuario_controller -->|"uses"| node_usuario_model
node_venta_controller -->|"uses"| node_db_config
node_venta_detalle_controller -->|"uses"| node_db_config
node_inventario_controller -->|"uses"| node_db_config
node_insumo_controller -->|"uses"| node_db_config
node_producto_controller -->|"uses"| node_db_config
node_proveedor_controller -->|"uses"| node_db_config
node_auth_controller -->|"renders"| node_auth_views
node_registro_controller -->|"renders"| node_auth_views
node_usuario_controller -->|"renders"| node_dashboard_views
node_admin_usuario_controller -->|"renders"| node_dashboard_views
node_venta_controller -->|"renders"| node_sales_views
node_venta_detalle_controller -->|"renders"| node_sales_views
node_inventario_controller -->|"renders"| node_inventory_views
node_insumo_controller -->|"renders"| node_catalog_views
node_producto_controller -->|"renders"| node_catalog_views
node_proveedor_controller -->|"renders"| node_catalog_views
node_chatbot_controller -->|"integrates"| node_layout_shell
node_auth_views -->|"composes"| node_layout_shell
node_dashboard_views -->|"composes"| node_layout_shell
node_sales_views -->|"composes"| node_layout_shell
node_catalog_views -->|"composes"| node_layout_shell
node_inventory_views -->|"composes"| node_layout_shell
node_reports_views -->|"composes"| node_layout_shell
node_db_config -->|"backed by"| node_db_schema
node_venta_controller -->|"feeds"| node_reports_views
node_inventario_controller -->|"feeds"| node_reports_views

click node_public_index "https://github.com/benjaminotalora222/panapp/blob/main/public/index.php"
click node_db_config "https://github.com/benjaminotalora222/panapp/blob/main/config/database.php"
click node_db_schema "https://github.com/benjaminotalora222/panapp/blob/main/sql/panaderia2.sql"
click node_auth_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/AuthController.php"
click node_registro_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/RegistroController.php"
click node_usuario_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/UsuarioController.php"
click node_admin_usuario_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/AdminUsuarioController.php"
click node_usuario_model "https://github.com/benjaminotalora222/panapp/blob/main/models/usuario.php"
click node_venta_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/VentaController.php"
click node_venta_detalle_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/VentaDetalleController.php"
click node_inventario_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/InventarioController.php"
click node_insumo_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/InsumoController.php"
click node_producto_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/ProductoController.php"
click node_proveedor_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/ProveedorController.php"
click node_chatbot_controller "https://github.com/benjaminotalora222/panapp/blob/main/controllers/ChatbotController.php"
click node_layout_shell "https://github.com/benjaminotalora222/panapp/blob/main/views/layouts/header.php"
click node_auth_views "https://github.com/benjaminotalora222/panapp/blob/main/views/usuarios/login.php"
click node_dashboard_views "https://github.com/benjaminotalora222/panapp/blob/main/views/dashboard/admin.php"
click node_sales_views "https://github.com/benjaminotalora222/panapp/blob/main/views/ventas/crear.php"
click node_catalog_views "https://github.com/benjaminotalora222/panapp/blob/main/views/productos/index.php"
click node_inventory_views "https://github.com/benjaminotalora222/panapp/blob/main/views/inventario/index.php"
click node_reports_views "https://github.com/benjaminotalora222/panapp/blob/main/views/reportes/index.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_public_index toneBlue
class node_auth_controller,node_registro_controller,node_usuario_controller,node_admin_usuario_controller,node_usuario_model,node_venta_controller,node_venta_detalle_controller,node_inventario_controller,node_insumo_controller,node_producto_controller,node_proveedor_controller,node_chatbot_controller toneAmber
class node_layout_shell,node_auth_views,node_dashboard_views,node_sales_views,node_catalog_views,node_inventory_views,node_reports_views toneMint
class node_db_config,node_db_schema toneRose
```

## Components

### Entrada web

Punto de arranque HTTP y bootstrap de la app

- [Front controller](https://github.com/benjaminotalora222/panapp/blob/main/public/index.php): entrypoint PHP · Recibe requests y delega al resto de la app · `public/index.php`

### Aplicación

Controladores y modelo central

- [Auth](https://github.com/benjaminotalora222/panapp/blob/main/controllers/AuthController.php): controller · Autenticación, sesión y roles · `controllers/AuthController.php`
- [Registro](https://github.com/benjaminotalora222/panapp/blob/main/controllers/RegistroController.php): controller · Alta de usuarios · `controllers/RegistroController.php`
- [Usuarios](https://github.com/benjaminotalora222/panapp/blob/main/controllers/UsuarioController.php): controller · Gestión operativa de usuarios · `controllers/UsuarioController.php`
- [Admin usuarios](https://github.com/benjaminotalora222/panapp/blob/main/controllers/AdminUsuarioController.php): controller · Administración de cuentas y permisos · `controllers/AdminUsuarioController.php`
- [Usuario](https://github.com/benjaminotalora222/panapp/blob/main/models/usuario.php): model · Modelo de usuario · `models/usuario.php`
- [Ventas](https://github.com/benjaminotalora222/panapp/blob/main/controllers/VentaController.php): controller · Flujo principal de venta · `controllers/VentaController.php`
- [Detalle venta](https://github.com/benjaminotalora222/panapp/blob/main/controllers/VentaDetalleController.php): controller · Ítems y detalle transaccional de la venta · `controllers/VentaDetalleController.php`
- [Inventario](https://github.com/benjaminotalora222/panapp/blob/main/controllers/InventarioController.php): controller · Stock, ajustes y control de existencias · `controllers/InventarioController.php`
- [Insumos](https://github.com/benjaminotalora222/panapp/blob/main/controllers/InsumoController.php): controller · Materia prima e insumos · `controllers/InsumoController.php`
- [Productos](https://github.com/benjaminotalora222/panapp/blob/main/controllers/ProductoController.php): controller · Catálogo de productos · `controllers/ProductoController.php`
- [Proveedores](https://github.com/benjaminotalora222/panapp/blob/main/controllers/ProveedorController.php): controller · Catálogo de proveedores · `controllers/ProveedorController.php`
- [Chatbot](https://github.com/benjaminotalora222/panapp/blob/main/controllers/ChatbotController.php): controller · Asistencia contextual integrada · `controllers/ChatbotController.php`

### Presentación

Vistas y composición de interfaz

- [Layout](https://github.com/benjaminotalora222/panapp/blob/main/views/layouts/header.php): shared views · Header, sidebar y footer compartidos · `views/layouts/header.php`
- [Auth views](https://github.com/benjaminotalora222/panapp/blob/main/views/usuarios/login.php): views · Pantallas de login y registro · `views/usuarios/login.php`
- [Dashboards](https://github.com/benjaminotalora222/panapp/blob/main/views/dashboard/admin.php): views · Paneles por rol: admin y cajero · `views/dashboard/admin.php`
- [Sales views](https://github.com/benjaminotalora222/panapp/blob/main/views/ventas/crear.php): views · Crear, ver y detallar ventas · `views/ventas/crear.php`
- [Catalog views](https://github.com/benjaminotalora222/panapp/blob/main/views/productos/index.php): views · CRUD visual de productos, proveedores e insumos · `views/productos/index.php`
- [Inventory views](https://github.com/benjaminotalora222/panapp/blob/main/views/inventario/index.php): views · Consulta y ajuste de inventario · `views/inventario/index.php`
- [Reports](https://github.com/benjaminotalora222/panapp/blob/main/views/reportes/index.php): views · Consulta y exportación PDF · `views/reportes/index.php`

### Datos

Configuración y esquema relacional

- [DB config](https://github.com/benjaminotalora222/panapp/blob/main/config/database.php): database config · Centraliza la conexión a la base de datos · `config/database.php`
- [Schema](https://github.com/benjaminotalora222/panapp/blob/main/sql/panaderia2.sql): SQL schema · Esquema relacional y datos de dominio · `sql/panaderia2.sql`

## Connections

- Front controller → Auth: dispatch · Enruta acciones de autenticación y sesión
- Front controller → Registro: dispatch · Enruta el alta de cuentas
- Front controller → Usuarios: dispatch · Enruta gestión de usuarios
- Front controller → Admin usuarios: dispatch · Enruta administración de cuentas y roles
- Front controller → Ventas: dispatch · Enruta el flujo de ventas
- Front controller → Detalle venta: dispatch · Enruta el detalle transaccional de venta
- Front controller → Inventario: dispatch · Enruta ajustes y consulta de stock
- Front controller → Insumos: dispatch · Enruta gestión de insumos
- Front controller → Productos: dispatch · Enruta catálogo de productos
- Front controller → Proveedores: dispatch · Enruta catálogo de proveedores
- Front controller → Chatbot: dispatch · Enruta la asistencia contextual
- Auth → DB config: uses · Consulta persistencia y sesión de usuario
- Registro → DB config: uses · Guarda nuevos usuarios
- Usuarios → Usuario: uses · Opera sobre el modelo de usuario
- Admin usuarios → Usuario: uses · Administra cuentas y roles
- Ventas → DB config: uses · Lee y escribe ventas
- Detalle venta → DB config: uses · Persiste líneas de venta
- Inventario → DB config: uses · Controla existencias y ajustes
- Insumos → DB config: uses · Gestiona materia prima
- Productos → DB config: uses · Mantiene catálogo de productos
- Proveedores → DB config: uses · Mantiene catálogo de proveedores
- Auth → Auth views: renders · Entrega login y registro
- Registro → Auth views: renders · Entrega alta de usuario
- Usuarios → Dashboards: renders · Recicla paneles y gestión de usuarios
- Admin usuarios → Dashboards: renders · Usa vistas de administración
- Ventas → Sales views: renders · Presenta creación y listado de ventas
- Detalle venta → Sales views: renders · Presenta detalle de venta
- Inventario → Inventory views: renders · Presenta inventario y ajustes
- Insumos → Catalog views: renders · Presenta CRUD de insumos
- Productos → Catalog views: renders · Presenta CRUD de productos
- Proveedores → Catalog views: renders · Presenta CRUD de proveedores
- Chatbot → Layout: integrates · Se monta dentro de la UI compartida
- Auth views → Layout: composes · Usa la estructura visual compartida
- Dashboards → Layout: composes · Usa navegación y footer comunes
- Sales views → Layout: composes · Usa navegación y footer comunes
- Catalog views → Layout: composes · Usa navegación y footer comunes
- Inventory views → Layout: composes · Usa navegación y footer comunes
- Reports → Layout: composes · Usa navegación y footer comunes
- DB config → Schema: backed by · La conexión opera sobre el esquema SQL
- Ventas → Reports: feeds · Sus datos alimentan reportes
- Inventario → Reports: feeds · Sus datos alimentan reportes