ARQUITECTURA APROBADA · VERSIÓN 1.0

Modelo central de la Plataforma de Gestión de la Calidad Educativa

Conectar personas, instituciones, estándares, evaluaciones, evidencias y mejora continua mediante datos trazables y separados por institución.

19Entidades

24Relaciones

9Roles

7Ciclos de estado

10Reglas de integridad

COLUMNA VERTEBRAL

Cómo viaja la información

La institución da contexto; el estándar establece qué evaluar; la evidencia sustenta el resultado y la mejora cierra el ciclo.

1Institución
2Evaluación
3Evaluación de requisito
4Evidencia
5Hallazgo
6Acción de mejora
7Indicador
8Reporte

ENTIDADES

Qué información tendrá identidad propia

Cada tarjeta indica su responsabilidad, ámbito y campos esenciales. Los campos restringidos nunca deben aparecer en consultas públicas.

Identidad y acceso

InstituciónRaíz institucional+

Organización educativa propietaria de sus procesos y datos.

iduuidinternal

legalNamestringinternal

displayNamestringinternal

countryCodeiso-countryinternal

statusenum:active|suspended|archivedinternal

createdAtdatetimeinternal

updatedAtdatetimeinternal

UsuarioToda la plataforma+

Identidad de una persona que puede participar en una o más instituciones.

iduuidinternal

emailemailrestricted

displayNamestringconfidential

statusenum:active|blocked|deletedinternal

lastAccessAtdatetime|nullconfidential

createdAtdatetimeinternal

MembresíaPor institución+

Une una identidad con una institución y determina su rol y alcance.

iduuidinternal

institutionIduuidinternal

userIduuidinternal

roleIdrole-idinternal

statuslifecycle:membershipinternal

invitedAtdatetimeinternal

acceptedAtdatetime|nullinternal

Estructura de calidad

Marco o estándarCatálogo global+

Norma, modelo de acreditación o marco institucional que organiza requisitos.

iduuidinternal

codestringpublic

namestringpublic

versionstringpublic

statusenum:draft|published|retiredpublic

RequisitoCatálogo global+

Unidad evaluable perteneciente a un marco o estándar.

iduuidinternal

frameworkIduuidinternal

parentIduuid|nullinternal

codestringpublic

titlestringpublic

descriptiontextpublic

weightdecimal|nullinternal

ProcesoPor institución+

Proceso institucional sujeto a gestión, evaluación e indicadores.

iduuidinternal

institutionIduuidinternal

ownerMembershipIduuid|nullconfidential

codestringinternal

namestringinternal

statusenum:active|inactive|archivedinternal

Evaluación y evidencia

EvaluaciónPor institución+

Ejercicio de diagnóstico, autoevaluación, auditoría o revisión aplicado a un marco.

iduuidinternal

institutionIduuidinternal

frameworkIduuidinternal

namestringconfidential

typeenum:self_assessment|audit|diagnostic|reviewinternal

statuslifecycle:assessmentinternal

startsAtdateinternal

closesAtdate|nullinternal

Evaluación de requisitoPor institución+

Resultado trazable de evaluar un requisito dentro de una evaluación.

iduuidinternal

institutionIduuidinternal

assessmentIduuidinternal

requirementIduuidinternal

processIduuid|nullinternal

evaluatorMembershipIduuid|nullconfidential

statuslifecycle:evaluationinternal

ratingdecimal|nullconfidential

conclusiontext|nullconfidential

EvidenciaPor institución+

Documento, enlace o registro que demuestra cumplimiento o una actuación.

iduuidinternal

institutionIduuidinternal

evaluationIduuid|nullinternal

actionIduuid|nullinternal

submittedByMembershipIduuidconfidential

titlestringconfidential

storageKeystringrestricted

checksumsha256internal

statuslifecycle:evidenceinternal

validUntildate|nullconfidential

HallazgoPor institución+

Brecha, conformidad, riesgo u oportunidad identificada durante una evaluación.

iduuidinternal

institutionIduuidinternal

evaluationIduuidinternal

typeenum:conformity|nonconformity|risk|opportunity|observationconfidential

severityenum:low|medium|high|criticalconfidential

descriptiontextconfidential

statuslifecycle:findinginternal

Mejora

Acción de mejoraPor institución+

Compromiso con responsable, plazo y verificación para tratar un hallazgo o mejorar un proceso.

iduuidinternal

institutionIduuidinternal

findingIduuid|nullinternal

processIduuid|nullinternal

ownerMembershipIduuidconfidential

titlestringconfidential

descriptiontextconfidential

dueAtdateconfidential

statuslifecycle:improvement_actioninternal

effectivenessResulttext|nullconfidential

Medición

IndicadorPor institución+

Definición de una medida asociada a un proceso, requisito o acción.

iduuidinternal

institutionIduuidinternal

processIduuid|nullinternal

namestringconfidential

unitstringinternal

targetdecimalconfidential

frequencyenum:monthly|quarterly|semiannual|annual|custominternal

MediciónPor institución+

Valor observado de un indicador en un periodo y su fuente verificable.

iduuidinternal

institutionIduuidinternal

indicatorIduuidinternal

valuedecimalconfidential

periodStartsAtdateinternal

periodEndsAtdateinternal

recordedByMembershipIduuidconfidential

sourceEvidenceIduuid|nullrestricted

Formación y certificados

CursoCatálogo global+

Oferta formativa relacionada con capacidades de calidad educativa.

iduuidinternal

codestringpublic

namestringpublic

statusenum:draft|published|retiredpublic

Participación formativaInstitución opcional+

Relaciona una persona con un curso y conserva su resultado.

iduuidinternal

institutionIduuid|nullinternal

userIduuidrestricted

courseIduuidinternal

statusenum:enrolled|in_progress|completed|withdrawnconfidential

completedAtdatetime|nullconfidential

CertificadoToda la plataforma+

Credencial verificable emitida por un logro formativo.

iduuidinternal

enrollmentIduuid|nullinternal

verificationCodestringpublic

recipientNamestringpublic-on-lookup

courseNamestringpublic-on-lookup

issuedAtdate|nullpublic-on-lookup

statuslifecycle:certificatepublic-on-lookup

statusReasontext|nullrestricted

Reportes e IA

ReportePor institución+

Vista congelada y reproducible de resultados autorizados.

iduuidinternal

institutionIduuidinternal

typeenum:assessment|improvement|indicator|executiveinternal

parametersjsonconfidential

generatedByMembershipIduuidconfidential

generatedAtdatetimeinternal

storageKeystring|nullrestricted

Asistencia de IAPor institución+

Registra una solicitud autorizada a IA, sus fuentes, resultado y revisión humana.

iduuidinternal

institutionIduuidinternal

requestedByMembershipIduuidconfidential

purposestringconfidential

sourceReferencesjsonrestricted

providerstringinternal

modelstringinternal

outputtextrestricted

reviewStatusenum:pending|accepted|rejectedconfidential

createdAtdatetimeinternal

Trazabilidad

Evento de auditoríaInstitución opcional+

Registro inmutable de actuaciones relevantes y cambios de estado.

iduuidinternal

institutionIduuid|nullinternal

actorUserIduuid|nullrestricted

actionstringinternal

entityTypeentity-idinternal

entityIduuidinternal

changesjsonrestricted

occurredAtdatetimeinternal

MULTIINSTITUCIÓN

Separación obligatoria de datos

ENTIDAD RAÍZInstitucióninstitutionId

Todo registro institucional debe contener institutionId y se consulta siempre dentro de esa institución.
Un usuario accede a una institución únicamente mediante una membresía activa.
Las relaciones entre registros de instituciones diferentes están prohibidas.
Los marcos y requisitos globales son de solo lectura para las instituciones; cada institución configura su aplicación sin alterar el original.
Los eventos de auditoría son inmutables y conservan actor, fecha, acción y contexto institucional.

IDENTIFICACIÓN

Decisiones transversales

internal: UUID v4 no secuencial
public: Código específico del dominio cuando sea necesario
timestamps: ISO 8601 en UTC
deletion: Borrado lógico por defecto; eliminación física únicamente bajo una política documentada

RELACIONES

Quién depende de quién

Cada relación define cardinalidad y qué ocurre si se intenta retirar su origen.

InstituciónhasMembresíaone-to-many · al eliminar: restrict

Usuarioparticipates-throughMembresíaone-to-many · al eliminar: restrict

Marco o estándarcontainsRequisitoone-to-many · al eliminar: restrict

Requisitoparent-ofRequisitoone-to-many · al eliminar: restrict

InstituciónownsProcesoone-to-many · al eliminar: archive

InstituciónperformsEvaluaciónone-to-many · al eliminar: archive

Marco o estándarapplies-toEvaluaciónone-to-many · al eliminar: restrict

EvaluacióncontainsEvaluación de requisitoone-to-many · al eliminar: cascade-draft-only

Requisitois-evaluated-byEvaluación de requisitoone-to-many · al eliminar: restrict

Procesois-assessed-inEvaluación de requisitoone-to-many · al eliminar: restrict

Evaluación de requisitois-supported-byEvidenciaone-to-many · al eliminar: archive

Evaluación de requisitoproducesHallazgoone-to-many · al eliminar: restrict

Hallazgois-treated-byAcción de mejoraone-to-many · al eliminar: restrict

ProcesoownsAcción de mejoraone-to-many · al eliminar: restrict

Acción de mejorais-verified-byEvidenciaone-to-many · al eliminar: archive

Procesois-measured-byIndicadorone-to-many · al eliminar: archive

IndicadorrecordsMediciónone-to-many · al eliminar: restrict

CursohasParticipación formativaone-to-many · al eliminar: restrict

UsuarioundertakesParticipación formativaone-to-many · al eliminar: restrict

Participación formativamay-produceCertificadoone-to-zero-or-one · al eliminar: restrict

InstitucióngeneratesReporteone-to-many · al eliminar: archive

InstituciónauthorizesAsistencia de IAone-to-many · al eliminar: archive

Usuarioacts-inEvento de auditoríaone-to-many · al eliminar: anonymize-actor

InstituciónretainsEvento de auditoríaone-to-many · al eliminar: retain-policy

ROLES

Acceso según responsabilidad

Un usuario no recibe acceso directo a todos los datos: participa mediante una membresía y un alcance.

platform

Administrador de plataforma

Configura el servicio y los catálogos globales sin asumir decisiones institucionales.

institution

Administrador institucional

Gestiona la institución, integrantes, roles y configuración.

institution

Responsable de calidad

Coordina estándares, evaluaciones, hallazgos, planes e indicadores.

process

Responsable de proceso

Gestiona evidencias, acciones e indicadores de los procesos asignados.

assessment

Evaluador

Evalúa requisitos, valida evidencias y registra hallazgos.

institution

Colaborador

Aporta evidencias y ejecuta acciones asignadas.

assessment

Auditor o veedor

Consulta información autorizada sin modificarla.

learning

Participante

Accede a formación y certificados propios.

institution

Consulta

Visualiza reportes expresamente compartidos.

CICLOS DE ESTADO

Los registros cambian sin perder su historia

Membresía

invited→active→suspended→revoked

Evaluación

draft→in_progress→in_review→closed→cancelled

Evaluación de requisito

not_started→in_progress→submitted→validated→returned

Evidencia

draft→submitted→accepted→rejected→archived

Hallazgo

open→accepted→disputed→closed

Acción de mejora

planned→in_progress→blocked→completed→verified→cancelled

Certificado

active→revoked→annulled

INTEGRIDAD

Reglas que la aplicación deberá hacer cumplir

tenant-isolation
Toda relación entre entidades tenant debe compartir institutionId.
membership-authorization
Toda escritura institucional exige una membresía activa y un permiso suficiente.
evidence-parent
Una evidencia debe vincularse al menos con una evaluación de requisito o una acción de mejora.
finding-origin
Un hallazgo siempre pertenece a una evaluación de requisito.
action-accountability
Una acción requiere responsable, fecha límite y estado.
verified-action
Una acción solo llega a verified cuando existe resultado de eficacia y evidencia aceptada.
measurement-period
El final del periodo de medición no puede ser anterior a su inicio.
certificate-public-privacy
La verificación pública nunca expone el motivo privado de revocación o anulación.
ai-traceability
Toda asistencia de IA conserva propósito, fuentes autorizadas, proveedor, modelo y revisión humana.
audit-immutability
Un evento de auditoría no se edita ni se elimina mediante operaciones ordinarias.

IMPLEMENTACIÓN

Orden de construcción

El modelo reduce el riesgo dividiendo la plataforma en entregas verificables.

1
Identidad institucional
Institución · Usuario · Membresía · Evento de auditoría
2
Evaluación y evidencia
Marco o estándar · Requisito · Proceso · Evaluación · Evaluación de requisito · Evidencia · Hallazgo
3
Mejora y medición
Acción de mejora · Indicador · Medición · Reporte
4
Integración formativa
Curso · Participación formativa · Certificado
5
IA asistiva
Asistencia de IA

Modelo central de la Plataforma de Gestión de la Calidad Educativa

Cómo viaja la información

Qué información tendrá identidad propia

Identidad y acceso

Estructura de calidad

Evaluación y evidencia

Mejora

Medición

Formación y certificados

Reportes e IA

Trazabilidad

Separación obligatoria de datos

Decisiones transversales

Quién depende de quién

Acceso según responsabilidad

Administrador de plataforma

Administrador institucional

Responsable de calidad

Responsable de proceso

Evaluador

Colaborador

Auditor o veedor

Participante

Consulta

Los registros cambian sin perder su historia

Reglas que la aplicación deberá hacer cumplir

Orden de construcción

Identidad institucional

Evaluación y evidencia

Mejora y medición

Integración formativa

IA asistiva