# 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.