Plan tecnico Quaternity

Arquitectura, academia, escuela y overlays

Ruta integrada

Una sola plataforma para aprender, practicar, revisar y construir Quaternity sobre tablero.

El proyecto ya no se organiza solo por pantallas. A partir de ahora se ordena por capas: academia persistida, guia visual QCI, Escuela, overlays didacticos, progreso y, despues, motor serio de reglas.

Estado actual

La base tecnica esta avanzada; ahora toca convertirla en una academia de referencia.

  • 1. El admin ya crea, edita, clasifica y genera contenido desde Movehistory.
  • 2. `practice.html` ya valida ejercicios y guarda progreso base.
  • 3. `aprender.html` y `aprender-bloque.html` ya muestran academia persistida.
  • 4. El tablero necesita overlays didacticos y una capa Escuela.
  • 5. El motor completo de Quaternity aun no esta aislado como modulo serio.

Arquitectura objetivo

Cinco modulos tecnicos y dos capas pedagogicas.

  • 1. `motor_quaternity`: reglas, turnos, jaque, mate, absorcion, zombi, `pasa` y tablas.
  • 2. `exercise_engine`: validacion, feedback, pistas y solucion.
  • 3. `academy_content`: lecciones, ejemplos guiados, ejercicios y aperturas.
  • 4. `admin_console`: creacion, revision, aprobacion y clasificacion.
  • 5. `user_progress`: progreso por contenido y por bloque academico.
  • 6. `escuela`: lectura del tablero y simbolos base.
  • 7. `overlay_layer`: flechas, casillas, piezas y zonas marcadas.

Guia visual QCI aplicada

La academia debe parecer QCI y, a la vez, ensenar con claridad.

  • 1. Fondo principal crema `#FFF8ED` y paneles muy limpios.
  • 2. Texto principal `#212121` y acentos `#B52700`, `#526E3B`, `#DEC6A6`.
  • 3. Tipografia de UI y contenido: `Montserrat`.
  • 4. Logo y branding en cabeceras; no en overlays.
  • 5. Marca y didactica separadas: una da identidad, la otra lectura de juego.

Libro 0 y Escuela

Los simbolos del tablero ya definen la siguiente capa pedagogica.

  • 1. Casilla real atacada y casilla real libre.
  • 2. Pieza sin proteccion y pieza clavada.
  • 3. Rey en jaque y casilla de mate.
  • 4. Flecha solida, punteado y fila o columna sombreada.
  • 5. Escuela como ruta inicial para aprender a leer el tablero antes de la practica avanzada.

Orden recomendado

Orden real para continuar sin rehacer trabajo.

Paso 1

Consolidar bloques e items persistidos de academia y sembrar contenido base por bloque.

Paso 2

Aplicar la guia visual QCI a `aprender`, `aprender-bloque` y futura Escuela.

Paso 3

Definir y renderizar overlays: flechas, casillas, piezas marcadas y zonas sombreadas.

Paso 4

Crear Escuela con ejercicios de lectura visual: piezas sin proteccion y casillas reales.

Paso 5

Ampliar `academy_progress` y `user_progress` para seguimiento academico real.

Paso 6

Entrar despues en `motor_quaternity` modular, con rama `academy`, rama `game` y reglas especiales cerradas.

Lo que puedo seguir haciendo sin bloquearte

  • 1. Sembrar y ampliar contenido de Tactica, Jaque, Jaque Mate y Aperturas.
  • 2. Preparar la capa Escuela y el formato de overlays.
  • 3. Afinar la academia para que todo salga de datos persistidos.
  • 4. Diseñar la integracion de progreso academico.

Resultado esperado

  • 1. Una sola academia interactiva.
  • 2. Una sola base de contenidos.
  • 3. Una capa Escuela para aprender a leer el tablero.
  • 4. Una herramienta de practica y revision coherente con QCI.
  • 5. Una base solida para convertirse en referencia mundial de aprendizaje y juego serio de Quaternity.