Control de calidad

El control de calidad es el sistema interno con el que el equipo de Lumbre detecta, encarga, sigue y blinda el contenido que necesita atención. Es transversal: funciona igual sobre cualquier ficha administrable — objetos de aprendizaje, cursos, categorías, rutas, juegos, laboratorios, shows, aplicaciones, tours, lecturas y materiales. Y es solo de personal: el público nunca lo ve.

Dos estados independientes (no los mezcles con publicar)

El sistema lleva dos ejes separados, y confundarlos es el error más común:

• Estado del objeto (la etiqueta de calidad): borrador, revisar, auditar, correcto o no_tocar. Si un contenido nunca pasó por el sistema, es borrador.
• Estado de la tarea (cada observación): pendiente, en_proceso, resuelta, rechazada o requiere_humano.

Ninguno de los dos es el estado de publicación (DRAFT/PUBLISHED) ni la visibilidad: un objeto puede estar publicado y en revisar, o en correcto y seguir siendo privado. La calidad y la publicación son casillas distintas.

La barra de Calidad

En la parte superior de cada ficha administrable, el personal ve una barra pegajosa «Calidad» con:

• El tipo y título de la entidad y un desplegable para cambiar su estado de calidad en un clic.
• El botón + Observación: redactas la instrucción («el video del bloque 3 está roto, sustituirlo por…»), eliges tipo de incidencia (contenido, ortografía, imagen, video, diseño, pedagogía, cumplimiento curricular, enlace roto, funcionalidad, rendimiento, SEO u otro) y prioridad (baja, normal, alta, crítica).
• Un contador ⚠ pendientes que abre el historial completo de observaciones de ese contenido. En auditar aparecen además dos botones rápidos: ✓ Aprobar (→ correcto) y ↻ Solicitar otra corrección (vuelve a revisar).

El ciclo típico de una corrección

1. Detectas el problema y escribes una observación desde la barra: el objeto pasa solo a revisar.
2. Alguien toma la tarea: un humano la corrige directamente, o un agente de IA la reclama desde la cola MCP (ver abajo).
3. Al resolver la observación con su resumen, la tarea queda resuelta. Si ya no quedan tareas activas en ese objeto, pasa automáticamente a auditar; si quedan otras pendientes, sigue en revisar.
4. Un administrador revisa y decide: aprueba (correcto) o pide otra corrección (reabre y vuelve a revisar).
5. Si fue una IA quien reparó, el administrador recibe un correo con la observación original y el resumen de lo hecho.

NO TOCAR: el bloqueo absoluto

no_tocar es la protección más fuerte del sistema. Mientras un contenido está protegido:

• Ninguna automatización puede modificarlo: las herramientas de escritura de la API y del MCP (crear, actualizar, parchear) responden OBJECT_PROTECTED y no crean ni una versión nueva.
• Ningún agente puede reclamar ni cerrar trabajo sobre él; la protección gana incluso al auto-cambio de estado al resolver.
• Solo un administrador humano lo pone y lo quita, desde la barra. Crear una observación sobre un objeto protegido exige una confirmación explícita que levanta la protección; un agente, jamás.

Úsalo en exámenes en curso, materiales que un tercero está corrigiendo, o contenido bajo disputa: es la forma de decir «quieto, esto lo llevo yo».

La cola de calidad

En /admin/calidad tienes la cola completa: los conteos por estado y las observaciones ordenadas por prioridad (crítica primero) y antigüedad, con filtros por estado del objeto, estado de la tarea, tipo de contenido, tipo de incidencia y prioridad. Cada fila enlaza a la ficha exacta de su contenido.

Los agentes IA también trabajan aquí

La cola es el listado de trabajo de los agentes con clave de personal (ámbitos quality:read y quality:write): listan observaciones, reclaman una de forma atómica con un lease de dos horas, corrigen con las herramientas de escritura habituales y reportan la resolución — o piden un humano si no pueden. Todo el protocolo está explicado para agentes en Lumbre para IA.

Regla de oro del flujo: el agente nunca publica ni aprueba su propio trabajo. Al resolver, el objeto pasa a auditar: la última palabra siempre es humana.

Todo deja rastro

Cada cambio de estado, reclamación, resolución o reapertura queda registrado en un historial append-only: quién pidió, quién procesó (con la etiqueta del agente), cuándo, y el estado antes/después. Las observaciones resueltas nunca se borran: son el expediente del contenido. Puedes reabrir una cerrada si detectas que sigue mal; la reapertura también queda anotada.

Cómo seguir

La protección NO TOCAR afecta a quien edita por API o MCP: mira la ayuda para creadores. El panel completo de administración está en la ayuda para administradores.