REQ-DOC-02 — Landing de la versión 2.3
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ón | Entregable |
|---|---|
| CA1 · Inventario verificado de cambios posteriores a la 2.2, con clasificación | 17 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 tono | Reutiliza 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 fecha | Línea de tiempo agrupada por mes, filtro por tipo y <time> visible por cambio |
| CA4 · Veterinaria integrada con espacio propio | Sección con diez pantallas, cuatro puntos de integración y tablero ilustrativo |
| CA5 · Lenguaje de cliente, sin detalles técnicos ni datos ajenos | Sin códigos internos, rutas ni endpoints; cifras de ejemplo declaradas |
| CA6 · Ingreso, registro y contacto vigentes | Ingreso a /layout; solicitud de acceso por correo; contacto por correo, WhatsApp y teléfono |
| CA7 · Versión 2.3 identificada y 2.2 accesible | Portada / 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 HTTPS | Metadatos + noindex, llms.txt con veterinaria y HSTS |
| CA9 · Escritorio y móvil sin truncados ni desbordamientos | Playwright de 320 a 1440 px: 0 desbordamientos y 0 errores de consola |
| CA10 · Propuesta para validación antes de publicar | Landing en desarrollo y spec con el registro de cambios; publicación pendiente de aprobación |
🧩 La página, en piezas
| Pieza | Rol |
|---|---|
app/page.tsx | Portada: sirve la landing 2.3, la misma página que /v2-3 |
app/v2-3/page.tsx · loading.tsx | Ruta versionada de la 2.3 y carga estándar con acento brasa |
app/v1/page.tsx | Landing de la versión 1, conservada en /v1 |
src/components/landing-v2-3/pagina-v23.tsx | Contenido compartido por la portada y la ruta versionada |
src/data/landing-v2-3.ts | Novedades, veterinaria, comparativa, versiones, accesos y resumen |
landing-v2-3/nav-v23.tsx | Cabecera con progreso, sección activa y notas flotantes |
landing-v2-3/hero-v23.tsx | Titular y resumen derivado del listado (6 novedades, 6 mejoras, 12 áreas, 17 cambios) |
landing-v2-3/novedades-v23.tsx | Línea de tiempo con filtro por tipo y fecha por cambio |
landing-v2-3/veterinaria-v23.tsx | La clínica dentro del almacén: integración, tablero y pantallas |
landing-v2-3/comparativa-v23.tsx | Tabla v2.2 → v2.3 con vistas comparar / solo v2.2 / solo v2.3 |
landing-v2-3/cierre-v23.tsx | Historial 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) connoindex, nofollow, coherente con el sistema interno autenticado (REQ-SEO-01). sitemap.xmlyrobots.txtse regeneran sin cambios de host ni reglas (REQ-SEO-02/04).llms.txtincorpora la clínica veterinaria al resumen y a las áreas funcionales (REQ-SEO-03).- HSTS y cabeceras de seguridad aplicadas por
next.config.jse IIS (REQ-SEC-01).
🧪 Verificación
| Prueba | Resultado |
|---|---|
npx jest landing-v2-3 landing-v2-2 | 22/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 --noEmit | 0 errores en esta entrega; 6 preexistentes en reportes/recepciones |
GET / · /v2-3 · /v1 · /v2-2 · /layout | 200 |
| Playwright 320 / 375 / 768 / 1440 px | Sin 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
- Spec: REQ-DOC-02: Landing de la versión 2.3
- Requerimiento anterior: REQ-DOC-01: Página de novedades de la v2.2
- Backlog:
docs/mejoras-propuestas-almacen.md
