Flujo de la aplicación

Este documento traza cómo se mueve un lector típico por verificaOTP, desde que llega por primera vez hasta que vuelve días después a retomar una serie. También deja un mapa de rutas como referencia rápida para quien navega el código.

Recorrido principal

entrada -> Inicio -> Serie -> Capítulo -> (80% leído) celebración -> Siguiente capítulo
                \-> Biblioteca (filtrar / buscar) -> Serie
Inicio -> "Continuar aprendiendo" -> próximo capítulo pendiente

El primer visitante llega al inicio y ve la serie destacada. Al entrar a una serie, el mapa de prerrequisitos orienta qué leer antes. En el capítulo, la lectura del 80% marca el avance; el bloque final ofrece el siguiente capítulo o, al terminar la serie, volver a la biblioteca.

Un visitante que llega desde un enlace directo a un capítulo intermedio —por ejemplo, compartido en un chat de equipo— entra igual a la vista de tres columnas, sin pasar por el inicio. El mapa de prerrequisitos de la serie sigue disponible desde la barra lateral, por si ese lector necesita retroceder a un capítulo base.

Mapa de rutas

• / — inicio.
• /biblioteca — catálogo de series.
• /serie/:slug — detalle de serie y mapa.
• /serie/:slug/:capitulo — lectura del capítulo.
• /docs y /docs/:doc — documentos del proyecto.

Estados relevantes

Sin progreso, el inicio omite «Continuar aprendiendo». Con progreso, apunta al siguiente pendiente de la última serie tocada. Las rutas inexistentes muestran una página 404 en español.

Dentro de un capítulo, el scroll-spy de la tabla de contenidos actualiza el encabezado activo a medida que el lector avanza, y ese mismo mecanismo de scroll es el que alimenta el cálculo del 80% leído: no mide tiempo en pantalla, sino posición real de lectura.

Navegación por teclado

El mapa de prerrequisitos de una serie se puede recorrer con las flechas del teclado, moviéndose entre nodos conectados, y confirmar la navegación con Enter. Esto evita que el mapa sea un adorno solo utilizable con mouse.