// caso de estudio · havada-desktop
HavadaDesktop
ERP de escritorio multiusuario para negocios pequeños: facturación, inventario, clientes y trabajo en red desde una PC servidor, con portal público para consultar un documento y aplicaciones empaquetadas para Windows, macOS y Linux.

// índice
01 / problema
Problema
Un negocio pequeño necesita que varias PC vean y editen los mismos datos, pero no siempre quiere depender de un SaaS ni de mantener un servidor en la nube.
Encima, la facturación en República Dominicana añade reglas propias: rangos NCF, padrón de RNC e ITBIS. Un formulario genérico se queda corto.
02 / solución
Solución
Una PC actúa como servidor: guarda un JSON central, corre la API Express y emite cambios por Socket.IO. El resto de las PC se conectan con un cliente Electron y siempre trabajan sobre la misma base de datos.
El acceso va por usuario y contraseña con bcrypt y JWT de 12 horas, con cinco roles —administrador, contador, vendedor, almacén y técnico— y permisos centralizados.
Cada factura puede generar un enlace público con un token aleatorio para que el cliente consulte su documento sin iniciar sesión.
03 / resultado
Resultado
Versión 1.0.0 con scripts para empaquetar Windows, macOS y Linux; hay cinco capturas reales de configuración, login, panel, facturación e inventario.
El README es honesto con los límites: está pensado para LAN o acceso remoto configurado —VPN/HTTPS si se expone—, WhatsApp no envía automáticamente y la restauración no comprueba permisos por sí sola. No hay script `test` en `package.json`.
04 / decisiones técnicas
Cómo está construido
D01
JSON central y escrituras atómicas
La base es un archivo JSON con colecciones y ajustes. Las escrituras pasan por un temporal y un rename para no dejar archivos a medias. El padrón de RNC de la DGII se guarda aparte, en un Map en memoria con un archivo de texto de apoyo.
D02
Permisos en un solo sitio
La tabla de permisos es única; las rutas la aplican con authenticate y requirePermission. Un usuario desactivado pierde el acceso de inmediato, sin esperar a que expire su token. El WebSocket exige el mismo JWT y cada usuario entra en su propia sala.
D03
NCF como rango, no como texto libre
Solo el administrador crea rangos y el sistema valida el número asignado. El ITBIS es configurable y el descuento se aplica antes del impuesto. Es una herramienta local que respeta esas reglas; no es facturación electrónica ni envía nada a la DGII.
D04
Portal con límites claros
El token del portal tiene 160 bits y la ruta pública permite 60 peticiones cada 15 minutos. La imagen de subida se valida por magic bytes, no por extensión, y la app impone CSP y CORS deshabilitado.
05 / galería
Capturas reales




