App Milagros
Sistema de punto de venta e inventario local-first, 100 % offline, para un comercio de productos capilares.
- Tipo
- Comercial (freelance)
- Estado
- En producción
- Año
- 2026
- Rol
- Desarrollador Full Stack principal
- Stack
- Node.js
- Express 5
- SQLite (better-sqlite3)
- JavaScript
- HTML5
- CSS3
- PDFKit
- ExcelJS
- bcrypt
- @yao-pkg/pkg

Problema
El negocio, un comercio de productos capilares en San Roque, Antioquia, necesitaba controlar ventas, inventario y créditos sin depender de internet y en equipos de pocos recursos.
Solución
Sistema POS e inventario local-first, 100 % offline, empaquetado como ejecutable .exe para equipos de 4 GB de RAM.
Funciones
- Productos y stock
- Escáner de códigos de barras
- Ventas a crédito y control de deudores
- Facturación con impresora térmica de 80 mm
- Recibos por correo
- Reportes e historial
- Exportación a Excel y PDF
- Copias de seguridad automáticas
Decisiones técnicas
SQLite en lugar de PostgreSQL
Es una base de datos liviana que va incluida en el mismo paquete de la aplicación, así que no hay que instalar nada en el equipo del cliente.
Rendimiento en 4 GB de RAM
El servidor del cliente tenía esa limitación, por lo que se redujo el trabajo innecesario tanto en el servidor como en el cliente. Por ejemplo, no se incluyeron imágenes de productos, para mantener el sistema liviano.
Mi rol
Desarrollador Full Stack principal — arquitectura, base de datos, frontend, backend, pruebas unitarias, optimización, empaquetado e instalación en el cliente. Otra persona colaboró en 4 historias de usuario.
Galería
Enlaces
- Repositoriohttps://github.com/Brayhan23/app-milagros