Diagramas fáciles con FlossFLOW y Docker

En un sin fin de proyectos en los que he trabajado he tenido que realizar algún diagrama, para mostrar toda la arquitectura y la relación de todos los elementos entre si. Creo que a estas alturas de la película, no hace falta que te diga, si eres administrador de sistemas o desarrollador, la necesidad de herramientas que nos faciliten este trabajo.

Para ello hoy voy a hablar de la herramienta FlossFLOW, pero antes de entrar en la parte del despliegue, veamos primero porque son necesarios los esquemas y los diagramas.

¿Por qué usar esquemas y diagramas?

La visualización de datos no es solo estética,es necesaria. Esta necesidad la podemos definir en varios pilares

• Velocidad de comprensión: El cerebro humano procesa imágenes mucho más rápido que el texto. Un diagrama convierte una explicación de 10 minutos en un vistazo de 5 segundos.
• Un lenguaje Universal: Los esquemas rompen las barreras técnicas. Permiten que un cliente, un gestor y un desarrollador entiendan lo mismo sin necesidad de usar el mismo vocabulario.
• Detección de errores: Al mapear un proceso, los fallos, pasos innecesarios o «cuellos de botella» se vuelven evidentes de inmediato.
• Memoria técnica: Sirven como el mapa de ruta de cualquier proyecto. Facilitan que el conocimiento no se pierda con el tiempo y que las nuevas incorporaciones entiendan todo rápidamente. ¡Documenta!

Un poco de historia: El origen de FlossFLOW

El proyecto FossFLOW, creado por Stan Smith, es una herramienta diseñada específicamente para generar diagramas isométricos (3D) de una manera profesional y sencilla. Su historia es un testimonio de la colaboración en el código abierto:

• La base (Isoflow): Como indica el propio Stan, FossFLOW está construido sobre la biblioteca Isoflow, desarrollada originalmente por @markmanx. Esta biblioteca es el «motor» que permite el renderizado isométrico de alta calidad.
• La evolución hacia FossFLOW: El autor tomó este motor y lo expandió para crear una aplicación web completa y accesible, añadiendo funcionalidades críticas como: Soporte multilingüe (incluyendo el español). Capacidad de funcionar como PWA (aplicación instalable). Un sistema de almacenamiento persistente diseñado para entornos modernos.
• Filosofía FOSS: El nombre recalca su naturaleza Free and Open Source. El autor mantiene el proyecto de forma independiente, buscando ofrecer una alternativa gratuita y privada que cualquiera pueda auto-alojar.

Desplegar FlossFLOW con Docker

Ya sabéis que suelo desplegar los proyectos que quiero probar con Docker, vía fichero de Docker Compose. En este caso no utilizaré mi RaspBerryPi, sino una máquina virtual que también tengo con varios proyectos de contenedores. Para la ocasión he utilizado esta configuración:

services:
  fossflow:
    image: stnsmith/fossflow:latest
    container_name: fossflow_app
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./diagramas_fossflow:/data/diagrams
    environment:
      - ENABLE_SERVER_STORAGE=true

Nada complicado, todo bastante simple y fácil.

Una vez desplegado podemos empezar a trabajar. Para muestra un botón (realmente no me he «matado» mucho, y no he tardado ni dos minutos en hacer lo que se en la imagen)

Ejemplo simple de uso de FlossFLOW

Igualmente, si lo queréis probar antes de desplegarlo, lo podéis hacer aquí: https://stan-smith.github.io/FossFLOW/

Como punto final, quiero agradecer a mi compañero de batallas en la oficina,  Lio, que sin él no hubiera conocida esta fantástica herramienta.