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

Guía para los equipos

Qué recibe cada equipo, para qué sirve cada cosa y cómo empezar.

Tomar equipoTabla de posicionesReglas del retoDocumentación de la API
Primero, tomen su equipo: elijan un servidor disponible y escriban sus nombres. En ese momento verán la contraseña de su servidor y el token de la API. Son solo para su equipo: guárdenlos y no los suban a GitHub.

El reto

Nivel 2 · desde el martes 20 por la noche

Para cada mensaje de un productor, su sistema decide si es un reporte de plaga y qué plaga es. Si abre un caso, calcula su semáforo, le asigna un técnico y revisa si hay brote. Los casos rojos y naranjas y los brotes se le avisan al coordinador por Telegram.

El agente de IA interpreta el mensaje: si es reporte, qué plaga y qué parte de la parcela está afectada. Las reglas, en código y sin IA, calculan el semáforo (severidad + superficie + etapa), eligen al técnico (especialidad, carga y el más cercano) y detectan brotes (3 o más casos de la misma plaga a menos de 5 km en 7 días). Cada acierto suma 1 punto y cada error resta 1; no arriesgarse no resta. A lo que ya registraron le pueden agregar los campos que le falten. Los detalles están en las reglas.

Así se califica un mensaje

Un ejemplo ficticio de punta a punta: cómo llega un mensaje, qué decide su sistema y cómo lo compara la API. Cómo lo interpreta su agente lo deciden ustedes.

Sus tres accesos

1

Su servidor en internet

Desde el martes 20

Una computadora en la nube solo para su equipo, encendida toda la semana. Ahí corre su sistema (el agente que lee los mensajes y avisa por Telegram), y está la carpeta /campo con reportes de ejemplo. Se entra desde la terminal con SSH (NN es el número de su equipo):

ssh -p 22NN equipoNN@179-236-73-82.sslip.io contraseña: al tomar su equipo

La primera vez pregunta si confían en el servidor: escriban yes. Ya dentro, el comando estado muestra cómo va todo.

2

Espacio para su aplicación

Opcional · lo vemos en clase

Su servidor tiene una carpeta para aplicaciones (~/app). Lo que pongan a correr ahí en el puerto 3000 se ve en su link, y cualquiera lo puede abrir en el navegador. No es requisito del hackathon: en clase vemos cómo desplegar una aplicación ahí.

https://equipoNN.179-236-73-82.sslip.io

3

La API del hackathon y su token

Desde el lunes 19, 17:00

La API simula a los productores de la junta. De ahí salen sus mensajes (texto, notas de voz y fotos) y ahí se registra el resultado de cada uno, que da puntos en la tabla de posiciones. El token identifica a su equipo: va en el encabezado X-Equipo-Token de cada solicitud.

https://itg.tailf75570.ts.net token: al tomar su equipo

En su servidor ya están configurados como $API_HACKATHON y $TOKEN_EQUIPO. En su computadora, guarden el token en .env, nunca en el código.

Enlaces

Reglas del retoCómo se calcula todo y cómo se califica.itg.tailf75570.ts.net/reglas Documentación de la APIAhí se puede probar cada consulta con su token.itg.tailf75570.ts.net/docs Tabla de posicionesSe actualiza cada 30 segundos.itg.tailf75570.ts.net

Lo que crea cada equipo

Su repositorio en GitHubUno por equipo, creado por ustedes, con todo el código de su sistema. Los dos integrantes hacen commits. ya
Bot de TelegramSe crea con @BotFather. Su token va en .env. martes
Llave de OpenRouterPara usar los modelos de IA. Se las entregamos nosotros. martes
Base de datosOpcional, para guardar sus resultados; por ejemplo, un proyecto de Supabase.

Cómo empezar

  1. Tomen su equipo y guarden sus accesos. Si pierden la contraseña del servidor, la recuperan con su token en GET /equipo.
  2. Creen su propio repositorio en GitHub para el proyecto y regístrenlo con PATCH /equipo y el cuerpo {"repo": "https://github.com/…"}.
  3. Prueben la API en /docs con su token: GET /reportes para ver los mensajes y GET /plagas para el catálogo.
  4. Prueben sus reglas con GET /casos-previos: son casos de la semana pasada con su prioridad, su semáforo, su técnico y su brote correctos. Si su código da lo mismo, va bien. Esos casos también cuentan para los brotes de esta semana.
  5. Ya están llegando mensajes en GET /reportes (desde el lunes a las 17:00). Para cada uno registran una sola vez su resultado en POST /casos, y un error resta puntos. Antes, prueben su código con /casos/validar: revisa que el formato esté bien sin registrar nada ni decirles si acertaron.
    curl -X POST https://itg.tailf75570.ts.net/casos/validar \
      -H "X-Equipo-Token: SU_TOKEN" -H "Content-Type: application/json" \
      -d '{"reporte_id": "R-2001", "es_plaga": true, "plaga": "gusano_cogollero",
           "semaforo": "amarillo", "tecnico_id": "T-03", "brote": false}'

Fechas

Lun 19 · 17:00Abre el hackathon y empiezan a llegar los mensajes. Sesión 1 del curso: Git y GitHub.
Mar 20 · 17:00Sesión 2 del curso: servidores, despliegue y agentes de IA.
Mar 20 · nocheEmpieza el nivel 2: cada caso lleva su semáforo, su técnico y si hay brote.
Jue 22 · 23:59Cierre: la API deja de aceptar resultados y se revisa el último commit de su repositorio.
Vie 23Demostraciones, preguntas a cada integrante, un mensaje urgente en vivo y premiación.