2.3 KiB
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)
- 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".
- Tests primero. Escribe o amplía el test que demuestra el fallo, comprueba que falla y luego arréglalo.
- Cambios pequeños. Un cambio, sus tests,
git diffrevisado por la pareja, commit. - Publicar = push a main.
git pull --rebase && git push. El CI construye y Argo CD despliega en 1-2 minutos. - Cuando cambiéis de tarea, la pareja hará
/clearpara 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/nik8s/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(cambiaconfig.jssolo 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.