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
- Ve un listado de agencias activas, filtradas por departamento de Nicaragua.
- Puede marcar agencias como favoritas para verlas primero.
- Al tocar una agencia disponible, se crea o abre un chat con esa agencia.
- En el chat puede escribir mensajes, ver estados del pedido y abrir WhatsApp con el teléfono de la agencia (con confirmación previa).
- Puede dejar una valoración de 1 a 5 estrellas (válida 90 días).
3. Panel Manada (agencia)
- La agencia activa o desactiva su disponibilidad (solo si tiene días de suscripción vigentes).
- Recibe conversaciones en una bandeja con nombre del cliente y mensajes no leídos.
- Responde en el chat y puede enviar estados rápidos: 📦 recibido, 🏍️ en camino, ✅ entregado.
- Esos estados se muestran al cliente como mensajes automáticos en el chat.
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
| Componente | Uso |
|---|---|
| Android + Kotlin | Aplicación móvil |
| Jetpack Compose | Interfaz de usuario |
| Firebase Auth | Inicio de sesión (Google y correo) |
| Cloud Firestore | Usuarios, agencias, chats y mensajes |
| FCM | Notificaciones push |
| Room (SQLite) | Caché local de mensajes del chat |