- Qué es
Entorno reproducible, dos tipos de cuenta independientes, consentimiento parental, y la capa de abstracción del proveedor de modelo.
- Pantallas
Registro, ingreso, recuperación, selección de tipo de cuenta.
- Aceptación
Un docente y un alumno se registran por separado, sin institución de por medio. Un docente puede pertenecer a una organización sin que eso cambie de qué cuelgan sus materias ni con qué se vincula la inscripción del alumno. Un menor no completa el registro sin consentimiento con fecha, adulto y versión de política. Y existe escrito el protocolo ante una señal de riesgo —qué responde el sistema, a qué adulto escala, en qué plazo y qué queda registrado (O6 del 03, I15)—: sin eso M0 no está terminado, porque desde la fase 1 hay menores conversando con el tutor. Ninguna llamada al modelo fuera de la capa propia. El entorno levanta con un comando.
- Depende de
Nada.
01 — Cómo usarlo
Qué hacer cuando aparece una duda
Este documento existe para una cosa: que nadie tenga que reconstruir de memoria una decisión a mitad de un sprint. Cuando aparezca una duda:
- Si es sobre una regla estructural —dónde cuelga algo, qué puede escribir la IA, qué se cita— está en la sección 03. Esas no se discuten mientras se codea.
- Si es sobre alcance —“¿esto lo hacemos ahora?”— está en los módulos o en qué queda para después.
- Si es una decisión que efectivamente no está tomada, está listada en la sección 08 con su forma de cerrarse. No se resuelve improvisando: se corre la prueba que corresponde.
- Si no está en ninguna de las tres, es una decisión nueva. Se anota, se decide en equipo, y se agrega acá.
El resto de los documentos. El 03 tiene la competencia, las obligaciones con menores y los controles de calidad de las respuestas. El 04 tiene el porqué de cada elección técnica y el detalle de arquitectura. El 07 tiene el producto entero y las fases. Este es el operativo: qué se construye y con qué reglas.
02 — Stack
Cerrado
| Capa | Elección |
|---|---|
| Front | Next.js + TypeScript, Tailwind y shadcn, en Vercel |
| Puerta de entrada | Server Actions de Next, que llaman a los servicios |
| Backend | Hono sobre Cloudflare Workers |
| Worker de ingesta | Fuera de Workers: 128 MB no alcanzan. Con qué tamaño todavía no está cerrado — sale de T2: si el parseo va por API el worker es liviano, si es autohospedado necesita varios GB |
| Base | Neon PostgreSQL sa-east-1 + pgvector |
| ORM | Drizzle |
| Archivos | Cloudflare R2 |
| Cola | Cloudflare Queues |
| Identidad | Clerk — sólo nombre, apellido y email |
| Autorización | Base propia |
| Modelos | Detrás de una capa propia, con un contrato por caso de uso |
| Observabilidad | Errores, trazas y logs estructurados desde el día uno |
Dos deployables, cuatro procesos
APP NEXT (Vercel)
front + Server Actions
SERVICIO BACKEND (Hono / Workers)
├─ API HTTP tutor, RAG, reportes, CRUD
├─ consumer psicopedagogo, asíncrono
└─ API de ingesta crea el trabajo, informa estado
│
▼
WORKER DE PARSEO fuera de Workers: 128 MB no alcanzan03 — Las invariantes
Lo que no se negocia mientras se codea
Cada una está acá porque romperla sale caro y porque es fácil romperla sin darse cuenta. Si algo del código las contradice, el error está en el código. Las cinco primeras no describen el esquema —las tablas y sus campos se definen módulo por módulo— sino de qué cuelga cada cosa, que es lo que después no se cambia sin migrar.
Modelo de datos
El perfil de aprendizaje cuelga del alumno, nunca del examen
Si se reinicia con cada parcial se pierde la acumulación, que es la única ventaja que no se compra. Y el esquema se diseña para durar años, no un cuatrimestre: cruza materias, sobrevive el cambio de nivel y admite que un concepto aprendido en 2026 se lea como prerrequisito de otro en 2028. Es la decisión D6, y se toma antes de M1 porque después es una migración sobre el histórico — es decir, sobre el activo.
La inscripción vincula alumno con examen, nunca con institución
Modelarlo como pertenencia a un colegio convierte el campus futuro en una migración.
El dominio se estima por concepto del grafo, no por tema suelto
Es lo que permite que una debilidad arrastre a los conceptos que dependen de ella.
El porcentaje de preparación es derivado, nunca un campo editable
Se calcula del perfil. Guardarlo como número invita a que se desincronice de la fuente de verdad.
El identificador de Clerk es una columna; el resto del sistema usa el id propio
Nada fuera de la capa de autenticación conoce un id de Clerk. Es lo que hace reversible esa decisión.
Contenido y respuestas
Nada llega al alumno sin aprobación del docente
Unidades, grafo y artefactos pasan por la cola de revisión. Es el pilar del producto.
En modo clase, toda afirmación cita un fragmento abrible
Con documento, sección y página. Sin cita verificable el sello del docente no vale nada.
Sin respaldo, se dice — nunca se completa con conocimiento general
“Esto no está en la bibliografía de este examen”, con la opción de pasar a modo libre.
El recorte por examen es un filtro en la consulta, no un reordenamiento
Un fragmento de otra materia no debe poder aparecer nunca, ni en último lugar.
El material de alumnos nunca entra al RAG del examen, ni al de otro alumno
Vive en modo libre. Si un docente lo quiere oficial, pasa por la cola de revisión. Y el índice de cada alumno es suyo: recupera sobre el material aprobado del examen más el que subió él, nunca sobre el de un compañero. Es el mismo filtro duro de I9, aplicado por cuenta además de por examen — y sin él, un alumno le sirve sus errores a otro con la autoridad del sistema.
En modo clase, resolver el ejercicio es una falla, no un éxito
Las instrucciones del tutor lo tratan como error, y la evaluación lo mide. En modo libre no rige: ahí el alumno puede pedir explícitamente la resolución y recibirla con el procedimiento a la vista. Dos condiciones para que eso no vacíe la regla: el cambio de modo es un acto del alumno y siempre visible (C2), y lo resuelto no cuenta como dominio — al perfil entra que pidió la respuesta, no que supo el tema.
Un formato derivado no agrega contenido nuevo
Podcast, juegos y tarjetas del feed se arman desde artefactos ya aprobados. Cambiar el formato no reabre el contenido — si no, el sello del docente se evade por la puerta de atrás.
Datos personales
La IA nunca califica
No escribe en ningún campo que determine nota, promoción o clasificación del alumno.
Un menor no completa el registro sin consentimiento parental registrado
Como entidad con quién, cuándo y sobre qué versión de la política. No un booleano.
Lo personal del alumno no va al reporte a la familia
Uso y progreso sí. Conversaciones no. La única excepción es una señal de riesgo, por protocolo.
El borrado ocurre en la base propia y en Clerk, y queda registrado
Borrado real y en cascada, no un campo de baja lógica.
El audio de una clase lo sube quien la dio
Nunca el alumno. Es lo que resuelve el consentimiento del docente grabado y de los chicos que hablan en el aula.
Código y costo
El prompt no crece con el uso
El perfil se lee resumido y la recuperación es acotada. Con el modelo de gama media, es la diferencia entre US$ 0,46 y US$ 2,71 por alumno por examen — casi seis veces, por una decisión de prompt.
Lo estable primero en el prompt, lo volátil al final
Instrucciones, material y perfil antes; la pregunta del alumno después. Sin ese orden el caché no sirve.
Ninguna llamada al proveedor de modelo fuera de la capa propia
Un contrato por caso de uso. Sin esto no hay comparación de modelos ni regresión de calidad.
Las Server Actions no tienen lógica de negocio
Componen vistas, manejan sesión y llaman a los servicios. No escriben en la base ni llaman al modelo.
Todo se versiona y se registra por interacción
Versión de prompt, de modelo, de parser y de grafo; fragmentos recuperados, tokens y latencia.
04 — Los módulos
Qué se construye, y cómo se sabe que está
Cada módulo trae qué es, sus pantallas, su criterio de aceptación y de qué depende. El criterio está escrito como algo demostrable con una persona adelante: si no se puede mostrar, el módulo no está terminado.
El núcleo
- Qué es
El docente crea una materia, la divide en instancias de trabajo —hoy el único tipo es el examen con fecha— y cada una en unidades. El plan, el progreso y el porcentaje de preparación cuelgan de la instancia, no del examen.
- Pantallas
Mis materias · Materia con sus exámenes · Examen con sus unidades.
- Aceptación
Un docente crea “Física II”, le agrega “Parcial 1” con fecha, y lo ve en borrador. No se puede publicar un examen con unidades sin aprobar.
- Depende de
M0.
- Qué es
Subida de PDFs y el pipeline completo por cola: parseo detrás de la interfaz, normalización, propuesta de unidades, extracción del grafo, fragmentación y embeddings.
- Pantallas
Material de la unidad: subir, listar, estado del procesamiento paso por paso.
- Aceptación
Un docente sube un PDF real y obtiene, sin intervención: unidades propuestas, un grafo de conceptos con relaciones tipadas, y cada concepto apuntando a los fragmentos donde aparece. El progreso es visible por paso. Un archivo que excede el límite se rechaza en la subida con un mensaje que explica el límite. Reprocesar dos veces no duplica nada.
- Depende de
M1.
- Qué es
La cola donde el docente aprueba, edita o rechaza — en tres capas: unidades, grafo y artefactos. Lo rechazado vuelve al pipeline con el comentario como instrucción.
- Pantallas
Tablero de revisión · Editor de unidad, de concepto y de artefacto · Vista del grafo para aprobar · Publicación con el código.
- Aceptación
El docente aprueba una unidad, corrige una relación mal extraída del grafo y rechaza un artefacto con comentario; el rechazado vuelve regenerado teniendo en cuenta ese comentario. Al publicar obtiene un código. Y el ciclo completo, desde subir hasta publicar, entra en una tarde de trabajo. Toda versión queda registrada: se puede reconstruir qué vio un alumno en una fecha dada.
- Depende de
M2.
- Qué es
El alumno entra con el código del docente. También puede crear un examen propio con material sin validar, para que el producto sirva sin docente cargado.
- Pantallas
Mis exámenes con cuenta regresiva · Sumarse con código · Crear examen propio.
- Aceptación
Un alumno se suma con un código y ve los días que faltan. Otro sin código crea la materia y estudia igual en modo libre, con el contenido visiblemente marcado como no validado.
Y de ahí sale la validación, sin venta institucional: el alumno invita a sus compañeros, y al llegar al umbral se dispara automáticamente un pedido al docente de la materia para que suba y apruebe su bibliografía. Mientras el docente no responde no se rompe nada — los alumnos siguen en modo libre —, y cuando responde, esa materia pasa a modo clase para todos los que ya estaban adentro. El umbral arranca en tres y es un número a medir, no una constante (T11). La inscripción nunca vincula con institución.
Depende de
M0, M3.
- Qué es
La pantalla central: el examen con sus unidades y el porcentaje de preparación de cada una, más el cronograma en bloques de tiempo que se recalcula.
- Pantallas
Examen por unidades · Qué toca hoy.
- Aceptación
El primer plan no es genérico: antes de emitirlo hay un diagnóstico corto —unas pocas comprobaciones sobre los conceptos raíz de la unidad— que ya mueve algo visible en el plan, y el alumno puede señalar qué cambió por su respuesta. Sin eso, el perfil recién se siente en la sesión veinte y el producto se parece a cualquier otro en la primera. Un alumno a doce días del examen recibe un plan repartido en esos doce días, con el orden respetando las relaciones
depende_dedel grafo. Si no entra tres días, el plan se reacomoda sin perder lo hecho. El porcentaje se calcula del perfil y no es editable. Este criterio es a propósito el piso: el orden sale del grafo, no del ritmo del alumno. La reasignación de bloques según cuánto le cuesta cada concepto es M18 y no entra acá — M5 tiene que poder emitir un plan el día uno, cuando el perfil todavía está vacío. No conviene sofisticar el reparto por días: M18 lo reescribe.- Depende de
M4.
- Qué es
Consumo del material aprobado de la unidad: resumen, guía y esquemas.
- Pantallas
Unidad con su material · Navegación entre unidades.
- Aceptación
Un alumno recorre una unidad completa, sale, vuelve y retoma donde quedó. El material aprobado se distingue visualmente del que subió él.
- Depende de
M5.
- Qué es
El agente profesor: recuperación filtrada por examen, respuesta con citas abribles, modo clase y modo libre.
- Pantallas
Conversación · Selector de modo siempre visible · Panel de la cita.
- Aceptación
Seis verificaciones obligatorias: (1) una pregunta cubierta recibe respuesta con cita, y la cita abre el fragmento real; (2) una no cubierta recibe “esto no está en la bibliografía” y no una respuesta inventada; (3) ante insistencia por la respuesta, guía y no resuelve; (4) el modo activo es visible siempre; (5) cada interacción queda registrada con versiones, fragmentos, tokens y latencia; (6) con dos alumnos del mismo examen que subieron material propio distinto, ninguno recibe jamás un fragmento del otro, ni en modo clase ni en modo libre (I10).
- Depende de
M2, M4.
- Qué es
El tutor decide cuándo verificar. Si el alumno falla, se clasifica el tipo de error y la explicación cambia de forma. El estado de sesión guarda las estrategias ya probadas para no repetirlas.
- Pantallas
Comprobación dentro de la conversación · Reformulación con formato distinto.
- Aceptación
Un alumno falla y la siguiente explicación cambia de forma: si la primera fue una definición, la segunda es un ejemplo o una tabla comparativa. El tipo de error queda registrado contra la taxonomía. Y el tutor nunca repite una estrategia que ya falló en esa sesión. Un observador puede señalar cuál fue el cambio.
- Depende de
M7 · y la taxonomía definida con un especialista en didáctica.
- Qué es
El agente psicopedagogo por cola: lee la sesión y escribe al perfil estructurado. Corre en paralelo a la respuesta, no bloquea, y consolida al cerrar.
- Pantallas
Mi progreso: dominio por concepto y qué falta antes de la fecha.
- Aceptación
Tras dos sesiones el perfil tiene dominio estimado por concepto y al menos un error tipificado con la estrategia que lo resolvió. Un alumno con dos materias tiene un solo perfil: un patrón detectado en una influye en la explicación de la otra. El perfil sobrevive al cierre del examen. Y por concepto queda registrado cuánto le costó llegar: intentos y tiempo hasta la primera comprobación aprobada, y con qué formato de explicación la aprobó. Es lo que M18 consume para reasignar bloques. Hoy es una columna; después de la corrida de campo es una migración sobre el histórico del perfil, que es la ventaja que ningún competidor puede copiar.
La lectura longitudinal es parte de la aceptación, no un extra, y depende de T18: hoy el grafo se extrae por materia y nada garantiza que «proporcionalidad» en Matemática y en Física sean el mismo nodo. Sin resolver esa identidad, este criterio no se puede cumplir y el perfil longitudinal queda en varias islas. Dado un concepto nuevo, el sistema recorre sus prerrequisitos en el grafo y señala cuáles el alumno tiene flojos de otra materia o de otro año, con la evidencia concreta que lo respalda —«en tus últimos cuarenta ejercicios aparecieron seis errores de proporcionalidad»— antes de empezar el tema nuevo. Eso es lo que un chat con memoria conversacional no puede hacer: no es recordar la charla, es un perfil estructurado por concepto sobre un grafo con vecinos.
Depende de
M8.
- Qué es
Lo agregado del curso: conceptos con más error, preguntas frecuentes, qué conviene repasar. Más el log completo consultable.
- Pantallas
Reporte del examen · Log de conversaciones del curso.
- Aceptación
El docente ve una frase accionable —“el 60% del curso confunde área con perímetro cuando la figura está rotada”— y no minutos de uso. Abre el log íntegro. El reporte no expone métricas por docente ni nada que un alumno haya contado de su vida. Tensión abierta con M15: un panel directivo es por definición una métrica por docente, y esta frase es lo que protege la confianza del docente. Es la decisión T17, y se cierra antes de construir M15.
- Depende de
M9.
- Qué es
El set propio de 50 a 100 preguntas reales con respuestas calificadas por un docente, y el arnés que lo corre ante cada cambio de prompt o de modelo.
- Pantallas
Ninguna de producto. Es herramienta interna.
- Aceptación
El set corre completo con un comando y reporta los seis ejes: anclaje, abstención, contención pedagógica, corrección, tono por edad y seguridad. Un cambio de prompt que degrade la contención se detecta antes de llegar a producción.
- Depende de
M7 · se construye junto con él, no después.
Después del núcleo
Los que siguen no entran en la definición de listo de la sección 06. Están especificados acá porque ya se sabe qué son y de qué dependen; cuándo se construye cada uno lo responde la sección 07 con su fase.
M12, M13 y M14 están por una razón: no requieren modelo de datos nuevo ni pipeline nuevo. Son otra salida de lo que M2 y M3 ya producen. Se construyen cuando el grafo está validado y la revisión funciona — antes no, porque los tres heredan lo que el grafo tenga de malo.
M15, M16 y M17 son los de la ampliación de alcance, y sí tocan el modelo: M15 crea la organización y sus asientos, M17 necesita un contenedor que no es el examen con fecha. Lo que las seis decisiones de la sección 05 preparan es que ese cambio sea una columna y no una migración.
M18 a M21 salieron de las notas de producto del 02/09. Tres de ellos figuran en qué queda para después —M19 es el TP grupal, M20 la voz, M21 el hub de apuntes—, con la fase en la que llega cada uno. M18 es la excepción: no está fuera de alcance, es M5 releído por el perfil.
- Qué es
El docente sube el audio de su propia clase. Se transcribe con marcas de tiempo y la transcripción entra al pipeline de ingesta como un material más: extracción de conceptos hacia el grafo, fragmentos recuperables, y un resumen de la clase generado por la IA. Todo cae en la misma cola de revisión que un PDF.
- Pantallas
Subir clase · Estado de la transcripción · Transcripción editable con marcas de tiempo · Resumen de la clase en la cola de revisión.
- Aceptación
Un docente sube una clase de cincuenta minutos y obtiene transcripción con marcas de tiempo, un resumen y conceptos propuestos, todo en la cola de revisión. Corrige un tramo mal transcripto y la corrección se propaga a los fragmentos. Una respuesta del tutor apoyada en la clase cita el minuto, y al abrirla se llega al momento exacto — igual que se abre la página de un PDF. El material queda distinguido como clase frente al PDF oficial. Y el audio lo sube el docente, nunca el alumno — I17.
- Depende de
M2, M3 · y de elegir el proveedor de transcripción (sección 08).
- Qué es
Microactividades de treinta segundos a tres minutos. La clave del diseño es que no se programa un juego por tema: el frontend tiene un conjunto acotado de mecánicas y la IA sólo genera los datos, desde el grafo. Agregar una materia no agrega trabajo de diseño.
- Pantallas
Juegos de la unidad · La mecánica en sí · Resultado que suma a la preparación.
- Aceptación
Las mecánicas del cuadro funcionan con datos generados desde el grafo de una unidad real, sin código específico de esa materia. Un juego mal generado se rechaza en la cola como cualquier artefacto — I6. Y el resultado de una partida actualiza el dominio del concepto igual que una comprobación en conversación: si no lo hace, es entretenimiento y no aprendizaje, y no vale la pena construirlo.
- Depende de
M3 · M8, para que el resultado cuente.
GameRenderer
MECÁNICAS EN EL FRONTEND DATOS DESDE EL GRAFO multiple\_choice ← conceptos y definiciones matching ← concepto ↔ definición ordering ← relaciones de secuencia fill\_blank ← enunciados con huecos classification ← conceptos y sus categorías memory · true\_false ← pares y afirmaciones flashcard ← concepto ↔ definición, de a uno simulacro ← tanda cronometrada de las anteriores
- Qué es
Dos formas de consumir lo que ya existe. El podcast de repaso es audio de la unidad generado por síntesis de voz sobre el resumen ya aprobado — para escuchar en el colectivo. El feed es la tarjeta del día: una microdosis que sale del cronograma y de los conceptos flojos del perfil, no de un azar.
- Pantallas
Reproductor de la unidad · Feed de inicio con la tarjeta del día.
- Aceptación
El podcast se arma sólo desde artefactos aprobados: no hay un modelo escribiendo guion nuevo que después se locuta sin revisar — I12. Cada tarjeta del feed se puede explicar: sale de una unidad del plan de hoy o de un concepto con dominio bajo, y se puede señalar cuál. Sin material aprobado, el feed no inventa: no muestra nada.
- Depende de
M6 para el podcast · M5 y M9 para el feed.
Ninguno de los tres genera imágenes. Los formatos visuales se escriben como texto y se dibujan en el navegador; el porqué está en qué queda para después.
- Qué es
La institución como entidad: agrupa a sus docentes y, a través de ellos, a sus materias y exámenes — nunca a las inscripciones de los alumnos (D2, I2). Encima de eso, compra de asientos, panel directivo que agrega el trabajo del colegio, y documentación de cuotas por asiento.
- Pantallas
Compra · Panel del directivo · Estado de los asientos.
- Aceptación
Un colegio compra N asientos; tres docentes de ese colegio crean sus materias y publican; el directivo ve el agregado del colegio sin métricas atribuidas a un docente ni conversaciones de alumnos. Un docente que se va del colegio conserva sus materias: la organización agrupa, no posee.
- Depende de
M10.
- Qué es
Agregaciones anónimas del curso: otros alumnos de la misma cohorte que están trabados en el mismo concepto, y un reporte del docente con los nudos del curso ordenados por frecuencia.
- Pantallas
Nudos que me traban · Nudos del curso para la clase de consulta.
- Aceptación
Las dos vías de entrada funcionan. Explícita: un alumno publica una duda o marca el párrafo que no entiende. Implícita: otro, sin publicar nada, tropieza tres veces con el mismo concepto y el sistema le ofrece enviar ese nudo al Doubtboard — y no lo envía si no acepta. Cuarenta dudas formuladas distinto sobre lo mismo se ven como un solo nudo conceptual, con el capítulo y las páginas exactas del material oficial y el porcentaje de la cohorte trabado ahí. Un alumno ve que otros de su cohorte están trabados en el mismo concepto, sin ver quiénes ni qué escribieron. El docente abre los nudos ordenados por frecuencia antes de la clase de consulta. Nada de lo que un alumno escribió se publica a otro alumno: la entrada explícita alimenta el cluster, no el muro — lo que se publica es el nudo, nunca el texto.
- Depende de
M4, M9.
- Qué es
Extensión del motor a primaria, cuya entrada no es un examen con fecha sino un nivel y un adulto responsable por registro. Material aprobado y plan de aprendizaje igual que secundaria.
- Pantallas
Sin determinar hasta cerrar T12.
- Aceptación
Sin criterio de aceptación a propósito. No se puede escribir sin responder de dónde sale el material aprobado en primaria, y dárselo inventado le daría permiso a alguien de construir sobre un supuesto que nadie tomó.
- Depende de
T12 (decisión abierta).
- Qué es
M5 reparte por grafo y por días. M18 reparte por lo que el perfil ya sabe del alumno: bloques más largos en los conceptos donde tardó más en aprobar la comprobación, el formato de explicación que le funcionó antes, y despriorización de las introducciones que ya dominó en otra materia o en otro examen.
- Pantallas
Qué toca hoy, con el porqué de cada bloque · El bloque despriorizado, visible y recuperable.
- Aceptación
Dos alumnos del mismo curso, a la misma cantidad de días del examen y con las mismas unidades, reciben cronogramas distintos, y se puede señalar en pantalla de qué evidencia del perfil salió cada diferencia. Todo bloque despriorizado queda visible con su porqué y el alumno lo recupera en un toque: despriorizar no es ocultar — un falso positivo del modelo de dominio no puede hacer que un contenido nunca aparezca. Sin perfil acumulado, M18 emite exactamente el plan de M5. Y no escribe en ningún campo que determine nota, promoción o clasificación (I13). El perfil se lee resumido, no el histórico crudo (I18).
- Depende de
M5 y M9 · y de que M9 registre intentos y tiempo por concepto.
- Qué es
La instancia de trabajo de tipo TP: consigna cargada por el docente, secciones mapeadas a subgrafos, reparto entre integrantes y avance compartido. La consigna entra por el pipeline de M2 como un documento más.
- Pantallas
TP con sus secciones · Mi sección · Avance del grupo.
- Aceptación
Un docente crea una instancia de tipo TP y cada sección queda mapeada a un subgrafo. Tres integrantes toman una sección cada uno y, al preguntar, reciben sólo los fragmentos de su subgrafo — un fragmento de otra sección no aparece nunca, con el mismo mecanismo de filtro duro que I9. El avance por sección es visible para el grupo. El plan, el progreso y el perfil cuelgan de la instancia y no del examen: si no es así, D1 no se cumplió.
- Depende de
M1 (D1), M2, M3, M7 · y T14 para el avance en vivo.
- Qué es
Oral individual y sala de voz grupal. La IA pregunta, escucha y repregunta sobre lo que se respondió. Paridad cara, con un tramo que no es paridad: la defensa grupal anclada a bibliografía validada.
- Pantallas
Simulacro oral · Sala de defensa grupal · Costo por sesión, en pantalla interna.
- Aceptación
Dos criterios. Oral individual: la IA repregunta sobre lo respondido, cada repregunta en modo clase se apoya en un fragmento abrible (I7), ante un tema no cubierto dice que no está en la bibliografía (I8), y el modo activo es perceptible. War-Room: tres integrantes exponen su TP; la IA hace al menos una repregunta cruzada por integrante anclada a la bibliografía, y al cerrar produce evidencia por integrante —qué conceptos demostró y cuáles no— que se escribe en el perfil de cada uno (I1) y en ningún campo que determine nota (I13). El grupo ve un agregado y el docente ve nudos: nunca un veredicto por alumno. Un integrante que no habló figura como sin evidencia, jamás como desaprobado. Cada sesión queda registrada con versión de modelo, latencia, tokens y costo (I22).
- Depende de
M7, M8, M19 · T13 · y el costo unitario de voz medido en la fase 2. Antes de construirlo hay que decidir consentimiento por participante y retención del audio: no rompe I17 literalmente —no es el audio de una clase— pero abre la misma superficie que I17 existe para cerrar, y con I14 de por medio.
- Qué es
Los alumnos comparten resúmenes y fichas con su comisión; los votos ordenan.
- Pantallas
Sin determinar hasta cerrar T16.
- Aceptación
Sólo la mitad que no depende de T16: el apunte aparece marcado como no validado en toda pantalla donde se muestre, vive sólo en modo libre, y es verificable en la base que el índice del examen no contiene ni un fragmento de origen alumno (I10). Qué significa exactamente «posicionar», y qué hace la votación, queda sin criterio hasta que cierre T16 — mismo precedente que M17. La votación ordena; nunca valida.
- Depende de
M3, M4, D3 · T16 · y que exista moderación.
05 — Orden de construcción
El camino, y por dónde empezar de verdad
Dependencias
M0 base
│
├─> M1 materias ─> M2 ingesta ─> M3 revisión ─┐
│ │ │
│ │ ▼
└──────────────────────> │ M4 inscripción
│ │
│ ┌──────────┼──────────┐
│ ▼ ▼ │
│ M5 plan ─> M6 estudiar │
│ │
└──────> M7 preguntar <──────────┘
│ ↕
│ M11 evaluación
▼
M8 comprobación
│
▼
M9 perfil
│
▼
M10 reporteLa secuencia recomendada no es el orden de los números: M0 → M1 → M2 → M7 + M11, cargando a mano lo que harían M3 y M4 — la aprobación del docente y la inscripción del alumno se simulan con datos sembrados hasta que existan. El riesgo mayor del proyecto no está en las pantallas sino en si la respuesta del tutor es buena y si el grafo sale bien. Cuanto antes se pueda evaluar eso, antes se sabe si vale la pena construir el resto.
M11 se construye junto con M7, nunca después. Un set de evaluación que se agrega al final se escribe para aprobar lo que ya existe.
M12, M13 y M14 quedan fuera de ese camino a propósito. No están bloqueados por falta de diseño sino por el grafo: los tres consumen conceptos y relaciones, así que construirlos antes de saber si el grafo sale bien es apostar tres módulos a un supuesto sin probar. Una vez que M3 funciona, son baratos — no agregan tablas ni pipeline.
La ampliación de alcance a instituto, colaborativo y peques no toca este camino: se paga como seis decisiones de modelo antes de M1 y siete módulos después de M10 (M15 a M21). Si el rediseño de alcance empuja T1 fuera de su lugar, se para el rediseño y se corre T1.
Las seis decisiones de modelo
Van antes de M1. Cada una es una columna o una tabla sobre un esquema que todavía no tiene datos de negocio; tomarlas después de M5 es una migración que invalida el histórico del perfil — que es, según el 03, la ventaja que ningún competidor puede copiar.
| # | Decisión | Qué prepara | Cuándo |
|---|---|---|---|
| D1 | Instancia de trabajo como la pieza de la que cuelgan plan, progreso y preparación. El examen pasa a ser su primer tipo, no la pieza misma | TP grupal y peques | Con M1. Es el punto de no retorno: si M1 cierra con el examen como pieza literal, los dos quedan detrás de una migración |
| D2 | Organización que agrupa del lado del docente y de la materia, nunca de la inscripción | Instituto, sin tocar I2 | Con M1, porque M1 crea la materia y ahí se define de qué cuelga |
| D3 | Cohorte: el conjunto de inscripciones que entró por un mismo código de publicación, como objeto con nombre | Colaborativo y el roster institucional | El principio con M1, la tabla con M4, que es donde el código ya existe |
| D4 | Nivel/registro como atributo de la materia o de la instancia, no del alumno | Peques y el eje «tono por edad» del set de evaluación | Con M1. Es una columna |
| D5 | Adulto responsable como actor con cuenta propia, no sólo como vínculo del alumno | Peques y el reporte a la familia | Con M0, porque toca accounts y su enum de tipos, hoy cerrado en teacher/student y sin datos reales |
| D6 | El perfil se acumula por concepto a lo largo de los años, con una línea de tiempo propia que no es la del examen ni la de la materia: etapa, año y nivel quedan copiados en cada pieza de evidencia en el momento en que se genera. No reemplaza a D4 —el nivel sigue siendo atributo de la materia o de la instancia— sino que lo congela en la evidencia, para que reclasificar una materia el año que viene no reescriba el historial | Que el alumno de secundario herede lo que se registró en primaria, y que un concepto de 2026 se lea como prerrequisito de otro en 2028 | Con M1. Es la que sostiene la tesis entera: si el perfil se ata al examen, no hay historial largo que heredar y el producto es un chat con memoria |
06 — Definición de listo
Cuándo está terminado el MVP
- Un docente real crea un examen, sube su bibliografía, revisa unidades, grafo y artefactos, y publica — en una sola sesión de trabajo. Si le lleva más de una tarde, el módulo está incompleto aunque funcione.
- El docente reconoce su materia en el grafo. Si el mapa de conceptos no se parece a cómo él entiende la materia, hay que replantear antes de seguir.
- Veinte alumnos reales se suman con el código y preparan el examen durante al menos dos semanas.
- El set de evaluación pasa en los seis ejes.
- La adaptación es observable: se puede señalar un caso donde el alumno falló, el error se tipificó, y la explicación siguiente cambió de forma.
- El perfil es único por alumno y sobrevive al cierre del examen.
- El porcentaje de preparación es defendible: se puede explicar de qué evidencia salió.
- El docente recibe un reporte accionable antes de la fecha, y puede auditar el log completo.
- Ningún dato de menor se procesa sin consentimiento registrado, y el borrado funciona de verdad en los dos lados.
- El costo por alumno por examen está medido, no estimado.
07 — Qué queda para después
Lo que no entra al MVP, y qué se hace con cada cosa
Casi nada está descartado. Lo que esta sección fija es el orden: qué no se toca hasta que el ciclo de la sección 06 esté cerrado.
Tener módulo no es entrar al MVP. Un módulo es una unidad de construcción ya especificada —con sus pantallas, su criterio de aceptación y sus dependencias— para que cuando le toque, nadie tenga que volver a discutir qué era. Cuándo le toca es otra pregunta, y la responde esta sección.
El MVP son los doce primeros: M0 a M11, el núcleo de la sección 04. Se corresponde con las fases 1 y 2 de la hoja de ruta y termina exactamente donde lo deja la definición de listo. De M12 en adelante, ninguno entra: empiezan en la fase 3 o más tarde, y la última columna dice en cuál. La segunda tabla es lo que no se construye en ninguna fase — dos cosas.
Los tres planes del producto son peques, adolescentes e instituciones, y no están al mismo nivel de definición. Instituciones tiene módulo y fase: M15 en la fase 4. Peques tiene módulo y ninguna fase, porque lo bloquea T12 —de dónde sale el material aprobado en primaria—. Adolescentes no tiene módulo propio: es el mismo motor vendido al alumno que llega solo, y lo que falta de T11 es medir si esa diferencia se percibe antes de usar el producto, y con cuántos alumnos conviene disparar el pedido al docente. Las filas que dicen «peques» o «instituto» son planes, no funcionalidades sueltas.
Planificado, pero no ahora
| Qué | Por qué no entra al MVP | Se construye en |
|---|---|---|
| Instituto — el colegio agrupa a sus docentes y, con ellos, sus materias y exámenes | Vender a una institución antes de que un docente solo lo use es montar el ciclo de venta sobre nada probado | Fase 4, como M15. D2 ya lo deja escrito en el modelo desde M1: agrupa del lado del docente, nunca de la inscripción, y así I2 sigue en pie |
| Doubtboard — los nudos de duda del curso | No está bloqueado por tiempo real: los nudos son una agregación por concepto sobre el perfil, no estado compartido en vivo. Tampoco lo habilita el volumen institucional — con los veinte alumnos que ya garantiza la definición de listo hay nudo, y M10 se compromete a mostrar que el 60% del curso confunde algo. Lo que lo corre es que M9 exista | Fase 5a, como M16 — y puede ir en paralelo con las fases 3 y 4: es lo que ataca el riesgo principal —que el lado docente no arranque— antes que cualquier otro módulo |
| TPs grupales | Segunda unidad de uso: necesita estado compartido y tiempo real, que es T14 sin cerrar | Fase 5b, como M19. Queda preparado desde M1 por la instancia de trabajo (D1), para que sumarlo sea un tipo nuevo y no una migración |
| Hub de apuntes de la cohorte — compartir, votar, reputación | Necesita moderación y roza el pilar del contenido validado: si un apunte de alumno entra al índice del examen se rompe I10 | Fase 5b, como M21, y no antes de que cierre T16. La votación ordena, nunca valida. Los agregados anónimos por concepto son otra cosa y ya viven en M16 |
| Voz — oral, defensa grupal, tutor por voz | Economía unitaria: la voz abierta no cierra a ningún precio que se pueda cobrar hoy. Dejó de ser un diferencial futuro —la competencia ya la tiene, así que es paridad—, pero lo que la sostiene al final es el costo, no la novedad | Fase 6, como M20, con el costo unitario medido en la fase 2 y T13 cerrado. Dentro de M20 va primero la defensa grupal: es el único tramo que no es paridad, porque lo diferencial no es hablar sino repreguntar sobre bibliografía que aprobó el docente |
| Peques — el plan de primaria, construido | El motor sirve igual: el grafo, la cita, la comprobación y el perfil no saben de nivel. Lo que no aplica es el contenedor —no hay examen con fecha ni bibliografía en PDF— y falta saber de dónde sale el material aprobado | Sin fase asignada: lo bloquea T12. El módulo está especificado como M17 y la frontera queda preparada desde M1 (instancia de trabajo, nivel, adulto responsable), pero la construcción no arranca hasta que cierre esa decisión |
| Cobro y suscripciones | El precio se fija después de la prueba empírica, no antes | Fase 7. La prueba corre en paralelo con la fase 2: sólo necesita un docente y un curso real, que existen al cerrar la fase 1 |
| App móvil nativa | Web primero: la misma pantalla en el navegador prueba lo mismo y cuesta una fracción | Fase 7 |
| Gamificación — XP, rachas, logros | Es capa de interfaz. Sin comprobación abajo premia el tiempo de pantalla, que es exactamente lo que el producto no quiere medir | Sin fase propia: es una capa encima de M8, y se agrega cuando M8 exista |
| Panel directivo a escala e integración con el campus del colegio | Ciclo de venta largo, y depende de una demanda que todavía no existe | Fase 8, cuando los pilotos traigan la demanda |
Lo que no se construye
| No entra | Por qué |
|---|---|
| Campus propio — marca, LMS, SSO, aula virtual | Los colegios ya tienen campus virtuales buenos: el nuestro competiría con el que ya usan. Integrarse con el suyo sí (fase 8); reemplazarlo no |
| Imágenes generadas como contenido pedagógico | Los formatos visuales —mapas, diagramas, líneas de tiempo, tablas comparativas, fórmulas— se escriben como texto y se dibujan en el navegador: determinístico, sin costo relevante, editable por el docente y versionable. Un modelo de imagen no da ninguna de esas cuatro cosas. Las cosméticas —portadas de feed y de podcast— sí entran, en la fase 7 |
Las alertas de bienestar salieron de esta sección. No son una funcionalidad futura: van en la fase 1, antes que la primera pantalla del producto. Ya en el MVP hay menores conversando con el tutor, y el 03 clasifica un incidente de señal de riesgo mal manejada como riesgo existencial. El protocolo escrito es condición de M0.
08 — Lo que falta decidir
Y cómo se cierra cada una
Ninguna se resuelve improvisando a mitad de un sprint. Si el código se topa con una de estas, se corre la prueba.
| # | Decisión | Cómo se cierra | Cuándo |
|---|---|---|---|
| T1 | Cómo se extrae el grafo de conceptosEl supuesto más riesgoso: siete funcionalidades dependen del resultado | Extraer el grafo de tres bibliografías reales y mostrárselo a un docente de la materia. Si no lo reconoce, replantear | Antes de M2 |
| T2 | Con qué se parsea el PDF | Tres PDF reales —uno limpio, uno con tablas, uno escaneado— por cada candidato detrás de la misma interfaz. Medir calidad, tiempo y memoria | Antes de M2 |
| T3 | Dónde corre el worker de parseo | Sale de la anterior: si es API, el worker es liviano; si es autohospedado, necesita contenedor con varios GB | Con M2 |
| T4 | Qué modelo va en cada trabajo | Correr el set de M11 sobre dos o tres candidatos por lado, comparando calidad contra costo y latencia | Con M7 |
| T5 | Modelo y dimensión de embeddings | La dimensión más chica que dé buen resultado en recuperación. Se mide con el mismo material que T2 y T6, y conviene correr las tres juntas. Ojo: 1536 ya está escrito en la tabla chunks y pgvector no permite cambiarla con un ALTER; hoy es barato porque chunks es dato derivado y re-embeber cuesta centavos, pero deja de serlo con el índice de T10 construido |
Con M2, y antes de T10 |
| T6 | Estrategia de fragmentación | Empíricamente sobre bibliografía real. Tamaño y solapamiento cambian mucho la recuperación en material académico | Con M2 |
| T7 | Cómo se calcula el dominio por concepto | Contador de aciertos y errores alcanza para el MVP. Lo que importa ahora es que el esquema soporte algo mejor sin migración | Con M9 |
| T8 | Cada cuánto corre el psicopedagogo | Arrancar por disparadores y medir si la adaptación llega tarde | Con M9 |
| T9 | Con qué se transcribe el audio de clase | Una clase real grabada con el micrófono de una notebook, no un audio de estudio: aula con eco, treinta chicos y vocabulario técnico. Se mide contra una transcripción hecha a mano de cinco minutos | Con M12 |
| T10 | Índice vectorial | Arrancar sin índice aproximado y medir. Con el filtro por examen el conjunto es chico y la búsqueda exacta suele ganar | Con M7 |
| T11 | Qué hace distinto al producto frente a subir tus propios PDFs a un chat gratuito, y si eso se percibe antes de usarlo. El mecanismo ya está definido —invitar compañeros dispara el pedido de validación al docente (M4)—; lo que falta medir es con cuántos alumnos conviene dispararlo y si la promesa se percibe antes de usar el producto | Mostrar a alumnos de un curso real dos descripciones y medir cuál eligen y qué frase citan; registrar el origen de cada inscripción; y probar el umbral con dos o tres cursos reales antes de fijarlo | Antes de comprometer nada del segmento adolescentes, y el umbral con M4 |
| T12 | De dónde sale el material aprobado en primaria | Con un docente de primaria, ver qué material existe realmente y si lo cargaría | Antes de especificar M17 |
| T13 | Proveedor de transcripción, síntesis y separación de voces | Una sesión oral real de tres personas, no un audio de estudio: dos hablando encima, micrófono de notebook, vocabulario técnico. Medir calidad de diarización, latencia de ida y vuelta y costo por minuto por participante | Antes de M20, y el costo medido durante la fase 2 |
| T14 | Infraestructura de tiempo real para el avance compartido del TP y la sala de voz | Elegir contra los dos casos de uso juntos, no contra uno. No aplica a M16, que es agregación y no estado compartido | Antes de M19 |
| T15 | Si hay plan gratis, y cuán generoso (la forma que se viene barajando son tres planes escalonados —acompañamiento diario, tutoría socrática, y sello con cátedra conectada—, hoy sin precio: son nombres, no una decisión) | Desglosar el costo por alumno en ingesta amortizada por curso contra tutor por cabeza; registrar el número concreto del plan gratis de la competencia, que hoy no está escrito en ningún lado; y la conversión que salga de la prueba empírica. Encadenada a T11: si apunta al alumno que llega solo, no se cierra antes que T11 | Con la fase 7, pero el desglose de costo se mide en la fase 2 |
| T16 | Qué hace la votación con el material de alumnos, sin romper I10 | Elegir entre las alternativas registradas —modo libre con candidatura a la cola de revisión, índice separado sólo de modo libre, el apunte como señal de cobertura, compartir sólo el nudo, o medir por uso y no por ingesta— y decidir si se abre moderación | Antes de especificar M21 |
| T17 | Qué ve el directivo sin romper la confianza del docente: un panel institucional es por definición una métrica por docente, y M10 promete que no las hay | Mostrarle a tres docentes de un mismo colegio dos versiones del panel —una con agregado por colegio y otra con corte por docente— y registrar cuál los haría dejar de cargar material | Antes de construir M15 |
| T18 | Cómo se sabe que dos conceptos de materias o años distintos son el mismo. Es prerrequisito duro de D6 y del criterio de aceptación de M9: hoy cada corrida de ingesta extrae su propio grafo y nada conecta el de Matemática con el de Física | Extraer el grafo de dos materias con solapamiento real —dos bibliografías donde el mismo concepto aparece con otro nombre— y probar los candidatos sobre eso: catálogo canónico curado, similitud por embeddings sobre nombre y definición, vinculación manual del docente en la cola de revisión, o taxonomía compartida por área. Se mide contra un listado de pares que un docente marcó a mano | Con T1, y antes de M9. La prueba de T1 hoy usa una sola materia y por eso no la cubre | | T19 | Qué sobrevive cuando se borra la cuenta de un menor. O3 pide retención definida por tipo de dato e I16 pide borrado real y en cascada; D6 necesita años de evidencia. Aplicado literalmente, el borrado se lleva el activo — y está bien que se lo lleve, porque es un derecho, pero nadie escribió si hay algo intermedio | Definir la tabla de retención por tipo de dato —conversación, evidencia del perfil, artefacto, log de auditoría— y decidir para cada uno si cae con el borrado, si sobrevive de-identificado, o si tiene plazo propio. Se cierra con asesoramiento legal, no con una prueba técnica | Antes de M9, y la tabla de retención antes de la corrida de campo | | T20 | Cómo se lee un perfil de años sin romper I18. El perfil resumido alcanza para un examen; con varias materias y varios años son cientos de conceptos y decenas de errores tipificados, y el prompt no puede crecer con el uso | Elegir el criterio de recorte —los N conceptos más flojos entre los prerrequisitos del tema, ventana de recencia, agregado por materia— y medirlo con el set de M11 sobre un perfil sintético grande, comparando calidad contra tokens | Con M9. T7 decide cómo se estima el dominio; ésta decide cómo se lee | | T21 | Con qué derecho se sube la bibliografía. El mecanismo de M4 le pide a un docente sin relación contractual que suba material con derechos de una editorial, y el sistema lo fragmenta, lo indexa y lo sirve con cita de página dentro de un producto que se cobra | Asesoramiento legal sobre qué figura ampara el uso —excepción educativa, licencia del colegio, material de autoría del propio docente, dominio público— y qué queda registrado al aprobar. Mientras no cierre, la cola de revisión pide una declaración explícita de origen y el docente puede marcar material como de su autoría | Antes de la corrida de campo con material real de una editorial | | T22 | Quién paga en peques y por qué producto. Los otros dos segmentos tienen pagador identificado; primaria no, y es el segmento del que depende la tesis de los años | Hablar con familias de primaria antes que con colegios: qué pagan hoy por apoyo escolar y qué esperarían de esto. Se corre junto con T12, que es la misma conversación | Antes de comprometer nada de peques | | T23 | Qué trae al alumno de vuelta entre exámenes. Si el uso se concentra en la semana previa, el perfil no acumula y el activo no se forma — el riesgo ya está nombrado en el 03 pero no tiene mecanismo | Medir primero: con los veinte alumnos de la definición de listo, cuántas sesiones hay fuera de la ventana del examen y qué las disparó. Recién con ese dato se diseña el contrapeso | Con la corrida de campo de la fase 2 |
Las dos primeras van antes de escribir M2, y son media tarde cada una. Cualquiera de las dos puede cambiar el diseño del pipeline, el lenguaje del worker y el proveedor — y son mucho más baratas de correr ahora que de descubrir a mitad de la implementación.
Plan de construcción · Septiembre 2026 · La fuente de verdad para el desarrollo