feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
---
|
||||
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 (Principio 9 de la Constitución)
|
||||
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
||||
1. **Subir la versión semántica** de forma coordinada.
|
||||
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
|
||||
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
||||
|
||||
---
|
||||
|
||||
## 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`
|
||||
@@ -0,0 +1,66 @@
|
||||
---
|
||||
name: sdd
|
||||
description: Flujo de desarrollo guiado por especificaciones (Spec-Driven Development) basado en los principios de ingeniería de software con IA y sintaxis EARS.
|
||||
---
|
||||
|
||||
# Skill: Spec-Driven Development (SDD)
|
||||
|
||||
Esta skill define el arnés metodológico innegociable para implementar, refactorizar o validar funcionalidades en **admin-edu-space**.
|
||||
|
||||
## Principio Fundamental
|
||||
**La especificación manda**: Ninguna línea de código de negocio se escribe si no está precedida por una especificación aprobada (`spec.md`), un plan técnico (`plan.md`) y una lista de tareas atómicas (`tasks.md`).
|
||||
|
||||
---
|
||||
|
||||
## Flujo de Trabajo (7 Pasos)
|
||||
|
||||
```
|
||||
1. Constitución (docs/constitution.md)
|
||||
↓
|
||||
2. Especificación (specs/NNN-nombre/spec.md)
|
||||
↓
|
||||
3. Clarificación (Revisión QA - detección de ambigüedades)
|
||||
↓
|
||||
4. Planificación (specs/NNN-nombre/plan.md)
|
||||
↓
|
||||
5. Desglose de Tareas (specs/NNN-nombre/tasks.md)
|
||||
↓
|
||||
6. Implementación (Tarea por tarea, Test-First)
|
||||
↓
|
||||
7. Validación (RF por RF + Criterios de Finalización)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Sintaxis EARS (Easy Approach to Requirements Syntax)
|
||||
Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5 estructuras EARS en español:
|
||||
|
||||
1. **Ubicuo (Comportamiento permanente)**:
|
||||
> `EL SISTEMA <comportamiento permanente>.`
|
||||
> *Ejemplo:* EL SISTEMA registrará en `AuditLog` toda modificación de asignación de aula.
|
||||
|
||||
2. **Basado en Eventos (Disparado por una acción)**:
|
||||
> `CUANDO <evento>, EL SISTEMA <respuesta>.`
|
||||
> *Ejemplo:* CUANDO el usuario confirme una reserva con conflicto físico, EL SISTEMA bloqueará la operación y retornará un error HTTP 409 con el detalle de la superposición.
|
||||
|
||||
3. **Basado en Estados (Activo mientras se cumpla una condición)**:
|
||||
> `MIENTRAS <estado>, EL SISTEMA <respuesta>.`
|
||||
> *Ejemplo:* MIENTRAS una comisión posea co-docencia activa registrada, EL SISTEMA permitirá la superposición horaria del docente auxiliar.
|
||||
|
||||
4. **No Deseado / Excepciones (Manejo de errores y límites)**:
|
||||
> `SI <condición no deseada>, ENTONCES EL SISTEMA <respuesta>.`
|
||||
> *Ejemplo:* SI la matrícula de la comisión supera el aforo máximo del aula, ENTONCES EL SISTEMA impedirá el guardado y alertará al operador de Bedelía.
|
||||
|
||||
5. **Opcional (Funcionalidad dependiente de configuración o rol)**:
|
||||
> `DONDE <característica opcional>, EL SISTEMA <respuesta>.`
|
||||
> *Ejemplo:* DONDE el usuario posea rol Bedelia o Admin, EL SISTEMA habilitará el botón de reasignación directa de aulas libres.
|
||||
|
||||
---
|
||||
|
||||
## Reglas de Ejecución para Agentes
|
||||
1. **No inventar**: Si falta información o un caso de uso no está cubierto, detenerse y marcar `[NECESITA ACLARACIÓN]`.
|
||||
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
|
||||
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
|
||||
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
|
||||
5. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
|
||||
6. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
|
||||
Reference in New Issue
Block a user