Documentacion

Manual de usuario - Panel 1000resultados

1. Alcance Este manual documenta, paso a paso, cómo usar el panel web en sus dos roles: - Cliente. - Admin/Superadmin. Incluye: - Registro, inicio de sesión y recuperación de cuenta. - Navegación en desktop y móvil. - Funcionalidades del cliente: agencias, dispositivos (TVs), pagos e historial, configuración de pantalla y solicitud de TV a la empresa. - Funcionalidades del admin: dashboard de métricas y gestión completa de solicitudes de TVs. 1.1 Secciones disponibles (según rol) Cliente 1. Dashboard 2. Agencias 3. Todos los TVs 4. Pagos (Histórico) Dentro de Agencias, puedes entrar al Detalle de agencia. Admin/Superadmin 1. Dashboard 2. Solicitudes 2. Acceso al sistema (paso a paso) 2.1 Registro 1. Ve a la pantalla Registro. 2. Completa los campos solicitados. 3. Presiona Registrarse. 4. Si el sistema requiere confirmación de cuenta: 5. Abre el enlace recibido. 6. Espera la confirmación. 7. El sistema te redirigirá a Iniciar sesión. Recomendaciones: 1. Usa un teléfono válido. 2. Usa una contraseña segura. 3. Evita registrar múltiples cuentas para la misma operación. 2.2 Inicio de sesión 1. Ve a la pantalla Iniciar sesión. 2. Escribe tus credenciales. 3. Presiona Iniciar sesión. 4. El sistema te llevará automáticamente al Dashboard correspondiente a tu rol. 2.3 Recuperación de contraseña 1. En Iniciar sesión, selecciona Recuperar contraseña. 2. Ingresa tu dato de recuperación (normalmente teléfono). 3. Confirma. 4. Abre el enlace o usa el token recibido. 5. En la pantalla Restablecer contraseña: 6. Introduce la nueva contraseña. 7. Confirma. 8. Regresa a Iniciar sesión. Si el token no funciona: 1. Solicita uno nuevo. 2. Verifica que el enlace no esté vencido. 3. Navegación y elementos comunes 3.1 Menú superior (desktop) 1. En la parte superior verás: - Logo (te lleva al dashboard según tu rol). - Menú de navegación. - Tema (cambiar modo claro/oscuro). - Menú de usuario. 3.2 Navegación en móvil 1. En móvil verás una barra inferior con accesos directos: - Dashboard. - Agencias. - TVs. - Pagos. - Soporte. 3.3 Panel lateral vs panel inferior (según dispositivo) Cuando abres un detalle o un asistente: - En pantallas grandes (desktop) se abre como panel lateral. - En móviles se abre como panel inferior. 3.4 Menú de usuario (perfil y sesión) 1. Presiona el avatar/usuario. 2. Opciones disponibles: - Editar cuenta. - Cerrar sesión. Editar cuenta (paso a paso) 1. Abre Editar cuenta. 2. Modifica los campos disponibles (ej. nombre y apellido). 3. Presiona Guardar cambios. 4. Cierra el panel si no se cierra automáticamente. Notas: 1. Algunos campos pueden estar bloqueados por política (por ejemplo teléfono/ubicación). 2. Si ves errores, corrige los campos marcados y vuelve a guardar. 3.5 Soporte (Chat) 1. En móvil, presiona Soporte. 2. Se abrirá el chat. 3. Si el botón aparece deshabilitado, espera a que el chat esté listo y vuelve a intentar. 4. Conceptos y reglas operativas 4.1 Roles - Cliente: solo ve datos de sus agencias y sus dispositivos. - Admin/Superadmin: ve y gestiona todo el sistema. 4.2 Estados de solicitudes de TV Estados: - Pendiente - Aprobada - Enviada - Instalada - Cancelada Reglas: - Aprobada/Enviada → solo puede pasar a Instalada. - Instalada es final (no debe cambiar). - Cancelada puede reaprobarse si el admin lo decide. 4.3 Relación TV ↔ Dispositivo (1:1) - Un TV se vincula a un solo dispositivo. - Un dispositivo solo puede tener un TV. 5. Manual de Cliente (paso a paso) 5.1 Dashboard Objetivo: ver un resumen de tus agencias, TVs y pendientes. Acciones: 1. Entra a Dashboard. 2. Revisa las tarjetas: - Total Agencias. - Total TVs. - TVs por activar. - TVs propios / de la empresa. 1. En Agencias recientes: 2. Presiona Ver todas para ir a Agencias. 3. O presiona Ver TVs en una agencia para ir a su detalle. 4. En TVs por activar: 5. Presiona Ver TVs por activar. 6. Esto te lleva a Todos los TVs con el filtro de pendientes. 5.2 Agencias 5.2.1 Ver y buscar agencias 1. Entra a Agencias. 2. Usa el buscador para filtrar por: - Nombre. - Ciudad. 1. Usa la paginación si hay más resultados. Qué verás en cada tarjeta de agencia (aproximado): 1. Nombre y ciudad. 2. Contadores (TVs totales, TVs propios, TVs de empresa, TVs por activar). 3. Botón para ver el detalle. 5.2.2 Crear nueva agencia 1. Presiona Nueva agencia. 2. Se abrirá: - Un panel lateral en desktop. - Un panel inferior en móvil. 1. Completa el formulario. 2. Presiona Crear/Guardar. 3. Verifica que la agencia aparezca en la lista. Campos comunes solicitados en el formulario: 1. Nombre de agencia. 2. Dirección. 3. Estado y ciudad. 4. Teléfono del responsable. 5. RIF y nombre fiscal. 5.2.3 Abrir detalle de una agencia 1. En una agencia, presiona Ver TVs. 2. Entrarás al Detalle de agencia. 5.3 Detalle de agencia Objetivo: gestionar los TVs (dispositivos) de una agencia. 5.3.1 Ver TVs de la agencia 1. Entra al detalle. 2. Verás el listado de TVs/dispositivos asociados. 3. Revisa indicadores: - Propiedad (TV propio / TV de la empresa). - Estado del servicio (activo/inactivo). - Fecha de corte / contador. Opciones típicas por TV (según estado): 1. Configurar pantalla. 2. Pagar/activar (si el TV está con pago pendiente o es elegible). 5.3.2 Afiliar/agregar un dispositivo (QR) 1. En el detalle de agencia, presiona la opción para Agregar dispositivo. 2. Se abrirá un panel (lateral en desktop / inferior en móvil). 3. Acciones dentro del panel: 4. Presiona Activar cámara. 5. Apunta al QR del dispositivo. 6. Espera el reconocimiento. 7. El sistema intentará afiliar el dispositivo a la agencia. 8. Si ocurre un error: - Reintenta. - Verifica permisos de cámara del navegador. Notas importantes: 1. El navegador puede pedir permiso de cámara; concédelo. 2. Si tu equipo no soporta cámara desde navegador, usa otro dispositivo. 5.3.3 Solicitar TV a la empresa Esta opción permite solicitar un TV para esa agencia. 1. En el detalle de agencia, presiona Solicitar TV a la empresa. 2. El sistema valida si ya existe una solicitud activa (Pendiente/Aprobada/Enviada): - Si existe, te mostrará un aviso y su estatus. 1. Si no existe solicitud activa: 2. Escribe el Motivo. 3. Escribe Notas (opcional). 4. Presiona Enviar solicitud. Estados “activos” que bloquean una nueva solicitud para la misma agencia: 1. Pendiente 2. Aprobada 3. Enviada 5.3.4 Configurar pantallas (Screen Config) 1. En el TV deseado, presiona Configurar. 2. Se abrirá el asistente. 3. Para crear una pantalla: 4. Presiona Agregar pantalla. 5. Selecciona el tipo. 6. Define segundos (mínimo según validación). 7. Si el tipo requiere selección (ej. “animalitos”), selecciona los elementos requeridos. 8. Opciones disponibles sobre una pantalla: - Mover arriba/abajo. - Duplicar. - Eliminar. 1. Presiona Guardar. Reglas de validación típicas: 1. Cada pantalla debe tener una duración mínima. 2. En tipos especiales, debes seleccionar la cantidad exacta de elementos requeridos. 3. Si hay error, el asistente lo indica y no permite guardar. 5.3.5 Pagar / activar un TV (desde la agencia) 1. Si un TV está con pago pendiente, presiona Pagar/Activar. 2. Se abrirá el asistente de pago. 3. Sigue el flujo del asistente (ver sección 5.5). 5.3.6 Pago en lote (bulk) 1. Selecciona múltiples TVs elegibles. 2. Presiona Pagar seleccionados. 3. Completa el asistente. 5.4 Todos los TVs Objetivo: ver todos tus dispositivos en un solo lugar. 5.4.1 Buscar y filtrar 1. Entra a Todos los TVs. 2. Usa: - Búsqueda por nombre, UUID o agencia. - Filtro de Estado (activos/inactivos). - Filtro de Propiedad (propios / empresa). - Filtro de Pago (pendientes / pagados). 1. Presiona Limpiar filtros si quieres volver a ver todo. Cómo abrir filtros en móvil: 1. Presiona Filtros. 2. Ajusta criterios. 3. Cierra el panel para aplicar. En móviles, el panel de filtros se abre como panel inferior. 5.4.2 Acciones por TV Según el estado del TV, podrás: - Abrir configuración de pantalla. - Iniciar pago/activación. 5.5 Pagos 5.5.1 Histórico de pagos 1. Entra a Pagos. 2. Usa filtros: - Buscar por referencia, agencia o TV. - Estado: completados / pendientes / fallidos. - Método: tarjeta / transferencia / efectivo. - Fecha desde/hasta. 1. Usa paginación para ver más. Cómo abrir filtros en móvil: 1. Presiona Filtros. 2. Ajusta criterios. 3. Cierra el panel para aplicar. 5.5.2 Asistente de pago (paso a paso) Este asistente se usa para pagos individuales o múltiples. 1. Abre el asistente desde un TV o desde pago en lote. 2. Selecciona: - Plan. - Duración (días, semanas o meses). 1. Revisa el monto calculado. 2. Selecciona el método de pago. 3. Completa los datos solicitados (referencia, teléfono, etc. según método). 4. Confirma el pago. 5. Verifica el resultado (éxito/fallo) y cierra. Checklist antes de enviar: 1. Plan seleccionado. 2. Duración válida. 3. Método de pago seleccionado. 4. Referencia y teléfono (si aplica) en formato válido. 5. Confirmación marcada (si el asistente la solicita). 6. Manual de Admin/Superadmin (paso a paso) 6.1 Dashboard Objetivo: monitorear métricas del sistema. 6.1.1 Ver ingresos 1. Entra a Dashboard. 2. En la tarjeta Ingresos: 3. Elige granularidad: Día / Semana / Mes. 4. Elige vista: Ambos / VES / USD. 5. Define rango de fechas: - Abre el selector. - Selecciona desde/hasta. - Presiona Aplicar. - Opcional: presiona Este mes para reset rápido. 1. Revisa la serie y totales. Notas: 1. El USD se calcula con tasa diaria. 2. Si no hay datos en el rango, el gráfico puede mostrarse vacío. 6.2 Solicitudes de TVs Objetivo: gestionar el ciclo completo de solicitudes y asignaciones. 6.2.1 Listar, buscar y filtrar 1. Entra a Solicitudes. 2. Usa: - Buscador (agencia, solicitante, ciudad o motivo). - Filtro por estatus. 1. Interpreta la lista: - Badge de estatus. - Icono de vínculo si hay TV asignado. Acciones rápidas en el listado: 1. Presiona Ver para abrir detalle. 2. Presiona sobre el teléfono (si aparece) para abrir acciones de contacto. 6.2.2 Abrir el detalle 1. Presiona Ver. 2. Se abrirá: - Un panel lateral en desktop. - Un panel inferior en móvil. 6.2.3 Acciones según estatus A) Pendiente 1. Presiona Aprobar para pasar a Aprobada. 2. Presiona Cancelar para pasar a Cancelada. B) Cancelada 1. Presiona Reaprobar solicitud para volver a Aprobada. C) Aprobada (asignación) 1. Selecciona un dispositivo disponible de la agencia. 2. Busca el TV por serial: 3. Abre el selector. 4. Escribe una parte del serial (por ejemplo últimos 6 dígitos). 5. Selecciona el TV correcto. 6. En el footer, presiona Asignar este televisor. 7. Resultado: - Se crea vínculo 1:1 TV↔Dispositivo. - La solicitud pasa a Instalada. Recomendación operativa: 1. Confirma que estás en la agencia correcta. 2. Confirma que el dispositivo seleccionado está disponible. D) Enviada 1. Presiona Marcar como instalada cuando se complete. E) Instalada 1. No hay acciones de cambio de estatus. 6.2.4 Desvincular TV del dispositivo Si la solicitud tiene TV asignado: 1. En el footer, presiona Desvincular TV del dispositivo. 2. Confirma. 3. Resultado: - Se elimina el vínculo TV↔Dispositivo. - Se limpia el TV de la solicitud. - El sistema ajusta el estatus según el flujo. 7. Solución de problemas (rápido) 7.1 Cámara/QR no funciona 1. Verifica permisos del navegador. 2. Reintenta con buena iluminación. 3. Cierra y abre de nuevo el panel. 7.2 No aparecen TVs al buscar para asignar 1. Escribe al menos parte del serial. 2. Verifica que el TV esté en estatus permitido. 3. Verifica que el TV no esté ya vinculado a otro dispositivo. 7.3 No permite asignar 1. Falta seleccionar dispositivo. 2. El dispositivo ya tiene TV. 3. El TV ya está en uso. 8. Glosario - TV/Dispositivo: equipo físico en una agencia. - Agencia: punto/ubicación donde operan TVs. - Solicitud de TV: registro administrativo para pedir/gestionar un TV. - Vínculo: relación 1:1 entre TV y Dispositivo. - Panel lateral/inferior: forma en que el sistema muestra detalles o asistentes según el dispositivo.