drawio
Herramienta de diagramación visual que permite crear diagramas arquitectónicos complejos con interfaz gráfica. Los diagramas se almacenan como XML, lo que los hace versionables en Git y facilita la colaboración.
When to use
Usar cuando se necesiten diagramas de arquitectura de alto nivel que requieran mayor detalle visual que PlantUML/Mermaid, como diagramas de infraestructura completos, mapas de red o diagramas de flujo con elementos gráficos personalizados. Ideal para presentaciones a stakeholders no técnicos o documentación de arquitectura detallada del sistema KYC.
Instructions
- Instalar draw.io Desktop desde https://github.com/jgraph/drawio-desktop/releases o usar la extensión de VS Code
hediet.vscode-drawio. - Crear archivos
.drawiodentro dedocs/diagrams/con la convención<nombre_descriptivo>.drawio. - Diseñar diagramas de arquitectura del sistema de verificación incluyendo todos los módulos: liveness, OCR, face_match, doc_processing, antifraud y decision.
- Representar las conexiones entre servicios, bases de datos (PostgreSQL, Redis), almacenamiento (MinIO) y APIs externas de fallback.
- Exportar a SVG o PNG para inclusión en documentación: File > Export as > SVG/PNG.
- Guardar siempre el archivo
.drawio(XML) en el repositorio como fuente de verdad, además de los archivos exportados. - Configurar la extensión de VS Code para editar los diagramas directamente desde el IDE sin necesidad de abrir la aplicación de escritorio.
Notes
- Los archivos
.drawioson XML plano, lo que permite diffs legibles en Git aunque no sean perfectos visualmente. - Usar la extensión de VS Code para edición rápida y la aplicación de escritorio para diagramas complejos que requieran mayor control visual.
- Mantener una librería de shapes personalizada para los componentes recurrentes del sistema (módulos, bases de datos, servicios ML).