Sistema POS - Punto de Venta

Sistema de punto de venta para tienda de dulces y abarrotes, desarrollado con Electron, React y MariaDB.

Requisitos Previos

• Node.js: Versión 20 o superior
• MariaDB: Versión 10.6 o superior
• DBeaver (opcional): Para administración visual de la base de datos

Instalación de MariaDB en Windows

Opción 1: Instalador Oficial

1. Descarga MariaDB desde https://mariadb.org/download/
2. Ejecuta el instalador y sigue los pasos
3. Durante la instalación, configura:
   • Puerto: 3306
   • Contraseña root: (la que prefieras)

Opción 2: Chocolatey

choco install mariadb

Opción 3: XAMPP

1. Descarga XAMPP desde https://www.apachefriends.org/
2. Instala y activa el módulo MariaDB

Configuración de la Base de Datos

1. Copia el archivo de variables de entorno

copy .env.example .env

Edita el archivo .env con tus credenciales:

DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=pos_user
DB_PASSWORD=tu_contraseña
DB_DATABASE=punto_venta

2. Ejecuta el script de configuración

Abre DBeaver o cualquier cliente MySQL y ejecuta:

-- Ejecuta el contenido de database/setup.sql

O desde la línea de comandos:

mysql -u root -p < database/setup.sql

3. Crea el usuario de la aplicación

CREATE USER 'pos_user'@'localhost' IDENTIFIED BY 'pos_pass';
GRANT ALL PRIVILEGES ON punto_venta.* TO 'pos_user'@'localhost';
FLUSH PRIVILEGES;

Instalación de Dependencias

npm install

Ejecución en Modo Desarrollo

npm run dev

Esto abrirá:

• Frontend en http://localhost:5173
• Aplicación Electron

Uso de la Aplicación

Inicio de Sesión

1. Selecciona tu usuario
2. Ingresa tu PIN de 4 dígitos
3. Ingresa el fondo inicial de caja

Usuarios por defecto:

• Administrador: PIN 1234
• Cajera: PIN 1234

Módulos

• Ventas: Punto de venta con búsqueda de productos, escáner de códigos de barras, y cobros
• Inventario: CRUD de productos, categorías, y control de stock
• Corte de Caja: Cierre de turno con resumen y generación de PDF
• Reportes: Ventas por período, inventario, y cancelaciones
• Configuración: Datos de la tienda, usuarios, y respaldos

Comandos Disponibles

npm run dev          # Iniciar en modo desarrollo
npm run build        # Generar el ejecutable .exe
npm run migration:run  # Ejecutar migraciones de BD

Generación del Ejecutable

npm run build

El archivo .exe se generará en la carpeta release/.

Estructura del Proyecto

Punto_Venta/
├── electron/           # Proceso principal de Electron
│   ├── main.ts         # Punto de entrada
│   ├── preload.ts      # API segura para renderer
│   └── ipc/           # Handlers IPC
├── src/               # Código React
│   ├── components/    # Componentes reutilizables
│   ├── routes/       # Pantallas de la aplicación
│   ├── store/        # Estados Zustand
│   ├── hooks/        # Custom hooks
│   ├── utils/        # Utilerías
│   └── types/        # Tipos TypeScript
├── database/         # Entidades y configuración BD
├── package.json
└── README.md

Notas

• Los tickets se generan en PDF (no requiere impresora térmica)
• El peso de productos granel se ingresa manualmente
• Los respaldos se guardan en Documentos\PuntoVenta_Respaldos

Solución de Problemas

Error de conexión a la base de datos

1. Verifica que MariaDB esté corriendo
2. Confirma las credenciales en .env
3. Verifica que el usuario tenga permisos

Error al generar el ejecutable

1. Limpia la caché: rm -rf node_modules/.cache
2. Elimina la carpeta release/
3. Intenta de nuevo: npm run build

Licencia

MIT