> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Sobre Midaz

> Visión general de alto nivel de la arquitectura y componentes principales de Midaz

export const GAccountType = ({children}) => <Tooltip headline="Tipo de cuenta" tip="Una clasificación que define la naturaleza y propósito de una cuenta — como corriente, ahorro, depósito en garantía o liquidación — permitiendo el enrutamiento adecuado de transacciones." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GAuditTrail = ({children}) => <Tooltip headline="Registro de auditoría" tip="Un registro cronológico e inmutable de cada acción y transacción en el sistema — esencial para el cumplimiento regulatorio y la resolución de disputas." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GOperation = ({children}) => <Tooltip headline="Operación" tip="La unidad atómica de movimiento en el ledger — un solo débito o crédito. Cada transacción se compone de una o más operaciones, proporcionando trazabilidad precisa para cumplimiento y reportes." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GOperationRoute = ({children}) => <Tooltip headline="Operation Route" tip="Una plantilla reutilizable que define las reglas para una etapa de una transacción financiera — especificando qué cuentas participan, en qué dirección y bajo qué anotación contable." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GTransactionRoute = ({children}) => <Tooltip headline="Accounting Route" tip="Un plano completo de transacción compuesto por múltiples Operation Routes — definiendo todos los débitos y créditos involucrados en un tipo de transacción, asegurando el cumplimiento de partida doble." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GSegment = ({children}) => <Tooltip headline="Segmento" tip="Una clasificación aplicada a cuentas que comparten características — como niveles de clientes (VIP, Estudiante) o divisiones regionales — permitiendo reglas y precios diferenciados." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GPortfolio = ({children}) => <Tooltip headline="Portfolio" tip="Una agrupación de cuentas pertenecientes al mismo cliente, unidad de negocio o propósito — uniendo cuentas corrientes, de ahorro e inversión en una vista unificada." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GAsset = ({children}) => <Tooltip headline="Asset" tip="Una unidad de valor rastreada en el ledger — monedas tradicionales (BRL, USD), monedas digitales (BTC) o unidades personalizadas como puntos de fidelidad. Cada cuenta está vinculada a exactamente un asset." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GSourceAvailable = ({children}) => <Tooltip headline="Source-available" tip="Un modelo de licencia donde el código fuente es públicamente accesible para inspección, modificación y auto-hospedaje, mientras que ciertos usos comerciales pueden requerir una licencia." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GDoubleEntry = ({children}) => <Tooltip headline="Partida doble" tip="Cada movimiento financiero se registra como al menos dos operaciones: un débito de una cuenta y un crédito en otra, asegurando que el sistema siempre esté balanceado." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

export const GLedger = ({children}) => <Tooltip headline="Ledger" tip="El libro financiero central que registra todas las transacciones, saldos y operaciones de una organización — la fuente única de verdad para las finanzas de una unidad de negocio." cta="Ver glosario" href="/es/glossary">
    {children}
  </Tooltip>;

Midaz es la espina dorsal de las infraestructuras financieras modernas, diseñado para ayudar a las instituciones a construir, operar y escalar **ecosistemas transaccionales** con **agilidad** y **precisión**. Como <GLedger>Ledger</GLedger> central de código fuente disponible (<GSourceAvailable>*source-available core ledger*</GSourceAvailable>), Midaz ofrece una base modular y extensible, lo que permite a los clientes dar forma a sus operaciones financieras con independencia.

En esencia, Midaz se estructura en torno a dos dominios esenciales: *Onboarding* y *Transaction*. Juntos, proporcionan un marco completo para **configurar**, **ejecutar** y **gobernar** flujos financieros a escala.

<Note>
    Esta arquitectura dirigida por dominios (*domain-driven*) garantiza que la configuración (*Onboarding*) y la ejecución (*Transaction*) permanezcan claramente separadas, pero totalmente integradas, lo que permite rendimiento, **trazabilidad** y agilidad empresarial.
</Note>

## Dominios y APIs

***

### Dominio de Onboarding

El **dominio de Onboarding** es donde las instituciones estructuran sus operaciones financieras **configurando** las entidades esenciales de su *Ledgers*. Este dominio establece las reglas, cuentas y relaciones que rigen cómo se registrarán e interpretarán las transacciones.

#### Componentes del dominio de Onboarding

* **Organizaciones**: Representa una entidad comercial — como un banco, fintech o subsidiaria — que opera dentro de Midaz. Cada organización posee sus propios *Ledgers*, configuraciones y controles de acceso, lo que permite operaciones multi-entidad bajo una sola plataforma.
* **<GLedger>Ledgers</GLedger>**: El libro financiero central de una organización. Los *Ledgers* rastrean cada saldo, transacción y operación, asegurando la **integridad** en todos los datos financieros. Piensa en un ledger como la fuente única de verdad para las finanzas de una unidad de negocio.
* **<GAsset>Activos</GAsset>**: Definen las unidades de valor rastreadas en el *Ledger* — como BRL, USD, BTC o puntos de fidelidad. Esta flexibilidad permite a las instituciones gestionar monedas tradicionales, activos digitales y programas de recompensas personalizados dentro del mismo sistema.
* **<GAccountType>Tipos de Cuenta</GAccountType>**: Clasificaciones que definen la naturaleza y el propósito de las cuentas (p. ej., corriente, ahorro, custodia, liquidación). Estos tipos permiten el **enrutamiento** adecuado de las transacciones y aseguran que las reglas de negocio se apliquen de forma consistente en todas las categorías de cuentas.
* **Cuentas**: Las unidades fundamentales de almacenamiento de valor — donde el dinero (o cualquier activo) realmente reside. Las cuentas siempre están vinculadas a un activo y se pueden organizar aún más en segmentos o portafolios para reflejar tu estructura de negocio.
* **<GPortfolio>Portafolios</GPortfolio>**: Agrupan múltiples cuentas que pertenecen al mismo cliente, unidad de negocio o propósito. Por ejemplo, un solo cliente puede tener cuentas corrientes, de ahorro y de inversión en diferentes monedas — un portafolio las une para una vista unificada.
* **<GSegment>Segmentos</GSegment>**: Permiten la agrupación de cuentas bajo características compartidas, como niveles de cliente (p. ej., VIP, Estudiante) o divisiones regionales. Los segmentos ayudan a aplicar reglas diferenciadas, precios o beneficios en toda tu base de clientes.

<Tip>
  El Dominio de Onboarding configura cómo se estructura tu mundo financiero, asegurando la **coherencia** antes de que tenga lugar cualquier transacción.
</Tip>

### Dominio de Transacción

Una vez que se configura el dominio de Onboarding, el **dominio de Transacción** toma el control, impulsando la ejecución en tiempo real, el movimiento y la **conciliación** de fondos.

#### Componentes del dominio de Transacción

* **Saldos**: Recupera el saldo actual de cualquier cuenta, incluyendo sus montos disponibles, en espera (*on-hold*) y reservados. Esta es la instantánea financiera en tiempo real que respalda validaciones, comprobaciones previas a la transacción y visualizaciones orientadas al cliente.
* **<GOperationRoute>Rutas de Operación</GOperationRoute>**: Plantillas reutilizables que definen las reglas para cada "tramo" (*leg*) de una transacción financiera — especificando qué cuentas participan, en qué dirección (origen/destino) y bajo qué anotación contable. Aseguran que cada tipo de transacción siga reglas de negocio consistentes.
* **<GOperation>Operaciones</GOperation>**: La unidad **atómica** de movimiento en el *Ledger* — un único débito o crédito. Todos los movimientos financieros se descomponen en operaciones, proporcionando un <GAuditTrail>rastro de auditoría</GAuditTrail> completo y trazabilidad precisa para cumplimiento y reportes.
* **<GTransactionRoute>Rutas Contables</GTransactionRoute>**: Plantillas de transacción completas compuestas por múltiples Rutas de Operación. Por ejemplo, una ruta de "Transferencia Pix" define todos los débitos y créditos involucrados, asegurando el cumplimiento de <GDoubleEntry>doble entrada</GDoubleEntry> cada vez que se ejecuta ese tipo de transacción. (Se expone como el recurso `transactionRoute` en la API.)
* **Transacciones**: El movimiento real de valor entre cuentas. Las transacciones pueden involucrar múltiples **Operaciones** (p. ej., comisiones, impuestos, divisiones), permitiendo flujos financieros complejos como pagos de marketplace o liquidaciones multi-parte en un solo evento atómico.

<Tip>
  El dominio de Transacción garantiza que cada movimiento se procese con precisión, transparencia y de acuerdo con las reglas contables y de negocio configuradas previamente.
</Tip>

## En resumen

***

Midaz es una plataforma de *Ledger* dirigida por dominios, diseñada para la **fiabilidad**, la **flexibilidad** y la **gobernanza**.

| Dominio         | Propósito                                                        | APIs Clave                                                                                   |
| :-------------- | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------- |
| **Onboarding**  | Estructura y configuración del ecosistema financiero.            | Organizaciones, Ledgers, Activos, Tipos de cuenta, Cuentas, Portafolios, Segmentos.          |
| **Transacción** | Ejecución, movimiento y contabilidad de operaciones financieras. | Saldos, Rutas Contables (`transactionRoute`), Transacciones, Rutas de operación, Operaciones |

Con esta arquitectura, Midaz permite a las instituciones financieras estructurar sus datos con precisión y operar a escala, al tiempo que mantienen el **control** total y la **transparencia** sobre su ecosistema financiero.
