Documento de requisitos de producto

verificaOTP es una plataforma de educación para desarrolladores organizada en series de tutoriales sobre verificación de identidad con contraseñas de un solo uso en producción. Su audiencia son ingenieros, líderes técnicos y equipos de producto en Latinoamérica que construyen o mantienen flujos de verificación en retail, banca, fintech y servicios públicos.

El producto nace de una observación simple: la mayoría de la documentación sobre OTP explica la llamada a una API, pero no el criterio detrás de cuándo verificar, con qué canal, cuánto tiempo dar y qué hacer cuando el canal falla. Esa capa de criterio es la que se enseña aquí, apoyada en ejemplos que el lector puede ejecutar sin credenciales ni costos.

Objetivos

• Enseñar verificación con OTP con profundidad de producción, no de demo.
• Permitir practicar sin cuentas, sin costos y sin red mediante playgrounds aislados.
• Reflejar el contexto regional: numeración, portabilidad, codificación de SMS y regulación.
• Ofrecer una experiencia editorial a la altura de las mejores documentaciones técnicas.

Funciones

Inicio. Presenta la serie destacada con su lista de capítulos y progreso, un carril de capítulos nuevos de la semana con distintivo NUEVO y fecha, un bloque «Continuar aprendiendo» que aparece solo si hay progreso y apunta al siguiente capítulo pendiente, y tres propuestas de valor.

Biblioteca. Cuadrícula de series con anillo de progreso porcentual, chip de nivel (Base, Intermedio, Avanzado) y tema. Filtros por tema (2FA, Canales, Números, Anti-fraude, Casos) y búsqueda en vivo que ignora tildes y busca también en títulos y resúmenes de capítulos.

Serie. Lista ordenada de capítulos con estado de completado y un mapa de prerrequisitos interactivo: al pasar el cursor o enfocar una serie se resalta su cadena de ancestros; al hacer click se navega.

Capítulo. Tres columnas: lista de capítulos con casillas a la izquierda, prosa de ~68 caracteres al centro y tabla de contenidos con seguimiento de scroll a la derecha. Incluye callouts, bloques de código, playgrounds, widgets de diff, navegación anterior/siguiente y comentarios.

Playground. Editor de código con ejecución en vivo y una transcripción en forma de teléfono. Ejecuta el JavaScript del usuario en un Web Worker con un SDK simulado (mx) para SMS, chat, OTP, DIDs y firma de webhooks.

Progreso. Al leer el 80% de un capítulo se marca completado automáticamente con una celebración animada, un sonido breve (solo tras interacción del usuario) y una notificación. Los anillos de toda la app se actualizan al instante.

Diff. Bloque antes/después que alterna con animación: las líneas eliminadas colapsan en rojo y las insertadas se expanden resaltadas en cian.

Comentarios. Hilos con un nivel de respuestas, nombre, me gusta y persistencia local, sembrados con comentarios editoriales por capítulo.

Docs y modo atenuado. Seis documentos del proyecto y un modo atenuado persistente desde el encabezado.

Audiencia y tono

El lector principal ya sabe programar y probablemente ya integró algún proveedor de mensajería; lo que busca es criterio de producto y de seguridad, no un tutorial de «hola mundo». Por eso el contenido asume JavaScript y conceptos básicos de autenticación, y en cambio profundiza en decisiones de diseño, costos y fraude específicos de la región.

Fuera de alcance

• Cuentas de usuario y sincronización entre dispositivos.
• Envío real de mensajes o llamadas.
• Analítica o rastreo de visitantes.