Skip to content

Repository files navigation

Vendra

Sistema de gestión de pedidos e inventario optimizado para rendimiento

Live Demo Next.js TypeScript Tailwind CSS Prisma Docker License: MIT CI

Demo showcase desarrollado por Lykos - Performance-Driven Web Solutions. La pantalla de login tiene autenticación básica para el demo. Credenciales: vendra2026


🌐 English Summary

Vendra is an open-source order and inventory management dashboard for small and medium businesses (SMBs). Built as a demo/portfolio showcase by Lykos - Performance-Driven Web Solutions.

Features: order tracking with status workflow, customer directory with order history, product catalog with stock alerts, and a sales dashboard with charts.

Stack: Next.js 16 (App Router) · TypeScript · Tailwind CSS v4 · Prisma · SQLite · Recharts

Live demo: vendra.lykos.com.ar — pre-seeded with realistic Argentine business data (15 products, 20 customers, 60 orders over 3 months).


✨ Funcionalidades

  • 📊 Panel general — ventas del mes con variación contra el mes anterior, pedidos pendientes, alertas de stock bajo y gráfico de ventas de los últimos 30 días.
  • 📦 Pedidos — listado con filtros por estado (PENDIENTE, EN_PREPARACION, ENVIADO, ENTREGADO), vista de detalle con los productos y cambio de estado con un clic.
  • 👥 Clientes — directorio con búsqueda por nombre, email o ciudad, y ficha con historial completo de compras.
  • 🏷️ Productos — alta, edición y baja con control de stock y alerta visual cuando el stock llega al mínimo configurado.

🛠️ Stack

Tecnología Uso
Next.js 16 (App Router) Framework web + Server Actions
TypeScript Tipado estático
Tailwind CSS v4 Estilos
Prisma + SQLite Base de datos
Recharts Gráfico de ventas
Lucide Íconos

🚀 Cómo correrlo localmente

Requisitos: Node.js 20+

# 1. Clonar e instalar
git clone https://github.com/Lykos-Software-Solutions/vendra.git
cd vendra
npm install

# 2. Configurar entorno
cp .env.example .env

# 3. Crear la base y cargar datos de ejemplo
npm run db:setup

# 4. Levantar el servidor de desarrollo
npm run dev

Abrí http://localhost:3000. El seed carga 15 productos, 20 clientes y 60 pedidos distribuidos en los últimos 3 meses.


🐳 Docker

docker run -p 3000:3000 \
  -v vendra-data:/app/data \
  -e DATABASE_URL=file:/app/data/vendra.db \
  ghcr.io/lykos-software-solutions/vendra:latest

Al arrancar, el contenedor aplica las migraciones y ejecuta el seed solo si la base está vacía, así el demo siempre levanta con datos sin pisarlos en cada reinicio.


☁️ Deploy con Dokploy / Docker Compose

El repo incluye un Dockerfile pensado para Dokploy (build type Dockerfile).

Qué Valor
Variable de entorno DATABASE_URL=file:/app/data/vendra.db
Volumen (mount) /app/data
Puerto expuesto 3000

📁 Estructura

app/
  (panel)/          Layout con sidebar y las cuatro secciones
    page.tsx        Panel general (métricas + gráfico)
    pedidos/        Listado con filtros y detalle con cambio de estado
    clientes/       Listado con búsqueda y ficha con historial
    productos/      CRUD con control de stock
  login/            Pantalla de acceso decorativa
components/         Sidebar, gráfico de ventas, badges y formularios
lib/                Cliente de Prisma, acciones de servidor y formateo es-AR
prisma/             Schema, migraciones y seed con datos realistas

🤝 Contribuciones

Este es un proyecto de demostración de Lykos - Performance-Driven Web Solutions. Leé CONTRIBUTING.md antes de abrir un PR.

¿Querés una versión con autenticación real, pagos, multi-sucursal o integración con WhatsApp? hola@lykos.com.ar


📄 Licencia

MIT — © 2025 Lykos - Performance-Driven Web Solutions