Generador de evaluaciones

Un editor de pruebas donde lo que se ve en pantalla es la hoja impresa, las preguntas y alternativas se reordenan arrastrándolas, cada pregunta queda categorizada por objetivo de aprendizaje e indicador, y hay herramientas de IA que consumen una bolsa de tokens del establecimiento.

1El problema

Crear una prueba en WebClass hoy pasa por el módulo que vive en el repo vanilla (sistema/webclass/home/preguntas, home/pruebas, home/evaluacionesbanco, home/importarpreguntas). Tiene lo esencial y lleva años funcionando, pero arrastra cuatro problemas concretos:

• El profesor no ve cómo va a quedar la prueba hasta que la descarga. Edita en formularios y recién al imprimir descubre que una pregunta quedó cortada entre dos páginas, o que la hoja se fue a tres páginas.
• Reordenar es caro. Cambiar una pregunta de lugar o mover una alternativa obliga a editar campos de orden, no a arrastrar.
• La categorización existe en la base pero está escondida. Ya hay tablas de objetivos, habilidades e indicadores por pregunta (ver §3), y aun así la tabla de especificaciones se arma a mano en una planilla aparte. Y la pantalla deja declarar un solo objetivo por pregunta cuando las tablas admiten varios: las preguntas que integran dos contenidos —las mejores— quedan declaradas a medias. Ver §6.5.b.
• No hay asistencia de IA en ninguna parte del flujo.
• La prueba se arma sin mirar cómo le fue al curso. WebClass sabe el logro de cada objetivo —lo calcula el informe de aprendizaje—, pero eso vive en otra sección, a cuatro clics de donde se crea la evaluación. Se termina decidiendo qué evaluar de memoria, teniendo el dato. funcionalidad nueva
• No se reusa nada. Un profesor escribe unas 40 preguntas al año y al año siguiente las vuelve a escribir. Hoy el camino más rápido para armar una prueba es digitalizar el PDF del año pasado, teniendo esas preguntas en la base. Ver §6.9.b.
• Las preguntas de desarrollo no tienen pauta. Son las únicas que no se corrigen solas, y hoy la pauta de corrección no dice nada de ellas: «6 puntos de desarrollo» los reparte cada profesor a ojo, y con dos cursos paralelos eso es una diferencia de nota que después nadie puede explicar. funcionalidad nueva

2Quién lo usa

3Lo que ya existe en la base — reusar, no recrear

Relevado el 2026-09-11 leyendo los DAO del repo vanilla y los modelos Eloquent de wc-laravel/app/. La estructura para casi todo lo que pide este gadget ya está.

4Dónde vive en wc-laravel

El producto no tiene un layout común: cada módulo trae el suyo. Este gadget necesita ser un módulo propio.

resources/views/evaluaciones/
├── layouts/header.blade.php      layout propio del modulo
├── crear.blade.php               pantalla 1
└── editor.blade.php              pantalla 2

resources/js/evaluaciones/evaluaciones.js    entrada Vue 2
resources/sass/evaluaciones.scss

app/Http/Controllers/Evaluaciones/
├── EvaluacionController.php      CRUD de la prueba
├── PreguntaController.php        alta/edicion/orden de preguntas
├── CategorizacionController.php  OA, indicador, atributos
└── AsistenteIaController.php     herramientas de IA + tokens

Una línea más en webpack.mix.js

.js('resources/js/evaluaciones/evaluaciones.js', 'public/js')

Rutas (routes/web.php)

Route::group(['prefix' => 'evaluaciones', 'namespace' => 'Evaluaciones'], function () {
    Route::get('/crear',            'EvaluacionController@crear');
    Route::post('/',                'EvaluacionController@store');
    Route::get('/{prueba}/editor',  'EvaluacionController@editor');
    Route::post('/{prueba}/orden',  'PreguntaController@reordenar');
    Route::post('/{prueba}/guardar', 'EvaluacionController@guardar');
    Route::post('/ia/{herramienta}','AsistenteIaController@ejecutar');
});

5Pantalla 1 — Crear el recurso

Arriba, el título de la herramienta —«Generador de evaluaciones»— y debajo el nombre del recurso con su etiqueta «Nombre:». Los dos juntos y en ese orden: sin el título no se sabe en qué herramienta se está, y sin la etiqueta el nombre del recurso se lee como el título de la pantalla y nadie descubre que es editable.

Después, tres selectores y cuatro caminos de creación. Nivel y asignatura son obligatorios: definen qué catálogo de objetivos de aprendizaje se ofrece después, así que no se puede entrar al editor sin ellos.

Se puede entregar por etapas. «Desde cero» y «desde el banco» son el mínimo para reemplazar lo que hay hoy. El PDF y la tabla de especificaciones pueden ir en una segunda entrega sin bloquear nada.

5.1 Importar la tabla de especificaciones

La tabla ya existe en el colegio, en una planilla de UTP. Obligar a reescribirla campo por campo dentro de WebClass es la forma más segura de que nadie use esta función. Se aceptan dos entradas:

• Pegar las celdas copiadas de Excel o Google Sheets.
• Subir el archivo (.xlsx, .xls, .csv).

Después de leerla se muestra una vista previa con las columnas identificadas — objetivo, indicador, nº de preguntas, puntaje, habilidad, dificultad, eje — y el docente corrige la que esté mal antes de continuar. Con eso se crean las preguntas vacías, cada una ya asignada a su OA e indicador, repartiendo el puntaje de la fila entre sus preguntas.

5.2 La tabla: qué se mide y cuántas preguntas de cada cosa funcionalidad nueva

Dos de los cuatro caminos —«a partir de tabla de especificaciones» y «a partir de la situación del curso»— abren la misma pantalla, en pantalla propia. Es una tabla con una fila por objetivo (o por habilidad) del nivel, y en cada fila se decide cuántas preguntas y de dónde salen. La diferencia entre los dos caminos son dos columnas: el de curso trae el logro, el otro no.

Objetivos o habilidades — dos pestañas sobre la misma tabla

El currículo se mira de dos maneras y las dos están en la base, en pregunta_atributo: qué contenido mide una pregunta y qué habilidad exige. Hay departamentos que arman la prueba por objetivo y otros que la arman por habilidad —«necesito tres de analizar»—, y las dos formas son legítimas.

• La pestaña cambia qué lista se ve, no la prueba: se puede pedir 2 preguntas de un objetivo y 3 de una habilidad, y las dos cosas valen a la vez.
• Y de más de un nivel. En el camino de la tabla, el nivel y la asignatura del catálogo se eligen ahí mismo y cambiarlos no borra lo ya pedido: se acumula. Un recuperativo mide objetivos del año anterior junto con los del año en curso, y la prueba tiene que poder decirlo. Cada pregunta sale del banco de su propio nivel y entra marcada como ajena si se aparta del de la evaluación.
• Cambiar de pestaña no borra lo pedido en la otra, y el rótulo de cada una lleva la cuenta: sin eso, lo decidido en la pestaña que no se está mirando es invisible y se vuelve a pedir.
• «Proponer» rehace sólo la pestaña y el nivel que se están mirando. Vaciar todo borraría en silencio trabajo del profesor, que es lo que un botón que dice «proponer» no puede hacer.
• Sobre la tabla va un resumen de todo lo pedido —de las dos pestañas y de todos los niveles—, con lo de otro nivel marcado. Sin eso, la tabla en pantalla muestra una fracción de lo decidido y el resto es invisible: se vuelve a pedir.

Arriba de todo, una fila comodín: «Cualquiera del nivel» funcionalidad nueva

No todo profesor arma la prueba objetivo por objetivo. Hay quien quiere diez preguntas de 2° Medio · Matemática y revisarlas después, y sin esta fila ese camino obligaba a repartir a mano entre catorce objetivos para pedir algo que da lo mismo de cuál salga. Era el atajo que tenía la tarjeta del plan de IA antes de fusionarla con esta pantalla, y se repone acá.

• No significa «sin objetivo»: significa «elígelo tú». Lo que llega del banco viene con el suyo. Lo que genera la IA sale repartido por el catálogo del nivel —un objetivo distinto por pregunta, con su indicador— y llega categorizado, con el enunciado diciendo que el objetivo lo eligió la plataforma para que el profesor lo revise. Una pregunta sin categorizar dejaría la prueba fuera del banco y fuera de la tabla de especificaciones, que es justo lo que esta pantalla existe para llenar.
• El banco que ofrece es el del nivel entero, no el de un objetivo: por eso el número de esa fila es mucho más grande que el de las de abajo.
• No entra en las cuentas del currículo. No se cuenta entre los objetivos del nivel, no tiene logro que mostrar —en el camino del curso sus tres columnas dicen «no aplica»— y «Proponer» no la toca: proponer reparte por el currículo, que es lo contrario de lo que la fila significa.
• Sólo en la pestaña de Objetivos. En Habilidades no aparece: ahí cada pregunta generada ya trae la suya, y «cualquier habilidad» no le ahorra nada a nadie.
• Lleva clave como cualquier otra fila —con su nivel y su asignatura— con el código reservado *, así que se acumula al cambiar de nivel igual que las demás y aparece en el resumen de lo pedido.

Abajo, los objetivos propios del colegio funcionalidad nueva

Un colegio mide cosas que el catálogo del Mineduc no trae: un sello del proyecto educativo, una habilidad que el departamento decidió seguir. WebClass ya lo permite —es pregunta_atributo_adicional, ver §6.5.c— y el producto calcula su logro igual que el de un objetivo del catálogo. Si la tabla no los mostrara, armar la prueba desde acá sería un retroceso frente a lo que el profesor ya puede hacer.

• Van después del currículo y fuera de su orden. Con curso, el orden de la tabla es la recomendación, y esa recomendación es sobre el catálogo: un objetivo que el colegio se puso a sí mismo no compite con los del Mineduc por el primer lugar.
• Traen su logro en el camino del curso, como cualquier fila, y su banco: la cuenta de preguntas que ya lo declaran.
• No entran en las cuentas del currículo —«3 de 6 objetivos del nivel nunca evaluados» habla del catálogo— y «Proponer» no los toca: cuánto pesan en la prueba lo decide el profesor.
• Salen de lo que el colegio ya escribió en otras preguntas. Debajo de la tabla hay un campo para agregar uno nuevo, que queda pedido con una pregunta. Si se escribe uno casi igual a uno existente —otra mayúscula, sin tilde, con punto final— se usa el existente y se dice: el informe agrupa por el texto exacto y los contaría como dos.
• En la pestaña de Habilidades aparecen las habilidades propias (tipo = 4); en la de Objetivos, los objetivos (tipo = 3).
• Lo que genera la IA para una fila propia llega con ese objetivo propio, y cuenta como categorizado. Lo que llega del banco trae los suyos, además de su OA.

De dónde sale cada pregunta: banco o IA, por fila

• El selector dice cuántas preguntas tiene el banco de esa fila —«Banco 5»— y queda deshabilitado cuando tiene cero. Ese número es el dato con el que se elige.
• Si se piden más de las que el banco tiene, se dice en la misma fila y las que faltan las genera la IA. No se puede fallar en silencio ni repetir el mismo item para llegar al número.
• Las del banco no cuestan tokens y entran listas; las de IA cuestan y entran como borrador. Una pregunta que ya rindieron treinta cursos y una que acaba de escribir un modelo no merecen la misma confianza.

De qué tipos

• Un campo por tipo —selección múltiple, varias correctas, V/F, respuesta corta, desarrollo, términos pareados—. Sin esto salen todas de alternativas, que es lo que produce cualquier generador cuando no se le pregunta.
• El reparto manda sólo sobre lo que genera la IA. Una pregunta traída del banco llega con el tipo que ya tiene, y reescribirlo sería inventar. Por eso la cuenta que tiene que calzar es la de IA, no el total.
• Mientras no calcen se dice cuánto falta y Crear queda deshabilitado; hay un «Repartir automáticamente». Y el reparto se rehace solo cada vez que cambian las cantidades: si no, tocar una fila dejaría la pantalla bloqueada por una cuenta que el profesor no rompió.
• Las preguntas salen intercaladas, no en bloque por tipo.
• Crear imágenes para las generadas: una figura por pregunta, con el generador de §7.b y su mismo precio. El costo se recalcula al marcarlo.

5.3 Lo que agrega el camino curso/alumno: el logro funcionalidad nueva

Los otros caminos parten de lo que el profesor quiere evaluar. Este parte de lo que el curso necesita que le evalúen, que no es lo mismo y casi nunca se mira. Y no se mira por una razón concreta: el dato ya existe en WebClass —lo calcula el informe de aprendizaje—, pero vive en otra sección, a cuatro clics del lugar donde se arma la prueba. Un dato que hay que ir a buscar a otra pantalla es un dato que no se usa.

Se elige un curso y la tabla gana tres columnas: ya evaluado, logro y estado, calculados sobre todas las evaluaciones ya rendidas. Vale para las dos pestañas: un curso puede tener los objetivos al día y estar al debe en «analizar», y eso es lo que la prueba siguiente tendría que ejercitar.

Sólo se ofrecen los cursos del nivel elegido arriba. Mostrar los de otros niveles contradecía el paso anterior —el profesor ya dijo qué nivel iba a evaluar— y cambiaba el catálogo entero por accidente.

Los alumnos del PIE se avisan acá, no después de imprimir funcionalidad nueva

Elegido el curso, la pantalla dice cuántos de sus alumnos tienen necesidades educativas especiales, separando permanentes de transitorias, y qué adecuación pide cada diagnóstico. En el campo de alumnos, los del PIE van marcados —tanto en el listado de búsqueda como en la ficha, una vez elegidos— con su tipo a la vista.

Va en esta pantalla y no en otra porque acá es donde se decide la prueba. Si el curso tiene un alumno con discapacidad visual, el tamaño de letra deja de ser una preferencia; si tiene dos con déficit atencional, treinta preguntas apretadas en una hoja es una decisión y no un descuido. Enterarse después de imprimir no sirve de nada.

• No bloquea y no cambia nada solo. Las adecuaciones las define el equipo PIE, no un generador de pruebas. Lo que hace la pantalla es que el dato no pase inadvertido.
• Con alumnos elegidos, el aviso habla de ellos, no del curso: la prueba se está armando para ese grupo. Y si ninguno de los elegidos es del PIE, se dice también, recordando que el curso completo sí tiene.
• Un curso sin alumnos PIE lo dice igual, con un visto. El silencio se lee como «no se comprobó», que es lo contrario de lo que se quiere.

6Pantalla 2 — El editor

6.1 El editor está paginado: cada hoja de la pantalla es una página del PDF

El centro de la pantalla no es un lienzo continuo con una línea de corte dibujada encima: son hojas de verdad, separadas, cada una a escala real con su número de página al pie. Cuando el contenido pasa del alto útil, la pregunta siguiente se va a la hoja siguiente, igual que al imprimir. Es lo que resuelve el problema principal del §1.

• Alto útil = alto de la hoja − los dos márgenes. Se van agregando preguntas y, cuando una no cabe, empieza una hoja nueva.
• Una pregunta nunca se parte entre dos páginas. Como efecto, al final de una hoja puede quedar espacio en blanco: es correcto, no es un error de maquetación.
• El enunciado y cada alternativa se editan en el lugar, sin abrir un formulario aparte.
• Al salir de un campo se vuelve a paginar: si el enunciado creció, el corte se movió, y un editor que no lo recalcula deja de decir la verdad.

6.2 Los enunciados y las alternativas se escriben en un editor WYSIWYG con LaTeX

Tanto el enunciado como cada alternativa son campos con formato: negrita, cursiva, subrayado, superíndice, subíndice, tipografía, tamaño de letra, imágenes y fórmulas.

Alineación por fila

La barra trae los cuatro botones habituales —izquierda, centro, derecha y justificado— y se aplican a la fila donde está el cursor, o a lo que esté seleccionado. El botón queda hundido mostrando cómo está alineado eso: sin esa seña, los cuatro se ven iguales y no hay forma de saberlo.

Dos formas de poner una imagen: subirla o generarla

La barra trae dos botones distintos, no uno: 🖼️ Subir una imagen y 🎨 Generar una imagen con IA (§7.b). Son dos caminos separados y el segundo cuesta tokens; mezclarlos en un solo botón obligaría a entrar a un formulario de IA al profesor que sólo quiere poner la figura que ya tiene escaneada.

• Acepta PNG, JPEG, WebP y GIF, hasta 12 MB por archivo.
• Se achica en el navegador antes de entrar, a un tope de 1400 px de ancho. Por encima de eso no aporta nada impreso, y el problema es real: una prueba con veinte fotos de celular sin tocar es un PDF de 40 MB que nadie va a poder mandar por correo ni imprimir en el colegio. El aviso dice cuánto se achicó y cuánto pesa al final.
• Los PNG y los GIF se reencodean como PNG, no como JPEG: pasarlos a JPEG les pone fondo blanco y una figura con transparencia queda con un recuadro alrededor.
• La imagen subida se comporta como cualquier otra: se redimensiona tirando de una esquina y se alinea con los botones de la barra.

El tamaño de una imagen se cambia tirando de una esquina

Las imágenes del enunciado —la generada por IA y la recortada de un PDF— entran con un tamaño de oficio que casi nunca es el que el profesor quiere. Un clic la selecciona y aparecen cuatro tiradores, uno por esquina; se arrastra cualquiera de ellos.

• Mantiene la proporción siempre: se escribe el ancho y el alto queda en auto. Una figura deformada en una prueba de geometría es un error de contenido, no de estética.
• Mientras se arrastra se muestra la medida en píxeles.
• Mínimo 60 px; máximo, el ancho de la columna de la hoja —no el del modal, que es más ancho—. Midiéndolo contra el modal, el profesor podía estirar hasta 640 px y en el papel salía recortada a 570 por el max-width: había dimensionado contra algo que no era lo que se imprime.
• Con la imagen seleccionada, Supr la borra.
• El ancho se guarda en el elemento (style="width:NNNpx"), así que viaja con el enunciado y sale igual en el PDF.

Y se recorta: mostrar sólo una parte funcionalidad nueva

Una figura escaneada, generada por IA o traída de un Word casi nunca viene encuadrada: arrastra el enunciado de al lado, media tabla, el borde de la hoja, el número de página del libro. Hasta ahora la única salida era recortarla en otro programa y volver a subirla — un viaje de ida y vuelta por algo que se resuelve con un rectángulo.

• Con la imagen seleccionada aparece ✂ Recortar en su propio marco, que es donde está mirando quien acaba de elegirla.
• Se arrastra un rectángulo sobre la imagen; lo que queda afuera se oscurece, y se dice qué porcentaje del ancho y del alto se va a ver.
• Un clic sin arrastrar no es un recorte: es un clic. Por debajo del 3% se descarta.
• Funciona igual sobre una figura vectorial generada por IA, avisando que al recortarla pasa a ser una imagen de píxeles.

La fórmula se inserta escribiendo LaTeX con vista previa en vivo y una fila de atajos para lo más usado (fracción, raíz, ±, ≤, π, Δ, ∑). Una vez puesta se comporta como un objeto: se selecciona entera y al hacer clic se vuelve a abrir el editor de LaTeX. No se puede escribir por dentro, que es lo que la rompería.

<span class="formula" data-latex="k = \frac{25}{16}">…render…</span>

6.2.b Tablas dentro de una pregunta

El botón de tabla abre un selector de tamaño por rejilla — se pasa el mouse y se elige 3 × 4, como en Word o Docs — con la opción de usar la primera fila como encabezado. Después se escribe directo en las celdas.

Sirve para lo que en matemática y ciencias aparece todo el tiempo: tablas de frecuencia, de valores x/y, de datos experimentales. Las tablas van dentro del enunciado, no como un objeto aparte: son parte de la pregunta y tienen que viajar con ella al banco de items.

Lo que falta y hay que definir: agregar y borrar filas o columnas después de creada, combinar celdas, y alineación por columna. La maqueta inserta la tabla y deja escribir, nada más. Si se usa CKEditor, esto viene resuelto.

6.2.c Gráficos interactivos: JSXGraph

Un bloque de gráfico dentro del enunciado, con dos formas de describirlo en el mismo campo:

• La forma corta, que es la que usa un profesor: la función (f(x)=-5x^2+30x), los puntos (A=(3,45)) y opcionalmente la ventana (ventana=(-1,7,-5,50)), una por línea. Cubre lo que pide una prueba de colegio sin obligar a programar.
• Código JSXGraph, pegado tal cual desde los ejemplos de jsxgraph.org, con su JXG.JSXGraph.initBoard(BOARDID, …). Así entran deslizadores, geometría dinámica y superficies 3D, que la forma corta no cubre y que la librería sí sabe hacer.

No hay que elegir el modo: se reconoce solo. La marca es la misma en todos los ejemplos de la librería —JXG.JSXGraph.initBoard, o un board.create(— y ninguna de esas cadenas puede aparecer en la forma corta, que no lleva llamadas ni puntos. BOARDID es el hueco que la propia documentación deja para el id del contenedor, así que el ejemplo se pega sin tocar una letra.

6.3 Agregar preguntas — botón flotante, como en Google Forms

Un botón fijo a la ventana, abajo a la derecha, siempre visible. Al pulsarlo se despliega hacia arriba una paleta con los tipos de pregunta y los dos orígenes alternativos:

• Los siete tipos de pregunta de WebClass (§6.3.a)
• Texto compartido por varias preguntas (§6.4.b)
• Digitalizar desde un archivo —PDF o Word— (§6.3.c) · Recortar de un PDF o imagen (§6.3.b)
• Desde el banco de items · Con ayuda de la IA

La pregunta se agrega al final, la vista baja hasta ella y el cursor queda en el enunciado, listo para escribir.

6.3.a Los tipos de pregunta: los que WebClass ya guarda

No se inventó ninguno. La lista sale de leer el módulo home/preguntas/CreaPreguntas del vanilla: el if($tipo==N) de controlador/controladorPregunta.php y las clases Objetos/Respuesta_*.php. pregunta.tipo es un entero y estos son sus valores:

Los iconos del producto (truefalse.gif, match.gif, essay.gif, multichoice.gif, shortAnswer.gif) son los de Moodle, y existe un módulo giftEvaluation: la numeración viene de ahí. Conviene tenerlo presente si alguna vez se quiere importar o exportar en formato GIFT.

var sumfrac = frac0 + frac1 + … + frac7;
if (sumfrac != 1) { alert('La calificación sugerida no es el 100%'); return; }

$puntaje = respuesta_alternativa.puntaje;      // la fraccion
if ($puntaje > 0) { $puntaje = $puntajePregunta; }   // ← el puntaje COMPLETO
else               { $puntaje = 0; }

Selección múltiple con varias correctas

• La letra alterna en vez de mover una marca única, y se dibuja cuadrada en lugar de redonda: es la señal de que se puede marcar más de una, antes de leer el enunciado.
• Cada alternativa correcta lleva su porcentaje del puntaje, editable, en la zona que no se imprime: en el papel el alumno no debe ver cuánto vale cada una.
• Marcar una nueva correcta reparte 100% en partes iguales. Es predecible; quien quiera 60/40 lo escribe después.
• Poner un porcentaje mayor que cero es marcarla correcta: el puntaje y la bandera son el mismo dato, igual que en la base.
• Si los porcentajes no suman 100% se avisa bajo la pregunta y no se deja guardar. Sumar menos hace la pregunta imposible de obtener completa; sumar más la hace valer más de lo que dice su puntaje. No se corrige solo: cambiarle la prueba al docente por detrás es peor que avisarle.
• En la pauta de corrección, estas preguntas rinden un grupo de letras (ACE), no una sola.

Términos pareados

• Se editan por pares, que es como se piensan: término y definición en la misma fila.
• La columna B se imprime revuelta, y el orden se guarda en la pregunta (respuesta_enpareja_orden.orden): si se re-revolviera en cada repintado, la pauta impresa dejaría de servir.
• La columna A lleva un recuadro para escribir la letra, se numera sola y los pares se arrastran para reordenar.
• La clave (1→B 2→D…) se calcula sola y no se imprime. Hay un botón para volver a revolver la columna B.
• No se puede guardar con un par que tenga una columna vacía.

El señuelo sin pareja «+ distractor»

La columna B puede llevar opciones que no calzan con ningún término de la A. Sin ellas, el último par sale gratis: quien ya emparejó el resto acierta por descarte. Con un señuelo, cada fila hay que resolverla.

• Se agregan con el botón «+ distractor», al lado de «+ par». Son una fila más de la columna B, sin fila en la A: por eso la B queda más larga que la A y las letras siguen corridas (A…F con cuatro pares y dos señuelos).
• Se revuelven junto con los pares, no se pegan al final. Un señuelo que siempre cae en la última letra se delata solo y deja de servir.
• En pantalla la fila se marca con el rótulo sin pareja y trae su propia × para quitarla. En el papel no se marca nada: ambos elementos llevan no-imprimir, y el texto del señuelo se imprime como una opción más.
• La clave de pantalla los lista aparte: 1→B 2→D 3→C 4→F · sin pareja: A, E.
• El puntaje de la pregunta no cambia al agregar un señuelo: se sigue puntuando por par correcto. Un señuelo no suma ni resta por sí mismo; penaliza porque ocupa el lugar de una respuesta que no existe.
• Los pares siguen con un mínimo de dos. Los señuelos no tienen mínimo —son opcionales— pero ninguno puede quedar sin texto: en el papel saldría una letra en blanco. La validación dice «tiene un distractor sin texto».

Modelo de datos: ya existe, no hay que inventarlo. Un señuelo es una fila de respuesta_enpareja_orden con columna = B y su orden, cuyo vínculo en respuesta_enpareja_vinculo queda con vinculo_a = -2. Es exactamente lo que el producto llama «distractor» en editarPreguntas.php y controladorPregunta.php. El control está comentado en varios archivos: la tarea es descomentarlo y completarlo —y verificar que el corrector no intente emparejar un -2—, no escribirlo de cero. Ver la caja sobre la palabra «distractor», porque en la otra acepción sí se descartó.

Respuesta corta

• En el papel es una raya. Lo que el sistema necesita es la lista de respuestas aceptadas, y esa no se imprime.
• Cada respuesta aceptada lleva su porcentaje, que es respuesta_corta.puntaje: así «7», «7,0» y «siete» valen 100% y «2 y 5» vale 50%.
• No se puede guardar sin al menos una respuesta aceptada.
• Hay que definir la tolerancia de la comparación: mayúsculas, tildes, espacios y coma vs. punto decimal. Ver §11.

Desarrollo, con rúbrica para el profesor funcionalidad nueva

En el papel la pregunta es un bloque de líneas. Lo que se agrega es que nace acompañada de una rúbrica: es el único tipo que no se corrige solo, y sin pauta «6 puntos de desarrollo» los reparte cada profesor a ojo —con dos cursos paralelos, eso es una diferencia de nota que nadie puede explicar después.

ALTER TABLE rubrica ADD COLUMN id_pregunta INT NULL DEFAULT NULL;
-- NULL  = rúbrica del banco, como hoy: se arma y se aplica aparte
-- id    = rúbrica de esa pregunta, viaja con ella y sale en su pauta

• Nace con tres niveles —Logrado 100%, Parcial 50%, No logrado 0%— y dos criterios con descriptores de ejemplo. Se agregan más con «+ nivel»; con cuatro o cinco, la tabla se desplaza sola dentro del modal.
• Un nivel nuevo entra antes del último, no al final: el último es «No logrado» y la escala tiene que seguir leyendo de mayor a menor.
• Cada criterio lleva su puntaje máximo, y cada celda muestra cuántos puntos vale (puntaje del criterio × % del nivel). Eso es lo que convierte la rúbrica en algo con lo que se pone una nota.
• La suma de los criterios tiene que ser el puntaje de la pregunta. Si no calza, se avisa en la cabecera y Guardar se bloquea diciendo cuánto suma —el mismo control que el de los porcentajes de las preguntas de varias correctas—. Tampoco se puede guardar con un criterio sin nombre ni con una celda sin descriptor: al corregir, la celda vacía aparece justo en el nivel que hay que decidir.
• La rúbrica se puede quitar. Queda en su lugar el aviso de que la pregunta se corrige a mano y el botón para volver a ponerla.

V/F con justificación

Es el tipo 1 más un bloque de líneas rotulado «Justifica tu respuesta». La justificación se corrige a mano y tiene su propio puntaje: la tabla respuesta_vof_justificacion ya trae justificacion y puntajeObtenido por separado.

6.3.b Recortar de un PDF o imagen — una pregunta por recorte

El profesor sube el PDF o la foto de una prueba anterior, ve el documento en pantalla y arrastra un rectángulo sobre cada pregunta. Cada recorte entra como una pregunta, en texto editable: el enunciado queda escrito, las alternativas se separan solas y las tablas se rehacen como tabla.

Recortar de una imagen: reconocer el texto

Este era el caso que quedaba afuera, y es el más común en un colegio: la prueba del año pasado está fotocopiada, o el profesor le saca una foto con el celular. Sin capa de texto, el recorte entero entraba como imagen, con las alternativas en blanco para llenar a mano — es decir, no se ahorraba nada.

• Los recortes sin texto se cuentan y se muestran juntos, con el botón «Reconocer el texto (OCR)». Se reconoce lo que el profesor encuadró, no la página entera.
• No consume tokens. Ver la caja de abajo: el OCR no es una llamada a un proveedor de IA.
• Lo reconocido pasa por el mismo camino que la capa de texto de un PDF: se separan las alternativas, se detecta el tipo de pregunta, y queda texto editable.
• Entra marcado como borrador. Un error del OCR que nadie revisa viaja hasta la sala.
• Se conserva el recorte original junto a la pregunta (origenRecorte.imagen): es lo único que permite comprobar después si la transcripción decía lo mismo que el papel.

Las fórmulas se traen como LaTeX, y se pueden editar

Un PDF nacido digital no guarda «√12»: guarda un √ y un 12 con sus coordenadas, y la raya de la raíz es un trazo vectorial aparte. Lo mismo con un exponente —el 7 de 2⁷ es un trozo más chico y más arriba— y con una fracción, que son dos trozos apilados. Aplanar eso a texto daba 2 7 3 y la pregunta quedaba sin sentido.

Ahora esas señas —alto del trozo, desplazamiento respecto de la línea base, apilamiento— se leen y se reconstruye el LaTeX. La fórmula entra como el mismo <span class="formula" data-latex="…"> que produce el editor, así que se abre y se corrige como cualquier otra.

El recortador ocupa el 90% de la pantalla, con zoom

El documento es el trabajo, no un detalle del formulario. En un notebook de 13″ la página entraba tan chica que el texto no se leía, y encuadrar «la pregunta completa» a ojo era imposible.

• El modal ocupa 90% de ancho y de alto, en dos columnas: el documento a la izquierda con todo el alto disponible, la lista de recortes a la derecha. Bajo 900 px la lista pasa abajo.
• Un selector de zoom: Ajustar al ancho y de 50% a 200%. El 100% es el tamaño natural de la página, no el del contenedor —si no, «100%» significaría cosas distintas según el ancho de la ventana y el selector dejaría de querer decir algo—.
• Detalle de implementación: el zoom cambia el ancho del <img>, no un transform. Las coordenadas del recorte se calculan desde el rectángulo del propio <img>, así que al reflotar el layout siguen saliendo bien solas en cualquier zoom. Con transform habría que corregirlas a mano en cada cálculo.

Un recorte, una pregunta

Antes todos los recortes se sumaban a una sola pregunta, para el caso de una pregunta partida entre dos columnas. Estaba mal calibrado: lo habitual es encuadrar varias preguntas seguidas, y recibirlas todas pegadas obliga a deshacer a mano lo que el sistema juntó. Ahora cada recorte es una pregunta; una partida en dos se arregla con un recorte que abarque las dos partes, o pegando el texto después —que ahora se puede, porque es texto—.

Qué se reconoce dentro del recorte

Las tablas se reconocen por alineación, no por los bordes dibujados: hay tablas sin bordes y hay rayas que no son tablas. Se acepta como tabla una seguidilla de tres o más líneas que se parten en el mismo número de celdas y en las mismas posiciones; con dos filas podría ser cualquier cosa.

Las figuras se buscan por bandas: se toman las franjas horizontales del recorte que ninguna línea de texto ocupa y se mira si tienen tinta. Hay que mirar las tres clases de banda —antes de la primera línea, entre dos líneas y después de la última—: el caso más común es la figura bajo el enunciado, y mirar sólo los huecos intermedios lo dejaba fuera.

La imagen se recorta al ancho del recorte, no al del texto —una figura suele ser más ancha que las líneas— y después se le quita el aire blanco ajustando al contorno de la tinta. Sin eso la figura entra rodeada de página en blanco y se ve como un error.

Una banda que no llega al 0,4% de tinta se descarta: es espacio entre párrafos, no un dibujo. Y un recorte que trae sólo una figura, sin texto, entra igual — como pregunta de desarrollo con la imagen dentro.

El panel de la derecha muestra, por cada recorte, qué se reconoció —tipo, cuántas alternativas, si trae tabla o figura— antes de importar nada. Es la única forma de darse cuenta de que algo salió mal antes de tener quince preguntas rotas en la hoja.

Fuera de alcance por ahora: detectar solo dónde empieza y termina cada pregunta, enderezar un escaneo torcido, y separar columnas automáticamente. Si el escaneo viene muy inclinado, conviene avisarlo antes de que el profesor pierda el tiempo recortando.

6.3.c Digitalizar desde un archivo completo — sin recortar nada a mano

La diferencia con §6.3.b no es de grado: allá el profesor encuadra cada pregunta y lo encuadrado entra como imagen. Acá se lee el archivo entero y se separan solas las preguntas y sus alternativas. Acepta PDF y Word, y en el PDF aprovecha que un PDF nacido digital trae capa de texto con coordenadas. No es OCR y no adivina: pdf.js entrega cada trozo con su x, su y y su tamaño, y eso es información exacta.

También desde Word funcionalidad nueva

La mitad de las pruebas de un colegio están en .docx, no en PDF: el PDF es lo que se imprime, el Word es el original que el profesor guarda. Pedirle que exporte a PDF para poder importarlo es pedirle un paso que no entiende para qué sirve.

Lo que cambia es sólo el lector. El reconocimiento —qué línea abre una pregunta, cuál es una alternativa, cuál es el pie que se repite, cuál de las listas numeradas es la de preguntas— es el mismo código para los dos formatos. El lector de Word produce las mismas líneas que produce pdf.js y de ahí en adelante el camino es idéntico, incluida la pantalla de revisión.

• Las imágenes salen mejor que del PDF. En un PDF hay que ir a buscarlas recortando el lienzo rasterizado; en un .docx vienen como archivo dentro del paquete, con su posición. Se extraen enteras y se ponen en la pregunta que las contiene.
• Las tablas entran como una línea por fila, con las celdas seguidas. El contenido no se pierde, pero la tabla hay que rehacerla con el botón de tabla del editor. Se dice en el resumen, no se deja descubrir mirando el resultado.
• El .doc viejo no se puede leer —el binario de Word 97 no es un paquete—, y se dice qué hacer: «Guardar como .docx». Un «formato no soportado» deja al profesor sin saber si tiene arreglo.
• Si el Word no trae texto —la prueba está dentro de una imagen pegada o de un cuadro de texto— no se ofrece OCR, que es para escaneos: se manda a recortar a mano.

Cuando las alternativas son dibujos

«¿Cuál de los cuerpos geométricos tiene 6 caras cuadradas?», con cuatro figuras rotuladas A) B) C) D) debajo. Entraban como desarrollo con una sola imagen: el alumno ve las cuatro opciones en el papel, pero el sistema no sabe que son cuatro y no hay dónde marcar la clave, así que la pregunta no se podía corregir. En el ensayo de ejemplo son 2 de 40; en pruebas de Geometría de básica son bastantes más.

Las letras no sirven de guía: se midió la capa de texto de esa página y los rótulos A) B) C) D) no están ahí —son parte del dibujo—. Lo único que trae el PDF es el enunciado y la línea «Marca la letra de la imagen elegida». Lo que sí se puede leer es la imagen: las figuras están separadas por blancos verticales, que es como se dibujaron.

El importador recorre la banda de la figura columna por columna, marca cuáles tienen tinta y corta donde hay un blanco ancho. Si salen entre 3 y 6 grupos, son las alternativas: cada uno se recorta en su propia imagen, se les asignan las letras en orden y la pregunta entra como selección múltiple, con su clave por marcar como cualquier otra. Se avisa en la lista previa: «sus alternativas son dibujos: entran como imágenes».

Con esto el ensayo de ejemplo entra completo: 40 de 40 preguntas con sus 4 alternativas, dos de ellas como imágenes.

En el producto, cada recorte es un archivo más: son cuatro por pregunta y van en respuesta_alternativa como URL, con la misma regla que las imágenes del enunciado —§6.2, «Dos formas de poner una imagen»—. En la maqueta van como data: porque no hay servidor.

6.4 Arrastrar y soltar

• Preguntas: se toman de un asa que aparece al pasar el mouse y se sueltan en otra posición, incluso en otra hoja. La numeración se rehace sola y la prueba se vuelve a paginar.
• Alternativas: lo mismo dentro de su pregunta; las letras A/B/C/D se reasignan según la posición nueva.
• El orden se persiste en prueba_preguntas (y el de alternativas en su tabla respuesta_*) con un solo POST al soltar, no uno por elemento.

6.4.b Un recurso compartido por varias preguntas funcionalidad nueva

«Lee el siguiente texto y responde las preguntas 11 a 14». El texto —o la imagen, o la tabla de datos, o el gráfico— se escribe una sola vez y vale para todas ellas. Es la forma de casi todo ensayo SIMCE y PAES, y de cualquier prueba de comprensión lectora.

Hoy la única manera es copiar el texto dentro de cada enunciado. Eso falla de tres formas, y la tercera es la grave:

1. Ocupa la hoja cuatro veces. Un texto de media página repetido en cuatro preguntas es una prueba de tres hojas que debería ser de una.
2. Se corrige en un lugar y queda mal en los otros tres. Una errata detectada el día antes de imprimir hay que arreglarla cuatro veces, y basta olvidar una.
3. Se rompe al barajar. Al asignar la prueba a un curso, WebClass puede repartir las preguntas en orden distinto para cada alumno. Si el texto vive dentro del enunciado de la pregunta 11, al alumno que la recibe de última le llega el texto al final y las preguntas 12, 13 y 14 antes, apuntando a un texto que todavía no leyó. La prueba deja de tener sentido y nadie se entera hasta que la rinde.

Cómo se usa

• En el menú +, «Texto compartido por varias preguntas». Lo único que se pregunta al crearlo es cuántas preguntas van a usarlo, porque de eso depende dónde queda el bloque; el texto se escribe después sobre la hoja, con el mismo editor que un enunciado.
• El rótulo «responde las preguntas 11 a 14» se arma solo y se actualiza al agregar, sacar o reordenar. Escrito a mano quedaría mintiendo a la primera pregunta que se mueva.
• Cada pregunta dice en su carril a qué texto pertenece, en un selector. Las tres operaciones —meterla, sacarla, pasarla a otro texto— son la misma elección, así que es un solo control.
• La tarjeta del recurso trae «＋ Pregunta» y «Separar». Separar deja las preguntas donde están y borra el texto: sin preguntas que lo usen no tiene dónde imprimirse, y eso se avisa antes.
• Borrar la última pregunta de un texto se lleva el texto, y la confirmación lo dice. Puede ser media página escrita a mano.

// EvaluationsController
->leftJoin('archivo as a', 'p.idrecurso', '=', 'a.id')
->select( … 'a.url as url_archivo', 'a.archivo_extension', … )

$preguntas = $barajarPreguntas == 1 ? $preguntas->shuffle() : $preguntas;

6.5 Categorización — el carril de la derecha

Cada pregunta tiene, a su derecha y alineada con ella, una tarjeta con tres estados: Categorización y Retroalimentación. Cada uno se marca solo cuando está completo, así se ve de un vistazo qué falta. Hay además una banderita para marcar una pregunta y volver a ella.

Al hacer clic se abre un cajón lateral. Los campos de categorización:

El orden sigue el del currículo: primero dónde se busca —nivel, asignatura, eje— y después qué se eligió ahí dentro —objetivo, indicador—. Con el eje debajo del objetivo, el filtro aparecía después de lo filtrado y no servía de nada.

Las seis primeras filas —de nivel a habilidad— se repiten una vez por objetivo: una pregunta puede declarar varios. Ver §6.5.b. La dificultad y el puntaje, en cambio, van una sola vez por pregunta.

No hay campo de etiquetas libres. Estuvo y se quitó: para filtrar el banco de items ya están el objetivo, el indicador, la habilidad, el eje, la dificultad y el nivel —todos de catálogo y todos comparables entre colegios—. Un texto libre al lado se llena distinto en cada sala («u3», «Unidad 3», «unidad III») y termina siendo ruido en el buscador en vez de un filtro.

Cambiar el nivel o la asignatura limpia eje, objetivo e indicador, y se avisa: apuntan a un catálogo que ya no es el vigente, y dejarlos produciría combinaciones que no existen en ningún currículo. Por lo mismo, al cambiar el OA se limpia el indicador.

Al revés, elegir un objetivo completa el eje solo: el eje es un dato del objetivo, no una etiqueta que el profesor tenga que recordar.

6.5.b Una pregunta puede medir varios objetivos funcionalidad nueva

Hoy la pantalla deja declarar un objetivo por pregunta, y eso no alcanza. Un problema de área que se resuelve con una ecuación cuadrática mide geometría y álgebra; una pregunta de un recuperativo mide un objetivo del año anterior junto con el del año en curso. Con un solo casillero, el profesor tiene que elegir cuál declarar, y la tabla de especificaciones queda contando de menos justamente en las preguntas más ricas.

El cajón pasa a tener una tarjeta por objetivo, cada una con su nivel, asignatura, eje, objetivo, indicador y habilidad completos, más un botón «+ otro objetivo» y una × por tarjeta. Todas las reglas de §6.5 —el eje filtra, cambiar el nivel limpia lo de abajo, elegir el objetivo completa el eje, lo ajeno se marca en naranjo— siguen valiendo dentro de cada tarjeta, por separado.

• Cada tarjeta puede ser de otro nivel y otra asignatura. Una pregunta de 2° Medio puede declarar un objetivo de 1° Medio sin dejar de declarar el suyo.
• La dificultad y el puntaje quedan fuera de las tarjetas, una sola vez al final. Son propiedades de la pregunta, no del objetivo que mide: repetirlas por tarjeta invitaría a ponerles valores distintos, que no significan nada.
• El objetivo nuevo hereda el nivel y la asignatura del anterior, no los de la evaluación. Si el profesor está categorizando contenido de otro nivel, lo probable es que el siguiente también lo sea.
• Una pregunta cuenta como categorizada con que al menos un objetivo tenga objetivo e indicador. Empezar a escribir un segundo no puede devolver a «sin categorizar» una pregunta que ya lo estaba.
• El carril muestra las etiquetas de todos los objetivos, no sólo del primero: si no se ven, la categorización múltiple existe pero nadie la revisa.

6.5.c El objetivo propio, fuera del catálogo

No es nuevo en WebClass: hoy el profesor le puede poner a una pregunta un objetivo que no está en el catálogo, y queda en pregunta_atributo_adicional (id, pregunta_id, tipo, caracteristica) con caracteristica en texto libre. Verificado en el vanilla: los informes lo leen (test_informe, informepme), el logro lo cuenta —EvaluacionDao tiene la misma consulta con esta tabla en vez de pregunta_atributo— y se copia al duplicar la pregunta. Lo que faltaba era que el generador lo ofreciera.

En el cajón, junto a «+ Otro objetivo», va «+ Objetivo propio». La tarjeta que agrega pide dos cosas y nada más:

• Tipo — objetivo de aprendizaje, habilidad o actitud. Son los códigos 3, 4 y 7 que la tabla ya usa, los mismos de pregunta_atributo.tipo.
• Qué mide — el texto.

Sin nivel, sin eje, sin indicador: la tabla no tiene esas columnas y pedirlos sería inventarlas. Por lo mismo un objetivo propio nunca se marca como ajeno: su nivel es el de la prueba.

• Cuenta como categorizada una pregunta cuyo único objetivo es uno propio de tipo objetivo: el producto lo mide, así que la tabla de especificaciones también. Los de tipo habilidad o actitud acompañan —como la habilidad del catálogo— pero no categorizan solos.
• En la tabla de especificaciones cada objetivo propio es una fila, después de los del catálogo y antes de «sin categorizar», y se lleva su parte del puntaje como cualquier otro (§6.5.b): una pregunta de 3 puntos con dos OA y uno propio le da 1 a cada uno. Las habilidades y actitudes propias no reparten puntaje y van en una lista aparte, con sus preguntas.
• En la planilla exportada el objetivo propio sale como una fila más, con «Propio: …» en la columna de objetivo y sin nivel ni eje; las habilidades y actitudes propias van en la columna de habilidad.
• El carril los muestra con su propio color, y el resumen de la barra los cuenta aparte: «3 OA + 1 propio».
• Si la IA propone la categorización, completa el primer objetivo del catálogo; si el primero es propio, no le escribe un código de OA encima.

6.6 Retroalimentación

La pestaña se llamaba «Explicación» y ofrecía un campo de texto. Al revisar el producto resultó que WebClass ya guarda siete textos de retroalimentación por pregunta, y que el nombre correcto es el suyo. Relevado en App\Pregunta, Api/ScormController y los Objetos/Respuesta_*.php del vanilla:

• La retroalimentación de cada alternativa va en la misma pestaña, como un grupo más, y también la correcta tiene campo: en la base la columna es por alternativa, sin excepción, y «por qué esta es la correcta» es justo lo que conviene mostrarle a quien acertó.
• Es lo que después permite el análisis de resultados — saber qué no entendió el curso, no sólo cuántos fallaron.
• La herramienta de IA escribe los tres textos de una vez y cobra una sola vez: pedirlos por separado serían tres cobros para una sola lectura de la pregunta.
• La marca del carril se enciende con cualquiera de los textos: una pregunta con retro de correcto e incorrecto está trabajada aunque no tenga la general.

6.7 Dos pestañas

6.9.b El banco de items funcionalidad nueva

Es lo que justifica económicamente el gadget. Un profesor escribe unas 40 preguntas al año y al año siguiente las vuelve a escribir. Reusar gana lejos sobre generar, y hoy el camino más rápido para armar una prueba es digitalizar el PDF del año pasado —teniendo esas preguntas en la base de datos—.

• Se busca por atributos: nivel, asignatura, eje, objetivo, indicador, habilidad, tipo y dificultad. Arranca con el nivel y la asignatura de la evaluación. Ver la caja de abajo.
• Se eligen varias de una vez y el botón dice cuántas.
• Llegan ya categorizadas: OA, eje, indicador, habilidad y dificultad viajan con la pregunta. No hay que volver a clasificarlas.
• Un item de otro nivel o asignatura se marca como ajeno en la lista, antes de traerlo.

6.10 Cambiar el nivel, la asignatura o el tipo después de crear

Los tres se eligen al crear la evaluación y quedan en ⚙ Opciones › La evaluación, arriba de todo. Equivocarse de nivel y tener que rehacer la prueba entera es el problema más caro de los que hay en juego acá, más caro que cualquiera de los que trae el cambio.

6.8 La barra del editor: una sola línea

Al centro, en la misma línea, las cuatro pestañas y después de un separador los dos botones que abren cajón: ⚙ Opciones y ✨ Herramientas de IA. A la derecha, Descargar y Guardar — son lo que se hace al terminar y la relación entre ellas importa (§6.9).

No hay una segunda fila de menú. Es alto robado a la hoja, que es lo único que el profesor necesita mirar. El separador marca la diferencia entre las dos mitades: a la izquierda se cambia de vista, a la derecha se abre un cajón. Cuando la ventana es angosta, pestañas y botones bajan juntos a una segunda fila: separarlos reinventaría el menú que se acaba de eliminar.

«Ver saltos de página» apagado muestra una tira continua, cómoda para escribir seguido. La pantalla lo advierte: con los saltos apagados el editor deja de coincidir con la impresión.

6.8.b El encabezado de la hoja

6.8.c Las casillas que llena el alumno son configurables funcionalidad nueva

Eran tres interruptores fijos —nombre, curso, fecha— y cada colegio pide alguno más: RUT, sala, número de lista, firma del apoderado, puntaje obtenido. Con una lista cerrada, el que necesita otra casilla la dibuja a mano sobre la fotocopia.

Ahora es una lista: se ocultan las que no se usan, se agregan otras del catálogo de WebClass, se crean propias con el nombre que se quiera, se reordenan arrastrando y cada una elige su ancho.

Con más de tres casillas la ficha pasa a dos filas y el rótulo se corre al costado izquierdo, que es como se llena una ficha en papel: en una sola fila, cuatro campos quedan tan angostos que el alumno escribe encima del de al lado.

ALTER TABLE prueba ADD COLUMN encabezado TEXT NULL DEFAULT NULL;

// App\Prueba
protected $casts = ['encabezado' => 'array'];

{"logo":true,
 "datos":false,            <-- la linea bajo el titulo
 "campos":[
  {"id":"nombre","visible":true,"ancho":"ancho"},
  {"id":"curso","visible":false},
  {"id":"c1","etiqueta":"RUT","ancho":"corto"}
]}

El nombre y las instrucciones se editan en la hoja

El nombre de la evaluación tenía un campo en la barra superior y se quitó. Era el mismo dato en dos lugares, y el de arriba ni siquiera lo mostraba con la tipografía con que se va a imprimir: se escribía a ciegas. Ahora se edita sobre el título de la hoja, que es donde el profesor lo va a leer. La miga de pan lo sigue mientras se escribe.

Ese campo no abre el editor de texto: se escribe directo sobre la hoja. Un nombre es un rótulo, no un párrafo —ofrecerle negrita, tipografía, fórmulas, tablas y gráficos es ruido— y abrir un modal para teclear cuatro palabras sería peor que el problema que resuelve. Lo mismo vale para los términos pareados y las respuestas aceptadas. Ver §6.2.

Es el texto que más se retoca —cambia con cada prueba— y mandarlo a un formulario aparte era un rodeo para tres palabras. Ahora se escriben sobre la hoja, igual que el enunciado de una pregunta, y ese es el único lugar donde se editan.

Cuando quedan vacías, en el editor se ve un texto guía en gris —si no, no habría dónde hacer clic para volver a escribirlas— pero al imprimir el recuadro desaparece.

6.9 Guardar y Descargar

El botón principal dice Guardar, no «Publicar»: en WebClass una evaluación no se publica — se guarda, y después se asigna a un curso, que es otra acción y de otro módulo. Al lado va Descargar.

Al guardar hay dos niveles, y la diferencia importa:

8.b Qué es «clave completa» en cada tipo

Cada tipo tiene su propia idea de estar listo, así que la regla vive en el catálogo de tipos y no repartida en condiciones sueltas por el código. Agregar un tipo nuevo es agregar una fila acá, no buscar todos los if que hablaban de «desarrollo».

6.11 Qué le pareció la pregunta al profesor funcionalidad nueva

Cada pregunta que propuso la plataforma —traída del banco o generada por IA— muestra en su carril dos pulgares: 👍 la volvería a usar y 👎 no me gusta, cámbiala.

Lo elegido queda a la vista, no sólo hundido

Dos pulgares grises uno al lado del otro no dicen cuál se apretó: hay que acordarse. Con veinte preguntas en la prueba, eso es justo lo que no se puede pedir. Así que lo elegido se pinta: amarillo el pulgar arriba, rojo el pulgar abajo, el otro se apaga para que en el carril haya una sola respuesta a la vista, y el rótulo dice en palabras lo mismo que dice el color —«La volverías a usar» / «No te gustó»—, porque el color solo no basta para quien no lo distingue.

Sólo se pregunta por lo que la plataforma propuso

Una pregunta que el profesor escribió él, o que importó de su propio PDF, no pide valoración. Pedirle que califique lo suyo es pedirle que se califique solo: no dice nada de la plataforma y ensucia el dato justo donde se lo quiere limpio.

El pulgar abajo no es sólo una queja: viene con el reemplazo

• Si la pregunta vino del banco, se ofrece otra del banco del mismo objetivo —y que no esté ya en la prueba, porque cambiar una pregunta por otra que el alumno va a ver dos páginas más abajo no es un reemplazo—. Si el banco no tiene otra, se dice y se ofrece generarla.
• Si la pregunta la generó la IA, se ofrece generar otra para el mismo objetivo, y se cobra como cualquier generación.
• Siempre se puede dejarla como está. La opinión queda guardada igual: son dos cosas distintas y el profesor puede querer una sin la otra.
• El reemplazo conserva el puntaje y la posición: la prueba no cambia de forma porque una pregunta no gustara.
• Volver a apretar el mismo pulgar retira la opinión. Opinar por accidente y no poder deshacerlo ensucia exactamente el dato que se quiere limpio.

Lo que se cambia no se borra del banco. Que a un profesor no le sirva no es motivo para retirarla; que se lo digan varios, sí — y esa decisión no es de una prueba, es del establecimiento o de WebClass.

CREATE TABLE pregunta_valoracion (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  id_pregunta INT      NOT NULL,
  id_usuario  INT      NOT NULL,
  id_prueba   INT      NULL,        -- en qué prueba se opinó
  valor       TINYINT  NOT NULL,    -- 1 la volvería a usar · -1 no me gusta
  creado      DATETIME NOT NULL,
  UNIQUE KEY uq_opinion (id_pregunta, id_usuario)
);

7Herramientas de IA y tokens

Todas las acciones de IA descuentan de una bolsa de tokens del establecimiento, que el WebClass manager del colegio reparte entre sus profesores (más abajo). Lo que el profesor ve en el cajón lateral, en todo momento, es su cupo.

7.a El generador de preguntas pregunta sobre qué

Antes tomaba «algún OA del nivel de la prueba» sin preguntar. Eso servía para una demo y para nada más: lo primero que hace un profesor es decidir sobre qué quiere las preguntas. El formulario pide nivel y asignatura —con los de la evaluación puestos por defecto—, después el objetivo, y opcionalmente el indicador, además de cuántas, de qué tipo y con qué dificultad.

• Cambiar el nivel o la asignatura cambia el catálogo de OA que se ofrece, y el eje del objetivo elegido se muestra bajo el selector.
• Se puede pedir de otro nivel a propósito: un recuperativo mide objetivos del año anterior tan seguido como los del propio. Esas preguntas entran con su nivel y asignatura explícitos, para que se marquen como ajenas al revisarlas.
• Todo lo generado entra como borrador, igual que antes.
• La correcta no cae siempre en la A. Ver la caja de abajo.

Este es el generador del cajón, para agregar preguntas a una prueba que ya existe: pide un objetivo y agrega unas pocas. La tabla de §5.2 es el mismo motor pero al crear, con varias filas, su reparto por tipo y la posibilidad de traer del banco. Conviene que compartan el endpoint y el registro de consumo, y que se diferencien sólo en el formulario. El endpoint tiene que aceptar además el caso sin objetivo —la fila comodín de §5.2—, donde el objetivo lo elige y devuelve el servidor: la pregunta vuelve categorizada, no en blanco.

7.b El generador de imágenes

No se lista en el cajón de Herramientas de IA. Vive sólo en el botón 🎨 de la barra del editor de texto, al lado del de subir una imagen. El motivo es concreto: una imagen se inserta donde está el cursor, y desde un cajón lateral no hay cursor al que apuntar —terminaba cayendo al final del enunciado—. Igual sigue en el catálogo de herramientas por dentro, porque el precio y el registro de consumo tienen que salir de un solo lugar.

El formulario pide qué se tiene que ver, un estilo (esquema o diagrama, ilustración, línea de tiempo, gráfico de datos) y una proporción. Genera, muestra la vista previa, y recién ahí se inserta.

• Cobra al generar, no al insertar. Regenerar vuelve a cobrar, y eso tiene que estar claro antes: es la acción más cara del gadget.
• Siempre pide revisarla. La IA se equivoca en los rótulos y en las proporciones, y una figura mal rotulada en una prueba de geometría invalida la pregunta.
• La imagen queda en el enunciado con data-ia="1" y data-peticion, que guarda el texto con el que se pidió. En el editor lleva una marca IA; en el papel no: una estampa sobre la figura no le sirve de nada al alumno. Lo que hace auditable la imagen es el registro, no el sello.
• Se acota a 330 px de ancho. A ancho completo una figura generada se come media hoja y empuja la pregunta a la página siguiente.

La bolsa es del colegio, y el WebClass manager la reparte

Decidido: una bolsa por establecimiento. El WebClass manager del colegio la divide entre sus profesores —es él quien sabe quién está armando pruebas este mes y quién no—, y cada profesor gasta contra su cupo, no contra el total. Así un profesor no se lleva la bolsa entera en marzo.

• Al profesor se le muestra su saldo, no el del colegio: es el número sobre el que puede decidir.
• Cuando se acaba, se le avisa que no le quedan créditos y quién se los puede ampliar. No se falla con un error genérico ni se le cobra al colegio por fuera.
• Lo que no cuesta tokens sigue funcionando igual: el banco de preguntas, la lectura de PDF y el OCR (§6.3.b). Quedarse sin créditos no deja al profesor sin generador de pruebas.
• El manager ve el consumo por persona y puede mover cupo de uno a otro dentro del período.

Tablas nuevas (las únicas del gadget)

ia_bolsa_tokens
    id, colegio, tokens_asignados, tokens_consumidos,
    periodo_inicio, periodo_fin, activo

ia_cupo_profesor                    <-- el reparto que hace el manager
    id, bolsa, usuario, tokens_asignados, tokens_consumidos
    UNIQUE (bolsa, usuario)

ia_consumo
    id, colegio, usuario, prueba, pregunta (nullable),
    herramienta, tokens, exito, mensaje_error, created_at

ia_cupo_profesor es tabla y no una columna en usuario porque el reparto cambia cada período y hay que poder mirar el anterior: un cupo guardado encima del usuario no tiene historia. La suma de tokens_asignados de los cupos no puede pasar el de la bolsa, y esa validación es del servidor.

7.cDeshacer y borrador automático

8Reglas y validaciones

• Una pregunta de selección múltiple tiene exactamente una alternativa correcta: marcar otra desmarca la anterior. En la variante de varias correctas, la letra alterna y los porcentajes tienen que sumar 100 %.
• El puntaje total se recalcula solo. El puntaje para el 4,0 no se calcula acá: depende de la exigencia, que se fija al asignar la prueba a un curso.
• Al guardar se avisa de: opciones repetidas, preguntas sin categorizar, sin respuesta correcta, y borradores de IA sin revisar. Se guarda igual — el profesor manda — pero la prueba queda marcada como incompleta y no entra al banco de items.
• Una prueba ya rendida por alumnos no se edita. Se duplica y se edita la copia. Las tablas respuesta_*_alumno apuntan a la pregunta por id: editarla cambia retroactivamente lo que se le tomó al curso.
• Todo contenido que vuelva al navegador se escapa. Los enunciados aceptan HTML acotado (negrita, cursiva, sub/superíndice, imágenes) y hay que filtrarlo con lista blanca, no confiar en el editor.

8.a Opciones repetidas funcionalidad nueva

Dos alternativas iguales no son un descuido de forma: cambian lo que la pregunta mide. Si la repetida es la correcta, la pregunta tiene dos correctas y se corrige mal —el alumno que marcó la otra pierde puntaje por una respuesta que era cierta—. Si es incorrecta, el alumno las descarta las dos de una sola vez y la pregunta mide menos de lo que dice medir.

Y no es un caso raro: pasa solo, copiando una alternativa para editarla y olvidándose de cambiarla. Nadie relee las cuatro opciones de las treinta preguntas antes de imprimir.

• Se avisa al guardar, diciendo qué pregunta y cuál es el texto repetido, con un botón que lleva a la primera.
• No bloquea. Puede haber un motivo —una prueba de atención, un formato heredado— y bloquear obligaría a discutir con el sistema. Lo que no puede pasar es que se imprima sin que nadie se haya dado cuenta.

9Fuera de alcance

• Rendición en línea y corrección automática (ya existen en el producto).
• El análisis de resultados posterior, aunque este gadget genere los datos que lo alimentan.
• Migrar las pruebas históricas: se trabaja sobre las mismas tablas, así que no hay migración.
• Rúbricas para preguntas de desarrollo. Aparecen mencionadas en la maqueta como pendiente explícito.
• Apagar el módulo viejo de vanilla. Conviven hasta que este pruebe estar completo.
• GeoGebra. Se evaluó y se descartó por licencia (§6.2.c): es gratis sólo para uso no comercial y esto vive dentro de un producto que se vende. No queda como opción ni como interruptor.
• El análisis del error por alternativa, que es el otro sentido de la palabra «distractor» y no existe en WebClass (§6.6). Lo que sí queda es la retroalimentación por alternativa, que es una columna real. El señuelo sin pareja de los términos pareados —el único «distractor» que el producto tiene— sí está en el alcance.

10Criterios de aceptación

1. No se puede llegar al editor sin nivel y asignatura elegidos.
2. Arrastrar una pregunta a otra posición renumera la prueba y el orden sobrevive a recargar la página.
3. Una pregunta se puede arrastrar de una hoja a otra, y la prueba se repagina sola.
4. Arrastrar una alternativa reasigna las letras y la respuesta correcta sigue siendo la misma alternativa, no la misma letra.
5. El número de hojas del editor es igual al número de páginas del PDF, y el corte cae entre las mismas preguntas.
6. Ninguna pregunta queda partida entre dos páginas.
7. Cambiar el tipo de hoja o los márgenes vuelve a paginar en el momento, y el PDF sale en ese tamaño.
8. Una fórmula insertada se puede volver a editar: al abrir el campo y hacerle clic dentro del editor reaparece su LaTeX original, no el HTML renderizado.
9. Escribir en un enunciado no rompe una fórmula vecina: se selecciona y se borra entera.
10. Las fórmulas salen bien en el PDF, no sólo en pantalla.
11. El botón flotante de agregar está siempre visible sin scrollear, responde al clic en toda su superficie, agrega la pregunta, baja la vista hasta ella y abre el editor de texto en su enunciado.
12. Cambiar la tipografía o el tamaño base repagina la prueba, y el PDF sale con esa letra.
13. Una tabla insertada en un enunciado se imprime con sus bordes y no se parte entre dos páginas.
14. Pegar una tabla de especificaciones copiada de Excel identifica sola las columnas, y un indicador con coma adentro no descuadra la fila.
15. Las preguntas creadas desde la especificación llegan con su OA e indicador puestos, y esos valores siguen ahí al abrir la categorización aunque no estén en el catálogo.
16. Un bloque de gráfico aparece en el PDF como imagen, no como un hueco en blanco.
17. Un PDF de varias páginas se muestra y se puede navegar; dos recortes de páginas distintas se acumulan en una pregunta.
18. Cada recorte de un PDF con texto entra como una pregunta distinta, en texto editable, con sus alternativas separadas y sus tablas como <table>.
19. Una pregunta numerada sin separador —el número dentro de un círculo, que en la capa de texto es un 4 suelto— se reconoce igual, y también cuando el número va solo en su línea. Un 3 metros más que su altura no se confunde con una numeración.
20. Los recortes sin capa de texto se cuentan aparte y ofrecen reconocer el texto; lo reconocido entra como texto editable, marcado como borrador, y conserva el recorte original al lado.
21. Reconocer el texto no descuenta tokens ni aparece en el consumo: no es una llamada a un proveedor de IA.
22. Una tabla cuyas celdas ocupan varias líneas entra como <table> con sus columnas correctas y cada celda entera —no aplanada como párrafo, ni con las tres columnas intercaladas—.
23. Una raíz, un exponente, un subíndice o una fracción apilada del PDF entran como fórmula reeditable: al hacerle clic dentro del editor reaparece su LaTeX.
24. En ∛2⁷ el exponente queda dentro de la raíz, y en 2^{7/3} la fracción queda dentro del exponente.
25. Una frase con números no se convierte en fórmula.
26. Una línea con varias fracciones apiladas entra con cada fracción entera y en su lugar —no con los numeradores y denominadores barajados—, y un párrafo de dos líneas no se convierte en fracción.
27. Un PDF con la capa de texto ilegible se detecta, se dice por qué, y se ofrece reconocer el texto en vez de importar cuadraditos.
28. Las rayas de una tabla no se importan como si fueran una figura: no aparecen recuadros vacíos montados sobre el texto.
29. El recortador ocupa el 90% de la pantalla y trae un selector de zoom; recortar sigue cayendo donde corresponde en cualquier zoom.
30. Un recorte con texto e imagen trae las dos cosas, y la imagen queda en el mismo lugar que ocupaba respecto del texto.
31. La imagen importada llega sin el blanco sobrante alrededor.
32. Un recorte sin capa de texto entra como imagen, y la pantalla lo dice antes y después de importar.
33. El número de la pregunta del documento original no queda dentro del enunciado.
34. Esa pregunta nace sin clave, muestra la etiqueta «sin clave», y Guardar se bloquea sin ofrecer «guardar igual».
35. Marcada la clave, la etiqueta desaparece y Guardar deja de bloquearse por ese motivo.
36. Cambiar el número de alternativas (2 a 6) conserva la clave si sigue existiendo esa letra.
37. Al insertar una fórmula, tabla o gráfico, el contenido entra donde estaba el cursor: abrir el diálogo no puede perder el punto de inserción.
38. Después de insertar un gráfico se puede seguir escribiendo debajo.
39. Un ejemplo de jsxgraph.org pegado tal cual se reconoce como código y se dibuja, deslizadores y 3D incluidos; el bloque lo dice y la cabecera muestra cuántas líneas, no el código entero encima del dibujo.
40. Un texto que no se entiende en el campo del gráfico avisa por qué y deja el motivo escrito en el bloque: no dibuja una cuadrícula vacía que parece correcta.
41. En el modal del gráfico, la ayuda no se monta sobre el campo, ni siquiera después de estirarlo.
42. El diálogo se llama «Digitalizar desde un archivo» y acepta PDF y .docx; el reconocimiento de preguntas y alternativas es el mismo para los dos.
43. Un .docx se lee sin internet y sin librería, con sus imágenes puestas en la pregunta que las contiene.
44. Las tablas de Word entran como una línea por fila sin perder datos, y el resumen avisa que hay que rehacerlas.
45. Un .doc antiguo dice qué hacer —guardarlo como .docx—, no «formato no soportado».
46. Un Word sin texto manda a recortar a mano, no ofrece OCR: el OCR es para escaneos.
47. Una imagen del enunciado se puede recortar desde su propio marco: se arrastra un rectángulo, lo de afuera se oscurece y se dice qué porcentaje se va a ver.
48. Lo que queda es exactamente la parte marcada, en el tamaño del recorte y no en el de la imagen entera.
49. El original se conserva y «Quitar el recorte» lo devuelve entero; recortar dos veces seguidas no pierde el archivo de partida.
50. Descargar con cambios sin guardar no descarga: explica por qué y ofrece guardar y descargar en un paso.
51. La tabla de especificaciones cuadra: la suma de puntos por indicador es el puntaje total, y las sin categorizar aparecen en su propia fila.
52. Al cambiar el OA de una pregunta, el indicador queda vacío y sólo ofrece los del OA nuevo.
53. El eje aparece sobre el objetivo y lo filtra; elegir un objetivo completa el eje solo.
54. Una pregunta puede categorizarse con un objetivo de otro nivel o asignatura, y la pantalla lo advierte.
55. Cambiar el nivel o la asignatura de la pregunta limpia eje, objetivo e indicador y lo avisa.
56. Una pregunta admite varios objetivos, cada uno con su propio nivel y asignatura, y el carril los muestra todos.
57. Un objetivo agregado sobre otro nivel ofrece el catálogo de ese nivel y se marca como ajeno.
58. La dificultad y el puntaje aparecen una sola vez, fuera de las tarjetas de objetivo.
59. El puntaje de una pregunta con dos objetivos se reparte entre ellos: la tabla de especificaciones sigue sumando 100 %.
60. Una pregunta con un objetivo completo y otro a medias sigue contando como categorizada.
61. Si los tipos no suman las preguntas que va a generar la IA, se dice cuántas faltan o sobran y Crear queda deshabilitado; «Repartir automáticamente» lo resuelve.
62. Cada fila entrega la cantidad pedida de preguntas, con su objetivo o su habilidad puesta.
63. Marcar crear imágenes suma su costo al total antes de generar, y las preguntas generadas llegan con imagen.
64. En una prueba generada, la respuesta correcta recorre las cuatro letras: ni todas en la A, ni alternando entre dos.
65. Las de V/F generadas no se responden todas «Verdadero».
66. Cada pregunta del banco o generada muestra los dos pulgares en su carril; una escrita a mano no los muestra.
67. Volver a apretar el mismo pulgar retira la opinión.
68. El pulgar abajo ofrece el reemplazo del mismo origen: del banco si vino del banco, generada si la generó la IA — y siempre deja dejarla como está.
69. El reemplazo conserva puntaje y posición, y no cambia cuántas preguntas tiene la prueba.
70. La del banco que se ofrece no está ya en la prueba.
71. Una pregunta generada que se descarta se guarda igual, marcada como tal: la opinión sobre ella no se pierde al reemplazarla.
72. Al guardar no se cuentan las opiniones ni se pide nada por ellas: el profesor ya vio el pulgar que apretó.
73. Una línea con las cuatro alternativas juntas (A) 2 B) 4 C) 6 D) 8) entra como cuatro alternativas, no como una.
74. Alternativas en dos columnas —A y C arriba, B y D abajo— entran en orden A–D.
75. A.2, sin espacio tras el punto, entra como alternativa; «El vértice A. Se ubica…» y «a) y b) son paralelas» no.
76. Si a las alternativas les falta una letra, se dejan en el orden del documento en vez de reordenarse a medias.
77. El pie que se repite en todas las páginas no queda pegado al final de ninguna alternativa.
78. Las instrucciones numeradas de la portada no entran como preguntas, y las preguntas 1 a 5 de verdad sí.
79. Dos celdas de una tabla, o dos alternativas consecutivas, no se unen en una fracción; una fracción de verdad sí se reconoce.
80. Una alternativa con signos matemáticos —A) 56 ÷ 0 = 56— sigue siendo una alternativa, no parte del enunciado.
81. La prosa que sigue a una fórmula no queda dentro de ella.
82. Una prueba con los ejercicios pegados como imagen entrega todas sus preguntas, cada una con su imagen y la clave para marcar.
83. El resumen distingue las que traen su texto de las pegadas como imagen, y explica por qué.
84. Se ofrece OCR también en el camino del PDF completo; lo reconocido entra como borrador y conserva la imagen original.
85. El detector de pies repetidos no elimina números de pregunta aunque caigan en la banda del borde.
86. Un recorte de un plano o cuadrícula con rótulos adentro entra como una sola imagen con sus rótulos dentro, no como palabras sueltas.
87. Un párrafo enmarcado y una tabla reconocida no se convierten en imagen: siguen siendo editables.
88. Un subrayado o la raya para responder no disparan la detección de dibujo.
89. Cada recorte ofrece «Como texto» / «Como imagen» en el panel de revisión, y lo elegido manda sobre lo detectado.
90. Un recorte marcado como imagen deja de aparecer en la oferta de OCR.
91. Hay cuatro caminos de creación: no existe ya uno para «con ayuda de la IA» aparte de la tabla de especificaciones.
92. Los caminos van en filas agrupadas en dos bloques —«empezar a escribir» y «partir del currículo»—, sin iconos y sin fondo de color; los dos que consumen tokens lo dicen.
93. «A partir de tabla de especificaciones» y «a partir de la situación del curso» abren una pantalla propia —no un panel bajo las filas, y no el editor—, con su miga de pan y un Volver.
94. La tabla tiene dos pestañas, Objetivos y Habilidades; cambiar de una a otra no borra lo pedido en la otra, y cada rótulo lleva la cuenta de lo pedido ahí.
95. La fila «Cualquiera del nivel» va primera en Objetivos y no aparece en Habilidades; ofrece el banco del nivel entero, no entra en las cuentas del currículo y «Proponer» no la llena.
96. Lo pedido en esa fila llega con un objetivo distinto por pregunta, tomado del catálogo del nivel: ninguna entra sin categorizar, y el enunciado dice que el objetivo lo eligió la plataforma.
97. «Proponer» no borra lo pedido a mano en el comodín ni en los objetivos propios.
98. Los objetivos propios del colegio aparecen después del currículo, con su logro en el camino del curso, sin entrar en las cuentas del nivel. Agregar uno casi igual a uno existente usa el existente y lo avisa.
99. En el cajón, «+ Objetivo propio» agrega una tarjeta de tipo y texto, sin nivel, eje ni indicador, que ofrece los que el colegio ya usa. Un texto que sólo difiere en mayúsculas, tildes, espacios o punto final queda escrito como el existente.
100. Una pregunta con sólo un objetivo propio de tipo objetivo cuenta como categorizada; en la tabla de especificaciones es una fila que se lleva su parte del puntaje, y los puntos siguen sumando el total. Las habilidades y actitudes propias van aparte, sin puntaje.
101. La valoración elegida se ve de lejos: amarillo el pulgar arriba, rojo el pulgar abajo, el otro apagado, y el rótulo dice en palabras lo mismo que el color.
102. Un texto compartido se imprime una sola vez, antes de sus preguntas, con el rótulo «responde las preguntas N a M» armado solo.
103. Las preguntas de un recurso quedan siempre contiguas y detrás de él: meter una la mueve a ella junto al bloque, no mueve el bloque hacia ella.
104. El rótulo del rango se actualiza al agregar, sacar o reordenar preguntas.
105. Al paginar, el recurso no queda separado de su primera pregunta por un salto de hoja.
106. Separar el recurso deja las preguntas y borra el texto, avisando antes; borrar la última pregunta de un recurso avisa que el texto se va con ella.
107. La prueba guardada deja el bloque declarado, para que quien la baraje al asignarla baraje bloques y nunca deje una pregunta antes de su recurso.
108. Elegido un curso, se avisa cuántos de sus alumnos están en el PIE, separando permanentes de transitorias, y cada diagnóstico trae su adecuación.
109. Los alumnos del PIE van marcados en el listado de búsqueda y en su ficha una vez elegidos.
110. Con alumnos elegidos el aviso habla de ellos; si ninguno es del PIE lo dice, sin dejar de recordar que el curso sí tiene.
111. Un curso sin alumnos PIE también lo dice: el silencio se lee como «no se comprobó».
112. Proponer rehace sólo la pestaña que se está mirando.
113. Hay un reparto por tipo de pregunta; la cuenta que tiene que calzar es la de las generadas por IA, no el total, y se rehace sola al cambiar las cantidades.
114. Las preguntas creadas respetan el reparto por tipo y salen intercaladas.
115. El Excel de UTP se importa desde esta pantalla y llena la tabla; lo que no calza con el catálogo del nivel se dice, no se descarta en silencio.
116. Sin curso, la tabla no muestra las columnas de logro ni el selector de curso, y queda en el orden del currículo.
117. Con curso, sólo se ofrecen los cursos del nivel elegido arriba.
118. Cada pantalla muestra su propio título: la tabla de especificaciones no se anuncia como «la situación del curso».
119. Un clic sobre las casillas del alumno en la hoja abre el modal que las configura.
120. Se puede ocultar una casilla sin perderla, agregar una del catálogo de WebClass, crear una propia con el nombre que sea y reordenarlas arrastrando.
121. Las de WebClass se marcan como tales y no se pueden borrar, sólo ocultar; las propias sí.
122. Con más de tres casillas visibles la ficha pasa a dos filas.
123. Deshacer devuelve una casilla borrada.
124. Elegir uno o varios alumnos cambia el logro de la tabla al de ellos, y el título y las migas dicen de quién es.
125. El campo de alumnos ofrece el curso completo, filtra al escribir ignorando las tildes, agrega con Enter y quita la última ficha con Retroceso.
126. Un alumno descendido muestra más objetivos bajos que el promedio de su curso; volver a «Todo el curso» restituye la tabla.
127. Cambiar de curso limpia los alumnos elegidos: son de otro curso.
128. En la tabla de especificaciones se puede cambiar de nivel y de asignatura, y lo ya pedido no se pierde: se acumula y se ve en el resumen, con lo de otro nivel marcado.
129. Una prueba con filas de dos niveles trae preguntas del banco de cada nivel, y las del nivel ajeno llegan marcadas como tales.
130. La cantidad se ajusta con botones −/+, y el origen con dos botones donde el del banco muestra cuántos items tiene.
131. El pie queda fijo abajo: el total y el botón de crear se ven sin llegar al final de la tabla.
132. La tabla trae todos los objetivos del nivel, no sólo los ya evaluados, y los nunca evaluados van primero y dicen «Nunca», no 0%.
133. El selector de origen muestra cuántos items tiene el banco de ese objetivo, y queda deshabilitado cuando tiene cero.
134. Pedir del banco más de las que hay se dice en la fila y se completa con IA; el costo cuenta sólo las de IA.
135. Proponer no pide preguntas de los objetivos ya logrados.
136. Cambiar de curso cambia el catálogo de objetivos y reinicia lo pedido; si el curso es de otro nivel, se avisa que manda el del curso.
137. Lo traído del banco entra listo y lo generado como borrador, y todo llega categorizado.
138. Guardar con dos alternativas iguales avisa, dice qué pregunta y qué texto, ofrece ir a ella y deja guardar igual.
139. Ese aviso ignora mayúsculas, etiquetas, espacios de más y el punto final, y no se dispara con las alternativas vacías.
140. También avisa de la columna B repetida en términos pareados —distractores incluidos— y de las respuestas aceptadas repetidas.
141. El banco ya no tiene búsqueda por texto del enunciado: se filtra por eje, objetivo, indicador y habilidad.
142. Cada opción del filtro dice cuántos items tiene detrás, y ninguna lleva a cero resultados.
143. Elegir un eje acota los objetivos y elegir un objetivo acota los indicadores; cambiar el de arriba suelta los de abajo.
144. Una acción de IA descuenta exactamente lo que anunció, y si el proveedor falla no descuenta nada.
145. Con tokens insuficientes se explica cuántos faltan; no hay error genérico.
146. El profesor gasta contra su cupo, no contra el total del colegio, y el saldo que se le muestra es el suyo.
147. Al agotarse el cupo se le dice que no le quedan créditos y quién se los amplía; lo que no cuesta tokens —banco, lectura de PDF, OCR— sigue funcionando.
148. La suma de los cupos repartidos no puede pasar la bolsa del colegio, y esa validación es del servidor.
149. Guardar con preguntas sin categorizar avisa qué falta, guarda igual y deja la prueba fuera del banco.
150. Cada forma generada trae su propia pauta, y la pauta de la forma A es la del orden original.
151. Intentar editar una prueba ya rendida ofrece duplicarla en vez de permitir el cambio.
152. El menú de agregar ofrece los siete tipos de WebClass, y cada uno se crea con un ejemplo utilizable, no vacío.
153. En varias correctas: marcar una segunda alternativa reparte 100 % entre las marcadas; dejar la suma en otro valor avisa bajo la pregunta y bloquea Guardar diciendo cuánto suma.
154. Escribir un porcentaje mayor que cero marca sola la alternativa como correcta, y bajarlo a cero la desmarca.
155. La pauta de una pregunta de varias correctas es un grupo de letras; la de pareados no es una letra; la de desarrollo y respuesta corta es un guión.
156. En pareados: la columna B se imprime revuelta, la clave se calcula sola y no cambia entre repintados; «Revolver B» la cambia y la clave se actualiza.
157. Agregar o quitar un par renumera la columna A y vuelve a revolver la B.
158. Un par con una columna vacía bloquea Guardar.
159. «+ distractor» agrega a la columna B una opción sin fila en la A: la B queda más larga que la A y las letras siguen correlativas.
160. El señuelo se revuelve junto con los pares —no queda fijo al final— y la clave de pantalla lo lista aparte como «sin pareja».
161. En el papel el señuelo es indistinguible de las demás opciones de la B: no se imprime su rótulo ni su botón de quitar.
162. Un señuelo sin texto bloquea Guardar; quitarlo no toca la columna A ni el puntaje de la pregunta.
163. En respuesta corta: se pueden agregar varias respuestas aceptadas con su porcentaje, y sin ninguna Guardar se bloquea.
164. Una pregunta de desarrollo nace con rúbrica: tres niveles de logro y criterios con descriptores, y cada celda muestra cuántos puntos vale.
165. La rúbrica no se dibuja sobre la hoja: es una opción del carril lateral que sólo aparece en las preguntas de desarrollo, y al pincharla se abre en un modal ancho.
166. Si los criterios no suman el puntaje de la pregunta, el modal lo dice, el carril muestra «rúbrica no suma» sin cerrar el modal, y Guardar se bloquea indicando cuánto suma. Un criterio sin nombre o una celda sin descriptor también lo bloquean.
167. Cambiar el puntaje de un criterio o el % de un nivel recalcula las celdas en el momento.
168. Un nivel nuevo entra antes del último, y todas las filas ganan su celda; quitarlo se la saca a todas.
169. Al descargar Para el estudiante la hoja sale sin rúbrica; en la Pauta de corrección aparece bajo cada pregunta de desarrollo como una tabla sin campos ni botones, y al terminar la hoja vuelve a quedar limpia.
170. La rúbrica se puede quitar y volver a poner desde el modal, sin tocar el puntaje de la pregunta, y la marca del carril pierde y recupera su ✓.
171. El generador de imágenes declara su límite antes de generar, rechaza una petición fuera de ese límite sin cobrar tokens y diciendo cuál fue el motivo.
172. Una petición válida cobra los tokens una sola vez, deja el consumo registrado, muestra la vista previa y pide revisarla antes de insertar.
173. La imagen insertada conserva el texto con que se pidió (data-peticion), lleva marca IA en el editor y no en el papel.
174. Desde la barra del editor, la imagen se inserta donde está el cursor.
175. El aviso de Guardar dice qué le falta a cada pregunta, no un texto genérico igual para todas.
176. La pantalla de creación muestra el título de la herramienta y, bajo él, el nombre del recurso con su etiqueta «Nombre:»; hacer clic en la etiqueta enfoca el campo.
177. La barra del editor ocupa una sola línea: pestañas, Opciones y Herramientas de IA al mismo nivel, sin segunda fila de menú.
178. Las cuatro opciones del encabezado se configuran dentro de Opciones, y cada cambio se ve en la hoja al instante.
179. El encabezado de la hoja no trae QR, y la insignia va a la izquierda con el título centrado respecto de la hoja.
180. La línea de datos bajo el título viene apagada; el interruptor de Opciones la enciende y muestra asignatura, nivel, tipo, cuántas preguntas y el puntaje total, una sola vez y en la primera hoja.
181. Esa línea se arma sola: agregar una pregunta cambia la cuenta y el puntaje, y cambiar la asignatura en Opciones la actualiza. No se escribe a mano.
182. Encenderla y apagarla es un cambio como cualquier otro: deshacer la repone.
183. Activar la casilla de fecha pasa la ficha a dos filas y corre los rótulos al costado izquierdo.
184. Las instrucciones se editan sobre la hoja y vacías no se imprimen, pero siguen siendo clickeables en el editor.
185. El nombre de la evaluación se edita sobre el título de la hoja, la miga de pan lo sigue, y no hay campo de nombre en la barra.
186. Un clic sobre el enunciado, sobre una alternativa o sobre las instrucciones abre el editor en un modal, con la barra de formato fija arriba del área de escritura, y el título dice qué se está editando.
187. Aplicar vuelca el texto a la hoja y repagina; Cancelar y Esc lo descartan; clic fuera equivale a Aplicar.
188. Con el editor abierto, Esc sobre un modal de fórmula, tabla o gráfico cierra sólo ese y devuelve al texto sin perderlo.
189. Los campos de una sola línea (nombre de la prueba, pares, respuestas aceptadas) se siguen escribiendo sobre la hoja, sin modal y sin barra.
190. Los cuatro botones de alineación actúan sobre la fila del cursor: alinear una no mueve a las demás, y el botón correspondiente queda hundido.
191. Una imagen del texto se alinea a izquierda, centro o derecha, y se mueve de verdad dentro de su fila. Con el cursor en un párrafo, alinear ese párrafo no mueve la imagen.
192. Se puede deshacer y rehacer con Ctrl+Z / Ctrl+Y, y el aviso dice qué se deshizo. Incluye «Revolver B», quitar una pregunta y quitar la rúbrica.
193. Una pregunta se puede duplicar —la copia entra justo debajo y con ids propios: marcar una correcta en ella no toca al original— y eliminar, con confirmación.
194. El borrador se guarda solo, se ofrece al volver con su fecha y su número de preguntas, y Guardar lo limpia.
195. Las preguntas, alternativas y pares se reordenan con el teclado desde su asa (flechas arriba/abajo), y una imagen se redimensiona con las flechas izquierda/derecha.
196. El banco filtra por nivel, asignatura, tipo y dificultad, busca por texto, muestra % de logro y las preguntas llegan ya categorizadas.
197. El generador de preguntas pide nivel, asignatura y OA, con los de la evaluación por defecto, y el catálogo de objetivos cambia al cambiar el nivel.
198. La tabla de especificaciones se descarga como planilla, con una fila por pregunta, y se abre en Excel en español sin quedar toda en una columna.
199. Un PDF escaneado ofrece reconocer el texto además de recortar a mano, no descuenta tokens —el OCR es Tesseract, no un proveedor que cobre por uso—, y lo reconocido entra marcado como borrador.
200. Una pregunta cuyas alternativas son dibujos entra como selección múltiple con cuatro imágenes, una por alternativa, con sus letras en orden y sin la figura entera duplicada. Se avisa en la lista previa.
201. Cada recorte llega sin el rótulo dibujado —la alternativa no puede decir «A)» dos veces— y ajustado a su dibujo, no al alto de la banda completa.
202. Una figura suelta no se parte en alternativas: si un trozo se lleva más de la mitad del ancho, o los blancos que separan apenas rozan el umbral, la pregunta sigue entrando con su figura entera.
203. El ensayo SIMCE de referencia entra completo: 40 de 40 preguntas con sus 4 alternativas.
204. La barra ofrece los dos caminos por separado: subir una imagen y generarla con IA.
205. Una imagen de 2000 px entra achicada a 1400, con la proporción intacta, y el aviso dice cuánto se achicó y cuánto pesa.
206. Un PNG sigue siendo PNG después de achicarse: no se le pone fondo blanco.
207. La imagen subida se redimensiona y se alinea igual que la generada.
208. Una imagen del texto se selecciona con un clic y muestra cuatro tiradores; arrastrando cualquier esquina cambia de tamaño manteniendo la proporción, con la medida a la vista.
209. El ancho máximo al que se puede estirar es el de la columna de la hoja, no el del modal: el tamaño que se ve al dimensionar es exactamente el que sale impreso.
210. No baja de 60 px ni pasa del ancho de la columna, y el tamaño sobrevive al Aplicar y sale igual en el PDF.
211. Con la imagen seleccionada, los botones de alineación la mueven y los de formato de texto quedan desactivados.
212. El HTML guardado no contiene ni el marco, ni los tiradores, ni la marca de selección.
213. Una fórmula sigue siendo reeditable: al abrir el campo y hacerle clic dentro del editor, reaparece su LaTeX original.
214. Elegir un camino de creación entra al editor sin botón «Crear»; sin nivel o asignatura avisa cuál falta.
215. La pestaña Retroalimentación ofrece los cuatro textos de la pregunta, y el de parcial aparece sólo en los tipos que reparten puntaje.
216. En verdadero o falso aparecen además los dos textos de V y de F.
217. En Retroalimentación todas las alternativas tienen campo, incluida la correcta.
218. La palabra «distractor» aparece sólo en el botón de los términos pareados —su único sentido en WebClass— y en ningún otro lugar de la interfaz.
219. El editor no tiene pestaña General ni Formas, ni interruptor de «marcar respuesta correcta», ni icono de usuario. Nivel, asignatura y tipo viven en Opciones.
220. Cambiar el nivel o la asignatura desde Opciones no borra ninguna categorización, y avisa cuántas preguntas quedaron con objetivos ajenos; volver al valor original apaga el aviso.
221. Cambiar el tipo de evaluación no toca la categorización.
222. El editor no pide ni muestra la exigencia, y el resumen dice que el puntaje del 4,0 se define al asignar la prueba a un curso.
223. Descargar pregunta si el archivo lleva la clave; «para el estudiante» viene preseleccionado y el editor queda con las marcas después de generar el PDF.

11Qué hay que confirmar antes de programar

Esta lista se acorta leyendo el código del producto, no preguntando. Varios puntos que estuvieron acá ya se cerraron así —el porcentaje por alternativa, la fórmula del logro, las columnas de pregunta_atributo— y quedaron escritos en su sección. Lo que sigue acá es lo que de verdad no se puede resolver mirando: decisiones de negocio, y datos que sólo están en la base en producción.

1. Si se aprueba la rúbrica por pregunta funcionalidad nueva — es lo único de este documento que no existe hoy (§6.4). Si entra, hay que decidir tres cosas:
   • ¿La rúbrica de una pregunta se puede guardar en el banco de Rúbricas de aprendizaje para reutilizarla en otra prueba, o vive sólo dentro de la evaluación? El modelo propuesto lo permite con poner id_pregunta en NULL.
   • ¿Es obligatoria en toda pregunta de desarrollo, o se puede quitar? La maqueta la crea sola y deja quitarla: la nota la pone el profesor, no el sistema.
   • ¿La justificación de una V/F con justificación merece lo mismo? También se corrige a mano y tiene puntaje propio.
2. El logro por objetivo: sólo falta si cuentan las pruebas no validadas. La fórmula está resuelta —es EvaluacionDao::getPuntajePorAtributo, transcrita abajo— y la ventana de tiempo también: el año en curso solamente, decidido por WebClass el 23-09. Un objetivo medido hace dos años, con otra composición de curso, no dice lo mismo. Queda sólo:
   • ¿Cuentan las pruebas no validadas y los ensayos, o sólo las calificadas?
   La fórmula del logro, tal cual está en el producto

   CASE WHEN r.puntaje >= tp.puntaje THEN 1
        WHEN r.puntaje <  tp.puntaje AND r.puntaje > 0 THEN r.puntaje / tp.puntaje
        ELSE 0 END
   FROM resultados r
   JOIN test_pregunta tp     ON tp.test = r.test AND tp.pregunta = r.pregunta
   JOIN pregunta_atributo pa ON pa.pregunta = tp.pregunta
   WHERE pa.atributo = ?

   Dos cosas quedan respondidas de paso. El puntaje parcial ya existe: si el alumno obtuvo menos que el máximo, cuenta la fracción r.puntaje / tp.puntaje. Y una pregunta con dos objetivos cuenta entera en cada uno —el JOIN con pregunta_atributo produce una fila por atributo y cada una se lleva la fracción completa—, que es justo lo que este documento suponía correcto. Ya no hay que decidirlo: está decidido. Y el puntaje parcial de los términos pareados también es real: DatosTestDao acumula por cada par acertado, así que respuesta_enpareja_vinculo.puntaje sí se usa —otra pregunta que este documento tenía abierta y ya no—.

   Hay una segunda versión de la misma consulta que usa pregunta_atributo_adicional en vez de pregunta_atributo: los objetivos propios del profesor también cuentan para el logro. Ver abajo.

   Conviene además reusar la consulta del informe de aprendizaje en vez de escribir otra: dos cálculos del mismo número terminan dando distinto, y el profesor va a comparar las dos pantallas.
3. El nivel del objetivo hay que agregarlo: hoy pregunta_atributo no lo tiene. Ya no es una pregunta, es un hecho verificado en el código del producto:

   INSERT INTO pregunta_atributo (pregunta, eje, tipo, atributo)

   Cuatro columnas, sin nivel. El nivel se deduce de la prueba (prueba.sector → sector.nivel). Con varios objetivos por pregunta y de niveles distintos (§6.5.b) esa deducción deja de ser posible, así que la categorización múltiple es un cambio de modelo y no sólo de pantalla. Lo que falta decidir es cómo: una columna nivel en pregunta_atributo, o que el catálogo al que apunta atributo ya lo traiga.
4. El objetivo propio del profesor: pregunta_atributo_adicional (id, pregunta_id, tipo, caracteristica). Es el mecanismo con el que hoy se le pone a una pregunta un objetivo que no está en el catálogo: caracteristica es texto libre. Lo confirmó WebClass, y en el código se ve que cuenta para el logro igual que un objetivo del catálogo, y que se copia al duplicar una pregunta.
   Ya está incorporado, en la maqueta y en el documento: el cajón deja agregar un objetivo propio (§6.5.c) y la tabla de creación los muestra como filas (§5.2). Quedan dos cosas que el código no responde:
   • De dónde sale la lista de «ya usados»: de las preguntas del colegio, de las del profesor, o de todo WebClass. Es la misma pregunta que el banco de items (abajo), y conviene contestarlas juntas. La maqueta supone el colegio.
   • Si los tipos 1 y 2 —contenidos mínimos y aprendizajes esperados, del currículo anterior— se siguen usando en objetivos propios. La maqueta ofrece sólo 3, 4 y 7. Un select tipo, count(*) from pregunta_atributo_adicional group by tipo lo responde.
5. Si se habilita el tipo de varias correctas sin tocar el corrector. La corrección queda fuera del alcance de este gadget —decidido: el gadget crea preguntas y la aplicación sigue el camino actual de WebClass—, pero eso obliga a mirar qué hace ese camino hoy: lee el porcentaje como bandera y entrega el puntaje completo a quien marque cualquier alternativa con fracción mayor que cero (§6.3.a). Una pregunta 50/50 daría 100% por la mitad de la respuesta. O se ajusta el corrector, o no se habilita el tipo: publicarlo así es entregar notas mal calculadas en silencio.
6. La tolerancia de la respuesta corta: mayúsculas, tildes, espacios sobrantes y coma vs. punto decimal. Sin una regla escrita, el mismo alumno con la misma respuesta acierta o falla según cómo la escriba. Es la única pregunta de corrección que queda.
7. Si algún tipo está en desuso en la base de producción. Un select tipo, count(*) from pregunta group by tipo lo responde, y evita construir pantalla para algo que nadie usa hace diez años.
8. Cómo se generan los PDF con fórmulas: navegador headless o render de fórmulas a imagen desde el servidor (§6.2). Es la decisión técnica más cara de revertir de todo el gadget.
9. Las plantillas de home/importarpreguntas del repo vanilla, antes de inventar un formato de Excel nuevo.
10. Las tres preguntas de tokens que quedan abiertas en el §7: renovación o compra de la bolsa, qué pasa con el cupo no gastado, y el proveedor de IA con su acuerdo de tratamiento de datos. La bolsa ya se definió: es por colegio y la reparte el WebClass manager.
11. Si el banco de items es por establecimiento, por sostenedor o compartido con WebClass.
12. Dónde se guarda el TEXTO de un recurso compartido (§6.4.b). Verificado en el código del producto: pregunta.idrecurso apunta a archivo, o sea sirve para una imagen; para un texto falta dónde ponerlo. Hay dos salidas propuestas, y la decisión es de arquitectura. No guardarlo como archivo ni como imagen del texto.
13. Barajar por bloques: hay que escribirlo, no existe. Se buscó expresamente y en los dos lugares que rinden una prueba el barajado es plano:
    • Web — AlumnoTestDao::getPreguntasPorIdTest: con barajar encendido la consulta termina en ORDER BY rand(), sin agrupar por nada.
    • App móvil — MobileApp/Evaluations/EvaluationsController: $preguntas->shuffle(), también plano.
    Ninguno menciona idrecurso. Hay que agrupar por recurso antes de revolver —revolver los grupos entre sí y las preguntas dentro de cada grupo— en los dos. Son pocas líneas, pero sin eso la funcionalidad no sirve: con el barajado encendido el texto queda separado de sus preguntas, que es justo lo que viene a resolver.
    Si existe un tercer lugar que rinda pruebas y no esté en los repos que se revisaron, hay que mirarlo también.
14. Dónde vive la nómina PIE y cómo se relaciona con curso, y si el diagnóstico está codificado o es texto libre (§5.3). Es lo único que queda de este tema: mostrar los nombres ya está aprobado y las adecuaciones también, las dos cosas el 23-09.
15. Dónde se guardan las imágenes y su recorte (§6.2): el recorte tiene que viajar como cuatro números junto a la URL, no como una imagen nueva, para poder cambiarlo después y para que dos preguntas usen dos recortes del mismo archivo. Va con la pregunta ya abierta de dónde viven los archivos (§6.2).