Saltar al contenido principal

REQ-DOC-01 — Página de novedades de la versión v2.2

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación del requerimiento REQ-DOC-01 (Página de novedades de la versión v2.2), dentro de Documentación y con prioridad Media. El sistema había acumulado una tanda amplia de cambios en octubre, pero no tenía una página de versión donde verlos juntos ni una lectura de qué cambió frente a la v1.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · Existe una página de la v2.2 con los cambios recientesRuta nueva /v2-2 con la línea de tiempo de novedades
CA2 · La página compara la v2.2 con la v1Sección «Qué cambia de la v1 a la v2.2» con vistas Comparar / Solo v1 / Solo v2.2
CA3 · Se enfoca en las funcionalidades nuevas y las mejorasCada novedad con su tipo y filtros por tipo; la comparativa solo recoge nuevos y mejoras

⚙️ Cómo funciona​

  • Ruta nueva, versiones previas con navegación. /v2-2 es nueva, como lo fueron /v2 y /v2-1. La v1, la v2 y la v2.1 mantienen su contenido; solo se les añadió el logo de la aplicación y el conmutador entre versiones en la cabecera.
  • Reutiliza el sistema visual de la v2.1. Importa app/v2-1/landing-v3.css (solo lectura), usa las clases v3-* y monta los mismos elementos de diseño: el fondo interactivo (FondoInteractivoV3, con la navegación flotante arriba/abajo) y el menú completo (barra de progreso, sección activa y notas flotantes por sección).
  • Contenido aparte. src/data/landing-v2-2.ts guarda los textos (novedades, comparativa, resumen e índice), igual que el resto de landings del proyecto.
  • Fuente de verdad. Las entradas salen de la documentación real (wiki/blog y wiki/docs/mejoras), sin cifras ni funcionalidades inventadas.

🧩 La página, en piezas​

PiezaRol
app/v2-2/page.tsx · loading.tsxRuta y patrón de carga estándar con acento brasa
src/data/landing-v2-2.tsNOVEDADES_V22, COMPARATIVA_V22, RESUMEN_V22, INDICE_V22
landing-v2-2/nav-v22.tsxCabecera con secciones y vistas v2.1/v2
landing-v2-2/hero-v22.tsxTitular y resumen de la entrega (cifras derivadas del listado)
landing-v2-2/novedades-v22.tsxLínea de tiempo agrupada por fecha con filtro por tipo
landing-v2-2/comparativa-v22.tsxTabla v1 → v2.2 con vistas
landing-v2-2/cierre-v22.tsxCTA al sistema, enlaces a versiones anteriores y pie

🚀 Qué reúne la v2.2​

Funcionalidades nuevas: REQ-SEC-05 (reCAPTCHA v3), REQ-SEC-18 (gestión de IPs bloqueadas), REQ-UX-04 (tour guiado), REQ-UX-05 (esqueletos de precarga), REP-007 (tableros personalizados), REP-008 (alertas inteligentes).

Mejoras: TEC-016/017/018 (inyección SQL/JS, prompt injection, anti-bots), TEC-019 (cifrado de datos sensibles y sesión endurecida), REQ-DSG-02 (borde visible en selects), REQ-UX-01 (confirmación al salir), REQ-UX-02 (resumen de almacén estandarizado), REQ-SEO-03/04 (llms.txt/robots.txt), REQ-AVA-03 (control de versiones), NestJS 12 y la nueva experiencia visual + telemetría de la landing v2.1.

Correcciones: listado de productos (slice) y sesión/contexto de usuario.

🧪 Verificación​

PruebaResultado
npx tsc --noEmit (web)0 errores
npx eslint app/v2-2 src/components/landing-v2-2Limpio
npx jest landing-v2-2 landing-v330/30 verde (v2.2 nueva + v3 sin regresión)
next dev → GET /v2-2200 con 19 novedades, filtros y 6 filas de comparativa
Wiki npm run buildSUCCESS

📎 Documentación​