Saltar al contenido principal

Pedir ayuda

Cuando algo no funciona y no encontraste la solución en esta documentación, es hora de pedir ayuda. Este capítulo te enseña cómo pedir bien para acelerar la resolución.

A quién​

  • Al equipo técnico que instaló y mantiene tu framework. Es el primer punto de contacto.
  • Al proveedor del framework si el problema es del código o hay un bug real. Puede que ya lo estén resolviendo.
  • Comunidad: si el framework tiene canales de Slack, Discord o GitHub Discussions, ve ahí para preguntas generales.

Cómo (información a incluir)​

Un buen reporte incluye:

1. Qué intentabas hacer​

Describe la acción de forma concreta.

  • ✅ "Estaba creando un nuevo pedido en el módulo Ventas y al guardar apareció error."
  • ❌ "El sistema no funciona."

2. Qué esperabas que pasara​

  • ✅ "Esperaba ver el pedido guardado con el número asignado."
  • ❌ "Esperaba que funcionara."

3. Qué pasó realmente​

  • ✅ "Salió una pantalla en blanco con un mensaje 'Undefined index: cliente_id'."
  • ❌ "Dio error."

4. Screenshot o video​

Vale más que mil palabras.

  • Screenshot completo (con URL visible).
  • Video corto (Loom, o cualquier grabador de pantalla) mostrando los pasos que hiciste.

5. Contexto técnico​

Si lo sabes o puedes averiguar:

  • URL donde ocurre.
  • Navegador y versión (Chrome 120, Safari 17...).
  • Sistema operativo (macOS 14, Windows 11...).
  • Tu usuario y rol (no la contraseña).
  • ¿Se reproduce siempre? ¿Solo a veces? ¿Solo con ciertos datos?

6. Pasos para reproducir​

Lista numerada de qué exactamente hiciste, desde el login:

1. Entré al CMS con mi usuario.
2. Fui a Ventas → Nueva venta.
3. Llené los campos: cliente = Juan Pérez, producto = Camisa azul, cantidad = 2.
4. Click en Guardar.
5. Apareció el error.

Con esos pasos, quien te ayude puede replicar y ver.

Errores que ayudan a diagnosticar​

Consola del navegador​

En Chrome/Firefox: F12 → pestaña "Console".

Si hay mensajes en rojo, cópialos y súmalos al reporte.

Log del servidor​

Los errores PHP se guardan en logs/. Si tienes acceso, extrae las últimas líneas.

Un mensaje como:

[2026-07-29 15:34:22] [ERROR] PDOException: Table 'db.foo' doesn't exist
   at /var/www/framework/api/models/get.model.php:45

… le dice al técnico exactamente dónde está el problema.

Qué NO enviar​

  • Contraseñas en claro. Nunca.
  • API Keys o JWT Secrets.
  • Archivos config.php completos si contienen credenciales. Envía solo las partes relevantes con las credenciales tachadas.
  • Base de datos completa — si necesitan verla, hazlo en un canal privado seguro.

Priorización​

Si tu problema es urgente (el sitio está caído en producción), márcalo como tal. Pero úsalo con criterio — si todo es urgente, nada lo es.

Escala típica:

  • Crítico: sitio caído, pérdida de datos, brecha de seguridad. Contacta inmediatamente por el canal más rápido.
  • Alto: funcionalidad clave rota (no se pueden vender productos, no llegan pedidos). Contacto directo el mismo día.
  • Medio: bugs molestos pero manejable. Ticket normal.
  • Bajo: mejoras, dudas, cosas cosméticas. Puede esperar días o incluso semanas.

Preguntar bien acelera todo​

Un reporte con:

  • Screenshot.
  • Pasos claros.
  • Descripción concreta del error.

… se resuelve en horas.

Un "no me funciona" sin más información puede tomar días de ida y vuelta.

Recursos generales​

  • Repositorio en GitHub: para reportar bugs o proponer mejoras al framework mismo.
  • Documentación: revisa siempre primero el índice — muchas dudas ya están respondidas.
  • Log de actividad en el CMS: te ayuda a rastrear qué acciones se hicieron cuándo.

¿Qué sigue?​

Si el reporte se envió con buena info, seguramente te contacten pronto. Mientras tanto, respalda todo por si acaso, y evita hacer cambios que puedan complicar el diagnóstico.