Plantilla inicial del taller
publicar / publicar (push) Failing after 6s

This commit is contained in:
taller committed 2026-11-22 18:51:27 +00:00
1 parent 37fd1f4f18
commit 4f7d614892
22 files changed
+1157

No files matched your search

+37
View File
@@ -0,0 +1,37 @@
# 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.