Pizzería Control ERP

Una orden parece sencilla hasta que atraviesa inventario, cocina, caja, entrega y compras. Este proyecto conecta esas piezas dentro de un solo flujo.

Pizzería Control es un sistema administrativo demostrativo desarrollado para gestionar la operación de una pizzería: catálogo, recetas, inventario, órdenes, cocina, caja, entregas, proveedores, reportes y compras sugeridas.

El repositorio forma parte del portafolio técnico de edHash y está preparado para ejecutarse de manera local con datos ficticios.

Important

Este proyecto es una demostración académica y de portafolio. No está preparado para producción ni contiene autenticación y autorización definitivas.

Flujo principal

Autoservicio / Mostrador
          ↓
        Orden
          ↓
        Cocina
          ↓
         Caja
          ↓
Descuento de inventario
          ↓
       Entrega
          ↓
Reportes y pronóstico
          ↓
Compras sugeridas y proveedores

Funcionalidades

Operación

• Creación de órdenes desde autoservicio o mostrador.
• Seguimiento por estados: nueva, cocina, preparación, lista, pagada y entregada.
• Panel específico para cocina, caja y entregas.
• Registro de pagos y cálculo de cambio.

Inventario y recetas

• Administración de insumos, unidades y existencias.
• Registro de entradas, salidas y ajustes.
• Recetas por producto y tamaño.
• Descuento automático de insumos al cobrar una orden.
• Historial de movimientos y consulta de stock bajo.

Compras y proveedores

• Administración de proveedores.
• Relación de insumos, precios y tiempos de entrega.
• Generación de solicitudes de compra.
• Envío supervisado por correo mediante SMTP opcional.
• Prevención de solicitudes duplicadas dentro del flujo implementado.

Reportes

• Ventas, pagos y ticket promedio.
• Productos vendidos y consumo de insumos.
• Pronóstico de ventas y necesidades de inventario.
• Compras sugeridas de acuerdo con stock, consumo y margen de seguridad.

Tecnologías

• PHP y CodeIgniter 3.1.11
• MySQL / MariaDB
• Grocery CRUD
• HTML, CSS y JavaScript
• Bootstrap y jQuery incluidos por las dependencias del proyecto
• XAMPP para el entorno local

Requisitos recomendados

• Apache
• PHP 7.4 para reproducir el entorno legacy del proyecto
• MySQL o MariaDB
• Extensión mysqli habilitada
• XAMPP o un entorno equivalente

PHP 8.x puede requerir ajustes adicionales debido a las versiones legacy de CodeIgniter y Grocery CRUD incluidas.

Instalación rápida

1. Copia la carpeta del proyecto dentro de htdocs con el nombre pizzeria_control.
2. Inicia Apache y MySQL desde XAMPP.
3. Importa database/pizzeria_control_demo.sql desde phpMyAdmin.
4. Copia application/config/database.local.example.php como application/config/database.local.php.
5. Ajusta las credenciales locales solo cuando sean distintas de root sin contraseña.
6. Abre:

http://localhost/pizzeria_control/index.php

La guía completa está en docs/INSTALLATION.md.

Configuración segura

Las credenciales locales no deben escribirse en archivos rastreados por Git.

Archivos de ejemplo:

application/config/database.local.example.php
application/config/email.local.example.php

Copias locales ignoradas automáticamente:

application/config/database.local.php
application/config/email.local.php

Base de datos de demostración

El archivo público:

database/pizzeria_control_demo.sql

contiene únicamente información ficticia:

• Correos con el dominio reservado example.com.
• Teléfonos no operativos.
• Ubicaciones generales y ficticias.
• Un usuario administrativo de demostración sin flujo de acceso habilitado.

Estructura

Pizzeria-Control-ERP/
├── application/        # Controladores, modelos, vistas y configuración
├── assets/             # Recursos visuales y dependencias del frontend
├── database/           # Base de datos demostrativa sanitizada
├── docs/               # Instalación y advertencias de seguridad
├── system/             # Framework CodeIgniter 3.1.11
├── .gitignore
├── index.php
└── README.md

Estado y limitaciones

Implementado:

• Flujo operativo completo de orden a entrega.
• Descuento de inventario por recetas.
• Reportes, pronóstico y compras sugeridas.
• Solicitudes de compra y correo SMTP supervisado.
• Paneles demostrativos por rol.

Pendiente antes de una posible versión de producción:

• Autenticación real.
• Autorización por roles en cada ruta.
• Protección CSRF.
• Reglas estrictas de sesión y cookies.
• Validación integral del lado del servidor.
• Pruebas automatizadas.
• Actualización de dependencias legacy.

Consulta docs/SECURITY.md antes de modificar o desplegar el sistema.

Evidencia visual

Las capturas del sistema pueden colocarse en:

docs/screenshots/

Licencias y dependencias

CodeIgniter y Grocery CRUD conservan sus archivos de licencia originales dentro del repositorio. El código y los recursos de terceros permanecen sujetos a sus respectivas licencias.

---

[ SYSTEM STATUS ]
Demo local preparada.
Datos públicos sanitizados.
El siguiente error todavía puede ser una pista.

Desarrollado y documentado bajo la identidad edHash.