GatewayQR - Municipalidad de Villa Allende
Portal de documentación. Cada página se genera a partir del Markdown que se mantiene en el repositorio. Los documentos técnicos (especificación, runbook, ADR, riesgos) están escritos en inglés; la hoja para la caja está en español.
- Operación: Runbook (manual de operación) y hoja para la caja
- Especificación y criterios de aceptación
- Dominio: Contexto, Modelo de dominio, Constitución
- Decisiones de arquitectura: ADR-001, ADR-002, ADR-003, ADR-004
- Riesgos, temas diferidos y traspaso (handoff)
- Evidencia de la prueba del POS del 18/11/2026
- Diagramas y presentación
Cómo ver el sitio localmente
Desde la raíz del repositorio (donde está mkdocs.yml), en un entorno virtual:
python -m venv .venv-docs
Actívelo (.venv-docs\Scripts\activate en Windows, source .venv-docs/bin/activate en Linux o macOS) y luego:
python -m pip install -r docs/requirements-docs.txt
mkdocs serve
mkdocs build --strict tiene que pasar antes de cada merge (lo corre la CI). Los archivos crudos de evidencia (logs,
JSON, texto) y los PDF quedan en el repositorio, pero no se incluyen en el sitio generado.