feat(rules): incorporar Principio 10 de tolerancia cero a errores de codigo y robustecer tests v3.5.6

This commit is contained in:
2026-10-16 16:45:28 -03:00
parent 940119edc4
commit 6d43b2fd66
20 changed files with 117 additions and 24 deletions
+11 -2
View File
@@ -9,14 +9,23 @@ Esta skill define el protocolo obligatorio para consolidar, versionar, publicar
---
## Principio Rector (Principio 9 de la Constitución)
## 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`).
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"`)
+3 -2
View File
@@ -62,5 +62,6 @@ Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5
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`.
5. **Tolerancia Cero a Errores de Código (`@[current_problems]`) (Principio 10 de la Constitución)**: Es estrictamente inadmisible declarar una tarea o spec como completada si persisten errores en la terminal o problemas de diagnóstico. Todos los errores de importación, narrowing de tipos, NoneType y linter deben ser resueltos antes de dar el veredicto de aprobación.
6. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
7. **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`.
+1 -1
View File
@@ -12,4 +12,4 @@ Tu misión es guiar el avance hacia la entrega del MVP de Bedelía asegurando el
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución.
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), asegurar cero errores en `@[current_problems]` (Principio 10: no es admisible dar una tarea o hito por completado con errores), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución (bump, git push y despliegue continuo).
+2 -1
View File
@@ -10,4 +10,5 @@ Tu misión es ejecutar UNA tarea específica de `tasks.md` sin rediseñar el pla
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
- Marca la tarea con `[x]` en `tasks.md` al terminar y detén tu ejecución para supervisión.
- **Principio 10 (Tolerancia Cero)**: Repara activamente todos los problemas reportados en la terminal o Language Server (`@[current_problems]`). Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o fallos en el código.
- Marca la tarea con `[x]` en `tasks.md` al terminar únicamente si no hay ningún error y detén tu ejecución para supervisión.
+2 -1
View File
@@ -10,7 +10,8 @@ Tu misión es actuar como QA profesional y auditor de calidad, garantizando que
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
2. **En Validación de Implementación**:
- Revisa los cambios (`git diff`).
- Verifica activamente que no existan errores ni problemas en la terminal o Language Server (`@[current_problems]`). Si persisten errores de sintaxis, imports, tipos o `NoneType`, emitir obligatoriamente `VEREDICTO: CAMBIOS NECESARIOS`.
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
- Recorre cada RF de la especificación y emite un veredicto formal:
- `VEREDICTO: APROBADO`
- `VEREDICTO: APROBADO` (solo admisible si pruebas pasan al 100% y cero problemas en `@[current_problems]`).
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
+1
View File
@@ -2,6 +2,7 @@
"python.defaultInterpreterPath": "${workspaceFolder}\\backend\\venv\\Scripts\\python.exe",
"python.analysis.extraPaths": [
"${workspaceFolder}\\backend",
"${workspaceFolder}\\scripts",
"${workspaceFolder}\\backend\\venv\\Lib\\site-packages"
]
}
+2 -1
View File
@@ -65,7 +65,8 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
## Límites
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa (`specs/`) antes de proponer o modificar código.
- **SIEMPRE**: Al finalizar la tarea, realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
- **SIEMPRE (Principio 10 - Tolerancia Cero)**: Repara activamente todos los problemas y errores reportados en la terminal / Language Server (`@[current_problems]`). **Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o problemas en el código.**
- **SIEMPRE**: Al finalizar la tarea (con cero problemas en el código), realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
- **PREGUNTA ANTES DE**: Añadir nuevas dependencias a `requirements.txt` o `package.json`, alterar el esquema relacional de la base de datos o cambiar la estrategia de caché.
- **NUNCA**: Expongas contraseñas, tokens de Moodle, secretos de API o el contenido del archivo `.credenciales` en el código fuente, commits o logs públicos.
+16
View File
@@ -11,6 +11,22 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.5.6] - 2026-10-16
### Added
- **Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)**:
- Incorporada directiva mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y definiciones de agentes en `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
- Prohibición estricta e infranqueable de declarar cualquier tarea o sprint como "terminado" o "completado" si persisten errores en el código o en el analizador de la IDE.
- Pre-verificación de Quality Gate `Paso 0: Verificación de Código Limpio (Zero Errors)` en el skill de despliegue antes de cualquier bump de versión o push.
### Changed & Fixed
- **Robustez en `SystemSetting`**:
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase (`SystemSetting.get_decrypted_value('key')`) o como método de instancia (`setting.get_decrypted_value()`), garantizando el paso del 100% de los tests de integración de la Fase 5.
- **Tipado estricto en `scripts/moodle_replicator.py`**:
- Corregido casteo a `int` en `local_course_id` y `role_id` en las líneas 586 y 607, satisfaciendo la firma de `enrol_user(local_uid: int, local_course_id: int, role_id: int)`.
- **Estabilidad de concurrencia en tests de SQLite**:
- Añadida espera explícita del worker asíncrono en `test_05_api_async_job_submission_and_polling` (`backend/tests/test_sprint4_optimizer_and_concurrency.py`) para evitar bloqueo de tablas en SQLite durante `tearDown`.
- Suite de pruebas de backend con 52 tests pasando al 100% (`52 passed`).
## [3.5.5] - 2026-10-16
### Added
- Mecanismo de autenticación mediante Clave API institucional (`X-API-Key` / `Authorization: ApiKey`) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos.
+13
View File
@@ -257,6 +257,19 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`).
- Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`).
- **Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador**:
- **Principio 10 de la Constitución**:
- Incorporada regla mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
- Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (`@[current_problems]`).
- **Reparación de Tipos en Replicador Moodle**:
- Ajustado casteo a entero `int(course_meta['local_id'])` y `int(u.get('role_id', 5))` en `scripts/moodle_replicator.py`.
- **Robustez Híbrida en `SystemSetting`**:
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
- **Resolución de Condición de Carrera en Tests de SQLite**:
- Añadida espera activa de finalización de workers en `test_05_api_async_job_submission_and_polling` para evitar bloqueos de base de datos en `tearDown()`.
- **Validación Automatizada**:
- 52/52 tests pasando en verde al 100% (`pytest tests -v`).
## Próximos pasos
1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles.
2. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.
+1 -1
View File
@@ -4,7 +4,7 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
**Versión Actual:** `3.5.5` (API Key Institucional Moodle, Purga de Tareas y Hardening)
**Versión Actual:** `3.5.6` (Principio 10 Tolerancia Cero a Errores, Robustez SystemSetting y Replicador)
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
+1 -1
View File
@@ -2,7 +2,7 @@
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
**Versión:** 3.5.5 (API Key Institucional Moodle, Purga de Tareas y Hardening)
**Versión:** 3.5.6 (Principio 10 Tolerancia Cero a Errores, Robustez SystemSetting y Replicador)
**Fecha de Actualización:** 16 de Octubre de 2026
**Rama Base:** `dev`
+1 -1
View File
@@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _
from config.config import Config
# Initialize extensions
__version__ = "3.5.5"
__version__ = "3.5.6"
db = SQLAlchemy()
migrate = Migrate()
cors = CORS()
+39 -4
View File
@@ -2,6 +2,18 @@ from app import db
from datetime import datetime
from app.services.crypto_service import CryptoService
class _hybrid_setting_method:
"""Descriptor que resuelve si se invoca sobre la clase SystemSetting o sobre una instancia."""
def __init__(self, inst_func, cls_func):
self.inst_func = inst_func
self.cls_func = cls_func
def __get__(self, instance, owner):
if instance is None:
return lambda *args, **kwargs: self.cls_func(owner, *args, **kwargs)
return lambda *args, **kwargs: self.inst_func(instance, *args, **kwargs)
class SystemSetting(db.Model):
"""
Parámetros de configuración del sistema persistentes en base de datos.
@@ -32,9 +44,18 @@ class SystemSetting(db.Model):
pass
return default
def _inst_get_decrypted_value(self, default=None):
try:
if self.value is not None and self.value.strip() != '':
if self.is_encrypted:
return CryptoService.decrypt(self.value)
return self.value
except Exception:
pass
return default
@classmethod
def get_decrypted_value(cls, key, default=None):
"""Retorna el valor desencriptado desde la base de datos."""
def _cls_get_decrypted_value(cls, key, default=None):
try:
record = cls.query.filter_by(key=key).first()
if record and record.value is not None and record.value.strip() != '':
@@ -45,9 +66,21 @@ class SystemSetting(db.Model):
pass
return default
get_decrypted_value = _hybrid_setting_method(_inst_get_decrypted_value, _cls_get_decrypted_value)
def _inst_get_masked_value(self, default=''):
try:
if self.value and self.value.strip() != '':
k_lower = (self.key or '').lower()
if self.is_encrypted or any(x in k_lower for x in ('secret', 'password', 'token', 'key')):
return '••••••••••••'
return self.value
except Exception:
pass
return default
@classmethod
def get_masked_value(cls, key, default=''):
"""Retorna una versión enmascarada si es un secreto, token o clave."""
def _cls_get_masked_value(cls, key, default=''):
try:
record = cls.query.filter_by(key=key).first()
if record and record.value and record.value.strip() != '':
@@ -59,6 +92,8 @@ class SystemSetting(db.Model):
pass
return default
get_masked_value = _hybrid_setting_method(_inst_get_masked_value, _cls_get_masked_value)
@classmethod
def set_value(cls, key, value, description=None, category='system', is_encrypted=False):
"""Guarda o actualiza un parámetro de configuración."""
+1 -1
View File
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
"info": {
"title": "Edu-Space REST API",
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
"version": "3.5.5"
"version": "3.5.6"
},
"servers": [
{
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.5.5",
version="3.5.6",
description="Administrative interface for Edu-Space Classroom Management System",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
@@ -278,6 +278,15 @@ class Sprint4OptimizerAndConcurrencyTestCase(unittest.TestCase):
list_data = list_res.get_json()
self.assertGreaterEqual(list_data['total'], 1)
# 4. Esperar a que el job asíncrono termine antes de tearDown para evitar locks en SQLite
waited = 0.0
while waited < 3.0:
j = OptimizerService.get_job(job_id)
if j and j.status in (OptimizerJobStatus.COMPLETED, OptimizerJobStatus.FAILED):
break
time.sleep(0.1)
waited += 0.1
if __name__ == '__main__':
unittest.main()
+5
View File
@@ -45,3 +45,8 @@ La asignación de reservas de aulas debe validar en tiempo real e impedir de for
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`).
- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados.
- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida.
### 10. Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)
- **Prohibición de Cierre con Errores**: Es estrictamente inadmisible declarar una tarea, plan o sprint como "terminado", "completado" o "finalizado" si existen errores en el código, advertencias críticas de tipado, o problemas reportados por el analizador estático / terminal (`@[current_problems]`).
- **Remediación Mandatoria Previa**: Toda tarea se considera incompleta por definición hasta que el agente verifique activamente y repare al 100% todos los errores de sintaxis, imports, resolución de módulos, estrechamiento de tipos (type narrowing) y accesos a `NoneType`.
- **Quality Gate Infranqueable**: Ningún commit, bump de versión o despliegue a producción puede ser ejecutado mientras existan problemas o errores no resueltos en `@[current_problems]`.
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.5.5",
"version": "3.5.6",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.5.5';
const FRONTEND_VERSION = '3.5.5';
const BACKEND_VERSION = '3.5.5';
const APP_VERSION = '3.5.6';
const FRONTEND_VERSION = '3.5.6';
const BACKEND_VERSION = '3.5.6';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
+3 -2
View File
@@ -583,7 +583,7 @@ def run_replication(
'name': f'Curso Prod {cid}',
'local_id': cid
})
local_course_id = course_meta['local_id']
local_course_id = int(course_meta['local_id'])
print("\n" + "-" * 70)
print(f"[*] Procesando: '{course_meta['name']}'")
@@ -604,7 +604,8 @@ def run_replication(
local_uid = loader.get_or_create_user(u)
if local_uid:
total_created += 1
if loader.enrol_user(local_uid, local_course_id, u['role_id']):
role_id = int(u.get('role_id', 5))
if loader.enrol_user(local_uid, local_course_id, role_id):
course_enrolled += 1
total_enrolled += 1