# Ficha técnica maestra · Plantillas Course Factory (VIC 5)

Documento vivo para Sergio / arquitecto instruccional.  
Fuente de límites de palabras (pantallas clásicas): `apps/player/src/runtime/content-limits.ts`.  
Plantillas VIC 5 (EXPLICACIÓN / ENUMERACIÓN / EXPLORACIÓN / COMPARACIÓN / INFOGRAFÍA / MULTIMEDIA): límites orientativos de layout; si no cabe, **dividir unidad** o pedir plantilla nueva — nunca forzar ni inventar hechos.

Paleta: `#0083FF` / `#FFFFFF` / `#00277B` / `#53647B`. Frame fijo `100dvh` sin scroll de documento.

Reglas duras de selección (Sergio 2026-09-20):
1. Elegir por **estructura cognitiva**, no por proximidad semántica, estética o disponibilidad.
2. No forzar contenido: si no cabe → otra plantilla / dividir / pedir plantilla nueva.
3. Antes de generar: (1) qué enseña (2) qué debe recordar el alumno (3) estructura de la info (4) interacción/visual de valor (5) plantilla.
4. Tras elegir: verificar cantidad, longitud, nº elementos, jerarquía vs esta ficha.
5. Nunca añadir info factual no presente en la fuente (salvo petición expresa); sí reorganizar/sintetizar/reformular preservando significado.

---

## Estructurales / intro

| Plantilla | Función pedagógica | Estructura | Máx. elementos | Límites | Acepta | Rechaza | Correcto | Incorrecto |
|---|---|---|---|---|---|---|---|---|
| **CourseCover** | Orientar; puerta de entrada | título + CTA (+ fondo opcional) | 1 CTA | título corto (~12–20 palabras) | nombre de curso, CTA “COMENZAR” | objetivos largos, listas | Portada con pulse CTA | Portada con párrafos de teoría |
| **CourseHelp** | Enseñar a usar el runtime | intro + N tips/pasos con callouts | tip. 3–5 tips | tip corto; caben en 100dvh móvil | navegación, iconos, controles | contenido de materia | Tips de UI | Explicar IA en Help |
| **CourseIndex** | Mapa del curso | módulos/submódulos | tip. ≤6 módulos visibles | títulos cortos | estructura real del curso | texto teórico | Índice navegable | Párrafos en el índice |
| **LearningObjectives** | Declarar qué sabrá hacer | objetivos + scope + imagen | tip. 3–5 objetivos | ~18 palabras/objetivo | verbos observables | teoría sin verbo | “Identificar X” | Ensayo en un objetivo |
| **ModuleCover** | Abrir un módulo | nº + título + imagen | 1 módulo | títulos cortos | hito de módulo | contenido completo del módulo | Portada 1.1 | Toda la teoría en portada |
| **SubmoduleCover** | Abrir subapartado | nº módulo/sub + título | 1 | títulos cortos | hito 1.1 | listas largas | Portada 1.1 | Índice completo |
| **CourseContract** | Contrato pedagógico | promesa + objetivos + duración + criterio | ≤4 objetivos | título ≤12; promesa ≤35; obj ≤18 | compromiso claro | detalle técnico | Contrato corto | Contrato = temario |

---

## EXPLICACIÓN (enseñar idea / conceptos)

| Plantilla | Función | Estructura | Máx. | Límites orientativos | Acepta | Rechaza | ✓ | ✗ |
|---|---|---|---|---|---|---|---|---|
| **ExplicacionTextoImagen** | Una idea + apoyo visual | title, subtitle, body, image | 1 cuerpo | body ~40–90 palabras | definición, tesis | listas largas, tablas | Tesis + imagen | 8 bullets densos |
| **ExplicacionDosColumnas** | Dos bloques paralelos | title, subtitle, 2 columns, bg | 2 columnas | ~40–60 palabras/col | contraste A/B | 5+ columnas | Dos ideas cara a cara | Cronología |
| **ExplicacionDescripcionImagen** | Imagen protagonista + pie | title, subtitle, lead, image, caption | 1 lead | lead ≤~80; caption ≤25 | describir evidencia | procedimiento | Foto + qué mirar | Decálogo |
| **ExplicacionDosConceptos** | Dos conceptos simétricos | image + 2 concepts | 2 | título+texto cortos | par conceptual | N>2 | A vs B | Glosario de 10 |
| **ExplicacionTresColumnas** | Tres conceptos | image + 3 concepts | 3 | cortos | triada | N≠3 | Tres pilares | Proceso de 8 pasos |
| **ExplicacionCuatroColumnas** | Cuatro conceptos | image + 4 concepts | 4 | muy cortos | cuaterna | N≠4 | Cuatro capas | Ensayo |
| **ExplicacionAmpliarInfo** | Revelar detalle (flip) | title, body + reveal* + image | 1 reveal | body corto; reveal sintetizado | “saber más” | evaluación | Flip dos flechas | Quiz en Ampliar |
| **ExplicacionBloquesInfo** | Varios bloques de info | title, image, blocks[] | tip. 3–5 bloques | bloque corto | secciones del mismo tema | timeline | Bloques temáticos | Hotspots espaciales |

---

## ENUMERACIÓN (secuencia / lista)

| Plantilla | Función | Estructura | Máx. | Límites | Acepta | Rechaza | ✓ | ✗ |
|---|---|---|---|---|---|---|---|---|
| **EnumeracionDecalogo** | Pasos numerados + foto | title, steps[], image | tip. 5–10 pasos | paso corto | procedimiento | comparación | Decálogo 1…n | Pros/contras |
| **EnumeracionListaBullets** | Lista no ordenada crítica | title, items[], image | tip. 4–8 | ítem corto | checklist | causalidad temporal | Bullet de requisitos | Línea de tiempo |
| **EnumeracionTimeline** | Hitos en el tiempo | title, milestones[], bg | tip. 4–7 | evento+nota cortos | evolución histórica | decisión | 2010→2024 | Clasificar categorías |

---

## EXPLORACIÓN (descubrir / localizar)

| Plantilla | Función | Estructura | Máx. | Límites | Acepta | Rechaza | ✓ | ✗ |
|---|---|---|---|---|---|---|---|---|
| **ExploracionUnElemento** | Un foco exploratorio | title, 1 item | 1 | corto | un concepto a explorar | N>1 | Un hallazgo | Decálogo |
| **ExploracionTresElementos** | Tres focos | 3 items | 3 | | | N≠3 | | |
| **ExploracionCuatroElementos** | Cuatro focos | 4 | 4 | | | N≠4 | | |
| **ExploracionSeisElementos** | Seis focos | 6 | 6 | textos muy cortos | | N≠6 | | |
| **ExploracionOchoElementos** | Ocho focos | 8 | 8 | microcopy | | N≠8 | | |
| **ExploracionSabiasQue** | Dato sorprendente | prompt, factTitle, fact, image | 1 hecho | fact corto | curiosidad | evaluación | Sabías que… | Pregunta de test |
| **ExploracionHotspots** | Localizar en imagen | image + hotspots[] | tip. ≤7 | label+desc ≤45 pal. | espacial | solo texto | Hotspots en diagrama | Párrafo sin imagen |

---

## COMPARACIÓN

| Plantilla | Función | Estructura | Máx. | Notas VIC 5 | Acepta | Rechaza |
|---|---|---|---|---|---|---|
| **ComparacionProsContras** | Valorar a favor/en contra | pros[], cons[] | tip. 3–5/lado | degradado full-slide, blanco ~50% | trade-offs | timeline |
| **ComparacionDosElementos** | Dos alternativas | left, right | 2 | | A vs B | N>2 |
| **ComparacionMultiplesElementos** | Varias alternativas | items[] | tip. 3–5 | | multi-opción | procedimiento |
| **ComparacionCuadrosResumen** | Cuadro resumen tabular | columns[] + rows[].cells[] | 2–3 cols, 1–10 filas | header #00277B, zebra, rounded | síntesis modular | pros/contras interactivo |

---

## INFOGRAFÍAS

| Plantilla | Función | Estructura | Máx. | Acepta | Rechaza |
|---|---|---|---|---|---|
| **InfografiaJerarquica** | Jerarquía de conceptos | items anidados | tip. 3–6 | árbol | diálogo |
| **InfografiaGraficoCircular** | Partes de un todo | slices[] | tip. 3–6 | proporciones | pasos |
| **InfografiaIndicadorPorcentajes** | KPIs / % | rows[] | tip. 3–5 | métricas | narrativa larga |

---

## MULTIMEDIA

| Plantilla | Función | Estructura | Notas | Acepta | Rechaza |
|---|---|---|---|---|---|
| **MultimediaVideoInteractivo** | Vídeo + info/quiz en timeline | markers + opciones | portrait avatar si aplica | checkpoint en vídeo | solo texto |
| **MultimediaVideo** | Vídeo expositivo | title, body, video | | narración | test multi-ítem |
| **MultimediaAudio** | Audio + captions | audio, captions | | podcast corto | imagen espacial |

---

## EJERCICIOS / TEST (practicar / evaluar)

| Plantilla | Función | Límites (content-limits) | Acepta | Rechaza |
|---|---|---|---|---|
| **DecisionScenario** | Decisión local | contexto ≤90; opción ≤22; feedback ≤70 | escenario + 2–4 opciones | teoría pura |
| **DialoguePractice** | Ensayo conversacional | turno ≤55; respuesta ≤75 | role-play | infografía |
| **ClassifyAndSort** | Clasificar | ítem ≤16 | categorías | timeline |
| **SequenceBuilder** | Ordenar | label ≤20 | procedimiento a ordenar | pros/contras |
| **InteractiveVideoCheckpoint** | Checkpoint en vídeo | prompt ≤45; opción ≤22 | vídeo + pregunta | sin vídeo |
| **KnowledgeCheck** | Comprobación corta | pregunta ≤55; opción ≤22; feedback ≤70 | 1 pregunta | evaluación final larga |
| **AssessmentAndTransfer** | Evaluación + transferencia | feedback final ≤120 | multi-ítem + compromiso | una sola idea teórica |

---

## Plantillas clásicas aún en schema (legado del piloto 1.1)

Pueden seguir en cursos existentes; al **remapear** preferir equivalentes VIC 5 cuando la estructura cognitiva lo permita:

| Legado | Preferir VIC 5 si… |
|---|---|
| NarratedConcept | ExplicacionTextoImagen / AmpliarInfo |
| TextVisualSplit | ExplicacionTextoImagen / DescripcionImagen |
| StoryEvidence | ExplicacionBloquesInfo / TextoImagen |
| ProcessWalkthrough | EnumeracionDecalogo / ListaBullets |
| TimelineCause | EnumeracionTimeline |
| ComparisonWorkspace | ComparacionProsContras / Dos / Múltiples |
| AnnotatedVisual | ExploracionHotspots |

---

## Changelog

| Fecha | Cambio |
|---|---|
| 2026-09-20 | Primera versión maestra a petición de Sergio (ficha + reglas de arquitecto). |