CTRoadmap
CTRoadmap es una herramienta local-first para documentación de infraestructura de homelab mediante diagramas, atlas JSON y exportaciones.
Ficha actualizada 21 sept 2026, 9:26 · upstream 21 sept 2026, 9:26 · release beta-v0.8.0
Qué es CTRoadmap
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
CTRoadmap es un software de documentación exclusivamente visual diseñado para mapear la topología de redes, servicios, almacenamiento y relaciones operativas en entornos de homelab. Funciona como una aplicación web servida por Docker que utiliza un archivo `data/atlas.json` como fuente única de verdad, permitiendo modelar nodos, servicios, contenedores, discos, scripts, configuraciones y flujos de trabajo sin ejecutar comandos ni interactuar con el sistema operativo subyacente.
La aplicación ofrece un editor de lienzo para crear diagramas interactivos con nodos arrastrables, relaciones direccionales y swimlanes para modelar procesos. Incluye un handbook estructurado que indexa todas las URLs e IPs del atlas, permite organizar elementos en familias y capas visuales, y soporta modos de planificación para infraestructura futura. La interfaz es compatible con vistas móviles y ofrece dos temas (Clásico y Zima).
CTRoadmap prioriza la seguridad mediante un código de acceso local opcional que protege la interfaz web sin exponer el backend. Los datos persistentes se almacenan en directorios montados, permitiendo copias de seguridad independientes del contenedor. Soporta exportaciones a Markdown, YAML, Mermaid y PNG (generado lado cliente), además de PDF para el handbook.
- Documentar la topología actual de un homelab con nodos, servicios y relaciones de red en un diagrama interactivo.
- Planificar cambios de infraestructura futura utilizando el modo de planificación para distinguir elementos activos de los propuestos.
- Generar documentación técnica exportable (Markdown, YAML, Mermaid) para compartir o integrar en wikis externos.
- Modelar flujos de procesos operativos mediante swimlanes y diagramas de flujo dentro del atlas sin ejecutar comandos reales.
- Organizar componentes complejos en familias visuales y capas para mejorar la navegación en grandes infraestructuras.
- Persistencia de datos en `data/atlas.json` con historial de deshacer/rehacer que sobrevive a reinicios del contenedor.
- Soporte nativo para Docker Compose v2 y despliegue rápido mediante imagen oficial en ghcr.io.
- Generación de exportaciones visuales (PNG, PDF) lado cliente sin necesidad de endpoints de API adicionales.
- Sistema de autenticación local opcional mediante código de acceso configurado en la aplicación.
- Compatibilidad con vistas móviles y temas personalizables (Clásico/Zima) para accesibilidad remota.
- La herramienta es de naturaleza beta y no ejecuta comandos, ni abre sesiones SSH, ni realiza comprobaciones en vivo contra la infraestructura.
- Las exportaciones PNG están sujetas a límites de tamaño de imagen del navegador para diagramas muy grandes.
- No incluye soporte automático para actualizaciones; los usuarios deben gestionar manualmente las versiones de la imagen Docker.
- La funcionalidad de planificación (Planning Mode) tiene baja adopción y podría ser eliminada en futuras versiones según el desarrollador.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado mediante Docker Compose con la imagen `ghcr.io/noobcity99/ctroadmap:beta`. Asegurar que el puerto 8088 sea accesible desde redes externas si se requiere acceso remoto. Configurar un código de acceso local en Settings antes de exponer la aplicación públicamente para proteger el acceso a la interfaz. Realizar copias de seguridad completas de los directorios `data` y `exports` antes de cualquier actualización o desinstalación, ya que estos contienen el estado persistente del atlas y las exportaciones generadas.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.