Figura 1. Midaz y sus dominios interconectados y estructura modular.
Componentes centrales
Midaz
Midaz está en el centro. Coordina todo, desde la persistencia de datos hasta la lógica de negocio.Capa de datos
Todos los datos fluyen hacia la capa de datos persistente. Esta capa aporta durabilidad, consistencia y rendimiento al sistema.Dominios y relaciones
Organizaciones
Cada organización es un entorno distinto en Midaz. Puede contener uno o varios ledgers, según cómo estructures tus datos.Ledgers
Un ledger contiene toda la actividad financiera. Rastrea saldos, almacena activos e impulsa transacciones. Cada ledger pertenece a una organización. Desde aquí, el sistema se ramifica en:- Activos: definen el tipo de valor que rastreas.
- Portafolios: agrupan cuentas relacionadas bajo un propósito compartido.
Activos
Los activos definen las unidades de valor, como BRL, USD, puntos o tokens. Cada cuenta usa un activo específico.Portafolios
Los portafolios agrupan cuentas por lógica de negocio. Puedes crear tantos portafolios como necesites para organizar tu estructura financiera. Cada portafolio contiene una o más cuentas.Cuentas y Segmentos
Una cuenta pertenece a un portafolio y representa un saldo individual. Los Segmentos agrupan cuentas, para que puedas aislar datos por cliente, producto, región o cualquier otra dimensión. Los segmentos te ayudan a rastrear e informar con precisión. Los Tipos de Cuenta clasifican las cuentas por naturaleza y propósito. Permiten el enrutamiento de transacciones y la validación operativa entre categorías de cuentas.Saldos
Un Saldo representa el monto neto que una Cuenta mantiene de un Activo determinado en un Ledger específico.- Una cuenta puede tener múltiples saldos. Cada uno tiene una
balanceKey(p. ej.default,collateral,operational) para particionar fondos sin dividir la cuenta. - Una cuenta externa tiene un solo saldo (
default). - Si omites
balanceKeyen una transacción, Midaz usa el saldo predeterminado. - Midaz deriva los saldos automáticamente de las operaciones del ledger. Puedes listarlos, consultarlos o (en escenarios de administración o prueba) ajustarlos manualmente.
- La clave de caché de Valkey incluye
balanceKeyen su formato:balance:{transactions}:<orgId>:<ledgerId>:<alias>#<balanceKey>.
Transacciones
Una transacción mueve valor entre cuentas. Cada transacción contiene operaciones (débitos y créditos). Esto mantiene tu lógica consistente, trazable y alineada con tu modelo de negocio y tus políticas contables.Entidades de Rutas Contables
Las entidades de Rutas Contables amplían Midaz. Crean un sistema estructurado que garantiza anotaciones correctas y direcciones de flujo financiero correctas. Tiene dos partes:- Rutas de Operación: definen comportamientos atómicos de transacción. Cada ruta establece cómo Midaz anota y dirige un movimiento financiero, según tus reglas de negocio y estándares contables.
- Rutas Contables: orquestan múltiples Rutas de Operación en eventos financieros balanceados. Aplican la validación de doble entrada y mantienen la integridad de la transacción en todas las cuentas. (La API lo llama
transactionRoute.)
En resumen
Midaz te ofrece una estructura modular:
- Las Organizaciones gestionan ledgers.
- Los Ledgers contienen activos, portafolios y estructuras contables.
- Los Portafolios contienen cuentas, agrupadas por segmento.
- Las Transacciones mueven valor y desencadenan tratamientos contables.
- Tus datos permanecen sincronizados, trazables y listos para la elaboración de informes financieros.