--- name: deploy description: Procedimiento innegociable de bump semántico de versión, git push y despliegue continuo en producción (LXC 10.0.0.217) utilizando .credenciales. --- # Skill: Despliegue Continuo, Bump de Versión y Git Push Esta skill define el protocolo obligatorio para consolidar, versionar, publicar y desplegar cambios en **admin-edu-space**. --- ## Principio Rector (Principios 9 y 10 de la Constitución) Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe: 0. **Tolerancia Cero a Errores en Código (`@[current_problems]`):** Es mandatorio verificar y resolver al 100% cualquier error de linter, compilación, imports o advertencias críticas antes de compilar o empaquetar. Nunca dar una tarea por terminada si hay errores en el código. 1. **Subir la versión semántica** de forma coordinada. 2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev` y `main`). 3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`. --- ## Paso 0: Verificación de Código Limpio (Zero Errors) Antes de proceder con el bump de versión: - Inspeccionar y limpiar todos los problemas reportados en `@[current_problems]`. - Ejecutar suite de pruebas: `cd backend && .\venv\Scripts\python.exe -m pytest tests -v`. - Verificar que el compilador no reporte errores de sintaxis ni de tipos: `py_compile`. --- ## Paso 1: Bump Semántico de Versión Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto: - `frontend/package.json` (`"version": "X.Y.Z"`) - `frontend/src/app.js` (`APP_VERSION`, `FRONTEND_VERSION`, `BACKEND_VERSION`) - `backend/app/__init__.py` (`__version__ = "X.Y.Z"`) - `backend/setup.py` (`version="X.Y.Z"`) - `backend/app/routes/api/openapi.py` (`"version": "X.Y.Z"`) - `CHANGELOG.md` (Nueva sección `## [X.Y.Z] - YYYY-MM-DD`) - `MEMORY.md` (Registrar hito del sprint) --- ## Paso 2: Git Commit y Push Ejecutar la suite de pruebas (`python -m pytest tests -v` en `backend`). Si está 100% en verde: ```powershell git add . git commit -m "feat/fix: descripción del cambio (vX.Y.Z)" git push origin dev ``` --- ## Paso 3: Despliegue en Servidor de Producción (LXC Edu-Admin-Space) Consultar el archivo `.credenciales` en la raíz del proyecto para obtener la IP, usuario y contraseña del host: - **Host / IP:** `10.0.0.217` (LXC Debian Edu-Admin-Space) - **Dominio Público:** `https://eduspace.oemspot.com.ar` - **Usuario SSH:** `root` - **Acceso:** Credenciales de `.credenciales` ### Comandos de Despliegue Remoto: 1. Conectar vía SSH y sincronizar repositorio en el servidor: ```bash ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev" ``` 2. Si hubo cambios en dependencias o esquema: ```bash ssh root@10.0.0.217 "cd /opt/admin-edu-space/backend && ./venv/bin/pip install -r requirements.txt && ./venv/bin/flask db upgrade" ssh root@10.0.0.217 "cd /opt/admin-edu-space/frontend && npm install" ``` 3. Reiniciar servicios systemd del Backend y Frontend: ```bash ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend" ``` 4. Verificar estado del servicio: ```bash ssh root@10.0.0.217 "systemctl status admin-edu-space-backend --no-pager" ssh root@10.0.0.217 "systemctl status admin-edu-space-frontend --no-pager" ``` --- ## Paso 4: Verificación de Disponibilidad en Vivo (Smoke Test) Comprobar que el endpoint público responde HTTP 200 con la nueva versión: - Backend version: `https://eduspace.oemspot.com.ar/api/v1/version` o `http://10.0.0.217:5000/api/v1/version` - Frontend version: `https://eduspace.oemspot.com.ar/version` - Pantalla de login accesible: HTTP 200 en `https://eduspace.oemspot.com.ar/login`