Saltar al contenido principal

REQ-DOC-02 — Landing de la versión 2.3

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

Implementación del requerimiento REQ-DOC-02 (Landing y comunicación de versiones), dentro de Documentación y con prioridad Media. Después de la 2.2 entraron la clínica veterinaria, el chat, los tickets, el centro de notificaciones y varios ajustes de acceso y plataforma; faltaba una página de versión que los contara juntos y en lenguaje de cliente.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · Inventario verificado de cambios posteriores a la 2.2, con clasificación17 cambios con fecha, tipo y respaldo en commits y notas de entrega
CA2 · Parte de la landing 2.2 y conserva su sistema visual y tonoReutiliza landing-v3.css, Figtree y las clases v3-*; mismos patrones de nav, hero, timeline y cierre
CA3 · Sección de novedades con título, descripción, tipo y fechaLínea de tiempo agrupada por mes, filtro por tipo y <time> visible por cambio
CA4 · Veterinaria integrada con espacio propioSección con diez pantallas, cuatro puntos de integración y tablero ilustrativo
CA5 · Lenguaje de cliente, sin detalles técnicos ni datos ajenosSin códigos internos, rutas ni endpoints; cifras de ejemplo declaradas
CA6 · Ingreso, registro y contacto vigentesIngreso a /layout; solicitud de acceso por correo; contacto por correo, WhatsApp y teléfono
CA7 · Versión 2.3 identificada y 2.2 accesiblePortada / y /v2-3 con la 2.3; entrada en el selector e historial con enlaces a /v2-2; la v1 se conserva en /v1
CA8 · Visibilidad y HTTPSMetadatos + noindex, llms.txt con veterinaria y HSTS
CA9 · Escritorio y móvil sin truncados ni desbordamientosPlaywright de 320 a 1440 px: 0 desbordamientos y 0 errores de consola
CA10 · Propuesta para validación antes de publicarLanding en desarrollo y spec con el registro de cambios; publicación pendiente de aprobación

🧩 La página, en piezas​

PiezaRol
app/page.tsxPortada: sirve la landing 2.3, la misma página que /v2-3
app/v2-3/page.tsx · loading.tsxRuta versionada de la 2.3 y carga estándar con acento brasa
app/v1/page.tsxLanding de la versión 1, conservada en /v1
src/components/landing-v2-3/pagina-v23.tsxContenido compartido por la portada y la ruta versionada
src/data/landing-v2-3.tsNovedades, veterinaria, comparativa, versiones, accesos y resumen
landing-v2-3/nav-v23.tsxCabecera con progreso, sección activa y notas flotantes
landing-v2-3/hero-v23.tsxTitular y resumen derivado del listado (6 novedades, 6 mejoras, 12 áreas, 17 cambios)
landing-v2-3/novedades-v23.tsxLínea de tiempo con filtro por tipo y fecha por cambio
landing-v2-3/veterinaria-v23.tsxLa clínica dentro del almacén: integración, tablero y pantallas
landing-v2-3/comparativa-v23.tsxTabla v2.2 → v2.3 con vistas comparar / solo v2.2 / solo v2.3
landing-v2-3/cierre-v23.tsxHistorial de versiones, accesos, contacto, CTA y pie

🚀 Qué reúne la 2.3​

Novedades: clínica veterinaria, mesa de ayuda con tickets, chat entre usuarios en línea, centro de notificaciones renovado, documentos de la mascota por correo y recuperación de contraseña por correo.

Mejoras: inventario único para almacén y clínica (farmacia y tienda como bodegas), buscador en los selectores de producto, atajo del cliente a sus mascotas, confirmaciones unificadas, recuperación desde el móvil y tours guiados en once pantallas más.

Ajustes: versión de plataforma fijada y comprobada en el despliegue, y una sola base para clínica y almacén.

Correcciones: el terminal móvil carga datos y conserva la sesión, el almacenista ve el panel completo de Inicio y la edición/inactivación de usuarios avisa y ya no permite auto-bloquearse.

🩺 Veterinaria, sin romper la narrativa​

La sección no presenta la clínica como un producto aparte: arranca en el inventario compartido. La farmacia y la tienda son bodegas del mismo almacén, con el mismo producto, el mismo kardex y la misma regla de lote y vencimiento. Desde ahí se despliega la operación clínica: tablero, agenda, clientes y mascotas, catálogo y precios, cartera, calificaciones, sanidad, personal y documentos.

El tablero que ilustra la sección está rotulado como vista ilustrativa y sus cifras son de ejemplo: no se muestran datos de ninguna instalación ni de otros clientes.

🔎 Visibilidad y seguridad​

  • Metadatos de la 2.3 (title, description, Open Graph y Twitter Card) con noindex, nofollow, coherente con el sistema interno autenticado (REQ-SEO-01).
  • sitemap.xml y robots.txt se regeneran sin cambios de host ni reglas (REQ-SEO-02/04).
  • llms.txt incorpora la clínica veterinaria al resumen y a las áreas funcionales (REQ-SEO-03).
  • HSTS y cabeceras de seguridad aplicadas por next.config.js e IIS (REQ-SEC-01).

🧪 Verificación​

PruebaResultado
npx jest landing-v2-3 landing-v2-222/22 verde
npx eslint app/v2-3 src/components/landing-v2-3 …0 errores, 2 avisos no-img-element (igual que la v2.2)
npx tsc --noEmit0 errores en esta entrega; 6 preexistentes en reportes/recepciones
GET / · /v2-3 · /v1 · /v2-2 · /layout200
Playwright 320 / 375 / 768 / 1440 pxSin desbordamientos de página ni errores de consola

⚠️ Estado​

La estructura, el contenido y la promoción de la 2.3 a la portada están aprobados. La landing está implementada y verificada en el entorno de desarrollo; la publicación queda pendiente de desplegar ccf-almacen-web por HTTPS. La v1 se conserva en /v1.

📎 Documentación​