Aptli

Aplicación Móvil

La interfaz móvil de Aptli está diseñada para trabajadores de campo en smartphones y tabletas. Instálela directamente desde su navegador — sin necesidad de tienda de aplicaciones — y obtenga acceso offline-first a sus asignaciones, un escáner QR para recogidas de inventario, creación de informes con captura GPS y de fotos, y redacción en el mapa. La experiencia móvil se centra en la ejecución; las tareas de administración permanecen en el escritorio.

¿Qué es una PWA?

Progressive Web App = sitio web instalable que funciona como una aplicación nativa:

Instalación:

  1. Abrir Aptli en el navegador móvil (Chrome, Safari, Edge)
  2. El navegador muestra el mensaje "Instalar Aplicación"
  3. Tocar "Instalar" → añade el icono a la pantalla de inicio
  4. Se abre en modo pantalla completa (sin la barra del navegador)

Ventajas Frente al Navegador Móvil:

  • Lanzamiento más rápido (en caché en el dispositivo)
  • Funciona sin conexión (caché del service worker)
  • Notificaciones push
  • Accesos directos en la pantalla de inicio a funciones específicas
  • Mejor rendimiento (recursos optimizados)

Herramientas Adicionales de Escritorio: algunas funciones como importaciones masivas, edición profunda y exportación de datos solo están disponibles en la aplicación de escritorio; la PWA móvil ofrece un acceso directo a "Transferencia de Datos", pero la exportación está limitada a la versión de escritorio.

Sin Necesidad de Tienda de Aplicaciones:

  • Sin proceso de aprobación de Apple/Google
  • Las actualizaciones se despliegan al instante (sin retraso de revisión de tienda)
  • Misma base de código que la versión web (eficiencia de mantenimiento)

Alcance Móvil

Incluido - Funciones de Ejecución:

  • ✅ Ver asignaciones (todas o solo las mías)
  • ✅ Crear informes desde asignaciones
  • ✅ Escanear códigos QR (autorización de recogida)
  • ✅ Ver mapa con entidades y tareas
  • ✅ Crear entidades simples en el mapa (punto, línea, polígono)
  • ✅ Ver informes (todos o solo los míos)
  • ✅ Subir fotos a los informes
  • ✅ Editar el perfil propio de usuario
  • ✅ Validar número de teléfono (2FA)
  • ✅ Solicitar ayuda (formulario de solicitud de ayuda)
  • ✅ Responder a solicitudes de ayuda dirigidas a usted

Excluido - Funciones de Administración:

  • ❌ Crear asignaciones (solo escritorio)
  • ❌ Modificar inventario (solo escritorio, excepto para escaneos del personal autorizado)
  • ❌ Registrar nuevas entidades (borradores simples OK, importaciones masivas solo en escritorio)
  • ❌ Añadir roles a usuarios (solo escritorio)
  • ❌ Operaciones masivas (solo escritorio)

Justificación:

  • 5 % del tamaño/complejidad de la aplicación de escritorio
  • Enfoque en la ejecución de campo
  • Tareas administrativas complejas se realizan mejor en escritorio

Interfaz Móvil

Interfaz de la PWA móvil — pantalla de inicio, asignaciones, informes y escáner QR

Interfaz del escáner de códigos QR integrado en la aplicación

Barra de Navegación Inferior:

  • Inicio (resumen rápido)
  • Asignaciones (ver y filtrar)
  • Informes (crear y ver)
  • Mapa (entidades, tareas, redacción)
  • Perfil (configuración de cuenta)

Accesos Directos (Pulsación Larga en el Icono de Inicio):

  • Escáner (lector de códigos QR)
  • Informe Rápido (crear informe desde la ubicación actual)
  • Mis Tareas (asignaciones con mis tareas resaltadas en el mapa)

Compatibilidad con Gestos:

  • Deslizar entre pestañas
  • Deslizar hacia abajo para actualizar (datos)
  • Pulsación larga para menús contextuales
  • Pellizcar para hacer zoom en el mapa

Función de Escáner

Escáner de códigos QR para recogidas de inventario y referencias de entidades:

Casos de Uso:

  • Escanear QR de recogida de asignación → autorizar transferencia de inventario
  • Escanear etiqueta QR de entidad → abrir el detalle de la entidad
  • Escanear QR de solicitud de ayuda → responder a un problema específico

Flujo de Trabajo:

  1. Toque el acceso directo del escáner (o el icono del escáner en la navegación inferior)
  2. Se abre la cámara con el visor QR
  3. Apunte al código QR
  4. Detección y decodificación automáticas
  5. Acción realizada (recogida, navegar a entidad, etc.)

Autorización de Recogida:

  1. Escanear el QR de recogida de la asignación
  2. Validar:
    • Que usted es el destinatario autorizado (o tiene el permiso canFacilitatePickups)
    • Hay existencias disponibles en el sitio de origen
    • Ubicación GPS (dentro del geocercado si está configurado)
  3. Confirmar la recogida
  4. Se crea automáticamente una transacción de transferencia
  5. El inventario se añade a su sitio personal

Escaneos QR Sin Conexión:

  • Los escaneos se almacenan en caché mientras está sin conexión
  • Se procesan al volver a estar en línea
  • Previene recogidas duplicadas (lógica de deduplicación)

Vista de Asignaciones

Opciones de Filtro:

  • Todas las asignaciones
  • Asignadas a mí
  • Creadas por mí
  • Estado (pendiente, en curso, completada)

Tarjeta de Asignación:

  • Nombre y descripción
  • Usuarios asignados (avatares)
  • Insignia de estado
  • Resumen de objetivos de recursos
  • Barra de progreso
  • Indicador de fecha de vencimiento

Acciones:

  • Tocar para ver los detalles
  • Crear informe (botón de acción rápida)
  • Ver código QR (si está autorizado y existe código de recogida)
  • Actualizar estado (en curso → completada)

Creación de Informes

Flujo de Informe Rápido:

  1. Desde la asignación → tocar "Crear Informe"
  2. Prellenado: asignación, tareas, consumo sugerido
  3. Ajustar los valores reales (lo que realmente ocurrió)
  4. Tocar el icono de cámara → hacer fotos
  5. GPS capturado automáticamente (ubicación actual)
  6. Enviar → se crean las transacciones de consumo

Campos Optimizados para Móvil:

  • Zonas táctiles grandes (botones, campos de entrada)
  • Voz a texto para descripciones
  • Subida de fotos desde la cámara o la galería
  • Autorelleno GPS (o selección manual en el mapa)
  • Campos mínimos obligatorios (nombre, trabajo completado, consumido desde)

Creación de Informes Sin Conexión:

  • Crear el informe sin conexión
  • Las fotos se almacenan localmente
  • Envío automático cuando se restaura la conexión
  • Resolución de conflictos si los datos cambiaron en el servidor

Vista de Mapa

Entidades Mostradas:

  • Todas las entidades confirmadas (de las capas)
  • Tareas cerca de la ubicación actual (filtro de proximidad)
  • Sus asignaciones resaltadas (codificadas por color)

Controles del Mapa:

  • Selector de capas (alternar la visibilidad de entidades)
  • Botón de ubicación actual (recentrar en el GPS)
  • Selector de mapa base (carreteras, satélite, terreno)
  • Búsqueda (encontrar entidad por nombre/ID)

Redacción Simple:

  • Toque el botón de acción flotante +; el primer toque revela las herramientas de dibujo, el segundo toque activa la herramienta seleccionada (este comportamiento de dos niveles mantiene la interfaz despejada en pantallas pequeñas)
  • Elegir el tipo de geometría (punto, línea, polígono)
  • Tocar el mapa para añadir puntos
  • Rellenar las propiedades básicas
  • Guardar en la versión borrador
  • Nota: los borradores creados en el móvil participan en el mismo sistema de versión/confirmación que en escritorio. Los usuarios móviles pueden solicitar confirmación, pero solo los administradores pueden aprobar; las versiones finalizadas son visibles para todos una vez aprobadas.

Teselas de Mapa Sin Conexión:

  • Las teselas del mapa se almacenan en caché (caducidad de 30 días)
  • Estrategia CacheFirst (carga rápida)
  • Funciona sin conexión a Internet
  • Sincroniza las entidades cuando vuelve a estar en línea

Transferencia de Existencias (Solo Personal Autorizado)

Personal con el permiso canFacilitatePickups:

Flujo de Trabajo:

  1. El trabajador llega al almacén
  2. Muestra el código QR de la asignación
  3. El personal escanea el QR en nombre del trabajador
  4. El sistema valida:
    • El trabajador es el destinatario autorizado
    • El personal tiene el permiso canFacilitatePickups
    • Hay existencias disponibles
  5. Se realiza la transferencia
  6. La transacción registra quién realizó el escaneo, en nombre de quién y el método de escaneo (propio vs. asistido por el personal)

Creación Manual de Transferencias: El personal puede crear transferencias manuales:

  • Seleccionar el sitio de origen
  • Seleccionar el destinatario
  • Seleccionar los recursos y volúmenes
  • Confirmar → se crea la transacción

Gestión del Perfil

Campos Editables:

  • Nombre, cargo, división
  • Número de teléfono (con validación)
  • Preferencias de notificación
  • Selección de idioma

Validación de Teléfono:

  1. Introducir el número de teléfono
  2. Tocar "Enviar Código"
  3. Recibir un SMS con código de 6 dígitos
  4. Introducir el código
  5. Teléfono validado (habilita las notificaciones por SMS)

Autenticación de Dos Factores:

  • Habilite 2FA desde el perfil
  • Escanee el QR TOTP con una aplicación de autenticación
  • Introduzca el código de 6 dígitos para confirmar
  • Requerido en futuros inicios de sesión

No Editable en Móvil:

  • Email (restricción de seguridad)
  • Roles (función de administrador)
  • Derechos de administrador (función de administrador)

Solicitudes de Ayuda

Crear Solicitud de Ayuda:

  1. Tocar "Solicitar Ayuda" (desde el perfil o el menú)
  2. Rellenar el formulario:
    • Asunto
    • Descripción (admite voz a texto)
    • Categoría (técnica, acceso, materiales, etc.)
    • Prioridad (baja, media, alta, urgente)
  3. Opcional: Añadir fotos
  4. Enviar → se envía una notificación al equipo correspondiente

Responder a Solicitudes de Ayuda:

  • Ver las solicitudes dirigidas a usted
  • Añadir comentarios/notas
  • Actualizar el estado
  • Subir fotos de respuesta
  • Cerrar cuando se resuelva

Capacidades Sin Conexión

Caché del Service Worker:

  • Respuestas API en caché (caducidad de 1 hora)
  • Teselas del mapa en caché (caducidad de 30 días)
  • Shell de la aplicación en caché (carga instantánea)
  • Imágenes y recursos en caché

Acciones Offline-First:

  • Crear informes (enviar cuando esté en línea)
  • Hacer fotos (subir cuando esté en línea)
  • Redactar entidades del mapa (sincronizar cuando esté en línea)
  • Ver asignaciones/informes en caché

Indicadores de Sincronización:

  • En línea: Punto verde
  • Sin conexión: Punto gris + "X elementos pendientes de sincronizar"
  • Sincronizando: Indicador giratorio + "Sincronizando X elementos..."
  • Se muestra la hora de la última sincronización

Instrucciones de Instalación

iOS (Safari):

  1. Abra aptli.com en Safari
  2. Toque el botón Compartir (caja con flecha)
  3. Desplácese y toque "Añadir a la Pantalla de Inicio"
  4. Toque "Añadir"
  5. El icono de la aplicación aparece en la pantalla de inicio

Android (Chrome):

  1. Abra aptli.com en Chrome
  2. Toque el menú (tres puntos)
  3. Toque "Añadir a la Pantalla de Inicio"
  4. Toque "Añadir"
  5. El icono de la aplicación aparece en la pantalla de inicio

Alternativamente:

  • El navegador muestra automáticamente un banner de "Instalar Aplicación"
  • Toque "Instalar" cuando se le indique

Actualizaciones

La PWA se actualiza automáticamente:

  • Sin necesidad de actualizaciones de la tienda
  • La nueva versión se descarga en segundo plano
  • Aviso para actualizar cuando está lista
  • Despliegue instantáneo de correcciones/funciones

Consideraciones de Seguridad

Almacenamiento en el Dispositivo:

  • Los datos de sesión se aseguran en el dispositivo
  • No se almacenan datos sensibles en texto plano
  • Todos los datos locales se borran al cerrar sesión

Privacidad del GPS:

  • Solo se accede a la ubicación cuando es necesario (informes, recogidas QR)
  • El permiso se solicita explícitamente
  • Se puede rechazar (se admite la introducción manual de ubicación)
  • Los datos GPS se cifran en tránsito (HTTPS)

Privacidad de las Fotos:

  • Las fotos se almacenan localmente hasta que se suben
  • Se eliminan tras una subida exitosa
  • Almacenamiento cifrado en el servidor
  • Acceso controlado por permisos

Mejores Prácticas

Instalar la PWA:

  • Más rápido que el navegador móvil
  • Funciona sin conexión
  • Mejor experiencia

Habilitar Notificaciones:

  • Recibir actualizaciones de asignaciones
  • Respuestas a solicitudes de ayuda
  • Caducidades de códigos de recogida

Sincronizar con Regularidad:

  • Abra la aplicación a diario (incluso sin conexión)
  • Las acciones en cola se procesan automáticamente
  • Evita grandes atrasos

Usar la Cámara:

  • Las fotos demuestran el trabajo completado
  • Documentan problemas de calidad
  • Más rápido que escribir descripciones

Informar desde el Campo:

  • Envíe mientras aún está en el sitio
  • Memoria fresca = detalles precisos
  • Captura automática de GPS (no olvide la ubicación)

Cachear Teselas del Mapa:

  • Abra el mapa en la zona de servicio mientras está en línea
  • Las teselas se almacenan en caché durante 30 días
  • El mapa se puede usar sin conexión