REQ-DOC-03 — Landing de la versión 2.4
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ón | Entregable |
|---|---|
| CA1 · Inventario verificado de cambios posteriores a la 2.3 | 34 cambios con fecha, tipo, frente y respaldo en commits, documentos y manuales |
| CA2 · Conserva el sistema visual de la 2.1 a la 2.3 | landing-v3.css sin modificar, Figtree, acento brasa y cabecera con progreso e índice |
| CA3 · No repite la estructura de la 2.3 | Sin hero de cuatro contadores, sin sección de módulo única y sin tercera tabla comparativa |
| CA4 · Cada frente con su pieza | Riel de cuatro etapas, mesa de caja interactiva, lista numerada, tirilla, banda de confianza, tabla de estructura y matriz |
| CA5 · Lenguaje de cliente | Sin 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ón | Ningún NIT, dirección, teléfono ni nombre de la clínica; las cifras de ejemplo se declaran |
| CA7 · Solo lo respaldado | Ocho 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 desbordamientos | Playwright de 320 a 1440 px: 0 desbordes, 0 errores de consola, también con texto grande |
| CA10 · Metadatos y visibilidad | Título, descripción, Open Graph, Twitter Card, noindex y llms.txt regenerado |
| CA11 · Pruebas, tipos y lint | 71/71 en las cinco suites de landing, tsc 0, eslint 0, build 0 |
| CA12 · Promoción reversible | El destino de / cambia en una línea de next.config.js |
🧩 La página, en piezas
| Pieza | Rol |
|---|---|
app/page.tsx | Portada: sirve la landing 2.4, la misma que /v2-4 |
app/v2-4/page.tsx · loading.tsx | Ruta versionada y carga estándar con acento brasa |
app/v2-4/landing-v24.css | CSS aditivo: papel térmico, banda oscura, ficha, mesa, tirilla, arqueo, flujo, estructura y matriz |
src/data/landing-v2-4.ts | Contenido ú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.tsx | Añ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
| Prueba | Resultado |
|---|---|
npx jest de las cinco suites de landing | 71/71 (23 de la 2.4 nuevas) |
npx tsc --noEmit · npx eslint | 0 · 0 |
npm run build | 0, 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 px | 0 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
