Files
escuadron-2/CLAUDE.md
T
taller 4f7d614892
publicar / publicar (push) Failing after 6s
Plantilla inicial del taller
2026-11-22 18:51:27 +00:00

2.3 KiB

Votación del viaje de fin de curso · Escuadrón

Sois un escuadrón de dos parejas: web (carpeta web/) y app (carpeta api/). Lo único que compartís es el contrato de la API: CONTRATO.md y openapi.yaml. Cada pareja tiene además su encargo: CONTRATO-WEB.md o CONTRATO-APP.md.

Responde siempre en español.

Flujo de trabajo (obligatorio)

  1. Arquitectura antes que código. Ante cada tarea, lee el contrato y propón un plan corto (qué ficheros, qué cambia, cómo se prueba). No escribas código hasta que la pareja diga "adelante".
  2. Tests primero. Escribe o amplía el test que demuestra el fallo, comprueba que falla y luego arréglalo.
  3. Cambios pequeños. Un cambio, sus tests, git diff revisado por la pareja, commit.
  4. Publicar = push a main. git pull --rebase && git push. El CI construye y Argo CD despliega en 1-2 minutos.
  5. Cuando cambiéis de tarea, la pareja hará /clear para empezar con el contexto limpio.

Normas

  • No modifiques los tests existentes para que pasen. Si un test parece incorrecto, dilo y para.
  • Pregunta antes de instalar cualquier librería o añadir dependencias.
  • No toques secretos ni ficheros de credenciales, y no los muestres por pantalla.
  • No toques la carpeta de la otra pareja salvo que lo pidan las dos.
  • No cambies el contrato (CONTRATO.md, openapi.yaml) sin que lo acuerden las dos parejas.
  • Nada de trazas ni mensajes internos en las respuestas de la API: errores en JSON, cortos.
  • No toques .gitea/ ni k8s/kustomization.yaml (los usa el despliegue automático).

Comandos

  • Tests de la API: cd api && pip install -r requirements.txt && python -m pytest -q
  • API en local: cd api && DB_PATH=/tmp/votos.db CENSO_PATH=../alumnos.csv python app.py (puerto 8000)
  • Probar la API: curl -s localhost:8000/api/resultados
  • Web en local: cd web && python3 -m http.server 8080 (cambia config.js solo en local, no lo subas)
  • Validar Kubernetes: kubectl kustomize k8s
  • Publicar: git add -A && git commit -m "..." && git pull --rebase && git push

Dónde mirar

  • La API y la web desplegadas: ver CONTRATO.md (direcciones del escuadrón).
  • Estado del despliegue: Argo CD (dirección en la tarjeta de la pareja).
  • El marcador del taller se proyecta en clase: allí aparece qué niveles superáis.