# Scripts de Utilidad

Este directorio contiene scripts para facilitar el desarrollo y testing de la aplicación.

## 📊 Seed de Proyectos de Prueba

### Opción 1: Via API Route de Next.js (Recomendado) ✅

Este método es más seguro ya que usa la API Route protegida.

**Requisitos:**
- El servidor de Next.js debe estar corriendo (`npm run dev`)
- Dolibarr debe estar accesible

**Uso:**
```bash
npm run seed
```

**Lo que hace:**
- Crea 12 proyectos de prueba con datos realistas
- Diferentes estados de progreso (0%, 15%, 35%, 50%, 65%, 75%, 90%, 100%)
- Variedad de presupuestos (€28k - €120k)
- Fechas de inicio y fin variadas
- Valida automáticamente los proyectos con progreso > 0%

**Proyectos incluidos:**
1. Desarrollo de App Móvil (65%)
2. Rediseño Web Corporativo (90%)
3. Sistema de Facturación Automática (35%)
4. Migración a Cloud AWS (20%)
5. Dashboard Analítico BI (100% - completado)
6. API REST Microservicios (50%)
7. App de Gestión de Proyectos (75%)
8. E-commerce con Marketplace (15%)
9. Sistema CRM Personalizado (0% - borrador)
10. Portal de Empleados (100% - completado)
11. Sistema de Reservas Online (45%)
12. App de Formación Online (30%)

---

### Opción 2: Conexión Directa a Dolibarr

Este método se conecta directamente a la API de Dolibarr (sin pasar por Next.js).

**Requisitos:**
- Dolibarr debe estar accesible
- Variables de entorno configuradas en `.env.local`

**Uso:**
```bash
npm run seed:direct
```

⚠️ **Nota:** Este método usa las credenciales directamente desde `.env.local`.

---

## 🔧 Troubleshooting

### Error: "No se puede conectar al servidor Next.js"
**Solución:** Asegúrate de que el servidor esté corriendo:
```bash
npm run dev
```

### Error: "Dolibarr API error"
**Soluciones posibles:**
1. Verifica que Dolibarr esté corriendo (Docker)
2. Revisa las credenciales en `.env.local`
3. Verifica que la URL de la API sea correcta

### Error: "No se pudo validar"
**No te preocupes:** Es normal. Algunos proyectos se crean correctamente pero no se pueden validar automáticamente. Puedes validarlos manualmente desde Dolibarr si es necesario.

---

## 🧹 Limpiar Proyectos de Prueba

Si quieres eliminar los proyectos de prueba creados, puedes hacerlo desde la interfaz de Dolibarr o usando la API:

```bash
# TODO: Crear script de limpieza
# npm run clean:projects
```

---

## 📝 Notas

- Los scripts pausan 500ms entre cada creación para no saturar la API
- Los proyectos con progreso 0% se dejan como "borrador"
- Los proyectos con progreso > 0% se intentan validar automáticamente
- Todos los proyectos tienen descripciones detalladas
- Las fechas están distribuidas entre 2023 y 2025

---

## 🎨 Personalización

Para modificar los proyectos de prueba, edita el array `projectsData` en cualquiera de los scripts:

```javascript
{
  title: "Tu Proyecto",
  ref: "PROJ-2024-XXX",
  description: "Descripción detallada...",
  opp_amount: 50000,        // Presupuesto en euros
  opp_percent: 50,          // Progreso (0-100)
  date_start: timestamp,    // Unix timestamp en segundos
  date_end: timestamp,      // Unix timestamp en segundos
}
```