trello_fake/scripts/README.md

3.1 KiB

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:

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:

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:

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:

# 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:

{
  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
}