Reportar Problemas - Sistema de Reporte de Incidencias

Guia Completa para Reportar y Dar Seguimiento a Problemas

El sistema de Reporte de Problemas permite a los usuarios notificar errores, fallos o situaciones inesperadas directamente desde la aplicacion. Cada reporte incluye una captura de pantalla automatica, la URL donde ocurrio el problema, y una descripcion detallada. El equipo de soporte recibe notificaciones por email y puede gestionar el ciclo de vida completo del reporte hasta su resolucion.

¿Como Reportar un Problema?

Para reportar un problema, haz clic en el boton de reporte ubicado en la barra superior de la aplicacion (icono de bandera/bug). Al presionarlo, el sistema capturara automaticamente una imagen de tu pantalla actual y abrira un formulario modal donde podras describir el problema.

Pasos para Crear un Reporte

1. Captura automatica: Al abrir el formulario, se toma automaticamente una captura de pantalla de la pagina donde te encuentras. Si necesitas una nueva captura, puedes presionar el boton "Capturar Pantalla".
2. Verifica la captura: Revisa que la imagen capturada muestre el problema que deseas reportar. La captura aparece en la parte superior del formulario.
3. Describe el problema: Escribe una descripcion clara y detallada del problema en el campo de texto. Incluye que estabas haciendo cuando ocurrio, que esperabas que sucediera, y que sucedio en realidad. Maximo 1,000 caracteres.
4. Informacion de contacto (opcional): Los campos de email y telefono de contacto se llenan automaticamente con la informacion de tu empresa. Puedes modificarlos si deseas que te contacten por un medio diferente.
5. Envia el reporte: Haz clic en "Enviar Reporte". El sistema subira la captura de pantalla, creara el reporte y notificara al equipo de soporte por email.

Informacion Capturada Automaticamente

Ademas de la descripcion y la captura de pantalla, el sistema registra automaticamente la siguiente informacion para facilitar el diagnostico:

• URL de la pagina: La direccion exacta donde ocurrio el problema.
• Direccion IP: La IP desde donde se envio el reporte.
• Usuario: Nombre y correo del usuario que reporta.
• Empresa: El nombre del tenant/empresa asociada.
• Fecha y hora: Momento exacto en que se creo el reporte.

Datos de Contacto

Al crear un reporte, los campos de email y telefono de contacto se auto-completan con la informacion de contacto configurada en tu empresa (contactEmail y contactPhone del tenant). Esto permite al equipo de soporte comunicarse contigo directamente si necesitan mas informacion.

Si prefieres ser contactado por un medio diferente (por ejemplo, un correo personal o un telefono celular), simplemente edita los campos antes de enviar el reporte. Ambos campos son opcionales.

Ver Mis Reportes

Para ver el historial de tus reportes, haz clic en "Ver Mis Reportes" en la parte inferior del formulario de reporte, o navega a la seccion "Reportes" desde el menu. La lista muestra todos los reportes que has creado con su estado actual.

Lista de Reportes

La pagina de reportes presenta una vista de tarjetas con los siguientes elementos:

• Filtros por estado: Chips de filtro rapido para ver Todos, Pendientes, En Progreso o Resueltos, con contadores de cada categoria.
• Busqueda: Campo de busqueda para filtrar reportes por titulo o descripcion.
• Tarjetas de reporte: Cada reporte muestra su estado (badge de color), titulo, descripcion resumida, fecha de creacion, e informacion de contacto si fue proporcionada.
• Indicador de respuesta: Los reportes resueltos muestran un indicador verde de "Respuesta disponible" para que sepas que el equipo de soporte respondio.

Estados de un Reporte

Cada reporte pasa por un ciclo de vida con tres estados posibles:

• Pendiente (amarillo): Estado inicial. El reporte ha sido recibido pero aun no ha sido revisado por el equipo de soporte.
• En Progreso (azul): El equipo de soporte esta trabajando activamente en el problema reportado.
• Resuelto (verde): El problema ha sido solucionado. Incluye notas de resolucion que explican como se resolvio el problema.

Cuando un reporte cambia de estado, el usuario que lo creo recibe una notificacion por email informandole del progreso. Al resolverse, el email incluye las notas de resolucion escritas por el equipo de soporte.

Detalle del Reporte

Al hacer clic en un reporte, se abre la vista de detalle con toda la informacion completa organizada en dos columnas:

Encabezado

• Titulo del reporte: Generado automaticamente con la URL donde ocurrio el problema.
• Badge de estado: Indicador visual del estado actual (Pendiente, En Progreso, Resuelto).
• Fecha de creacion: Cuando se creo el reporte.
• Empresa: Nombre del tenant asociado.
• Usuario: Quien creo el reporte.

Columna Izquierda - Captura de Pantalla

Muestra la imagen capturada al momento de crear el reporte. Puedes hacer clic en la imagen para verla a tamano completo con zoom. La imagen permanece fija (sticky) al hacer scroll en pantallas grandes.

Columna Derecha - Informacion

• Descripcion: El texto completo que escribiste al crear el reporte.
• Resolucion: Si el reporte fue resuelto, muestra las notas de resolucion con la fecha en que se resolvio.
• Contacto: Informacion de contacto de la empresa (email y telefono del tenant) y del reportante (si especifico datos diferentes al crear el reporte). Los emails y telefonos son enlaces clicables.
• Informacion del usuario: Nombre, email, empresa y direccion IP.
• Pagina donde ocurrio: Enlace directo a la URL donde se reporto el problema.
• Metricas de tiempo: Tres indicadores que muestran el tiempo transcurrido: desde la creacion hasta que se puso en progreso, tiempo en progreso, y tiempo total de resolucion.

Gestion de Reportes (Administradores)

Los administradores del sistema tienen acceso a una vista global de todos los reportes de todas las empresas desde la seccion "Todos los Reportes" en el menu de administracion.

Cambiar Estado de un Reporte

Desde la vista de detalle de un reporte, los botones de accion permiten cambiar el estado:

• Pendiente: Marca el reporte como pendiente de revision.
• En Progreso: Indica que el equipo esta trabajando en el problema.
• Marcar Resuelto: Abre un formulario para escribir las notas de resolucion (obligatorias). Estas notas se envian al usuario por email.

Resolver un Reporte

Al hacer clic en "Marcar Resuelto", se despliega un formulario donde debes escribir las notas de resolucion explicando como se soluciono el problema. Estas notas son obligatorias y se envian automaticamente al usuario por correo electronico. El campo tiene un limite de 1,000 caracteres.

Vista de Administracion (Todos los Reportes)

La vista administrativa muestra una tabla (desktop) o tarjetas (movil/tablet) con todos los reportes del sistema. Incluye:

• Estadisticas globales: Total de reportes, pendientes, en progreso y resueltos.
• Filtros: Busqueda por titulo/descripcion y filtro por estado.
• Tabla con columnas: Fecha, reporte (titulo y descripcion), empresa, contacto (email y telefono del reportante), estado y acciones.
• Acciones: Ver detalle y eliminar reporte.

Notificaciones por Email

El sistema envia notificaciones automaticas por email en los siguientes momentos:

• Nuevo reporte creado: Se envia un email al equipo de soporte (hola@digimart.cloud) con copia al email de contacto de la empresa, al usuario que reporto, y al equipo interno de Digimart. El email incluye la captura de pantalla como adjunto.
• Cambio a En Progreso: Se notifica al usuario que su reporte esta siendo atendido.
• Reporte resuelto: Se envia un email al usuario con las notas de resolucion explicando como se soluciono el problema.

Metricas de Tiempo

La vista de detalle muestra tres metricas de tiempo que ayudan a evaluar la velocidad de respuesta del equipo de soporte:

• Hasta Progreso: Tiempo transcurrido desde que se creo el reporte hasta que se marco como "En Progreso". Indica que tan rapido el equipo comienza a trabajar en el problema.
• En Progreso: Tiempo que el reporte estuvo en estado "En Progreso" hasta su resolucion. Indica cuanto tardo la solucion una vez que se comenzo a trabajar.
• Tiempo Total / Transcurrido: Tiempo total desde la creacion hasta la resolucion. Si el reporte aun no esta resuelto, muestra el tiempo transcurrido hasta el momento actual.

Preguntas Frecuentes

¿Puedo reportar un problema desde cualquier pagina?

Si. El boton de reporte esta disponible en la barra superior de toda la aplicacion. La captura de pantalla se tomara de la pagina donde te encuentres en ese momento, y la URL se registrara automaticamente.

¿Que pasa si la captura de pantalla no muestra el problema?

Si la captura automatica no captura correctamente el problema (por ejemplo, si el error desaparecio), puedes presionar el boton "Capturar Pantalla" para tomar una nueva captura. Asegurate de reproducir el error antes de capturar. En la descripcion, explica detalladamente los pasos para reproducir el problema.

¿Recibire notificacion cuando resuelvan mi reporte?

Si. Recibiras un correo electronico cada vez que el estado de tu reporte cambie: cuando pase a "En Progreso" y cuando se marque como "Resuelto". El correo de resolucion incluira las notas del equipo de soporte explicando como se soluciono el problema.

¿Puedo eliminar un reporte?

Si. Desde la lista de reportes, cada tarjeta tiene un boton de eliminar (icono de papelera). Se pedira confirmacion antes de eliminar. Esta accion no se puede deshacer.

¿Hay un limite de reportes que puedo crear?

No hay un limite estricto de reportes. Sin embargo, las capturas de pantalla tienen un limite de 2 MB por imagen. Si la captura excede este tamano, se guardara el reporte sin imagen.

¿Quien puede ver mis reportes?

Tus reportes son visibles para ti desde la seccion "Mis Reportes". Los administradores del sistema (Digimart) pueden ver todos los reportes de todas las empresas desde la vista administrativa "Todos los Reportes". Los demas usuarios de tu empresa no pueden ver tus reportes.

Consejos para un Buen Reporte

1. Se especifico: Describe exactamente que estabas haciendo cuando ocurrio el problema. Ejemplo: "Al hacer clic en 'Guardar' en la factura #1234, aparece un error en pantalla."
2. Incluye pasos para reproducir: Si el problema ocurre de forma consistente, lista los pasos exactos. Ejemplo: "1. Ir a Facturas, 2. Crear nueva factura, 3. Agregar producto X, 4. Hacer clic en Guardar."
3. Menciona lo esperado vs. lo actual: Explica que esperabas que sucediera y que paso en realidad.
4. Captura el momento exacto: Asegurate de que la captura de pantalla muestre el error o el estado problematico antes de abrir el formulario de reporte.
5. Proporciona contacto correcto: Si deseas ser contactado por un medio especifico, actualiza los campos de email y telefono antes de enviar.