Generador de unidades y clases

Armar una unidad viendo las dos cosas que importan a la vez: cómo se reparten las clases en las semanas del período, y cómo queda —exactamente— la planificación que WebClass ya imprime hoy. Con arrastre entre semanas, categorización por objetivo e indicador, y cobertura curricular que muestra qué quedó fuera.

1El formato impreso no se inventó

Este gadget no propone un documento nuevo. La pantalla reproduce el formato de planificación que WebClass ya genera —documento de referencia: la unidad «SEGUNDO BÁSICO - UNIDAD 1: Números del 0 al 100; contar y comparar», 30 clases, prof. yanett mayorga— con sus cajas de pestaña naranja, sus insignias redondas de OA y actitud, y sus recursos adjuntos en amarillo.

Es deliberado: si el editor mostrara otra cosa, el profesor no reconocería su propia planificación y habría que convencer a UTP de aceptar un formato distinto. Lo que cambia no es el documento; es que ahora se edita viéndolo.

1.1 La portada de la unidad

1.2 Cada clase

2Es el gadget 01, con otro par de tablas

La estructura es deliberadamente la misma que la del generador de evaluaciones, porque el producto es el mismo y el usuario también:

Se reusa todo lo que ya se resolvió ahí: paginación real, arrastre entre contenedores, carriles de metadatos, cajones, tokens de IA, y la regla de guardar bloqueado cuando falta algo sin lo cual el artefacto no sirve. Conviene leer esa solicitud antes que esta.

2.b Lo que el gadget 02 gana con eso

• El inicio, desarrollo y cierre de cada clase se escriben en el modal, con formato, listas, tablas e imágenes. Son los campos más largos del gadget y los que más se retocan; hasta ahora eran cajas de texto plano.
• Una clase se duplica —la siguiente suele ser la misma estructura con otro contenido—. La copia entra justo debajo, sin fecha y sin validar: una copia con la misma fecha choca con el original en el calendario, y una copia que nace «validada por UTP» es una firma que nadie puso.
• Una clase se elimina, con confirmación, y Ctrl+Z la devuelve.
• La cobertura curricular se descarga como planilla, con una fila por clase. UTP la necesita para sus informes y hasta ahora la rehacía a mano.
• Las clases se reordenan con el teclado. Con un detalle propio de este gadget: como se ordenan por fecha, mover la posición en la lista no se vería —el repintado siguiente las devuelve a su sitio—. Lo que se intercambia es la fecha y la hora con la clase vecina, que es lo que el profesor quiere decir con «esta clase va antes que la otra».

3Lo que ya existe en la base

Relevado el 2026-09-11 leyendo los modelos Eloquent de wc-laravel/app/. Las tablas ya están todas.

3.1 Lo que el formato impreso exige y hay que ubicar

El documento real muestra campos que la pantalla tiene que poder leer y escribir. Antes de programar hay que decidir dónde vive cada uno:

4Quién lo usa

5Dónde vive

En el módulo que ya existe: resources/views/planificacion/, con App\Http\Controllers\Planificacion\PlanificacionController y UnitController. Las vistas actuales montan Vue 2 en un <div id="app"> con componentes en resources/js/components/planificacion/ — o sea que el terreno para una pantalla Vue ya está preparado, a diferencia del gadget 01.

resources/views/planificacion/
├── unidad-editor.blade.php          la pantalla nueva
resources/js/components/planificacion/
├── Calendario.vue                   semanas + arrastre
├── Planificacion.vue                la hoja paginada
├── Cobertura.vue                    la tabla que se arma sola
└── CajonClase.vue                   objetivos, momentos, datos y recursos

Ya existe la entrada .js('resources/js/planificacion.js', 'public/js') en webpack.mix.js: no hay que agregar ninguna.

6Pantalla 1 — Crear la unidad

Arriba el contexto: nivel, asignatura, curso, período (desde / hasta) y horas semanales. El período es obligatorio — sin él no hay calendario que dibujar — y las horas semanales son lo que después permite avisar que una semana está sobrecargada.

7Pantalla 2 — El editor

7.1 Cuatro pestañas, porque son cuatro preguntas distintas

Las cuatro son la misma data. Mover una clase en el calendario cambia su lugar en la planificación; destildar un OA en General lo saca de la portada y de la cobertura; editar un momento sobre la hoja se guarda al instante. No son cuatro documentos.

7.2 El calendario

• Una fila por semana del período, calculada desde unidad.fechaini y fechafin.
• Cada semana muestra horas usadas / horas disponibles y se pone en rojo cuando se pasa. Es la señal que hoy no existe en ninguna parte: el profesor se entera de que no le alcanzan las horas cuando ya va tarde.
• Las clases se arrastran entre semanas. Al soltar, la fecha se recalcula: se conserva el día de la semana si ya lo tenía; si no, se reparte de lunes en adelante. Nunca cae sábado o domingo.
• Hay una bandeja de «sin fecha» arriba, que aparece sólo si hay alguna. De ahí se arrastran a una semana.
• El título se edita en la propia tarjeta, y las horas con un selector.
• Cada tarjeta lleva sus etiquetas de lo que falta: «sin objetivo», «sin fecha», «sin hora de término», «sin validar», «borrador IA». El borde izquierdo cambia de color según el caso.

7.3 La planificación impresa

Igual que la hoja del gadget 01: hojas de verdad, paginadas, cada una a escala real con su número al pie, y el mismo corte que tendrá el PDF.

• En Opciones: tipo de hoja, orientación, márgenes, ver saltos de página, y un interruptor para imprimir sin los momentos — la versión resumida que suele pedir UTP.
• El texto de cada momento y su tiempo en minutos se editan en el lugar, sobre la hoja.

7.4 Cobertura curricular

La tabla se arma sola con lo categorizado, igual que la de especificaciones. Pero con una diferencia que es el punto entero de la pestaña:

7.5 El cajón de la clase

Cambiar el OA vacía los indicadores y vuelve a ofrecer sólo los del OA nuevo: dejar los viejos sería peor que no tener ninguno. Cambiar la duración o la hora de inicio recalcula la hora de término, que es la raíz del defecto del §1.

8Herramientas de IA

Misma bolsa de tokens del gadget 01, mismas reglas (costo visible antes de gastar, consumo auditado por usuario, todo lo generado nace como borrador).

«Redistribuir» no usa IA — es un reparto aritmético por horas. Va en el cajón por comodidad, pero no cobra y lo dice: cobrar tokens por algo que es un bucle es el tipo de cosa que erosiona la confianza en el resto.

9Guardar y descargar

Mismo patrón del gadget 01, con dos niveles:

Descargar exige estar guardado, con la misma lógica y el mismo «Guardar y descargar» en un paso. Formatos: PDF de la unidad, PDF de una clase, Word editable y planilla de cobertura.

10Fuera de alcance

• El libro de clases y el registro de lo efectivamente realizado (clase_registro / LessonRegistration). Esta pantalla planifica; el registro es otra cosa y ya existe.
• El flujo de validación de UTP (solicitar, aprobar, rechazar con observaciones). Acá sólo se muestra y se edita el campo «Validado por».
• La adecuación PIE de cada clase, que tiene su propio módulo y sus propias tablas.
• La biblioteca de recursos: acá se listan y se nombran, pero subirlos y versionarlos es otro módulo.
• El cruce entre la cobertura de la unidad y la tabla de especificaciones de la prueba (§7.5).
• Compartir clases entre profesores: se decidió que se duplican (§3).

11Criterios de aceptación

1. Sin período no se puede llegar al editor.
2. La portada reproduce el documento real: dos tarjetas de cabecera, las cinco cajas y los OA agrupados por eje con su insignia.
3. La caja de actitudes imprime una actitud por línea con su letra, y en ningún caso la palabra Array.
4. Cada clase muestra Hora inicio y Hora término, y cambiar la duración o la hora de inicio recalcula la de término.
5. El calendario muestra una fila por semana del período y las fechas correctas.
6. Arrastrar una clase a otra semana cambia su fecha, y el cambio se ve en la planificación y en la cobertura.
7. Una clase arrastrada nunca queda en sábado o domingo.
8. Una semana con más horas de clase que las disponibles se marca.
9. El número de hojas de la planificación es igual al del PDF, cada clase empieza en hoja nueva y ninguna pieza se parte entre páginas.
10. Cambiar a horizontal repagina y el PDF sale apaisado.
11. Apagar «imprimir los momentos» produce la versión resumida, reduce el número de hojas y el PDF lo respeta.
12. Destildar un OA en General lo saca de la portada y de la cobertura.
13. La cobertura lista los OA y los indicadores sin cubrir, no sólo los cubiertos.
14. Al cambiar el OA de una clase, los indicadores quedan vacíos y sólo ofrece los del OA nuevo.
15. Guardar con una clase sin fecha, fuera del período o sin hora de término se bloquea, dice cuál es y lleva hasta ella.
16. Duplicar una unidad corre todas las fechas al período nuevo y no altera la original.
17. El inicio, desarrollo y cierre de una clase se escriben en un modal con la barra de formato fija arriba, y aceptan negrita, listas, tablas e imágenes.
18. Los cuatro botones de alineación actúan sobre la fila del cursor, y una imagen se alinea y se mueve de verdad dentro de su fila.
19. Una imagen se sube o se genera con IA, se redimensiona tirando de una esquina manteniendo la proporción, y el HTML guardado no contiene ni el marco ni los tiradores.
20. Una imagen de 2000 px entra achicada a 1400, y el aviso dice cuánto se achicó y cuánto pesa.
21. El generador de imágenes declara su límite antes de generar y rechaza lo que queda fuera sin cobrar tokens.
22. Se puede deshacer y rehacer con Ctrl+Z / Ctrl+Y, y el aviso dice qué se deshizo.
23. Una clase se duplica —la copia entra justo debajo, sin fecha y sin validar— y se elimina con confirmación; ambas se deshacen.
24. El borrador se guarda solo y se ofrece al volver, con su fecha y su número de clases.
25. Las clases se reordenan con el teclado desde su asa, intercambiando la fecha con la vecina —mover la posición sin tocar la fecha no se vería, porque el calendario ordena por fecha—.
26. La cobertura curricular se descarga como planilla, con una fila por clase, y se abre en Excel en español sin quedar toda en una columna.

12Qué hay que confirmar antes de programar

1. Las columnas de clase_detalle, leyendo la base: es dónde van inicio, desarrollo y cierre, y de eso depende si hay que agregar los tiempos y los prerrequisitos.
2. Dónde se guarda la hora de inicio y término, y por qué la de término queda en 00:00. Es el defecto del §1 y hay que ver si el arreglo es de datos, de formulario o de ambos.
3. Dónde se imprime Array en la plantilla de la clase: es un solo echo y arregla todas las páginas.
4. Qué son los tipos de atributo [3,4,5,7,9,16] que filtra AttributeType::attributeList(). Deberían estar ahí el OA, la habilidad y la actitud.
5. De dónde sale la letra de la actitud (B, C, D): si está en el catálogo o se arma en la vista.
6. Cómo se relacionan sector y asignatura, y si unidad.curso nulo significa «todos los cursos del nivel» — el código de Unit::getPlanUnitsBySchoolAndSector lo sugiere, porque trata el caso -1 con whereNull('unidad.curso').
7. De dónde salen las horas semanales de la asignatura por curso: si están en el horario del establecimiento, no hay que pedirlas a mano — y de paso sale la hora de inicio real de cada bloque.
8. Si el año escolar se filtra por year(from_unixtime(fechaini)), como hace hoy Unit: eso significa que las fechas se guardan como timestamp Unix, no como date. Conviene confirmarlo antes de escribir cualquier consulta.
9. Qué es exactamente «Validado por»: texto libre, nombre de usuario o estado con flujo. En el documento real conviven «Currículum WebClass» y el nombre de una persona.