feat(rules): incorporar Principio 10 de tolerancia cero a errores de codigo y robustecer tests v3.5.6
This commit is contained in:
@@ -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"`)
|
||||
|
||||
@@ -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`.
|
||||
|
||||
@@ -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).
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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).
|
||||
|
||||
Vendored
+1
@@ -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"
|
||||
]
|
||||
}
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
@@ -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
@@ -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`
|
||||
|
||||
|
||||
@@ -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()
|
||||
|
||||
@@ -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."""
|
||||
|
||||
@@ -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
@@ -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()
|
||||
|
||||
@@ -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,6 +1,6 @@
|
||||
{
|
||||
"name": "frontend",
|
||||
"version": "3.5.5",
|
||||
"version": "3.5.6",
|
||||
"description": "",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
|
||||
+3
-3
@@ -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);
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user