IT Green
Universidad Autónoma Chapingo Ingeniería Mecánica Agrícola
Hackathon · Git, servidores y agentes de IA

Reglas del reto «Alerta Plaga»

Tomar equipoGuía para los equiposTabla de posicionesDocumentación de la API

Reglas del reto «Alerta Plaga»

Pregunta del reto: ¿cómo lograr que el aviso de un productor se reciba, se interprete y se atienda antes de que la plaga se extienda?

Una junta local de sanidad vegetal de la región de Texcoco tiene un coordinador y doce técnicos de campo. Recibe por Telegram los mensajes de los productores: texto, notas de voz y fotos. Los productores usan nombres locales para las plagas («chahuixtle», «gusano del cogollo»), no siempre dan todos los datos y algunos mensajes no tienen nada que ver con plagas. La junta, los productores y los datos son ficticios.

Nivel 2 (desde el martes 20 por la noche). Ahora, además de decir si el mensaje es un reporte de plaga y qué plaga es, cada caso lleva su semáforo, su técnico y si hay brote. Lo que ya registraron conserva sus puntos y le pueden agregar lo que le falte (sección 10).

1. El reto

Para cada mensaje, su sistema decide si es un reporte de plaga y qué plaga es. Si el mensaje abre un caso, calcula su semáforo, le asigna un técnico y revisa si hay brote. Si el semáforo es rojo o naranja, o si hay brote, avisa al coordinador por Telegram.

Quién Qué hace
Agente de IA Interpreta el mensaje: ¿es un reporte de plaga? ¿Qué plaga es, según el catálogo? ¿Qué parte de la parcela está afectada? Nunca decide el semáforo, el técnico ni el brote.
Reglas (código, sin IA) Calculan la prioridad y el semáforo, eligen al técnico y detectan brotes con las fórmulas de las secciones 7, 8 y 9. Con los mismos datos dan siempre el mismo resultado.
Coordinador Un integrante del equipo. Recibe por Telegram los casos rojos y naranjas y los brotes, con su plaga, su parcela y su técnico.

2. Fechas

Momento Qué pasa
Lunes 19, 17:00 La API empieza a publicar mensajes de productores.
Martes 20, 17:00–21:00 Sesión 2 del curso: servidores, despliegue y agentes de IA.
Martes 20, noche Empieza el nivel 2: semáforo, técnico y brote.
Lunes 19 a jueves 22 Desarrollo. Siguen llegando mensajes, también de noche.
Jueves 22, 23:59 Cierre. La API deja de aceptar resultados y se revisa el último commit.
Viernes 23 Demostraciones, preguntas a cada integrante y premiación.

La hora es la del centro de México (UTC−6). La hora oficial es la de GET /salud.

3. Equipos

{ "nombre": "Los Cogolleros", "repo": "https://github.com/ana/alerta-plaga" }

4. Cómo funciona su sistema

  1. Recibir: cada minuto consulta los mensajes nuevos con GET /reportes?desde=….
  2. Interpretar (IA): ¿es un reporte de plaga? ¿Qué plaga? ¿Qué porcentaje de la parcela? El catálogo (GET /plagas) trae nombres locales y síntomas de las 10 plagas.
  3. Ubicar: la parcela es la del parcela_id del mensaje, y su cultivo, superficie, etapa y coordenadas salen de GET /parcelas. Si el mensaje no trae parcela_id, le preguntan al productor (sección 6).
  4. Decidir (reglas): prioridad, semáforo, técnico y brote. Para el brote guarden sus casos: los va a necesitar.
  5. Avisar: si el semáforo es rojo o naranja, o si hay brote, el bot de Telegram avisa al coordinador.
  6. Registrar: manda el resultado con POST /casos.

Su sistema corre en su servidor y su código vive en su propio repositorio de GitHub, uno por equipo, creado por ustedes. Guardar los resultados en una base de datos es opcional, pero ayuda.

5. La API

URL base: https://itg.tailf75570.ts.net · Documentación interactiva: /docs · Guía: /guia

Método Ruta Para qué
GET /reportes?desde=… Mensajes nuevos, recibidos después de desde (ISO 8601 o HH:MM).
GET /media/{archivo} Notas de voz (.ogg, como las de Telegram) y fotos (.jpg). No requiere token.
GET /plagas Catálogo de 10 plagas: nombres locales, síntomas, severidad, especialidad, etapas críticas y susceptibles, y si es cuarentenaria.
GET /parcelas, /productores Parcelas (productor, cultivo, superficie en hectáreas, etapa y coordenadas) y productores.
GET /tecnicos?momento=… Los 12 técnicos: especialidad, base (coordenadas) y su carga en ese momento.
GET /casos-previos Casos de la semana pasada con la respuesta correcta. Cuentan para los brotes y sirven para probar sus reglas (sección 9).
POST /preguntas Una pregunta al productor sobre un mensaje. Si contesta, su respuesta llega en /reportes con respuesta_a.
POST /casos El resultado de cada mensaje. Una sola vez por mensaje.
POST /casos/validar Revisa que su resultado esté bien armado sin registrarlo ni calificarlo. No dice si acertaron.
GET · PATCH /equipo Datos y avance del equipo.
GET · POST /visitas, /avisos Para los retos extra: visitas que registran los técnicos y un buzón de avisos al productor, al técnico, a los vecinos, a sanidad vegetal o al coordinador.

Un mensaje se ve así:

{ "id": "R-2291", "productor_id": "PR-118", "parcela_id": "P-077", "tipo": "voz",
  "texto": null, "audio_url": "/media/R-2291.ogg", "foto_url": null, "duracion_s": 14.2,
  "lat": 19.5112, "lon": -98.8817, "recibido": "2026-10-19T17:31:04-06:00", "respuesta_a": null }

6. Cómo decidir (agente de IA)

7. Semáforo (reglas, sin IA)

Prioridad = severidad + superficie + etapa (de 0 a 100)

Factor Cómo se calcula Puntos
Severidad Del catálogo: baja 15 · media 25 · alta 40 · crítica 50 hasta 50
Superficie ha afectadas = superficie_ha × porcentaje / 100; puntos = min(25, redondear(ha afectadas / 4 × 25)) (25 puntos desde 4 ha) hasta 25
Etapa Etapa de la parcela: crítica para esa plaga en ese cultivo 25 · susceptible 15 · otra 5 hasta 25
Semáforo Prioridad Visita a más tardar
Rojo 85–100 24 h
Naranja 70–84 48 h
Amarillo 40–69 72 h
Verde 0–39 7 días

Ejemplo: maíz de 4.5 ha en V8 con gusano cogollero (severidad alta) en la mitad de las matas: 40 + redondear(2.25 / 4 × 25 = 14.06) = 14 + 25 (V8 es crítica) = 79, naranja.

8. Técnico (reglas, sin IA)

  1. Solo técnicos de la especialidad de la plaga (entomologia o fitopatologia, viene en el catálogo).
  2. Solo los que tienen carga menor a 5 en el momento del mensaje: GET /tecnicos?momento=<recibido del mensaje>.
  3. De ellos, el más cercano a la parcela, medido desde su base con la fórmula de haversine y radio de la Tierra R = 6371 km.
  4. Empates de distancia (al metro): menor carga y, después, menor id.
  5. Si nadie cumple: tecnico_id: null.

La carga la simula la API y cambia con el tiempo. Por eso se consulta con la hora recibido del mensaje y no con la hora en que lo procesan.

9. Brote (reglas, sin IA)

Hay brote si, contando el caso actual, hay 3 o más casos de la misma plaga cuyas parcelas están a menos de 5 km de la parcela del mensaje, recibidos en los 7 días previos (168 h, incluido el momento del mensaje).

Ejemplo: llega un caso de chapulín el miércoles a las 10:00. Si en los últimos 7 días hubo otros dos casos de chapulín a menos de 5 km de esa parcela (aunque sean de la semana pasada), con este ya son 3: hay brote.

Para probar sus reglas: GET /casos-previos trae los casos de la semana pasada con la respuesta correcta: parcela_id, lat, lon, plaga, pct (el porcentaje que dijo el productor; null = no lo dijo, se usa 10), prioridad, semaforo, recibido, tecnico_id y brote. Si su código da los mismos resultados con esos datos, sus reglas están bien. Para el brote de un caso previo cuenten solo los casos previos.

10. Registro y puntos: POST /casos

{ "reporte_id": "R-2291", "es_plaga": true, "plaga": "gusano_cogollero",
  "semaforo": "naranja", "tecnico_id": "T-03", "brote": true, "prioridad": 79 }

Cada decisión acertada suma 1 punto y cada decisión equivocada resta 1.

El mensaje es… ¿Es reporte de plaga? ¿Qué plaga? Semáforo Técnico Brote
un caso nuevo true: +1 · false: −1 correcta: +1 · equivocada: −1 · "desconocida": 0 correcto: +1 · equivocado: −1 correcto: +1 · equivocado: −1 correcto: +1 · equivocado: −1
un seguimiento o un reporte que no se pudo aclarar true: +1 · false: −1 correcta: +1 · equivocada: −1 · "desconocida": 0 no cuenta no cuenta no cuenta
otra cosa false: +1 · true: −1 — — — —

11. Evaluación

Peso Criterio Cómo se mide
30 % Su sistema funciona Puntos de la tabla (aciertos menos errores) ÷ puntos posibles de los mensajes publicados hasta el cierre.
30 % Explicación individual Cada integrante explica su código y las decisiones del equipo.
20 % Ingeniería Commits de todos los integrantes, su sistema funcionando en su servidor, README y llaves fuera del repositorio.
20 % Retos extra Ver la sección siguiente.

12. Retos extra (opcionales)

13. Reglas de participación

  1. Se permite usar agentes de IA para programar y modelos de IA dentro del sistema.
  2. Cada equipo hace su propio sistema. Se pueden comentar ideas; no se copia código de otro equipo.
  3. El historial de commits refleja el trabajo de la semana y de todos los integrantes.
  4. Las llaves de API, los tokens y las contraseñas no se suben al repositorio.
  5. No se ataca la API ni se intenta obtener las respuestas por otro camino.
  6. Las dudas se resuelven en el grupo de Telegram del hackathon.

14. Al cierre y el viernes