trello_fake/QUICK_START.md

# 🚀 Guía Rápida de Uso

## Paso 1: Iniciar Dolibarr (Docker)

Si tienes Dolibarr en Docker:

```bash
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

```bash
# 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):

```bash
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**

1. Accede a Dolibarr: `http://localhost:8200`
2. Login: admin / p4ssw0rd
3. Ve a Proyectos > Nuevo Proyecto
4. 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
1. Busca proyectos con badge verde "Cerrado"
2. O con progreso del 100%
3. Ejemplos: "Dashboard Analítico BI", "Portal de Empleados"

### Ver proyectos en progreso
1. Busca proyectos con badge azul "Abierto"
2. Progreso entre 1% y 99%
3. Ejemplo: "App de Gestión de Proyectos" (75%)

### Ver borradores
1. Busca proyectos con badge gris "Borrador"
2. Progreso del 0%
3. Ejemplo: "Sistema CRM Personalizado"

### Comparar presupuestos
1. Cambia a vista de lista (☰)
2. Compara la columna "Presupuesto"
3. Proyecto más caro: "E-commerce con Marketplace" (€120k)

---

## 🐛 Solución de Problemas

### No veo proyectos
```bash
# 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`:
```javascript
// Comenta los proyectos que no quieras
const projectsData = [
  // ... solo deja los que quieras
];
```

### Modificar datos de un proyecto
Edita el objeto correspondiente:
```javascript
{
  title: "Tu Proyecto Personalizado",
  ref: "PROJ-2024-XXX",
  description: "Tu descripción...",
  opp_amount: 75000,    // Tu presupuesto
  opp_percent: 80,      // Tu progreso
  // ...
}
```

Luego ejecuta:
```bash
npm run seed
```

---

## 🔄 Resetear todo

### Limpiar proyectos en Dolibarr
1. Accede a Dolibarr
2. Ve a cada proyecto
3. Elimina uno por uno

### Limpiar caché de Next.js
```bash
rm -rf .next
npm run dev
```

### Empezar de cero
```bash
# 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 🎉