Automatizando la gestión de inventario y ventas para el emprendimiento venezolano.
- 📖 Descripción General
- 🚀 Stack Tecnológico
- 📂 Estructura del Proyecto
- ⚙️ Características Clave
- 📄 Documentos Generados con TCPDF
- 📊 Progreso del Proyecto
- 🎯 Impacto del Sistema
- 📚 Documentación
- 🛠️ Instalación y Configuración
- 📜 Licencia
SIEP es un sistema de información web diseñado e implementado para modernizar y optimizar los procesos de venta y gestión de inventario de la Papelería ISA&CRIS, ubicada en Maracaibo, Estado Zulia, Venezuela. Este sistema surge como respuesta a las limitaciones de la gestión manual y la falta de visibilidad digital, ofreciendo una plataforma centralizada, segura y escalable que automatiza tareas críticas como la gestión de productos, categorías, clientes, proveedores, ventas, compras y la generación de documentos oficiales en PDF y Excel.
| Capa | Tecnología |
|---|---|
| Backend | PHP 8.2 (Arquitectura MVC nativa) |
| Frontend | HTML5, CSS3, JavaScript (ES6), Bootstrap 5.3, jQuery, Ajax |
| Base de Datos | MySQL 8.0 (Relacional, Normalizada) |
| Generación de Reportes | TCPDF / FPDF (Documentos PDF) y Exportación a Excel/CSV |
| Arquitectura | Cliente-Servidor + MVC |
| Metodología | Extreme Programming (XP), TDD (Test Driven Development) |
| Seguridad | Autenticación por Sesiones, Gestión de Usuarios y Permisos |
/
├── ajax/ # Peticiones asíncronas (JavaScript/AJAX)
├── Animated Product Card/ # Animaciones y recursos gráficos
├── assets/ # Recursos estáticos (imágenes, íconos)
├── config/ # Configuración del sistema (Conexión BD)
├── css/ # Hojas de estilo personalizadas
├── files/ # Archivos subidos por el sistema
├── fpdf181/ # Librería FPDF (Generación de PDF)
├── img/ # Imágenes generales de la interfaz
├── js/ # Scripts de JavaScript personalizados
├── modelos/ # Modelos de datos (MVC)
├── public/ # Archivos públicos accesibles
├── reportes/ # Lógica de generación de reportes (TCPDF)
├── vistas/ # Vistas (HTML, PHP, CSS, JS)
├── index.php # Punto de entrada principal
├── login.html # Vista de inicio de sesión
├── siep.sql # Script de la base de datos MySQL
├── docs/
│ ├── media/
│ │ ├── logo_siep.png # Logo del proyecto
│ │ └── siep_demo.gif # GIF de demostración
│ └── manuals/
│ ├── MANUAL_DE_USUARIO_FINAL.pdf
├── .gitignore # Archivos ignorados por Git (seguridad y limpieza)
├── LICENSE # Licencia MIT del proyecto
└── README.md # Documentación del proyecto
| Módulo | Descripción | Funcionalidades |
|---|---|---|
| Escritorio | Panel de control principal | Métricas de compras/ventas, gráficos de los últimos 10 días y 12 meses |
| Productos | Gestión del catálogo de productos | CRUD completo, generador de códigos de barras, control de stock, precios e imágenes |
| Categorías | Clasificación de productos | CRUD, descripción, estado activo/inactivo |
| Proveedores | Gestión de suministradores | CRUD, datos fiscales, contacto, estado activo/inactivo |
| Ingresos (Compras) | Registro de mercancía comprada | CRUD, análisis de costos, cálculo de IVA, impuestos, control de documentos fiscales (boleta, factura, ticket) |
| Clientes | Gestión de compradores | CRUD, tipos de documento, dirección, teléfono, email |
| Ventas | Gestión de transacciones | CRUD, análisis de descuentos, cálculo de IVA, impuestos, asociación a clientes |
| Usuarios | Gestión de administradores | CRUD, asignación de permisos, control de accesos a módulos |
| Permisos | Control de roles y accesos | CRUD, asignación de permisos específicos a cada usuario (RBAC) |
| Consultas de Compras | Reportes de compras | Filtrado por fechas, exportación a PDF/Excel, reportes de ingresos |
| Consultas de Ventas | Reportes de ventas | Filtrado por fechas y clientes, exportación a PDF/Excel |
- Interfaz Intuitiva: Catálogo de productos con imágenes, precios en Bolívares (Bs) y disponibilidad.
- Menú Categorizado: Navegación por Lapiceros, Borradores, Sacapuntas, Libretas y Carpetas.
- Registro e Inicio de Sesión: Autenticación de clientes.
- Contacto Directo: Enlace a WhatsApp para consultas y compras.
El sistema cuenta con un módulo de reportes robusto que utiliza la librería TCPDF para generar documentos oficiales y de gestión:
- Reportes PDF: Reportes de productos, categorías, ventas, compras, clientes y proveedores.
- Códigos de Barras: Generación automática de códigos para etiquetado.
- Reportes Excel: Exportación de datos para análisis externo y contable.
- Impresión de Tickets de Compra y Venta: Opciones de impresión desde el navegador para los reportes generados.
| Módulo | Estado | Avance |
|---|---|---|
| Análisis de Requisitos | ✅ Completado |  |
| Diseño del Sistema (Base de Datos) | ✅ Completado | |
| Diseño de Interfaz (Wireframes) | ✅ Completado | |
| Módulo de Usuarios (CRUD + Permisos) | ✅ Completado | |
| Módulo de Categorías (CRUD) | ✅ Completado | |
| Módulo de Productos (CRUD + Códigos de Barras) | ✅ Completado | |
| Módulo de Proveedores (CRUD) | ✅ Completado | |
| Módulo de Clientes (CRUD) | ✅ Completado | |
| Módulo de Ventas (CRUD + Análisis de Costos) | ✅ Completado | |
| Módulo de Compras / Ingresos (CRUD) | ✅ Completado | |
| Generación de Reportes PDF (TCPDF) | ✅ Completado | |
| Dashboard y Estadísticas (Gráficos) | ✅ Completado | |
| Módulo Cliente (E-commerce) | ✅ Completado | |
| Implementación y Despliegue | ✅ Completado | |
| Capacitación del Personal | ✅ Completado | |
| Mantenimiento y Soporte | ✅ Completado | |
| Métrica | Antes (Manual) | Después (SIEP) | Mejora |
|---|---|---|---|
| Tiempo de registro | Horas/Días | ~2 segundos/consulta | -90% |
| Errores humanos | Alta incidencia | Validación automática | -85% |
| Control de inventario | Inexacto | Tiempo real | Exactitud total |
| Generación de reportes | Manual (No existía) | Automática (PDF/Excel) | Optimización total |
Puedes consultar los manuales del sistema en la carpeta docs/manuals/:
| Requisito | Versión |
|---|---|
| PHP | 8.2 o superior |
| MySQL | 8.0 o superior |
| Servidor Web | Apache (XAMPP, WAMP o Laragon recomendados) |
1. Clonar el repositorio
git clone https://github.com/<tu-usuario>/siep.gitcd siep2. Configurar el entorno (Base de Datos)
Edita el archivo config/Conexion.php (o config/global.php) con las credenciales de MySQL:
ini
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=mi_tienda
DB_USERNAME=root
DB_PASSWORD=3. Importar la base de datos
Importa el archivo siep.sql (ubicado en la raíz del proyecto) usando phpMyAdmin o la línea de comandos:
mysql -u root -p mi_tienda < "siep.sql"4. Ejecutar el servidor local
Coloca la carpeta del proyecto en htdocs (XAMPP) o www (WAMP) y accede desde el navegador:
http://localhost/siep/📄 Ver archivo LICENSE para más detalles.