╔════════════════════════════════════════════════════════════════════════════╗
║              MÓDULO WHMCS v2.0 - RESUMEN RÁPIDO DE INSTALACIÓN            ║
╚════════════════════════════════════════════════════════════════════════════╝

📋 CHECKLIST ANTES DE INSTALAR
═════════════════════════════════════════════════════════════════════════════

EN WHMCS:
□ Verificar que PHP 7.4+ y versión WHMCS 8.13.3+
□ Setup → API Configuration: MARCAR "Enable API access"
□ Setup → Staff Management → Manage API Credentials: CREAR credencial nueva
  - Rol DEBE tener estos permisos:
    ✓ Admin Area Access
    ✓ View & Search Clients
    ✓ View Client Details
    ✓ View Invoices
    ✓ View Products
    ✓ View Domains
    ✓ View Support Tickets
    ✓ View Client Emails
□ COPIAR: API Identifier y API Secret (se muestran solo una vez)
□ GUARDAR en bloc de notas (los necesitarás en Freescout)

EN FREESCOUT:
□ Freescout v1.8.140 o superior
□ Acceso administrativo a Freescout


🚀 INSTALACIÓN RÁPIDA (5 MINUTOS)
═════════════════════════════════════════════════════════════════════════════

1. COPIAR ARCHIVOS
   Linux/Mac:  cp -r LJPcWHMCSConnect_v2.0 /ruta/freescout/modules/LJPcWHMCSConnect

   Windows:    Copiar carpeta con explorador

2. PERMISOS (Linux/Mac)
   chmod -R 755 /ruta/freescout/modules/LJPcWHMCSConnect
   chown -R www-data:www-data /ruta/freescout/modules/LJPcWHMCSConnect

3. ACTIVAR EN FREESCOUT
   a) Ir a: Administración → Módulos
   b) Buscar: "WHMCS Connect"
   c) Clic en: Activar
   d) Esperar carga...

4. CONFIGURAR
   a) Ir a: Configuración → WHMCS
   b) Llenar 3 campos:
      • Base URL: https://whmcs.ejemplo.com (SIN / al final)
      • API Identifier: (pegar de WHMCS)
      • API Secret: (pegar de WHMCS)
   c) Clic en: Guardar
   d) Esperar 5 segundos
   e) Recargar página (F5)

5. VERIFICAR
   ✓ Debe aparecer: "WHMCS is connected"
   ✓ Con detalles de versión WHMCS


🧪 TEST DE CONEXIÓN (SI ALGO FALLA)
═════════════════════════════════════════════════════════════════════════════

Abre en navegador (reemplaza con tu dominio):
https://tu-freescout.com/whmcs-connect/api/test-connection

DEBE MOSTRAR:
{
  "success": true,
  "message": "Successfully connected to WHMCS",
  "details": { "version": "8.13.3", ... }
}

Si muestra error:
1. Verifica que los 3 campos en Configuración → WHMCS están llenos
2. Verifica que NO hay espacios al pegar credentials
3. Verifica que Base URL NO termina con "/"
4. Ejecuta: php artisan cache:clear
5. Recarga página


⚠️ ERRORES COMUNES
═════════════════════════════════════════════════════════════════════════════

"WHMCS is not connected"
→ Verifica: Base URL, Identifier, Secret (sin espacios)
→ Limpia cache: php artisan cache:clear
→ Recarga página

"Failed to connect to WHMCS API"
→ Verifica: API habilitada en WHMCS (Setup → API Configuration)
→ Verifica: Rol tiene TODOS los permisos (ver lista arriba)
→ Regenera credenciales en WHMCS

"Módulo no aparece en Administración"
→ Verifica carpeta está en: /modules/LJPcWHMCSConnect/
→ Verifica permisos: chmod -R 755 modules/LJPcWHMCSConnect
→ Limpia: php artisan module:clear
→ Recarga Administración → Módulos


📚 DOCUMENTACIÓN COMPLETA
═════════════════════════════════════════════════════════════════════════════

Archivos en la carpeta:

README.md
  → Descripción general del módulo

GUIA_INSTALACION.md
  → Instalación paso a paso con imágenes mentales
  → Solución de problemas detallada

API_PERMISOS_REQUERIDOS.md
  → Tabla exacta de permisos en WHMCS
  → Verificación manual de credenciales

API_PERMISOS_REQUERIDOS.md (este archivo)
  → Resumen rápido para referencia


📞 CONTACTO SI ALGO FALLA
═════════════════════════════════════════════════════════════════════════════

Reúne esta información:

1. Respuesta de: https://tu-freescout.com/whmcs-connect/api/test-connection
2. Versión WHMCS: (Setup → General Settings)
3. Versión Freescout: (Dashboard → esquina abajo)
4. Líneas relevantes de: tail -20 storage/logs/laravel.log | grep WHMCS
5. Screenshot de: Configuración → WHMCS (con valores ocultos)

Contacto:
Email: support@ljpc.solutions
Web: https://ljpc.solutions


✅ VERIFICACIÓN FINAL
═════════════════════════════════════════════════════════════════════════════

□ Ves "WHMCS is connected" en Configuración → WHMCS
□ /whmcs-connect/api/test-connection devuelve success: true
□ Módulo está activado en Administración → Módulos
□ WHMCS API está habilitada (Setup → API Configuration)
□ Rol API tiene TODOS los permisos necesarios
□ No hay espacios en credentials (copiar/pegar sin editar)
□ Base URL NO termina con barra (/)

SI TODOS ESTÁN ✓:
¡La instalación está completa y funcionando correctamente!


═════════════════════════════════════════════════════════════════════════════
Módulo WHMCS v2.0 - Compatibilidad verificada con WHMCS 8.13.3 y Freescout 1.8.140+
═════════════════════════════════════════════════════════════════════════════
