🔔 Reglas de notificacion vs ⚡ Reglas de auto-programacion (Notification Rules vs Auto-Schedule Rules)

El bot usa un sistema de filtrado de dos niveles para gestionar viajes eficientemente.

---

🔔 Reglas de notificacion — Primer filtro (amplio)

Proposito: Filtrar viajes de baja calidad y enviar alertas sobre oportunidades potenciales

Como funcionan:

• Aplican a todos los viajes en Area de busqueda (Search Area) (Area de programacion + 5 millas de buffer)
• Bloquean viajes obviamente malos de ser considerados
• Envian notificaciones de Telegram para viajes que pasan
• Funcionan 24/7, sin importar tu horario

Alcance geografico: Area de programacion + 5 millas en todas direcciones

¿Por que las 5 millas extra?

El buffer te permite ver viajes ligeramente fuera de tu area principal que aun podrian valer la pena. Si consistentemente ves buenos viajes en el area extendida, considera expandir tu Area de Programacion.

Mejor practica: Manten las reglas simples y amplias

Ejemplo:

price >= $20

Resultado: Notificacion de Telegram para cada viaje ≥$20 dentro del Area de Busqueda. Tu revisas y reservas manualmente si te interesa.

Modelo mental: "Muestrame todo lo que no sea basura obvia"

---

⚡ Reglas de auto-programacion — Segundo filtro (estricto)

Proposito: Reservar automaticamente viajes que definitivamente quieres

Como funcionan:

• Aplican solo a viajes que pasaron las reglas de notificacion
• Reservan automaticamente viajes que coinciden con criterios estrictos
• Solo reservan viajes que comienzan durante tus horas programadas
• Verifican conflictos de programacion con viajes existentes:
  • Verifica tiempo suficiente para llegar al punto de recogida desde el viaje anterior (usando trafico en tiempo real)
  • Verifica tiempo suficiente para llegar al siguiente viaje despues de que termine el actual
• Verifican 24/7 pero respetan tu horario semanal

Alcance geografico: Solo Area de Programacion (sin buffer)

Alcance temporal: Solo auto-reserva viajes que comienzan durante franjas horarias configuradas a menos que la regla sea forzada

Mejor practica: Se estricto y especifico

Ejemplo:

price >= $30 AND hourly_rate >= $40 AND mile_rate >= $1.5

Resultado: El bot automaticamente reserva viajes calificados dentro del Area de Programacion que comienzan durante tus horas programadas. Recibes una notificacion de confirmacion despues de la reserva.

Modelo mental: "Solo reserva viajes que estoy 100% seguro que quiero"

---

⚡ Ventaja de velocidad: Auto-programacion vs Manual

La auto-programacion aumenta dramaticamente tus chances de obtener viajes competitivos.

Flujo de reserva manual

1. El bot detecta el viaje
2. Genera y envia notificacion de Telegram
3. Tu recibes la notificacion
4. Lees los detalles y decides
5. Haces clic en "Reserve"
6. El bot procesa tu solicitud
7. El bot intenta reservar

Tiempo total: 5-30+ segundos (el viaje puede ser tomado por otro conductor)

Flujo de auto-programacion

1. El bot detecta el viaje
2. Verifica reglas de auto-programacion (instantaneo)
3. Reserva el viaje inmediatamente via algoritmo optimizado
4. Envia confirmacion

Tiempo total: <1 segundo

Impacto en el mundo real

Para viajes competitivos (pago alto, distancia corta, ubicacion conveniente), multiples conductores compiten simultaneamente. La auto-programacion proporciona una ventaja competitiva significativa al:

• Eliminar el retraso de respuesta humana (5-30 segundos ahorrados)
• Usar algoritmo de reserva optimizado
• Trabajar 24/7 incluso cuando no estas disponible

tip

Viajes de alto valor como $50 con tarifa de $60/hr se reclaman rapido. La auto-programacion asegura que los captures antes que otros conductores.

---

Como funciona el filtro de dos niveles

Aparece nuevo viaje
    ↓
[Primer filtro: Reglas de notificacion]
    ↓
¿Coincide con regla de notificacion?
    ├─ No → IGNORAR (filtrado)
    └─ Si → Continuar
         ↓
    [Segundo filtro: Reglas de auto-programacion]
         ↓
    ¿Coincide con regla de auto-programacion?
         ├─ No → Verificar si esta en Area de Busqueda
         │        ├─ No → IGNORAR
         │        └─ Si → 📱 ENVIAR NOTIFICACION (reserva manual)
         └─ Si → Verificar ubicacion y tiempo
                   ├─ Fuera del Area de Programacion → 📱 ENVIAR NOTIFICACION
                   ├─ Fuera de franjas horarias (si no es forzada) → 📱 ENVIAR NOTIFICACION
                   └─ En Area de Programacion y franjas horarias → Verificar conflictos
                        ├─ Tiempo insuficiente desde viaje anterior → 📱 ENVIAR NOTIFICACION
                        ├─ Tiempo insuficiente para siguiente viaje → 📱 ENVIAR NOTIFICACION
                        └─ Sin conflictos → 🟢 AUTO-RESERVAR + notificacion

Puntos clave:

• Reglas de notificacion = Primer filtro amplio (elimina basura)
• Reglas de auto-programacion = Segundo filtro estricto (auto-reserva viajes excelentes)
• Area de Busqueda = Area de Programacion + 5 millas buffer (solo notificaciones)
• Area de Programacion = Limite estricto (solo auto-programacion)
• Franjas horarias = Solo verificadas para auto-programacion (a menos que la regla sea forzada)

---

Configuracion de ejemplo (Example Setup)

Regla de notificacion (amplia):

price >= $20

• Geografico: Area de Busqueda (Area de Programacion + 5 millas)
• Filtra viajes bajo $20
• Notifica sobre todo ≥$20 en area extendida

Regla de auto-programacion (estricta):

price >= $30 AND hourly_rate >= $40

• Geografico: Solo Area de Programacion
• Tiempo: Solo durante franjas horarias configuradas (a menos que la regla sea forzada)
• Auto-reserva los mejores viajes del conjunto ≥$20
• Deja viajes limitrofes para revision manual

---

Escenarios de ejemplo (Example Scenarios)

Detalles del viaje	Filtro de notificacion	Filtro de auto-programacion	Resultado
$35, $45/hr, en Area de Programacion, en horas	✅ Pasa	✅ Pasa	🟢 Auto-reservado + notificacion
$25, $38/hr, en Area de Programacion, en horas	✅ Pasa	❌ Falla (precio o tarifa baja)	📱 Notificacion - decision manual
$35, $45/hr, en Area de Programacion, fuera de horas	✅ Pasa	❌ Falla (fuera de franjas)	📱 Notificacion - decision manual
$35, $45/hr, 3 millas fuera del Area de Programacion	✅ Pasa (en buffer)	❌ Falla (fuera del area)	📱 Notificacion - decision manual
$18, $60/hr	❌ Falla	N/A (nunca verificado)	🚫 Bloqueado - sin notificacion

---

Diferencias clave (Key Differences)

Caracteristica	Reglas de notificacion	Reglas de auto-programacion
Proposito	Eliminar viajes basura	Auto-reservar viajes excelentes
Alcance geografico	Area de Busqueda (Area de Prog. + 5mi)	Solo Area de Programacion
Alcance temporal	Verifica todos los viajes sin importar hora de inicio	Verifica todos los viajes pero solo auto-reserva los que comienzan en franjas programadas (a menos que sea forzada)
Rigurosidad	Amplia, permisiva	Estricta, especifica
Accion	Enviar notificacion	Reservar automaticamente
Aplicado a	Todos los viajes en Area de Busqueda	Solo viajes que pasaron reglas de notificacion
Tu decision	Requerida (revision manual)	No necesaria (auto-reservado)
Recomendacion	Manten simple (ej., price >= $20)	Se especifico (ej., price >= $30 AND hourly_rate >= $40)

---

⚠️ Critico: Orden de procesamiento de reglas

Las reglas de auto-programacion SOLO se verifican si una regla de notificacion coincide primero.

Por eso las reglas de notificacion deben ser mas amplias (menos estrictas) que las reglas de auto-programacion.

✅ Configuracion correcta

Regla de notificacion: price >= $20  (mas amplia)
Regla de auto-programacion: price >= $30 AND hourly_rate >= $40  (mas estricta)

Que sucede:

• Viaje de $18 → ❌ Bloqueado (filtrado por regla de notificacion)
• Viaje de $25 → ✅ Notificacion enviada, ❌ no auto-programado
• Viaje de $35 con $45/hr → ✅ Notificacion enviada, ✅ auto-programado

❌ Configuracion incorrecta

Regla de notificacion: price >= $30 AND hourly_rate >= $40  (¡muy estricta!)
Regla de auto-programacion: price >= $20  (mas amplia - ¡NUNCA se activara!)

Problema: Viajes $20-$29 fallan la regla de notificacion primero, asi que la regla de auto-programacion nunca se verifica.

El orden de las reglas importa

Siempre asegurate de que las reglas de notificacion sean mas amplias que las reglas de auto-programacion. De lo contrario, las reglas de auto-programacion no funcionaran como se espera.