Referencia y Mapa Conceptual OPS

La arquitectura OPS (Open Pedagogy Specification) de ColabEdu trata la educación como código (Pedagogy as Code). Cada componente del ecosistema educativo —desde la ley curricular hasta el enunciado de una pregunta o la pauta de corrección socrática— se define mediante un archivo YAML tipado, inmutable y auditable en Git.

Para facilitar su comprensión pedagógica y técnica, las especificaciones se organizan en cuatro categorías funcionales, diferenciando claramente los esquemas del Estándar Abierto de las Herramientas de Automatización para Partners.

🏛️ Las 4 Categorías Pedagógicas de Specs

flowchart LR
    subgraph Cat1["1. Contenido y Aprendizaje"]
        IL["InteractiveLesson<br/>(Lección Interactiva)"]
        RL["ResourceLearning<br/>(Recurso OER)"]
    end

    subgraph Cat2["2. Evaluación (Assessment)"]
        BR["BlockRubric<br/>(Rúbrica C0)"]
        RC["Recipe<br/>(Orquestador C1)"]
        EX["ExerciseSpec<br/>(Exámenes C2)"]
    end

    subgraph Cat3["3. Currículo y Gestión"]
        CS["CourseSpec<br/>(Curso Soberano)"]
        PT["PathwayTemplate<br/>(Malla Oficial)"]
        TX["Taxonomy<br/>(Normativa/Niveles)"]
        CB["CourseBundle<br/>(Congelamiento)"]
    end

    subgraph Cat4["4. Gobernanza y Roles (C3)"]
        DI["Directive<br/>(Directivas de Aula)"]
        PE["Persona<br/>(Tutor/Evaluador IA)"]
    end

    Cat3 -->|"Estructura"| Cat1
    Cat3 -->|"Pondera"| Cat2
    Cat1 -->|"Ejercita con"| Cat2
    Cat4 -.->|"Condiciona"| Cat2

1. Para Contenido y Aprendizaje (Experiencias de Aula)

Especificaciones orientadas a la interacción directa del estudiante con el material didáctico. No son meros textos estáticos: son unidades interactivas con estados de avance y evaluación formativa embebida.

Tipo (Kind)	Propósito Pedagógico	Diseñado por
InteractiveLesson	Lecciones interactivas multimedia. Organizadas en slides con soporte Markdown, fórmulas matemáticas, bifurcaciones adaptativas (routing) y widgets interactivos (`quiz_widget`, `mermaid_viewer`, `scratchpad_widget`).	Creadores de contenido / Importadores LMS
ResourceLearning	Punteros curados a Recursos Educativos Abiertos (OER) (vídeos, simulaciones PhET, lecturas abiertas) anotados con un índice de calidad pedagógica tridimensional (alignment, pedagogicalRichness, accessibility).	Bibliotecarios curriculares / Docentes

2. Para Evaluación (Assessment y Calificación)

Especificaciones que garantizan una evaluación rigurosa, reproducible y alineada con la ley o con exámenes oficiales (EBAU, AP, IB).

Tipo (Kind)	Propósito Pedagógico	Diseñado por
BlockRubric	La fuente de verdad normativa (Capa C0). Define criterios analíticos oficiales, descriptores cualitativos por banda de logro y escalas de puntuación.	Ministerios, Agencias de Calidad, Comités de Examen
Recipe	El orquestador pedagógico (Capa C1). Vincula qué competencias evaluar, qué rúbrica aplicar, qué formato de informe emitir y qué directivas de retroalimentación debe seguir el evaluador.	Diseñadores Instruccionales / Jefes de Departamento
ExerciseSpec	Instrumento de evaluación concreto (Capa C2). Contiene el estímulo (texto, audio, gráfico) y las preguntas asociadas listas para que el alumno responda.	Docentes / Autores de Contenido
AssessmentItem	Componente atómico de evaluación interactiva. Reactivo aislado empaquetado para su resolución y corrección inmediata en el frontend.	Diseñadores de ítems
ExerciseType	Catálogo de interacciones agnósticas. Define la mecánica de interacción: texto libre, test de opciones múltiples, emparejamiento, ordenación, pizarra, etc.	Ingenieros pedagógicos

3. Para Currículo, Taxonomías y Gestión Académica

Especificaciones que resuelven la arquitectura del plan de estudios, la soberanía territorial y la gestión del ciclo lectivo.

Tipo (Kind)	Propósito Pedagógico	Diseñado por
CourseSpec	Unidad soberana de curso. Adapta un estándar oficial a un centro educativo concreto, configurando la modalidad de impartición (`FULL_YEAR`, `INTENSIVE`, `EXAM_MASTERY`, `REMEDIATION`) y librerías de errores comunes (misconceptions).	Centros Educativos / Coordinadores
PathwayTemplate	Malla curricular oficial. Estructura un curso en temas, horas estimadas y ponderaciones oficiales de examen (ej. Paper 1: 25%, Paper 2: 50%).	Organizaciones oficiales (IB, College Board, CCAA)
StandardSpec	Configuración marco del estándar educativo. Agrupa las directrices globales y bibliotecas de dificultades diagnósticas del estándar.	Administraciones Educativas
Taxonomy & TaxonomyIndex	Jerarquías de localización y niveles. Codifica países, regiones (CCAA, distritos), etapas educativas y competencias clave como código GitOps.	Equipos de Gobernanza
SubjectArea	Área de conocimiento unificada. Clasificación y normalización transversal de asignaturas (Matemáticas, Lengua, Idiomas).	Administradores de Catálogo
CourseBundle	Artefacto de congelamiento inmutable. Agrupa cursos y unidades para generar snapshots escolares inmutables por año lectivo, exportación a LMS o distribución.	Dirección Académica / Administradores

4. Para Gobernanza y Roles en el Aula (Capa C3)

Especificaciones que establecen el marco ético, didáctico y actitudinal dentro del entorno digital de aprendizaje.

Tipo (Kind)	Propósito Pedagógico	Diseñado por
Directive	Directivas didácticas de aula. Reglas docentes para el motor (por ejemplo: “No dar la respuesta directa al alumno”, “Formular repreguntas socráticas en español peninsular”).	Docente del aula
Persona	Perfil y tono pedagógico. Configura la personalidad del asistente (ej. Tutor Socrático Empático, Examinador Formal EBAU).	Equipos de Orientación / Docentes

5. Herramientas para Partners (Content Factory y Automatización)

CuratorPlan: Registro de campañas de ingesta persistente gestionadas por el Agente Curador.
CuratorBatch: Ficheros declarativos de pipeline por fases (discover $\to$ parse $\to$ approval $\to$ ingest).
CurriculumRequirements: Reglas para el CurriculumGapAnalyzer sobre el número de ejercicios y rúbricas requeridas para completar un temario.
Gem: Módulos de inteligencia artificial configurables para tareas de curación especializada.

Estructura Universal del Archivo YAML (`colabedu/v1`)

Cualquier especificación OPS —sea una rúbrica, una lección interactiva o una taxonomía nacional— sigue el sobre universal (Universal Envelope) normalizado:

# --- CABECERA CANÓNICA UNIVERSAL ---
api_version: "colabedu/v1"         # Versión formal del esquema
kind: "BLOCK_RUBRIC"               # Tipo de recurso según SpecType
metadata:
  reference_code: "es.madrid.c0.lengua.ebau.texto_argumentativo.v1"
  title: "Rúbrica EBAU Madrid — Comentario de Texto Argumentativo"
  version: "1.0.0"                 # Versionado semántico
  authority: "NATIONAL"            # GLOBAL | NATIONAL | DISTRICT | SCHOOL | TEACHER
  tags: ["lomloe", "ebau", "madrid", "lengua", "bachillerato"]

# --- CUERPO POLIMÓRFICO ---
spec:
  # Los campos internos dependen estrictamente del 'kind' especificado

Compatibilidad: El motor SpecManager acepta tanto la nomenclatura estricta (kind: BLOCK_RUBRIC, api_version: "colabedu/v1") como los alias históricos (kind: Rubric, apiVersion: colabedu.ai/v1beta1) garantizando la retrocompatibilidad con repositorios existentes.