🏪

KioscoPro

Sistema de Gestión para Kioscos y Pequeños Comercios

Versión 1.3 | Licencia GPL v3

📦 Repositorio GitLab ❤️ Donar

📋 Descarga

💿

Instalador para Windows

kioscopro_v1.3.exe

MD5: 1bed193e18659128032f7fcd431777a3

⬇️ Descargar Instalador (.exe)

✅ Ejecutá el instalador y seguí los pasos. KioscoPro se instalará en tu equipo con acceso directo en el Escritorio.

🔍 Verificar integridad del archivo

Después de descargar, verificá que el archivo no esté corrupto comparando el hash MD5:

Comando para verificar (PowerShell):
Get-FileHash .\kioscopro_v1.3.exe -Algorithm MD5

Hash esperado:
1bed193e18659128032f7fcd431777a3

🦊 Descarga Manual (solo HTML)

Si preferís no usar el instalador, descargá solo el archivo HTML y abrilo con Firefox:

📄 Descargar kioscopro.html

📋 ¿Qué es KioscoPro?

KioscoPro es un sistema de gestión integral diseñado específicamente para kioscos, despensas y pequeños comercios. Desarrollado 100% en HTML, CSS y JavaScript vanilla, funciona como una aplicación web autocontenida.

🚀 Instalador .exe Un solo clic para instalar en Windows. Acceso directo en el Escritorio.

📡 100% Offline No necesita conexión a internet. Todos los datos se guardan localmente.

💰 Gratuito Software libre bajo licencia GPL v3. Sin costos ocultos.

🔐 Multi-usuario Roles de Admin y Cajero con permisos diferenciados.

⚡ Funcionalidades Principales

💰 Punto de Venta Ágil

Interfaz optimizada para ventas rápidas con búsqueda inteligente. Escribí parte del nombre o código de barras, seleccioná con flechas y presioná Enter para agregar al carrito. Menos de 3 clics por venta.

⚡ Ítem Express

¿Un producto no está en el sistema? Agregalo al vuelo con nombre y precio. Ideal para fiambrería o productos sin código de barras. No descuenta stock y queda marcado para cargarlo después.

📦 Control de Inventario

Stock actualizado en tiempo real con cada venta. Alertas visuales cuando un producto llega al mínimo. Listado de reposición con cantidades sugeridas.

💲 Actualización Masiva de Precios

Fundamental en contextos inflacionarios. Aumentá todos los precios por porcentaje, filtrá por categoría y simulá antes de aplicar los cambios.

💵 Caja por Turnos

Apertura y cierre de caja con arqueo. Registro de ingresos por medio de pago (efectivo, débito, crédito, QR) y egresos. Cálculo automático de diferencia.

📊 Reportes con Ganancia Neta

Visualizá ventas, costos y ganancia real por día, semana, mes y total histórico. Top 10 de productos más vendidos con ranking.

📱 Envío por WhatsApp

Al cobrar, elegí entre imprimir el ticket o enviarlo por WhatsApp al cliente. Con detalle de productos, total, medio de pago y vuelto.

🌓 Tema Claro/Oscuro

Botón flotante para cambiar entre tema claro y oscuro. Reduce la fatiga visual en entornos con poca luz.

⌨️ Navegación por Teclado

El sistema funciona completamente sin mouse. Atajos F1-F10, F12, Ctrl+Shift para todas las funciones principales.

🚀 Cómo Empezar

1

Instalá o descargá
Ejecutá kioscopro_v1.3.exe o descargá el .html manualmente.

2

Abrí KioscoPro
Desde el acceso directo en el Escritorio o haciendo doble clic en el archivo. Recomendado: Mozilla Firefox.

3

Iniciá sesión
Usuario demo: admin | Contraseña: admin
Usuario cajero: cajero | Contraseña: cajero

4

Configurá tu negocio
Andá a ⚙️ Configuración y cargá el nombre, CUIT y dirección de tu negocio.

5

Cargá tus productos
Andá a 📦 Productos y empezá a cargar tu inventario.

6

¡A vender!
Presioná F1 para ir al Punto de Venta y empezá a cobrar.

⌨️ Atajos de Teclado

Tecla	Función
F1	Punto de Venta
F2	Dashboard
F3	Productos
F4	Inventario
F5	Precios
F6	Caja y Turnos
F7	Reportes
F8	Foco en buscador
F9	Foco en monto recibido
F10	Cobrar venta
F12	Ayuda
Ctrl+Shift+E	Ítem Express
Ctrl+Shift+X	Anular última venta
Ctrl+Shift+N	Nuevo producto
Ctrl+Shift+S	Guardar datos

🔐 Roles y Permisos

Funcionalidad	👑 Admin	👤 Cajero
Punto de venta	✅	✅
Ver productos	✅	✅
Crear/Editar productos	✅	❌
Eliminar productos	✅	❌
Actualizar precios	✅	❌
Anular ventas	✅	✅
Ver reportes	✅	✅
Abrir/Cerrar caja	✅	✅
Gestionar usuarios	✅	❌
Configuración	✅	❌
Backup/Importar	✅	❌
Panel Debug	✅	❌

🔧 ¿Cómo Funciona Técnicamente?

💾 Almacenamiento

KioscoPro utiliza IndexedDB, una base de datos NoSQL integrada en todos los navegadores modernos. Los datos se guardan automáticamente en cada operación y persisten al cerrar el navegador.

🗄️ IndexedDB
• Base de datos transaccional (ACID)
• Capacidad: varios GB (limitada por disco)
• Búsquedas por índice
• 100% offline
• Más robusta que localStorage

📂 Estructura de Datos

Los datos se organizan en un objeto JSON con esta estructura:

{
"productos": [
{ "id": 1, "codigo": "779...", "nombre": "...",
"precio": 1850, "costo": 1420, "stock": 25, "stockMin": 10 }
],
"ventas": [
{ "id": 123, "numeroFactura": 101, "fecha": "...",
"items": [...], "total": 3700, "mediosPago": [...],
"turnoId": 456, "cajero": "...", "anulada": false }
],
"turnos": [...],
"movimientosCaja": [...],
"usuarios": [...],
"config": { "nombreNegocio": "...", "cuit": "...", ... }
}

🎨 Interfaz

La interfaz se renderiza dinámicamente con JavaScript template literals. Cada sección (Dashboard, Ventas, Productos, etc.) es una función que retorna HTML. Al navegar, se reemplaza el contenido del panel principal.

🌓 Tema Claro/Oscuro

Se implementa con variables CSS y un atributo data-theme en el elemento <html>. Al cambiar el tema, se alternan los valores de las variables y todos los elementos se adaptan automáticamente.

🔐 Autenticación

Los usuarios y contraseñas se almacenan en IndexedDB. Al iniciar sesión, se compara con los datos guardados. Cada usuario tiene un rol que determina qué funciones puede usar mediante un objeto de permisos.

💾 Backups

Automáticos cada 30 minutos y al cerrar caja. Se guardan como registros adicionales en IndexedDB con prefijo backup_. Se mantienen los últimos 10 backups. También se puede exportar/importar manualmente como archivo JSON.

🖥️ Requisitos del Sistema

Componente	Mínimo	Recomendado
Navegador	Firefox 80+, Chrome 86+, Edge 86+	🦊 Firefox (última versión)
RAM	2 GB	4 GB
Pantalla	1024x768	1366x768 o superior
Sistema Operativo	Cualquiera con navegador	Windows 10/11, Linux, Android (tablet)

💡 Recomendaciones

• 🦊 Usar Mozilla Firefox por su privacidad y eficiencia con IndexedDB
• 💾 Hacer backup manual periódico (📥 Descargar JSON)
• 🔐 Cambiar la contraseña de admin al iniciar
• 📱 Usar el atajo Ctrl+Shift+E para Ítem Express
• ⌨️ Aprender los atajos de teclado para mayor velocidad
• 🖨️ Conectar una impresora térmica para tickets

👤 Autor

Fabián Bonetti

📧 lu4ehf@gmail.com

📦 gitlab.com/lu4ehf/kioscopro

📜 Licencia GPL v3 - Software Libre

---

¿Te es útil? ❤️

Donar con Mercado Pago

---

KioscoPro v1.3 - Hecho con ❤️ en Argentina 🇦🇷