Zolve

Super-App de servicios bajo demanda para Cali, Colombia

Plataforma que revoluciona la seguridad y eficiencia en servicios bajo demanda, cumpliendo estrictamente con los estandares de la Ley 2466 de 2025 (Regulacion de Plataformas Digitales).

---

Table of Contents

• flag Propósito
• image Screenshots
• star Características
• architecture Arquitectura Tecnológica
• download Instalación
• settings Configuración
• build Comandos Principales
• folder Estructura del Proyecto
• map Roadmap
• description Licencia

---

flag Propósito

En un entorno urbano dinámico como Cali, la confianza es nuestra moneda principal. Zolve no solo conecta oferta y demanda; integra un ecosistema de seguridad avanzada:

• check_circle Cumplimiento Normativo: Alineación total con la Ley 2466/2025 para la protección de trabajadores digitales
• security Seguridad Biométrica: Verificación de Cédula de Ciudadanía mediante IA en tiempo real (OpenCV + Liveness Detection)
• shield Respaldado por Gigantes: Micro-seguros integrados por Allianz para cada tarea (Póliza #ZT-2026)
• credit_card Pagos Inmediatos: Integración nativa con Bre-B / COP y sistemas de pago colombiano
• smart_toy Motor de IA Local: Pricing inteligente con 27 categorías y contexto geográfico de Cali

---

image Screenshots

security Selección de Rol

person Flujo Cliente

Home	Explorar	Pedidos

Home Detalle	Zolve Pay	Perfil

Cliente Vista	Perfil Detalle	Pedidos Vista

group Flujo Socio

Home Socio	Servicios	Pedidos

Home Socio Detalle	Perfil Socio	Compartir Perfil

Perfil Socio Detalle	Perfil Socio Vista

---

star Características

rocket Core

• location_on Tracking GPS en vivo con geolocalización precisa en 30 barrios de Cali
• sync Arquitectura dual Cliente/Socio con nested routes y cambio de perfil dinámico
• whatshot Base de datos en tiempo real con Firebase Firestore (fallback a localStorage)
• map Geocoding real con Nominatim API + cálculo de distancia haversine
• local_offer Motor de pricing con IA: factores de zona, urgencia, materiales y distancia

security Seguridad

• verified_user Verificación biométrica de identidad (KYC)
• face Detección de liveness con OpenCV (análisis de sonrisa + varianza del Laplaciano)
• id_card Validación de documentos PDF417 (cédula colombiana)
• analytics Análisis de calidad de imagen en tiempo real

palette Experiencia de Usuario

• sparkles Design system premium con Tailwind CSS v4
• text_fields Tipografía Bebas Neue + Roboto Flex Variable
• dark_mode Dark mode nativo en toda la aplicación
• notifications Notificaciones toast en tiempo real
• flash_on Transiciones de ruta optimizadas

---

architecture Arquitectura Tecnológica

Frontend

Componente	Tecnologia	Version
Framework	React	19.2.0
Build Tool	Vite	7.3.1
Routing	React Router DOM	7.13.1
Styling	Tailwind CSS	4.2.1
Mapas	Leaflet + React-Leaflet	1.9.4 / 5.0.0
Iconos	Material Symbols Outlined	CDN
Mobile	Capacitor	8.2.0

Backend & IA

Componente	Tecnologia	Proposito
API	FastAPI	Microservicio de IA
Vision por Computadora	OpenCV	KYC + deteccion facial
Procesamiento	NumPy	Analisis de imagenes
Validacion	Pydantic	Esquemas de datos

Infraestructura

Servicio	Uso
Firebase Firestore	Base de datos en tiempo real
Docker + Docker Compose	Contenedores de produccion
Nginx	Servidor estatico
Nominatim (OSM)	Geocoding de direcciones

---

download Instalación

list Requisitos Previos

• Node.js >= 20.x
• npm >= 10.x
• Python 3.10+ (para backend de IA)

build Pasos de Instalación

laptop Frontend

# 1. Clonar el repositorio
git clone https://github.com/Zolve-app/Zolve.git
cd Zolve 

# 2. Instalar dependencias
npm install

# 3. Iniciar servidor de desarrollo
npm run dev

settings_suggest Backend (IA Service)

# Navegar al directorio del backend
cd backend/ai_service

# Crear entorno virtual
python -m venv venv

# Activar entorno virtual
source venv/bin/activate  # Linux/Mac
# o
venv\Scripts\activate  # Windows

# Instalar dependencias
pip install -r requirements.txt

# Iniciar servidor FastAPI
uvicorn app:app --reload

vpn_key Variables de Entorno

Crear un archivo .env en la raíz del proyecto con:

# Firebase Configuration
VITE_FIREBASE_API_KEY=tu_api_key
VITE_FIREBASE_AUTH_DOMAIN=tu_project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=tu_project_id
VITE_FIREBASE_STORAGE_BUCKET=tu_project.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=tu_sender_id
VITE_FIREBASE_APP_ID=tu_app_id

# Google Maps
VITE_GOOGLE_MAPS_KEY=tu_google_maps_api_key

# Backend API
VITE_BACKEND_URL=http://localhost:8000

terminal Comandos Principales

react Frontend:

npm run dev              # Iniciar servidor de desarrollo
npm run build            # Build de producción
npm run preview          # Preview de build
npm run lint             # Ejecutar linter

phone_android Capacitor (Mobile):

npx cap sync            # Sincronizar con plataformas nativas
npx cap open android    # Abrir en Android Studio
npx cap open ios        # Abrir en Xcode
npx cap run android     # Ejecutar en dispositivo Android

dataset Docker:

docker-compose up -d    # Levantar contenedores
docker-compose down     # Detener contenedores
docker-compose build    # Reconstruir imágenes

folder Estructura del Proyecto

Zolve/
├── src/
│   ├── components/         # Componentes reutilizables
│   │   ├── AIEstimator.jsx
│   │   ├── BottomNav.jsx
│   │   ├── Layout.jsx
│   │   ├── PartnerRadar.jsx
│   │   └── SocioLayout.jsx
│   ├── context/            # Estado global
│   │   └── ZolveContext.jsx
│   ├── data/               # Datos mock y seeds
│   │   └── mockData.js
│   ├── lib/                # Utilidades y configuraciones
│   │   ├── firebase.js
│   │   └── zolveGeo.js
│   ├── views/              # Vistas principales
│   │   ├── socio/          # 6 vistas del panel Socio
│   │   └── [25 vistas Cliente]
│   ├── App.jsx             # Router principal
│   ├── index.css           # Design system y tokens
│   └── main.jsx            # Entry point
├── backend/
│   └── ai_service/         # Microservicio FastAPI + OpenCV
├── public/                 # Assets estaticos
├── screenshots/            # Capturas de pantalla
├── docker-compose.yml      # Orquestacion de contenedores
├── package.json
└── README.md

map Roadmap

calendar_month Q3 2026

• check_circle Autenticación Firebase completa (Google/Apple Sign-In)
• check_circle Integración pasarela de pagos real (PSE/Nequi/Daviplata)
• check_circle KYC productivo con OCR PDF417 real

calendar_month Q4 2026

• star Sistema de reputación y calificaciones
• chat Chat en tiempo real cliente-socio
• history Historial de servicios con filtros avanzados

calendar_month 2027

• public Expansión a Bogotá y Medellín
• card_giftcard Programa de lealtad Z-Points
• developer_mode API pública para desarrolladores

description Licencia

Distribuido bajo la Licencia MIT. Ver LICENSE para más información.

phone Contacto

Zolve Engineering - Cali, Colombia

• mail Email: contacto@zolve.app
• language Website: https://zolve.app

favorite Hecho para la comunidad de Cali, Colombia