Skip to content

ZIVLO-Team/zivlo-app

Repository files navigation

ZIVLO

Cobra en segundos. Sin internet. Sin complicaciones.


👋 Bienvenido a ZIVLO

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.


🎯 Nuestra Misión

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.


📦 Repositorios

Repositorio Descripción Estado
zivlo App móvil Flutter — POS offline-first ✅ En desarrollo
zivlo-backend API FastAPI + PostgreSQL para sincronización 📋 Pendiente
zivlo-license-generator Generador de licencias JWT 📋 Pendiente

🚀 Producto Principal: Zivlo POS

El punto de venta diseñado para el comercio real en Latinoamérica.

Características Principales

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

¿Para quién es Zivlo?

  • 🏪 Tiendas de abarrotes y retail
  • 🛒 Supermercados pequeños
  • 🎪 Stands de exposición y ferias
  • 🚚 Vendedores ambulantes
  • 💼 Emprendedores en formación

🏗️ Arquitectura Técnica

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      │
└─────────────────────────────────────────┘

Stack Tecnológico

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

🎨 Identidad de Marca

Nuestro Logo

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.

Versión Principal Sobre Accent Solo Símbolo
zivlo zivlo

Paleta de Colores

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

Tipografía

  • Display/Headlines: Syne — Bold 700–800
  • Body/UI: DM Sans — Regular 300–500
  • Números/Precios: Space Mono — Regular 400, Bold 700

📊 Métricas de Éxito

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%

🤝 Contribuir

¡Las contribuciones son bienvenidas! Revisa los repositorios individuales para guías específicas de contribución.

Código de Conducta

  • 🌟 Sé respetuoso y colaborativo
  • 🎯 Enfócate en el impacto real para usuarios
  • 📚 Comparte conocimiento abiertamente
  • 🐛 Reporta bugs y sugiere mejoras

📄 Licencia

Todos los repositorios de ZIVLO-Team están licenciados bajo MIT License a menos que se indique lo contrario.


📞 Contacto

Canal Enlace
🌐 Website zivlo.app (próximamente)
📧 Email contact@zivlo.app
💬 Issues GitHub Issues
📦 Releases GitHub Releases

🚀 Únete a nosotros

Hecho con ❤️ para el comercio real en Latinoamérica

ZIVLO-Team © 2024