fix: polish landing qa details

ai/tasks/done/TASK-026-landing-final-qa-pass.md

@@ -0,0 +1,97 @@
+# TASK-026-landing-final-qa-pass
+
+## Goal
+Realizar una pasada final de QA funcional y visual sobre la landing actual de HLL Vietnam para detectar y corregir pequenos defectos de presentacion, consistencia o comportamiento antes de pasar a una nueva linea de trabajo mas analitica e historica.
+
+## Context
+La landing ya dispone de:
+- hero estable
+- CTA principal a Discord
+- trailer
+- panel de servidores con 2 servidores reales de la comunidad
+- snapshots actuales con polling backend
+- boton `Historico` funcional por servidor
+
+Antes de entrar en la siguiente fase del proyecto (estadisticas e historico), conviene hacer una revision final de calidad sobre la version actual para corregir detalles pequenos de UX, responsive, textos, alineacion visual y funcionamiento de enlaces.
+
+## Steps
+1. Revisar la landing completa en su estado actual.
+2. Validar el comportamiento y acabado de:
+   - hero
+   - CTA principal de Discord
+   - trailer
+   - panel de servidores
+   - badges de actualizacion
+   - botones `Historico`
+3. Revisar posibles problemas pequenos como:
+   - textos cortados o saltos raros
+   - alineaciones inconsistentes
+   - spacing irregular
+   - badges o chips descompensados
+   - estados visuales poco claros
+   - fallback estatico vs UI hidratada con diferencias no deseadas
+4. Revisar que los 2 botones `Historico` apunten correctamente a:
+   - `https://scoreboard.comunidadhll.es/games`
+   - `https://scoreboard.comunidadhll.es:5443/games`
+5. Revisar que el badge de actualizacion use datos reales y no texto ficticio.
+6. Revisar el comportamiento responsive basico de la landing.
+7. Corregir unicamente defectos pequenos o medianos detectados en esta pasada.
+8. No abrir redisenos grandes ni nuevos bloques funcionales.
+9. Al completar la implementacion:
+   - dejar el repositorio consistente
+   - hacer commit
+   - hacer push al remoto si el entorno lo permite
+
+## Files to Read First
+- AGENTS.md
+- frontend/index.html
+- frontend/assets/css/styles.css
+- frontend/assets/js/main.js
+- backend/app/payloads.py
+- backend/app/routes.py
+- docs/frontend-backend-contract.md
+- ai/repo-context.md
+
+## Expected Files to Modify
+- frontend/index.html
+- frontend/assets/css/styles.css
+- frontend/assets/js/main.js
+- opcionalmente documentacion minima si se detecta que algun comportamiento visible necesita quedar reflejado
+
+## Constraints
+- No redisenar la landing completa.
+- No cambiar la arquitectura backend actual.
+- No introducir nuevas features grandes.
+- No anadir librerias nuevas.
+- No romper polling, snapshot o hidratacion actual.
+- No hacer cambios destructivos.
+- Mantener el trabajo centrado en QA final y correcciones concretas.
+
+## Validation
+- La landing queda mas consistente y pulida.
+- No hay defects visibles relevantes en el flujo principal.
+- Los 2 servidores correctos siguen mostrandose.
+- Los enlaces de `Historico` funcionan correctamente.
+- El badge de actualizacion sigue reflejando un dato real.
+- Los cambios quedan committeados y se hace push si el entorno lo permite.
+
+## Change Budget
+- Preferir menos de 4 archivos modificados.
+- Preferir menos de 180 lineas cambiadas.
+
+## Outcome
+- `frontend/index.html` alinea el polling visible de la landing con el backend a `120000` ms y aclara que el panel usa snapshots consultados desde backend.
+- `frontend/assets/js/main.js` deja de insertar una segunda rejilla dentro de `#servers-list`, con lo que el fallback estatico y la UI hidratada comparten la misma estructura visual.
+- El badge de actualizacion distingue snapshot fresco frente a snapshot stale usando el dato real `last_snapshot_at` y el flag `is_stale`.
+- Se mantiene la ruta correcta de ambos botones `Historico` hacia los dos scoreboards de la comunidad.
+- `frontend/assets/css/styles.css` corrige un detalle menor de consistencia en el bloque del CTA secundario de tarjetas.
+
+## Validation Result
+- Validado con `node --check frontend/assets/js/main.js`.
+- Verificadas en codigo las URLs `https://scoreboard.comunidadhll.es/games` y `https://scoreboard.comunidadhll.es:5443/games` tanto en el fallback HTML como en el mapeo dinamico de `SERVER_HISTORY_URLS`.
+- Verificado en fuente que `data-server-refresh-ms="120000"` queda alineado con el intervalo por defecto documentado para snapshots.
+- Revisado `git diff --name-only`: el alcance queda limitado a `frontend/index.html`, `frontend/assets/js/main.js`, `frontend/assets/css/styles.css` y este archivo de task.
+
+## Decision Notes
+- La pasada de QA se limita a consistencia visual y semantica del estado visible; no abre nuevas features ni cambia el contrato backend.
+- Para evitar otra divergencia entre fallback y estado hidratado, el contenedor `#servers-list` se mantiene como rejilla unica y la hidratacion solo reemplaza sus tarjetas internas.

frontend/assets/js/main.js

@@ -157,12 +157,15 @@ function setServersDataState(badgeNode, state) {
     return;
   }
 
-  const hasTimestamp = typeof state.timestampLabel === "string" && state.timestampLabel;
-  badgeNode.textContent = hasTimestamp
-    ? `Actualizado ${state.timestampLabel}`
+  const hasLabel = typeof state.label === "string" && state.label;
+  badgeNode.textContent = hasLabel
+    ? state.label
     : "Actualizado no disponible";
-  badgeNode.classList.toggle("status-chip--ok", Boolean(hasTimestamp));
-  badgeNode.classList.toggle("status-chip--fallback", !hasTimestamp);
+  badgeNode.classList.toggle("status-chip--ok", Boolean(hasLabel && state.isFresh));
+  badgeNode.classList.toggle(
+    "status-chip--fallback",
+    !hasLabel || !state.isFresh,
+  );
 }
 
 function renderServerStatsCard(server) {
@@ -201,11 +204,7 @@ function renderServerStatsCard(server) {
 }
 
 function renderServerSections(latestItems) {
-  return `
-    <div class="servers-grid servers-grid--section">
-      ${latestItems.map((server) => renderServerStatsCard(server)).join("")}
-    </div>
-  `;
+  return latestItems.map((server) => renderServerStatsCard(server)).join("");
 }
 
 function renderServerAction(server) {
@@ -271,10 +270,22 @@ function isRealA2SSnapshot(item) {
 }
 
 function deriveSnapshotState(serversData) {
-  return {
-    timestampLabel: serversData?.last_snapshot_at
+  const timestampLabel = serversData?.last_snapshot_at
     ? formatTimestamp(serversData.last_snapshot_at)
-      : "",
+    : "";
+  if (!timestampLabel) {
+    return {
+      label: "",
+      isFresh: false,
+    };
+  }
+
+  const isFresh = serversData?.is_stale !== true;
+  return {
+    label: isFresh
+      ? `Actualizado ${timestampLabel}`
+      : `Ultimo snapshot ${timestampLabel}`,
+    isFresh,
   };
 }
 

frontend/index.html

@@ -12,7 +12,7 @@
   </head>
   <body
     data-backend-base-url="http://127.0.0.1:8000"
-    data-server-refresh-ms="60000"
+    data-server-refresh-ms="120000"
   >
     <div class="page-shell">
       <header class="hero">
@@ -35,7 +35,7 @@
                 <span class="hero__title-accent">HLL Vietnam</span>
               </h1>
               <p class="hero__text">
-                Centro de reunión para escuadras, eventos y acceso directo al
+                Centro de reunion para escuadras, eventos y acceso directo al
                 Discord oficial de la comunidad.
               </p>
               <div class="hero__actions">
@@ -85,6 +85,9 @@
                 Actualizado no disponible
               </p>
             </div>
+            <p class="panel__intro panel__intro--tight">
+              El panel muestra el ultimo snapshot disponible consultado desde backend.
+            </p>
             <div class="servers-grid" id="servers-list">
               <article class="server-card server-card--stats server-card--real">
                 <div class="server-card__top server-card__top--stats">