Guía general

Cómo funciona Lobo Express

La app conecta a personas que necesitan enviar paquetes con agencias de delivery registradas. Todo pasa en tiempo real gracias a Firebase (autenticación, base de datos y notificaciones).

Flujo principal

Cliente busca agencia Abre chat o WhatsApp Coordina el envío Agencia actualiza estado Cliente valora

1. Registro e inicio de sesión

  • Clientes: pueden registrarse con correo o iniciar sesión con Google. Completan nombre, teléfono y departamento.
  • Agencias: se registran con un token de registro válido (entregado por el administrador), además de datos de la empresa: nombre, cédula, dirección, teléfono y departamento.
  • Administrador: cuenta especial configurada en Firebase para gestionar la plataforma.

2. Panel del cliente

  1. Ve un listado de agencias activas, filtradas por departamento de Nicaragua.
  2. Puede marcar agencias como favoritas para verlas primero.
  3. Al tocar una agencia disponible, se crea o abre un chat con esa agencia.
  4. En el chat puede escribir mensajes, ver estados del pedido y abrir WhatsApp con el teléfono de la agencia (con confirmación previa).
  5. Puede dejar una valoración de 1 a 5 estrellas (válida 90 días).

Más detalles para clientes →

3. Panel Manada (agencia)

  1. La agencia activa o desactiva su disponibilidad (solo si tiene días de suscripción vigentes).
  2. Recibe conversaciones en una bandeja con nombre del cliente y mensajes no leídos.
  3. Responde en el chat y puede enviar estados rápidos: 📦 recibido, 🏍️ en camino, ✅ entregado.
  4. Esos estados se muestran al cliente como mensajes automáticos en el chat.

Más detalles para agencias →

4. Chat y notificaciones

  • Los mensajes se guardan en la nube (Firestore) y también en caché local en el teléfono para abrir el chat más rápido.
  • Si llega un mensaje nuevo y la app está cerrada, el usuario recibe una notificación push (Firebase Cloud Messaging).
  • Mientras estás dentro del chat, los mensajes se marcan como leídos automáticamente.

5. Suscripción de agencias

Las agencias operan con días de suscripción. El administrador puede sumar o restar días. Si la suscripción vence, la agencia no puede ponerse disponible hasta renovar. Cuando quedan 5 días o menos, la agencia ve una advertencia.

6. Tecnología

ComponenteUso
Android + KotlinAplicación móvil
Jetpack ComposeInterfaz de usuario
Firebase AuthInicio de sesión (Google y correo)
Cloud FirestoreUsuarios, agencias, chats y mensajes
FCMNotificaciones push
Room (SQLite)Caché local de mensajes del chat