siep - GitLite

KO | EN

gitlite — search

#go #command-line #php #agents #claude-code #git #cpp #self-hosted #electron #web

siep

(★ 9)

SIEP | Sistema de Información E-commerce para Papelería ISA&CRIS | PHP + MySQL | Arquitectura MVC | CRUD Completo | Reportes PDF (TCPDF) y Excel | jQuery + Ajax | Bootstrap | Metodología XP.

File Explorer

ZIP Download

- articulo.php
- articuloscliente.php
- categoria.php
- consultas.php
- editarperfil.php
- ingreso.php
- permiso.php
- persona.php
- usuario.php
- usuariocliente.php
- venta.php
- - blue.png
  - logo.jpg
  - pink.png
  - yellow.png
- index.html
- stylep.css
- - dataTables.bootstrap4.min.css
  - estilos.css
  - material-dashboard-rtl.css
  - material-dashboard.css
  - material-dashboard.css.map
  - material-dashboard.min.css
  - style.css
- - 2.jpeg
  - fondo.jpeg
  - logo.png
  - sidebar-1.jpg
- - all.min.js
  - arrive.min.js
  - bootstrap-notify.js
  - bootstrap.bundle.min.js
  - chart.min.js
  - dataTables.bootstrap4.min.js
  - funciones.js
  - iffe_login.js
  - jquery-3.6.0.min.js
  - jquery.dataTables.min.js
  - login_modulo.js
  - material-dashboard.js
  - material-dashboard.js.map
  - material-dashboard.min.js
  - register.js
  - script.js
  - sweetalert2.all.min.js
- Conexion.php
- global.php
- aos.css
- dataTables.bootstrap4.min.css
- estilos.css
- estyles.css
- material-dashboard-rtl.css
- material-dashboard.css
- material-dashboard.css.map
- material-dashboard.min.css
- style.css
- style1.css
- - MANUAL_DE_USUARIO_FINAL.pdf
- - logo_siep.png
  - siep_demo.gif
- - 1718692862.jpeg
- - descarga.jfif
- - 1535417472.jpg
  - 1535417486.jpg
- - __construct.htm
  - acceptpagebreak.htm
  - addfont.htm
  - addlink.htm
  - addpage.htm
  - aliasnbpages.htm
  - cell.htm
  - close.htm
  - error.htm
  - footer.htm
  - getpageheight.htm
  - getpagewidth.htm
  - getstringwidth.htm
  - getx.htm
  - gety.htm
  - header.htm
  - image.htm
  - index.htm
  - line.htm
  - link.htm
  - ln.htm
  - multicell.htm
  - output.htm
  - pageno.htm
  - rect.htm
  - setauthor.htm
  - setautopagebreak.htm
  - setcompression.htm
  - setcreator.htm
  - setdisplaymode.htm
  - setdrawcolor.htm
  - setfillcolor.htm
  - setfont.htm
  - setfontsize.htm
  - setkeywords.htm
  - setleftmargin.htm
  - setlinewidth.htm
  - setlink.htm
  - setmargins.htm
  - setrightmargin.htm
  - setsubject.htm
  - settextcolor.htm
  - settitle.htm
  - settopmargin.htm
  - setx.htm
  - setxy.htm
  - sety.htm
  - text.htm
  - write.htm
- - courier.php
  - courierb.php
  - courierbi.php
  - courieri.php
  - helvetica.php
  - helveticab.php
  - helveticabi.php
  - helveticai.php
  - symbol.php
  - times.php
  - timesb.php
  - timesbi.php
  - timesi.php
  - zapfdingbats.php
- - cp1250.map
  - cp1251.map
  - cp1252.map
  - cp1253.map
  - cp1254.map
  - cp1255.map
  - cp1257.map
  - cp1258.map
  - cp874.map
  - iso-8859-1.map
  - iso-8859-11.map
  - iso-8859-15.map
  - iso-8859-16.map
  - iso-8859-2.map
  - iso-8859-4.map
  - iso-8859-5.map
  - iso-8859-7.map
  - iso-8859-9.map
  - koi8-r.map
  - koi8-u.map
  - makefont.php
  - ttfparser.php
- - 20k_c1.txt
  - 20k_c2.txt
  - calligra.php
  - calligra.ttf
  - calligra.z
  - index.htm
  - logo.png
  - makefont.php
  - paises.txt
  - tuto1.htm
  - tuto1.php
  - tuto2.htm
  - tuto2.php
  - tuto3.htm
  - tuto3.php
  - tuto4.htm
  - tuto4.php
  - tuto5.htm
  - tuto5.php
  - tuto6.htm
  - tuto6.php
  - tuto7.htm
  - tuto7.php
- changelog.htm
- FAQ.htm
- fpdf.css
- fpdf.php
- install.txt
- license.txt
- 2.jpeg
- fondo.jpeg
- logo-mini-.png
- logo-mini.png
- logo.png
- sidebar-1.jpg
- - AUTHORS.txt
  - index.html
  - jquery-ui.css
  - jquery-ui.js
  - jquery-ui.min.css
  - jquery-ui.min.js
  - jquery-ui.structure.css
  - jquery-ui.structure.min.css
  - jquery-ui.theme.css
  - jquery-ui.theme.min.css
  - LICENSE.txt
  - package.json
- all.min.js
- arrive.min.js
- bootstrap-notify.js
- bootstrap.bundle.min.js
- chart.min.js
- dataTables.bootstrap4.min.js
- editarperfil.js
- funciones.js
- iffe_login.js
- jquery-3.6.0.min.js
- jquery.dataTables.min.js
- login_modulo.js
- material-dashboard.js
- material-dashboard.js.map
- material-dashboard.min.js
- register.js
- registrar.js
- script.js
- sweetalert2.all.min.js
- Articulo.php
- Articuloscliente.php
- Categoria.php
- Consultas.php
- EditarPerfil.php
- Ingreso.php
- Permiso.php
- Persona.php
- Usuario.php
- Usuariocliente.php
- Venta.php
- - bower.json
  - CHANGELOG.md
  - Gemfile
  - Gemfile.lock
  - Gruntfile.js
  - ISSUE_TEMPLATE.md
  - LICENSE
  - package.js
  - package.json
  - README.md
- - _all-skins.min.css
  - AdminLTE.min.css
  - bootstrap-select.min.css
  - bootstrap.min.css
  - font-awesome.css
  - font-awesome.css.map
  - font-awesome.min.css
  - ticket.css
- - buttons.colVis.min.js
  - buttons.dataTables.min.css
  - buttons.html5.min.js
  - dataTables.buttons.min.js
  - datatables.min.js
  - jquery.dataTables.min.css
  - jquery.dataTables.min.js
  - jszip.min.js
  - pdfmake.min.js
  - responsive.dataTables.min.css
  - vfs_fonts.js
- - fontawesome-webfont.eot
  - fontawesome-webfont.svg
  - fontawesome-webfont.ttf
  - fontawesome-webfont.woff
  - fontawesome-webfont.woff2
  - FontAwesome.otf
- - sort_asc.png
  - sort_asc_disabled.png
  - sort_both.png
  - sort_desc.png
  - sort_desc_disabled.png
- - avatar.png
  - avatar04.png
  - avatar2.png
  - avatar3.png
  - avatar5.png
  - default-50x50.gif
  - icons.png
  - photo1.png
  - photo2.png
  - photo3.jpg
  - photo4.jpg
  - user1-128x128.jpg
  - user2-160x160.jpg
  - user3-128x128.jpg
  - user4-128x128.jpg
  - user5-128x128.jpg
  - user6-128x128.jpg
  - user7-128x128.jpg
  - user8-128x128.jpg
- - adminlte.min.js
  - bootbox.min.js
  - bootstrap-select.min.js
  - bootstrap.min.js
  - Chart.bundle.min.js
  - Chart.min.js
  - jquery.min.js
  - jquery.PrintArea.js
  - JsBarcode.all.min.js
- exFactura.php
- exTicket.php
- Factura.php
- Letras.php
- logo.png
- PDF_MC_Table.php
- rptarticulos.php
- - articulo.js
  - articuloscliente.js
  - categoria.js
  - cliente.js
  - comprasfecha.js
  - ingreso.js
  - login.js
  - logincliente.js
  - modal.js
  - permiso.js
  - proveedor.js
  - script.js
  - scriptscliente.js
  - sweetAlert.js
  - usuario.js
  - venta.js
  - ventasfechacliente.js
- articulo.php
- borradores.php
- cabezal.php
- carpetas.php
- categoria.php
- cerrar_sesion.php
- cliente.php
- clienteacceso.php
- comprasfecha.php
- escritorio.php
- footer.php
- header.php
- index.html
- indexproductos.php
- ingreso.php
- lapiceros.php
- libretas.php
- login.html
- login.php
- noacceso.php
- permiso.php
- proveedor.php
- sacapuntas.php
- usuario.php
- venta.php
- ventasfechacliente.php
- vistacliente.php
.gitignore
index.php
LICENSE
login.html
README.md
siep.sql

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="docs/media/logo_siep.png" alt="Logo SIEP" width="180" style="border-radius: 12px; box-shadow: 0 4px 12px rgba(0,0,0,0.15); margin-bottom: 20px;">
</p>

<p align="center">
  <em>Automatizando la gestión de inventario y ventas para el emprendimiento venezolano.</em>
</p>

<div align="center">

[![SIEP](https://img.shields.io/badge/SIEP-Sistema%20E--commerce-brightgreen)](https://github.com/tu-usuario/siep)
[![PHP](https://img.shields.io/badge/PHP-8.2-777BB4?style=flat-square&logo=php&logoColor=white)](https://www.php.net/)
[![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat-square&logo=mysql&logoColor=white)](https://www.mysql.com/)
[![JavaScript](https://img.shields.io/badge/JavaScript-ES6-F7DF1E?style=flat-square&logo=javascript&logoColor=black)](https://developer.mozilla.org/es/docs/Web/JavaScript)
[![Bootstrap](https://img.shields.io/badge/Bootstrap-5.3-7952B3?style=flat-square&logo=bootstrap&logoColor=white)](https://getbootstrap.com/)
[![jQuery](https://img.shields.io/badge/jQuery-3.7-0769AD?style=flat-square&logo=jquery&logoColor=white)](https://jquery.com/)
[![Ajax](https://img.shields.io/badge/Ajax-Async%20Requests-blue?style=flat-square)](https://developer.mozilla.org/es/docs/Web/Guide/AJAX)
[![TCPDF](https://img.shields.io/badge/TCPDF-Reportes%20PDF-red?style=flat-square)](https://tcpdf.org/)
[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](https://raw.githubusercontent.com/andrea-lopez-dev/siep/main/LICENSE)

</div>

<p align="center">
  <img src="docs/media/siep_demo.gif" 
       alt="Demostración del sistema SIEP" 
       width="900" 
       style="border-radius: 12px; box-shadow: 0 4px 15px rgba(0,0,0,0.2);">
</p>

---

## 📑 Índice

- [📖 Descripción General](#-descripción-general)
- [🚀 Stack Tecnológico](#-stack-tecnológico)
- [📂 Estructura del Proyecto](#-estructura-del-proyecto)
- [⚙️ Características Clave](#️-características-clave)
- [📄 Documentos Generados con TCPDF](#-documentos-generados-con-tcpdf)
- [📊 Progreso del Proyecto](#-progreso-del-proyecto)
- [🎯 Impacto del Sistema](#-impacto-del-sistema)
- [📚 Documentación](#-documentación)
- [🛠️ Instalación y Configuración](#️-instalación-y-configuración)
- [📜 Licencia](#-licencia)

---

## 📖 Descripción General

**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.

---

## 🚀 Stack Tecnológico

| 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 |

---

## 📂 Estructura del Proyecto

```text
/
├── 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
```

## ⚙️ Características Clave

## 🔐 Módulos Administrativos (Dashboard)
<table align="center"> <thead> <tr> <th>Módulo</th> <th>Descripción</th> <th>Funcionalidades</th> </tr> </thead> <tbody> <tr> <td><strong>Escritorio</strong></td> <td>Panel de control principal</td> <td>Métricas de compras/ventas, gráficos de los últimos 10 días y 12 meses</td> </tr> <tr> <td><strong>Productos</strong></td> <td>Gestión del catálogo de productos</td> <td>CRUD completo, generador de códigos de barras, control de stock, precios e imágenes</td> </tr> <tr> <td><strong>Categorías</strong></td> <td>Clasificación de productos</td> <td>CRUD, descripción, estado activo/inactivo</td> </tr> <tr> <td><strong>Proveedores</strong></td> <td>Gestión de suministradores</td> <td>CRUD, datos fiscales, contacto, estado activo/inactivo</td> </tr> <tr> <td><strong>Ingresos (Compras)</strong></td> <td>Registro de mercancía comprada</td> <td>CRUD, análisis de costos, <strong>cálculo de IVA</strong>, impuestos, control de documentos fiscales (boleta, factura, ticket)</td> </tr> <tr> <td><strong>Clientes</strong></td> <td>Gestión de compradores</td> <td>CRUD, tipos de documento, dirección, teléfono, email</td> </tr> <tr> <td><strong>Ventas</strong></td> <td>Gestión de transacciones</td> <td>CRUD, análisis de descuentos, <strong>cálculo de IVA</strong>, impuestos, asociación a clientes</td> </tr> <tr> <td><strong>Usuarios</strong></td> <td>Gestión de administradores</td> <td>CRUD, asignación de permisos, control de accesos a módulos</td> </tr> <tr> <td><strong>Permisos</strong></td> <td>Control de roles y accesos</td> <td>CRUD, asignación de permisos específicos a cada usuario (RBAC)</td> </tr> <tr> <td><strong>Consultas de Compras</strong></td> <td>Reportes de compras</td> <td>Filtrado por fechas, exportación a PDF/Excel, reportes de ingresos</td> </tr> <tr> <td><strong>Consultas de Ventas</strong></td> <td>Reportes de ventas</td> <td>Filtrado por fechas y clientes, exportación a PDF/Excel</td> </tr> </tbody> </table>

## 🛍️ Módulo Cliente (E-commerce)

*  **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.

## 📄 Documentos Generados con TCPDF

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.

## 📊 Progreso del Proyecto

| Módulo | Estado | Avance |
|--------|--------|--------|
| **Análisis de Requisitos** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Diseño del Sistema (Base de Datos)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Diseño de Interfaz (Wireframes)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Usuarios (CRUD + Permisos)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Categorías (CRUD)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Productos (CRUD + Códigos de Barras)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Proveedores (CRUD)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Clientes (CRUD)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Ventas (CRUD + Análisis de Costos)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo de Compras / Ingresos (CRUD)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Generación de Reportes PDF (TCPDF)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Dashboard y Estadísticas (Gráficos)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Módulo Cliente (E-commerce)** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Implementación y Despliegue** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Capacitación del Personal** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |
| **Mantenimiento y Soporte** | ✅ Completado | ![100%](https://img.shields.io/badge/-100%25-brightgreen) |

## 🎯 Impacto del Sistema
<table align="center"> <thead> <tr> <th>Métrica</th> <th>Antes (Manual)</th> <th>Después (SIEP)</th> <th>Mejora</th> </tr> </thead> <tbody> <tr> <td><strong>Tiempo de registro</strong></td> <td>Horas/Días</td> <td>~2 segundos/consulta</td> <td><strong>-90%</strong></td> </tr> <tr> <td><strong>Errores humanos</strong></td> <td>Alta incidencia</td> <td>Validación automática</td> <td><strong>-85%</strong></td> </tr> <tr> <td><strong>Control de inventario</strong></td> <td>Inexacto</td> <td>Tiempo real</td> <td><strong>Exactitud total</strong></td> </tr> <tr> <td><strong>Generación de reportes</strong></td> <td>Manual (No existía)</td> <td>Automática (PDF/Excel)</td> <td><strong>Optimización total</strong></td> </tr> </tbody> </table>

## 📚 Documentación

Puedes consultar los manuales del sistema en la carpeta **`docs/manuals/`**:

*   📄 [Manual de Usuario](docs/manuals/MANUAL_DE_USUARIO_FINAL.pdf)

## 🛠️ Instalación y Configuración

<table align="center"> <thead> <tr> <th>Requisito</th> <th>Versión</th> </tr> </thead> <tbody> <tr> <td><strong>PHP</strong></td> <td>8.2 o superior</td> </tr> <tr> <td><strong>MySQL</strong></td> <td>8.0 o superior</td> </tr> <tr> <td><strong>Servidor Web</strong></td> <td>Apache (XAMPP, WAMP o Laragon recomendados)</td> </tr> </tbody> </table>

## Pasos de Instalación

**1. Clonar el repositorio**

```bash
git clone https://github.com/<tu-usuario>/siep.git
```

```bash
cd siep
```

**2. Configurar el entorno (Base de Datos)**

Edita el archivo **config/Conexion.php (o config/global.php)** con las credenciales de MySQL:

```bash
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:

```bash
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:

```bash
http://localhost/siep/
```

📄 **Ver archivo [LICENSE](LICENSE) para más detalles.**