Volver a la wiki

Sección /informes — Archivo de Deliberaciones de La Antesala

Hub único de Informes — secciones agrupadas + escaneo build-time anti-huérfanos

Descripción

Refactorización del sitio de informes en el Workspace. Consolida 3 entradas de navegación en 1 (/informes) y añade escaneo build-time anti-huérfanos para garantizar que ningún informe HTML queda invisible por falta de registro en el manifest.

Cambios principales

1. Consolidación de navegación

Antes: 3 entradas de menú

Ahora: 1 entrada principal

Los informes del sistema y Supercontexto ahora aparecen como subsecciones en el pie del hub.

2. Nueva lógica de escaneo build-time (src/pages/informes.astro)

En tiempo de build, la página ejecuta:

// Lee el manifest curado
const registrados = readFileSync('./public/informes/index.json')

// Escanea el directorio físico buscando HTML huérfanos
for (const dir of readdirSync('./public/informes', { withFileTypes: true })) {
  for (const file of readdirSync(`./public/informes/${dir.name}`)) {
    if (!file.endsWith('.html')) continue;
    const ruta = `/informes/${dir.name}/${file}`;
    // Si la ruta no está en el manifest, añádela como "sin registrar"
    if (!rutasRegistradas.has(ruta)) {
      huerfanos.push({ titulo, fecha, ruta, sinRegistrar: true });
    }
  }
}

Beneficio: Garantiza visibilidad. Un HTML olvidado en public/informes/roast/ aparecerá igualmente en la página, marcado con badge “sin registrar”. El dev/skill responsable sabe que debe actualizar index.json para curar el título y metadatos.

3. Agrupación en secciones

La página organiza los informes en secciones temáticas con descripción:

Cada informe muestra:

4. Cambio en /reports

Esto deja claro que /reports es un dominio distinto (métricas, costes, estado del sistema) respecto al hub /informes (deliberaciones curadas + análisis).

Verificación

✓ Typecheck: 0 errores
✓ Build: 2171 páginas OK

Archivos modificados

Impacto en UX

Véase también

Subir