Guía de operación · Cali

De solicitud a paseo completado y trazable.

Este manual acompaña al administrador durante todo el recorrido: revisar al equipo, leer el pulso del día, asignar con criterio y dejar cada movimiento registrado.

01

La regla principal

Nunca inicies un paseo sin un paseador asignado. El sistema bloquea ese salto para proteger la trazabilidad.

01 · Inicio rápido

La operación completa en cuatro movimientos

Entra con tu usuario administrativo, encuentra una solicitud y sigue el orden del estado. Cada acción actualiza el tablero, el paseador y la bitácora.

1Por asignarSolicitud recibida
2ConfirmadoPaseador asignado
3En recorridoPaseo iniciado
4CompletadoServicio cerrado
01
Entra al panel

Usa el usuario admin y la clave privada que recibiste.

02
Busca la referencia

Escribe el código WP-…, la mascota o el cliente en Agenda de hoy.

03
Abre Gestionar

Revisa familia, mascota, horario, notas y disponibilidad antes de asignar.

04
Avanza el estado

Asigna, inicia y completa. Confirma el resultado en la bitácora lateral.

03 · Calendario y reservas

Una agenda compartida, sin dobles asignaciones

14 días visibles

Selecciona un día en la franja de calendario para filtrar las reservas operativas.

Inmediata o programada

La familia puede pedir el servicio más cercano o elegir fecha y hora hasta con 60 días.

Reprogramación

La app de familias cambia el horario conservando responsable, estado y evento de bitácora.

Protección de horario

Antes de aceptar o asignar, la API compara inicio y duración contra la agenda del paseador.

Disponibilidad y agenda son distintas

Disponible significa que el paseador desea recibir trabajo. Una reserva futura no lo desconecta: solo bloquea oportunidades que se crucen. El estado En paseo se activa al iniciar realmente el servicio.

02 · Leer el tablero

Primero mira el pulso, luego actúa

🐾

Indicadores

Paseos del día, recorridos activos, paseadores listos y valor programado.

Semana

Compara el volumen de los últimos siete días y detecta el ritmo de la operación.

Radar

Da prioridad a solicitudes sin asignar, perfiles pendientes y paseos activos.

Mapa GPS

Ubica el equipo en Cali y muestra únicamente las posiciones reales recibidas desde WalkPet Pro.

Consejo de turno

Comienza por el Radar operativo. Las alertas con punto coral requieren atención; la flecha te lleva a la zona correspondiente.

04 · Gestionar un paseo

Qué hace cada acción

AcciónCuándo usarlaQué cambia
Asignar

La solicitud está Por asignar.

El paseo queda Confirmado y registra al paseador.

Iniciar paseo

El paseador recibió la mascota.

El estado pasa a En recorrido y el paseador figura ocupado.

Completar paseo

La mascota regresó y terminó el servicio.

Guarda reporte final, distancia GPS real y libera al paseador.

Cancelar

El servicio no se realizará.

Cierra el paseo, registra el motivo operativo y libera al paseador.

!
Los estados no retroceden

Un paseo completado o cancelado queda cerrado. Esto evita alterar una historia ya registrada.

05 · Seguridad, chat y SOS

Responder primero; dejar el expediente completo

SOS

Alerta inmediata

WalkPet Pro registra el SOS antes de intentar cargar una fotografía para no depender del archivo.

Ubicación

Si el GPS ya produjo una lectura, la novedad conserva las coordenadas del paseador.

Evidencia privada

Las fotos viven fuera de la web pública y cada consulta administrativa queda auditada.

Un solo chat

Familia, paseador y Operación escriben dentro del expediente del paseo.

Atender una novedad

  1. Abre Seguridad y revisa primero los SOS.
  2. Pulsa Abrir expediente para consultar paseo, conversación y fotografías.
  3. Escribe una respuesta concreta y marca Atendida o Resuelta.
  4. La respuesta queda notificada a familia y paseador.

Prioridades

  • SOS: contacto y respuesta inmediata.
  • Urgente: requiere acción operativa prioritaria.
  • Atención: revisar y responder durante el turno.
  • Informativa: conservar en el expediente.
!
WalkPet no reemplaza emergencias públicas

Si existe peligro inmediato, el paseador debe usar también la línea local de emergencias. El SOS de WalkPet coordina y documenta la respuesta del servicio.

06 · Equipo de paseadores

Disponibilidad no es lo mismo que aprobación

Estados del equipo

  • Disponible: puede recibir una asignación.
  • En paseo: está atendiendo un recorrido.
  • Desconectado: no debe recibir solicitudes.
  • Por verificar: espera revisión administrativa.

Aprobar un perfil

  1. Ubica el perfil con la etiqueta Por verificar.
  2. Abre el detalle y revisa el perfil, la foto, la red social y los tres documentos privados.
  3. Pulsa Aprobar solo si toda la información coincide.

07 · WalkPet Pro

Verificación antes de permitir trabajo

1RegistroPerfil creado
2SoportesPerfil + 3 documentos
3RevisiónAprobar o rechazar
4OperaciónOfertas y paseos

Expediente requerido

  • Identidad, antecedentes y primeros auxilios caninos en PDF.
  • Foto de perfil controlada.
  • Experiencia y capacitación.
  • Contacto de emergencia y una red social de referencia.
  • Declaración de servicio y lector de microchip.

Decisión administrativa

  1. Abre el paseador desde Equipo.
  2. Lee datos y soportes dentro de la sesión protegida.
  3. Aprueba o rechaza; en rechazo, escribe una razón concreta.
!
Los soportes no son públicos

Viven fuera de la carpeta web y solo el administrador autenticado puede consultarlos. Cada apertura queda registrada en Auditoría.

08 · Nova, Niko y conversaciones

Dos agentes, una supervisión completa

N

Nova

Atiende cuenta, reservas, paseos y operación de WalkPet. Si detecta una pregunta sobre la mascota la transfiere a Niko.

🐾

Niko

Usa edad, peso, raza, alergias y observaciones autorizadas para orientación general. No es veterinario, no diagnostica y no recomienda medicamentos ni dosis.

Monitoreo

El Centro de conversaciones reúne Niko, Nova y Care↔Pro; abre cualquier hilo para leerlo, responder o tomar control humano.

!

Moderación

Los mensajes sospechosos se conservan para revisión. Operación puede mostrarlos, ocultarlos o bloquear el hilo dejando motivo y auditoría.

Regla de enrutamiento

  1. Mascota, salud general, comportamiento o bienestar: Niko.
  2. Cuenta, pago, reserva, servicio u operación: Nova.
  3. La misma regla se reutilizará en telefonía cuando se defina el número.

Derivación segura

  1. Ante síntomas o urgencias Niko no improvisa.
  2. Recomienda atención veterinaria y muestra solo negocios reales del directorio WalkPet.
  3. Operación puede tomar control y continuar el hilo.

09 · Control, auditoría y correo

Cada acción sensible deja rastro

Sesión protegida

El centro de mando, los documentos, el correo y la auditoría exigen autenticación administrativa.

Auditoría

Registra actor, acción, entidad, fecha, IP, navegador, solicitud y contexto operativo.

Cola de salida

Los avisos automáticos y mensajes manuales se guardan primero; no se pierden si el transporte está desconectado.

Recepción

El conector IMAP incorporará el correo entrante a la bandeja cuando el buzón y los puertos estén habilitados.

Cómo leer el estado del correo

Conectado indica que las credenciales de transporte están instaladas. Conector pendiente significa que los mensajes permanecen seguros en cola y todavía no han salido; no los marques como enviados manualmente.

Enviar desde el tablero

  1. Abre Control y localiza Correo.
  2. Escribe destinatario, asunto y mensaje.
  3. Confirma que aparezca en la lista con su estado real.

Investigar una acción

  1. Abre Auditoría en Control.
  2. Busca fecha, actor y entidad afectada.
  3. Usa el identificador de solicitud para relacionar eventos.

10 · Aliados comerciales

Publicar, monetizar y medir desde el mismo panel

Crear un expediente

  1. Abre Negocios y despliega Agregar un aliado.
  2. Marca su ubicación exacta en el mapa o ajusta las coordenadas.
  3. Completa categoría, descripción, contactos, portada y galería.
  4. Elige plan, suscripción y publicación; verifica solo cuando corresponda.

Administrar la cartera

  1. Revisa ingreso mensual, contactos, interacciones y rendimiento de campañas.
  2. Cambia el plan o estado en la fila del negocio.
  3. Administra categorías, palabras de búsqueda y color del mapa.
  4. Pulsa Guardar cambios; cada acción queda en Auditoría.
01

Presencia

Ficha, mapa, contactos, servicios y reporte básico.

02

Crecimiento

Posición destacada, promociones y métricas por canal.

03

Líder

Máxima visibilidad, campañas y analítica comercial ampliada.

Resultado

WhatsApp, llamadas, rutas, sitio web, favoritos y promociones medibles.

Descubrimiento por cercanía

WalkPet Care permite buscar por servicio o necesidad, filtrar a 5 km, 20 km o toda Cali y abrir fichas desde pines georreferenciados. Las impresiones, clics y contactos de campañas quedan medidos.

!
Datos comerciales de este corte

Los negocios, contactos y cobros precargados son ficticios. No presentes esas empresas como aliados reales hasta firmar y validar su información.

11 · Relación con las apps móviles

Familias y paseadores se encuentran en la operación

APPLa familia reserva

Elige mascota, duración, fecha y hora; también puede reprogramar o cancelar.

WPSe crea una referencia

El código WP-… conecta ambas experiencias.

ADMOperaciones responde

La solicitud aparece en el calendario compartido y en la agenda operativa.

Dos aplicaciones independientes

WalkPet Care pertenece a familias y mascotas. WalkPet Pro pertenece a paseadores. Tienen identificadores Android distintos y ambos se conectan exclusivamente a la API y al esquema lógico de Firulais en este corte.

Avisos dentro de ambas apps

Asignaciones, mensajes y novedades se guardan en el Centro de avisos. El envío externo con Firebase todavía espera credenciales y por eso el producto lo muestra como pendiente, no como activo.

Punto de encuentro

Dentro de Nueva solicitud, pulsa Usar mi ubicación. El navegador o Android pedirán permiso y mostrarán el punto capturado en el mapa. Si no concedes permiso, continúa usando San Fernando como ubicación demo.

Abrir la experiencia móvil

12 · Si algo no sale

Comprobaciones rápidas

No veo una solicitud nueva

Pulsa actualizar en la Bitácora o recarga el panel. Luego busca la referencia exacta WP-… y activa el filtro Todos.

No aparece ningún paseador para asignar

Revisa Equipo. Solo se muestran paseadores verificados y disponibles; alguien En paseo, Desconectado o Por verificar no puede seleccionarse.

No puedo iniciar el paseo

Comprueba que el estado sea Confirmado y que exista un paseador asignado. El flujo no permite saltar directamente desde Por asignar.

El panel vuelve al inicio de sesión

La sesión administrativa expiró o fue cerrada. Ingresa nuevamente con tus credenciales.

Un correo aparece En cola

Revisa Control. Si SMTP figura como Conector pendiente, el mensaje está guardado pero no puede salir todavía. Cuando se configuren el buzón y los puertos, el trabajador de correo reintentará el envío.

Un paseador aprobado no recibe ofertas

Confirma que el perfil esté Aprobado y que haya activado su disponibilidad desde WalkPet Pro. Un perfil pendiente o desconectado no puede aceptar paseos.

No puedo asignar una reserva a un paseador

Si el sistema muestra un cruce, ese paseador ya tiene un servicio que ocupa parte del mismo horario. Elige otra persona o reprograma la reserva.

El paseo está activo pero el mapa dice “Esperando GPS real”

WalkPet Pro debe conservarse abierta durante el recorrido, con la ubicación del teléfono activada y autorizada. El panel nunca inventa movimiento: conserva la última señal y advierte cuando pasan más de 60 segundos sin una coordenada nueva.

¿Dónde veo el reporte de regreso?

Abre Gestionar sobre un paseo completado. Allí aparecen el estado de la mascota, agua y necesidades marcadas, la nota del paseador, la distancia calculada y la trazabilidad GPS recibida.

El aviso está en la app pero no llegó al sistema del teléfono

Los avisos internos ya funcionan. La notificación externa depende de Firebase y aparece identificada como pendiente hasta cargar credenciales válidas; revisa por ahora el Centro de avisos dentro de WalkPet o WalkPet Pro.

Corte activo de desarrollo

Los nombres, contactos y cobros iniciales son ficticios. En Android, la ruta solo aparece cuando WalkPet Pro transmite GPS real con permiso del paseador; si no hay señal, el sistema lo indica. Firulais usa su propio código publicado y el esquema lógico walkpet_firulais; Michi V1.5.2 permanece congelado.