Somos una organización dedicada a desarrollar soluciones tecnológicas para el comercio latinoamericano real. Nuestro producto principal es un punto de venta (POS) offline-first que convierte cualquier smartphone Android en una caja registradora completa, sin necesidad de internet ni hardware costoso.
Eliminar las barreras tecnológicas para pequeños comerciantes en Latinoamérica, proporcionando herramientas accesibles que funcionen en las condiciones reales de conectividad de la región.
| Repositorio | Descripción | Estado |
|---|---|---|
| zivlo-app | App móvil Flutter — POS offline-first | ✅ En desarrollo |
| zivlo-docs | Documentación oficial del proyecto | ✅ Disponible |
| zivlo-backend | API FastAPI + PostgreSQL para sincronización | 📋 Pendiente |
| zivlo-license-generator | Generador de licencias JWT | 📋 Pendiente |
El punto de venta diseñado para el comercio real en Latinoamérica.
| Feature | Descripción |
|---|---|
| 📷 Escaneo | Código de barras con cámara (EAN, QR, Code128, UPC-A) |
| 🛒 Carrito | Gestión de compras con descuentos y totales automáticos |
| 💵 Pagos | Efectivo, tarjeta y pago mixto con calculadora de cambio |
| 🖨️ Impresión | Conecta impresoras térmicas Bluetooth 58mm/80mm |
| 📊 Historial | Consulta de ventas por fecha con resúmenes diarios |
| 📦 Catálogo | Gestión completa de productos con stock y categorías |
| 🚫 Offline | 100% funcional sin conexión a internet |
- 🏪 Tiendas de abarrotes y retail
- 🛒 Supermercados pequeños
- 🎪 Stands de exposición y ferias
- 🚚 Vendedores ambulantes
- 💼 Emprendedores en formación
Utilizamos Clean/Hexagonal Architecture para construir software escalable, testeable y mantenible.
┌─────────────────────────────────────────┐
│ Presentation Layer (Flutter) │
│ BLoCs · Widgets · UI │
├─────────────────────────────────────────┤
│ Application Layer │
│ Use Cases · Either<Failure, T> │
├─────────────────────────────────────────┤
│ Domain Layer │
│ Entities · Value Objects · Ports │
├─────────────────────────────────────────┤
│ Infrastructure Layer │
│ Adapters · Hive · Hardware · API │
└─────────────────────────────────────────┘
| Capa | Tecnologías |
|---|---|
| Mobile | Flutter 3.x, Dart 3.x |
| Estado | BLoC Pattern (flutter_bloc) |
| Backend | FastAPI, PostgreSQL, SQLAlchemy |
| Base de Datos | Hive (local), PostgreSQL (server) |
| Hardware | mobile_scanner, bluetooth_thermal |
| Licencias | JWT con firma HMAC-SHA256 |
El símbolo de Zivlo fusiona un rayo (velocidad, energía, instantáneo) con la silueta de un recibo de papel (borde dentado característico). La lectura es inmediata: velocidad + comercio.
Logo Principal
Símbolo (Ícono de App)
| Color | Hex | Uso |
|---|---|---|
#E94560 |
Accent — CTAs, logo, acciones principales | |
#1A1A2E |
Primary — Fondos, app icon | |
#0F3460 |
Surface — Cards, sheets | |
#00D97E |
Success — Confirmaciones, stock | |
#FFB830 |
Warning — Alertas, cambios |
| Fuente | Uso | Peso |
|---|---|---|
| Syne | Display, Headlines | 700–800 |
| DM Sans | Body, UI, Botones | 300–600 |
| Space Mono | Números, Precios, Recibos | 400, 700 |
| Meta | Objetivo |
|---|---|
| ⏱️ Tiempo de transacción | < 20 segundos (escanear → cobrar → imprimir) |
| 🎯 Tasa de error en escaneo | < 2% |
| 🔗 Conexión BT | < 3 segundos |
| 💾 Pérdida de datos | 0% |
| 📈 Retención a 30 días | 70% |
¡Las contribuciones son bienvenidas! Revisa los repositorios individuales para guías específicas de contribución.
- 🌟 Sé respetuoso y colaborativo
- 🎯 Enfócate en el impacto real para usuarios
- 📚 Comparte conocimiento abiertamente
- 🐛 Reporta bugs y sugiere mejoras
Todos los repositorios de ZIVLO-Team están licenciados bajo MIT License a menos que se indique lo contrario.
| Canal | Enlace |
|---|---|
| 🌐 Website | zivlo.app (próximamente) |
| contact@zivlo.app | |
| 💬 Issues | GitHub Issues |
| 📦 Releases | GitHub Releases |