Saltar a contenido

0032. Tablero Kanban en GitHub Projects y portal documental privado

  • Estado: Propuesta (la acepta ENR al fusionar el PR que la trae)
  • Fecha: 2026-11-09
  • Decide: Enrique
  • Sustituye a: 0003 en lo que toca al estado de las tarjetas
  • Issue / PR: PR «Tablero Kanban en GitHub Projects y portal documental privado»

Contexto

ENR pidió (2026-11-09) un tablero Kanban para gestionar y asignar todas las tareas de todas las fases y ver cómo va todo, porque la documentación en Markdown del repositorio no basta para eso. También pidió un portal documental mejor que leer Markdown en GitHub, todo privado, y saber antes qué piezas son de pago.

La decisión 0003 dejó el tablero en Markdown y GitHub Projects solo como espejo. Con 246 pasos, varias personas (ENR y DAV) y sesiones de Claude Code en la nube trabajando a la vez, el índice en Markdown no da vista de columnas, ni asignación, ni roadmap, y cada movimiento exige un PR.

Opciones consideradas

  1. Mantener 0003 (Markdown como fuente y Projects como espejo manual). Contras: no cumple lo pedido; el espejo se desincroniza.
  2. Projects como fuente del estado, el repositorio como fuente del contenido, con issues generados desde el apéndice C por GitHub Actions. Pros: Kanban, roadmap y asignación de serie y gratis; los agentes pueden mover tarjetas con etiquetas (set-status/*) sin acceso a la API de Projects; el contenido de cada paso sigue versionado y revisado por PR. Contras: el estado deja de estar versionado en Git (queda el historial del issue); hace falta un token personal de ENR.
  3. Herramienta externa (Jira, Linear, Trello). Contras: otra cuenta y otra fuente; peor integración con PR y Actions.

Para el portal: 1. GitHub Pages: en un repositorio privado el sitio es público salvo con GitHub Enterprise Cloud (≈ 21 $ por usuario y mes). Descartado por coste. 2. Netlify o Vercel con contraseña: de pago (≈ 19 $ y ≈ 150 $ al mes). Descartado. 3. Cloudflare Pages + Cloudflare Access (Zero Trust Free): gratis hasta 50 usuarios; acceso por código al correo o cuenta de GitHub. Elegido. 4. Artefacto privado del workflow y mkdocs serve en local: gratis y sin cuentas nuevas, pero incómodo. Se mantiene como respaldo.

Decisión

  • Contenido de cada paso: apéndice C de la guía aplicada (sin cambios). El workflow Board sync lo refleja en un issue por paso, con etiquetas e hitos por fase.
  • Estado, asignación y fechas: el proyecto de GitHub Music Life (campo Status con los estados de B.3, assignees, Start date y Target date). Si una tarjeta en Markdown dice otra cosa, manda el proyecto.
  • Tarjetas en Markdown (docs/production/board/cards/): siguen siendo el registro detallado del paso (rondas, procedencia, entregables). Al cargar el proyecto por primera vez, su estado inicial se toma de ellas.
  • Los agentes mueven tarjetas con etiquetas set-status/* en el issue; un PR con Closes #N pasa el paso a Hecho al fusionarse.
  • Portal: MkDocs Material construido por GitHub Actions desde el repositorio, publicado en Cloudflare Pages y cerrado con Cloudflare Access. No se usa la wiki de GitHub.
  • Detalle operativo y puesta en marcha: docs/production/tooling.md.

Consecuencias

  • ENR crea un token personal (PROJECT_TOKEN) y, para el portal, una cuenta gratuita de Cloudflare con dos secretos. Hasta entonces el portal se descarga como artefacto del workflow Docs.
  • PROD deja de mantener a mano el resumen por estado del tablero en Markdown cuando el proyecto esté cargado; el índice de tarjetas se conserva como mapa de F0.
  • Material for MkDocs avisa de que MkDocs 2.0 romperá los temas y plugins actuales; se fija mkdocs==1.6.1 y se revisa la herramienta en G1 junto con D-24 (alternativa prevista: Zensical, del mismo equipo).
  • Coste total: 0 €. GitHub Actions gasta minutos del plan gratuito (2.000 al mes).
  • Documentos afectados: 0003 (sustituida en parte), tablero, CONTRIBUTING.md.