ERP Delivery Home

Un sistema ERP moderno y escalable para gestionar operaciones de una agencia de delivery. Construido con React, Vite, TailwindCSS y Zustand.

🚀 Características

• Dashboard Interactivo: Resumen ejecutivo con métricas clave
• Módulo de Ventas: Gestión de ventas y pedidos
• Módulo de Inventario: Control de stock y productos
• Módulo de Contabilidad: Gestión financiera y reportes
• Módulo de Pagos: Administración de transacciones y pagos
• Módulo de Clientes: Base de datos de clientes y contactos
• Navegación Responsiva: Sidebar adaptable a dispositivos móviles
• Tema Moderno: Diseño limpio y profesional con TailwindCSS
• Estado Global Centralizado: Gestión de estado con Zustand

📋 Estructura del Proyecto

src/
├── features/              # Módulos principales (features por carpeta)
│   ├── dashboard/        # Dashboard principal
│   ├── ventas/          # Módulo de ventas
│   ├── inventario/      # Módulo de inventario
│   ├── contabilidad/    # Módulo de contabilidad
│   ├── pagos/           # Módulo de pagos
│   └── clientes/        # Módulo de clientes
├── components/
│   ├── layout/          # Componentes de layout (Header, Sidebar, MainLayout)
│   ├── common/          # Componentes reutilizables
│   └── ui/              # Componentes base de UI (Button, Input, Card, Badge)
├── stores/              # Stores de Zustand (estado global)
│   ├── authStore.js     # Estado de autenticación
│   └── uiStore.js       # Estado de UI
├── hooks/               # Custom hooks
├── utils/               # Funciones de utilidad
├── styles/              # Estilos globales
└── router/              # Configuración de rutas

🛠️ Tecnologías

• React 19+: Librería UI
• Vite 8: Build tool y dev server
• TailwindCSS 3: Framework CSS
• Zustand: Gestión de estado global
• React Router 6: Enrutamiento
• Lucide React: Iconos

⚙️ Instalación

Requisitos Previos

• Node.js 18+
• npm o yarn

Pasos

1. Clonar o descargar el proyecto:

cd economia-delivery-home

2. Instalar dependencias:

npm install

3. Iniciar servidor de desarrollo:

npm run dev

La aplicación estará disponible en http://localhost:5173

📦 Scripts Disponibles

• npm run dev - Iniciar servidor de desarrollo
• npm run build - Compilar para producción
• npm run preview - Preview de compilación
• npm run lint - Ejecutar linter

🎨 Diseño Responsivo

La aplicación está completamente optimizada para:

• 📱 Dispositivos móviles
• 📱 Tablets
• 🖥️ Pantallas de escritorio

🔐 Estado de Autenticación

El sistema incluye auto-login para demostración. Para producción, implementar:

• Sistema de autenticación real
• Validación de credenciales
• Tokens JWT

📝 Próximos Pasos

1. Implementar Módulos: Completar lógica de cada módulo
2. Backend: Conectar con API backend
3. Validación: Agregar validación de formularios
4. Temas: Implementar modo oscuro/claro
5. Notificaciones: Agregar sistema de notificaciones
6. Reportes: Implementar generación de reportes PDF/Excel

🤝 Contribuir

Para contribuir al proyecto, seguir estas pautas:

1. Mantener la estructura de carpetas existente
2. Respetar el patrón de features por módulo
3. Usar componentes reutilizables de UI
4. Documentar cambios importantes

📄 Licencia

Proyecto privado para Delivery Home

📧 Contacto

Para consultas sobre el proyecto, contactar al equipo de desarrollo.

---

Última actualización: Marzo 2026