Apartado Guías + aviso de bienvenida en el Dashboard

Visión

Hasta ahora la documentación de lectura para personas (bienvenida al equipo, trabajo diario de cada uno, método) vivía mezclada en Informes junto a los estudios técnicos, o solo en la wiki. Este cambio le da un apartado propio, Guías (/guias), en el menú del workspace, y un aviso en el Dashboard que dirige allí a quien acaba de llegar.

User value

Quien se incorpora al equipo (o quien ya está pero quiere refrescar cómo trabaja cada día) tiene un sitio único y ordenado para leer, en vez de tener que preguntar o rebuscar en la wiki técnica. La guía de bienvenida se lee en diez minutos y explica qué es CreaRack, cómo está hecho y en qué punto está; las guías de trabajo diario (una por persona) cubren sus tareas habituales con Claude paso a paso. El grupo «Cómo trabajamos» añade el método completo, un ejemplo de decisión real y el plan de pruebas al abrir el producto al público.

Cómo usarla

• Menú → Guías (añadido a Sidebar.tsx y BottomNav.tsx) lleva a /guias, agrupada en: Empieza aquí, Tu trabajo diario, Cómo trabajamos y Para enseñar fuera (esta última pensada para versiones sin datos internos, mostrables a clientes o proveedores).
• Cada guía es un HTML autocontenido en public/guias/<slug>/index.html (con sus imágenes al lado), servido estático por Cloudflare Pages — se abre en pestaña nueva.
• El manifest public/guias/index.json aporta los metadatos curados por guía: grupo, titulo, resumen, para (a quién va dirigida), terceros (si tiene versión para fuera del equipo) y revisada (fecha ISO de última revisión).
• Ninguna guía queda invisible por un olvido: si hay una carpeta en public/guias/ sin entrada en el manifest, src/pages/guias.astro la detecta en build (lee sus subcarpetas con readdirSync y compara contra los slugs registrados) y la muestra igualmente en un grupo “Sin clasificar”, tomando el título del <title> de su HTML.
• Primeras tres guías publicadas: bienvenida (todo el equipo, con versión para terceros), txell y dani (trabajo diario de cada una, solo interno).
• 24-09-2026 tarde (PR#186): se llena el grupo «Cómo trabajamos» con tres guías nuevas — metodo (el método en 11 apartados), metodo-ejemplo-decision (caso real de agosto de 2026) y metodo-pruebas-apertura (paso intermedio de pruebas al abrir al público). Las seis guías ya publicadas ganan un apartado final común, «¿Algo no cuadra?», que enlaza a la tarea #341 para reportar discrepancias — es contenido repetido en cada HTML, sin lógica de código nueva.
• Aviso en el Dashboard: un panel fijo abajo a la derecha de src/pages/index.astro, oculto por defecto, que el script is:inline muestra salvo que la persona haya marcado “No volver a mostrar” (se recuerda en localStorage, clave ws-aviso-guias-oculto, por navegador — no hay backend detrás).
• Se retira de Informes la presentación del método del 21-09-2026 (metodo-claude-equipo-2026-09-21.html), sustituida por las guías nuevas.

Implementación

• src/pages/guias.astro (230 LOC, nuevo): lee el manifest, calcula huérfanas, renderiza los 5 grupos.
• src/pages/index.astro: añade el aviso (<aside id="aviso-guias">) + script inline de persistencia en localStorage + estilos con los tokens del tema (--space-*, --bg-raised, --accent…).
• public/guias/index.json: manifest nuevo, schema {slug, grupo, titulo, resumen, para, terceros, revisada, ruta}.
• public/guias/{bienvenida,txell,dani}/index.html + imágenes: contenido de las tres guías, sobre la plantilla claude-method/templates/GUIA.html.template.
• public/guias/{metodo,metodo-ejemplo-decision,metodo-pruebas-apertura}/index.html: las tres guías del grupo «Cómo trabajamos» (24-09-2026 tarde, PR#186), misma plantilla.
• src/components/shell/Sidebar.tsx y BottomNav.tsx: entrada de menú nueva.
• public/informes/index.json y public/informes/presentaciones/metodo-claude-equipo-2026-09-21.html: se retira la entrada y el fichero (movido de facto a Guías).

UNVERIFIED en el propio código: el bottom del aviso en móvil (calc(var(--space-4) + 64px)) es una altura aproximada de la barra inferior, no medida contra el dispositivo real (comentario /* UNVERIFIED */ en el CSS de index.astro).

Commits relacionados

• 572d23e2 (24-09-2026, PR#185) — feat(guias): apartado Guias propio en el menu + aviso de bienvenida en el Dashboard.
• b8b5da13 (24-09-2026, PR#186) — feat(guias): 'Como trabajamos' + ejemplo de decision + pruebas al abrir al publico; apartado 'Algo no cuadra?' en todas las guias; informe storm del protocolo de seguridad interno.

Véase también

• [[feature—workspace—refresh-ui-2026]]
• [[feature—workspace—correo-menu-f0-f1-f2]]
• [[feature—workspace—tools-hub]]
• [[feature—workspace—quick-links]]
• [[feature—workspace—version-banner]]