Zivlo Documentation

Documentación oficial de Zivlo — Punto de Venta Offline-First para el comercio latinoamericano.

---

📚 Contenido

Documentación del Producto

Archivo	Descripción
docs/PRD.md	Requisitos del Producto (Product Requirements Document)
docs/Brand.md	Identidad de Marca y posicionamiento
docs/Context.md	Contexto del proyecto y arquitectura
docs/Design.md	Especificaciones de diseño por pantalla
docs/Styles.md	Sistema de diseño visual (colores, tipografía)
docs/AppFlow.md	Flujos de usuario y navegación
docs/Stack.md	Stack tecnológico y dependencias
docs/RELEASES.md	Proceso de releases y versionado

Planes de Implementación

Archivo	Descripción
docs/plans/2024-03-24-mvp-core-features-plan.md	Plan MVP - Features core
docs/plans/2024-03-25-cicd-profesional-plan.md	Plan CI/CD profesional
docs/plans/2026-03-25-zivlo-backend-server-design.md	Diseño del backend server
docs/plans/2026-03-25-zivlo-license-system-design.md	Sistema de licencias

Guías de Contribución

• CONTRIBUTING.md — Cómo contribuir al proyecto
• CHANGELOG.md — Historial de cambios
• ORGANIZATION.md — Estructura de la organización

---

🏗️ Arquitectura del Proyecto

Zivlo usa Clean/Hexagonal Architecture para mantener el código limpio, testeable y escalable.

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

---

🎨 Identidad de Marca

Logo

zivlo

Colores de Marca

Color	Hex	Uso
Accent	#E94560	CTAs, logo, acciones principales
Primary	#1A1A2E	Fondos, app icon
Surface	#0F3460	Cards, sheets
Success	#00D97E	Confirmaciones, stock
Warning	#FFB830	Alertas, cambios

---

📦 Repositorios Relacionados

Repositorio	Descripción
zivlo-app	App móvil Flutter — POS offline-first
zivlo-backend	API FastAPI + PostgreSQL
zivlo-license-generator	Generador de licencias JWT

---

📞 Contacto

• Website: zivlo.app (próximamente)
• Email: contact@zivlo.app
• Issues: GitHub Issues

---

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

ZIVLO-Team © 2024