Vindex es una aplicación moderna de gestión de inventarios sin conexión a internet (offline-first), diseñada especialmente para la gestión de productos, fechas de caducidad y organización física en cajas de almacenamiento.
- Gestión Completa de Productos: Alta, edición, eliminación y visualización de productos.
- Detección de Caducidad: Alertas visuales inteligentes para productos por vencer (menos de 90 días) o ya vencidos.
- Organización por Cajas: Organización física asignando productos a "Cajas" (Boxes) específicas.
- Búsqueda Avanzada Inmune a Acentos: Buscador optimizado para buscar ignorando acentos (ej. buscar "acai" encuentra "acaí").
- Filtros por Línea (Categoría): Chips dinámicos en la cabecera para filtrar instantáneamente el inventario por su línea de producto.
- Importador de Datos (Excel / CSV / Copiar y Pegar):
- Soporta la carga de archivos
.xlsx,.xlsy.csv. - Detección Automática de Codificación: Auto-detecta si el CSV está en UTF-8 o Windows-1252 (formato por defecto de Excel en español), evitando que los acentos se corrompan (
jabA3n➔jabón). - Copiar y Pegar: Pestaña dedicada para copiar una tabla de Google Sheets o Excel y pegarla directamente como texto (TSV).
- Fusión Inteligente: Permite elegir qué hacer con registros duplicados (sumar stock, sobreescribir o ignorar).
- Soporta la carga de archivos
- Formateo Completo: Opción rápida y segura en el menú de ajustes para vaciar la base de datos por completo.
- Optimización de Alto Rendimiento: Diseñada para miles de registros con re-renderizado optimizado (
useCallback+React.memo) y carga virtualizada de lista (FlatList).
- Entorno: Expo / React Native
- Lenguaje: TypeScript
- Base de Datos: SQLite nativo con Drizzle ORM
- Biblioteca UI: React Native Paper
- Gestor de Estado: Zustand
- Enrutador: Expo Router
- Node.js instalado en tu ordenador.
- Expo Go instalado en tu dispositivo móvil (para pruebas rápidas en desarrollo).
-
Instalar dependencias:
npm install
-
Iniciar servidor de desarrollo:
npx expo start
Escanea el código QR con la cámara de tu móvil (iOS) o desde la app Expo Go (Android).
Para distribuir e instalar la app directamente en dispositivos de usuarios finales sin depender de la aplicación Expo Go, puedes generar un archivo instalador nativo (APK para Android o compilar para iOS).
Usaremos EAS Build (Expo Application Services), el servicio en la nube oficial de Expo.
- Debes tener una cuenta gratuita en Expo.dev.
- Instala la herramienta CLI de EAS de manera global en tu terminal:
npm install -g eas-cli
- Inicia sesión con tu cuenta de Expo:
eas login
El perfil preview está configurado para compilar directamente un archivo .apk instalable en cualquier móvil Android.
Ejecuta el siguiente comando en la terminal de tu proyecto:
eas build --platform android --profile preview¿Qué pasará a continuación?
- EAS empaquetará el código y subirá el proyecto a los servidores de compilación de Expo.
- Tras unos minutos, la terminal te proporcionará un código QR y un enlace directo de descarga.
- Abre el enlace en el móvil donde quieras instalar la app, descarga el archivo
.apke instálalo. (Es posible que Android te pida habilitar "Instalar aplicaciones de fuentes desconocidas" para tu navegador, lo cual es normal al instalar apps que no vienen directamente de Google Play).
Para compartir con usuarios de iPhone, Apple requiere un flujo diferente:
- Opción de Desarrollo Interno (Ad-hoc):
(Nota: Requiere una cuenta de desarrollador de Apple de pago para registrar los dispositivos UUIDs en los que se instalará).
eas build --platform ios --profile preview
- Distribución de Producción (TestFlight / App Store):
Una vez completada la compilación, se puede enviar directamente a TestFlight para invitar a usuarios de prueba (testers) por correo electrónico a probar la aplicación en sus iPhones.
eas build --platform ios --profile production
Este proyecto sigue una arquitectura limpia (Clean Architecture):
src/domain: Entidades y Reglas de Negocio puras (independientes de la base de datos y UI).src/data: Acceso a datos locales, esquemas de Drizzle, repositorios de SQLite y migraciones.src/presentation: Componentes, pantallas, estados globales de Zustand y estilos de la interfaz de usuario.