Skip to main content
Midaz ejecuta el servicio Ledger modular y un servicio Tracer separado. Despliega y escala cada servicio y su infraestructura de soporte según tu entorno. Para una visión general orientada al negocio, consulta Acerca de Midaz.
Midaz puede ejecutarse en entornos de nube pública o privada. Selecciona y opera la infraestructura que se ajuste a tus requisitos de despliegue. Midaz usa una arquitectura modular. Ledger está organizado en torno a límites de dominio, con infraestructura de soporte para almacenamiento, caché, mensajería y streaming. Tracer se ejecuta como un servicio separado.

​
Límite de repositorio y despliegue

Midaz v4.0.0 distribuye dos runtimes en un solo repositorio y lanzamiento source-available ELv2: el monolito modular Ledger (con CRM y Fees) y Tracer. Tracer no está integrado en el proceso Ledger: despliégalo y escálalo por separado. Ledger HTTP v2 puede optar por la interfaz de reserva unidireccional hacia Tracer. Ledger HTTP v1 nunca la llama. La superficie HTTP pública de Tracer se mantiene en /v1, así que la interfaz no crea una API pública Tracer v2. Tracer nunca llama a Ledger.

​
Arquitectura modular

El siguiente diagrama (Figura 1) muestra cómo encajan las piezas.

Figura 1. Macroarquitectura de Midaz

​
1. Capa de clúster (gestión del cliente)

El cliente administra esta capa. Proporciona la base de Kubernetes que ejecuta Midaz. Habilita estos servicios:
  • Service: abstracción de red para exponer y enrutar servicios.
  • AutoScaler: ajusta automáticamente el número de pods.
  • HPA (Horizontal Pod Autoscaler): escala las aplicaciones según métricas.
  • Secrets: gestión segura de datos sensibles.
  • ConfigMap: gestión de configuración externalizada.
Esta capa gobierna y coordina todos los componentes dentro del clúster.

​
2. Capa de front-end

La capa de front-end proporciona la interfaz de usuario para la interacción con el sistema (panel de administración, dashboards y más).
Las versiones más recientes de Midaz ya no incluyen una console empaquetada en el repositorio. La Lerian Console ahora proporciona la interfaz visual. La Lerian Console incluye Midaz como un módulo de producto.Si usas una versión anterior de Midaz, es posible que todavía tengas la Midaz Console independiente. Este componente está ahora en modo de mantenimiento. Recibe solo parches de seguridad críticos. Migra a la Lerian Console para obtener las funciones y mejoras más recientes.

​
3. Capa de back-end

El back-end de Ledger es un monolito modular que contiene las responsabilidades centrales del ledger de Midaz. Midaz también ejecuta Tracer como un servicio separado. Ledger reúne cuatro componentes centrales:
  • Dominio Onboarding: administra organizaciones, ledgers, activos, portafolios, segmentos y cuentas.
  • Dominio Transactions: maneja las transacciones financieras, las operaciones y los movimientos de activos.
  • CRM: está integrado en el proceso Ledger.
  • Fees: está integrado en el proceso Ledger.
Este enfoque mantiene límites de dominio claros. También simplifica el despliegue y reduce la complejidad operativa.

​
4. Capa de datos

Esta capa contiene las bases de datos y los componentes de infraestructura que dan soporte a los datos de la aplicación y a los flujos de eventos:
  • PostgreSQL: bases de datos separadas onboarding y transaction, cada una configurada con conexiones primaria y de réplica.
  • Valkey: un almacén clave-valor compatible con Redis para caché o recuperación rápida de datos.
  • MongoDB: almacena datos no estructurados y semiestructurados, como los metadatos de entidad.
  • RabbitMQ: broker de mensajería para la comunicación asíncrona entre servicios.
  • Redpanda: broker compatible con Kafka para los streams de eventos de Ledger. Ledger publica los eventos configurados en él solo cuando defines STREAMING_ENABLED=true y configuras los brokers de streaming.
La persistencia depende del despliegue. La configuración de Compose incluida no monta un volumen de datos para Redpanda. Configura el almacenamiento y la retención de producción para cada servicio.

​
5. Capa de Helm Chart

Midaz usa Helm Charts para desplegar y configurar la infraestructura. El chart conecta el código con Kubernetes. Despliega cada componente de la misma forma en todos los entornos.
Para más detalles, consulta la página Desplegar con Helm.

​
Cómo funcionan juntas las capas

Cada capa tiene un rol enfocado.
  • Kubernetes coordina cómo se comunican las capas.
  • Helm mantiene los despliegues y las configuraciones sincronizados.
Puedes agregar nuevos componentes según lo necesites sin interrumpir lo que ya está en ejecución.