Saltar al contenido principal

REQ-DOC-03 — Landing de la versión 2.4

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

Implementación del requerimiento REQ-DOC-03 (Landing y comunicación de versiones), dentro de Documentación y con prioridad Media. Después de la 2.3 entraron el punto de venta completo con su administración, la empresa y sus logos en los documentos, las áreas, las banderas de funcionalidad, el horario por bodega, el endurecimiento de seguridad, la pantalla de continuidad y el cierre de la solicitud en destino. Faltaba la página de versión que lo contara junto y en lenguaje de cliente.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · Inventario verificado de cambios posteriores a la 2.334 cambios con fecha, tipo, frente y respaldo en commits, documentos y manuales
CA2 · Conserva el sistema visual de la 2.1 a la 2.3landing-v3.css sin modificar, Figtree, acento brasa y cabecera con progreso e índice
CA3 · No repite la estructura de la 2.3Sin hero de cuatro contadores, sin sección de módulo única y sin tercera tabla comparativa
CA4 · Cada frente con su piezaRiel de cuatro etapas, mesa de caja interactiva, lista numerada, tirilla, banda de confianza, tabla de estructura y matriz
CA5 · Lenguaje de clienteSin códigos internos, rutas ni endpoints; la trazabilidad técnica queda en el dato, no en la página
CA6 · Sin datos de una instalaciónNingún NIT, dirección, teléfono ni nombre de la clínica; las cifras de ejemplo se declaran
CA7 · Solo lo respaldadoOcho límites explícitos en el documento del requerimiento
CA8 · Versiones anteriores accesibles/v2-3, /v2-2, /v2-1, /v2 y /v1 responden 200
CA9 · Escritorio y móvil sin desbordamientosPlaywright de 320 a 1440 px: 0 desbordes, 0 errores de consola, también con texto grande
CA10 · Metadatos y visibilidadTítulo, descripción, Open Graph, Twitter Card, noindex y llms.txt regenerado
CA11 · Pruebas, tipos y lint71/71 en las cinco suites de landing, tsc 0, eslint 0, build 0
CA12 · Promoción reversibleEl destino de / cambia en una línea de next.config.js

🧩 La página, en piezas​

PiezaRol
app/page.tsxPortada: sirve la landing 2.4, la misma que /v2-4
app/v2-4/page.tsx · loading.tsxRuta versionada y carga estándar con acento brasa
app/v2-4/landing-v24.cssCSS aditivo: papel térmico, banda oscura, ficha, mesa, tirilla, arqueo, flujo, estructura y matriz
src/data/landing-v2-4.tsContenido único: 34 novedades, etapas, mesa, pantallas, tirilla, controles, continuidad, flujo, estructura, matriz, versiones y accesos
src/components/landing-v2-4/*Nueve componentes de sección, cada uno con su pieza visual
src/components/selector-versiones.tsxAñade v2.4 y mueve v2.3 a /v2-3

🎨 Qué cambia en el diseño​

  • Paleta propia para distinguir la entrega. La 2.4 deja el coral de las versiones anteriores y pasa a violeta para la interfaz y verde para el dinero: el violeta lleva la identidad, la acción principal y los controles activos; el verde se reserva a las cifras de venta, los totales, el arqueo cuadrado y el paso «recibida». El campo animado del fondo arranca en verde, y la 2.3 conserva intactos su lienzo y su acento.
  • Los cuatro contadores de la 2.3 se retiran. Con 34 cambios, un número no dice qué pasó. En su lugar va la ficha de la entrega: entrega, recorridos, cambios y continuidad, con las cifras derivadas del propio listado.
  • La línea de tiempo se mueve al final y se pliega. Deja de ser el centro de la página y pasa a ser el apéndice completo, filtrable por tipo y por frente.
  • La tabla comparativa se convierte en matriz de madurez por área, con estado (nuevo, ampliado, consolidado, sin cambio). Era la tercera versión del mismo widget.
  • Una banda oscura, una sola. Es el único lugar de la página donde el estado no es «todo bien»: seguridad, continuidad y cierre de la solicitud.
  • La tirilla se dibuja con CSS y texto, sobre un papel térmico propio. El repositorio no tiene capturas de producto y no se inventan.
  • El riel de cuatro etapas usa clases que existían en el CSS de la 2.1 sin uso.

🔒 Lo que la landing no dice​

Cuatro afirmaciones quedan fuera por no estar respaldadas: que el login impide enumerar usuarios (el código responde 404 a una cuenta inexistente, contra lo que afirma el documento de la auditoría), que el POS emite factura electrónica, que funciona sin conexión vendiendo, y que opera en cualquier bodega. Los datos de la clínica que aparecen en los manuales del POS tampoco se trasladan a la página: son de una instalación.

✅ Verificación​

PruebaResultado
npx jest de las cinco suites de landing71/71 (23 de la 2.4 nuevas)
npx tsc --noEmit · npx eslint0 · 0
npm run build0, con el chequeo de build seguro en verde
Rutas/ y /v2-4 con la 2.4 y noindex; /v2-3 conserva la 2.3; /v2-2, /v1 y /layout en 200
Playwright 320 / 375 / 768 / 1440 px0 desbordes (también con texto grande) y 0 errores de consola

📌 Pendientes​

  • Decidir el rechazo del login frente a la enumeración de usuarios: corregir el código o el documento de la auditoría (D-038).
  • Publicar por HTTPS; si cambia el host, regenerar npm run seo:generar.
  • La telemetría flotante del fondo todavía puede tapar la esquina inferior derecha en escritorio; en móvil ya se oculta desde el CSS de la 2.4. Corregirlo en escritorio tocaría el comportamiento compartido con la 2.1 a la 2.3.

Documentación: REQ-DOC-03 · REQ-DOC-02 · Landing en la portada