4.1 KiB

Raw Permalink Blame History

🚀 Guía Rápida de Uso

Paso 1: Iniciar Dolibarr (Docker)

Si tienes Dolibarr en Docker:

docker start <nombre-contenedor-dolibarr>
# o
docker-compose up -d

Verifica que Dolibarr esté accesible en http://localhost:8200

Paso 2: Iniciar la aplicación

# Asegúrate de estar en el directorio del proyecto
cd trello_fake

# Inicia el servidor de desarrollo
npm run dev

Espera a ver:

✓ Ready in 2.3s
○ Local:   http://localhost:3000

Paso 3: Crear proyectos de prueba

Opción A: Usando el script (Recomendado)

En una nueva terminal (dejando npm run dev corriendo):

npm run seed

Verás algo como:

🚀 SEED DE PROYECTOS DE PRUEBA PARA DOLIBARR

[1/12] Desarrollo de App Móvil
    📈 Progreso: [▓▓▓▓▓▓░░░░] 65%
    💰 Presupuesto: €45,000
    ✅ Creado con ID: 1
    ✓ Validado (estado: abierto)

...

✨ PROCESO COMPLETADO
✅ Proyectos creados exitosamente: 12

Opción B: Crear proyectos manualmente en Dolibarr

Accede a Dolibarr: http://localhost:8200
Login: admin / p4ssw0rd
Ve a Proyectos > Nuevo Proyecto
Completa el formulario y guarda

Paso 4: Ver los proyectos

Abre tu navegador en: http://localhost:3000

Deberías ver:

📊 Dashboard con estadísticas
🎴 Proyectos en vista de grid (por defecto)
🔍 Barra de búsqueda funcional
🌓 Toggle de modo oscuro

Paso 5: Explorar funcionalidades

Vista de Lista

Haz clic en el botón ☰ (lista) en el header

Detalle de Proyecto

Haz clic en cualquier tarjeta de proyecto
Verás información completa: descripción, progreso, presupuesto, fechas

Búsqueda

Escribe en la barra de búsqueda
Filtra por nombre, cliente o referencia

Modo Oscuro

Haz clic en el icono ☀️/🌙 en el header
Elige: Claro, Oscuro o Sistema

🎯 Casos de Uso

Ver proyectos completados

Busca proyectos con badge verde "Cerrado"
O con progreso del 100%
Ejemplos: "Dashboard Analítico BI", "Portal de Empleados"

Ver proyectos en progreso

Busca proyectos con badge azul "Abierto"
Progreso entre 1% y 99%
Ejemplo: "App de Gestión de Proyectos" (75%)

Ver borradores

Busca proyectos con badge gris "Borrador"
Progreso del 0%
Ejemplo: "Sistema CRM Personalizado"

Comparar presupuestos

Cambia a vista de lista (☰)
Compara la columna "Presupuesto"
Proyecto más caro: "E-commerce con Marketplace" (€120k)

🐛 Solución de Problemas

No veo proyectos

# 1. Verifica que Dolibarr esté corriendo
curl http://localhost:8200

# 2. Ejecuta el seed
npm run seed

# 3. Recarga la página (F5)

Error 500 en la consola

Revisa .env.local
Verifica las credenciales de Dolibarr
Comprueba que la API esté habilitada en Dolibarr

Página en blanco

Abre la consola del navegador (F12)
Busca errores en rojo
Verifica que npm run dev esté corriendo

🎨 Personalización

Cambiar el número de proyectos de prueba

Edita scripts/seed-projects-via-api.js:

// Comenta los proyectos que no quieras
const projectsData = [
  // ... solo deja los que quieras
];

Modificar datos de un proyecto

Edita el objeto correspondiente:

{
  title: "Tu Proyecto Personalizado",
  ref: "PROJ-2024-XXX",
  description: "Tu descripción...",
  opp_amount: 75000,    // Tu presupuesto
  opp_percent: 80,      // Tu progreso
  // ...
}

Luego ejecuta:

npm run seed

🔄 Resetear todo

Limpiar proyectos en Dolibarr

Accede a Dolibarr
Ve a cada proyecto
Elimina uno por uno

Limpiar caché de Next.js

rm -rf .next
npm run dev

Empezar de cero

# Detén el servidor (Ctrl+C)
rm -rf .next
npm run dev
npm run seed

📚 Referencias Rápidas

Acción	Comando
Iniciar desarrollo	`npm run dev`
Crear proyectos	`npm run seed`
Build producción	`npm run build`
Ver logs	Ver terminal donde corre `npm run dev`
Ver API calls	F12 > Network > Fetch/XHR

¡Listo! Ya puedes explorar tu dashboard de proyectos Dolibarr 🎉

4.1 KiB Raw Permalink Blame History