> ## 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.

# Arquitectura y operaciones

> Sigue los estándares de arquitectura, observabilidad y operación que todo plugin debe cumplir para interoperar con Midaz y funcionar en producción.

Los plugins en el ecosistema de Lerian deben diseñarse teniendo en cuenta la interoperabilidad, escalabilidad y resiliencia. Esta sección describe los estándares arquitectónicos y de infraestructura que aseguran que tu plugin se conecte a Midaz a través de sus interfaces estándar y funcione de manera confiable en producción.

Estos son **requisitos obligatorios** para cada solución de socio publicada en el Lerian Marketplace.

## Lenguaje de programación y arquitectura

***

Eres libre de elegir el lenguaje de programación que mejor se adapte a tu plugin, pero ten en cuenta que el stack de Lerian está construido principalmente en **Golang**, y tu solución debe interoperar con él a través de sus interfaces estándar.

**Recomendamos:**

* Diseño container-first usando **Docker**.
* **Domain-Driven Design (DDD)** para una modularidad limpia.
* **Aislamiento** de responsabilidades y prácticas amigables con microservicios.

## Requisitos del modelo MSP

***

Todos los plugins deben estar diseñados para ejecutarse bajo el modelo **Managed Service Provider (MSP)**, con:

* **Infrastructure as Code (IaC)** documentada, preferiblemente en Terraform.
* **Helm Charts** para despliegues en Kubernetes.
* Despliegue declarativo con **GitOps**.

<Danger>
  GitOps es obligatorio para asegurar despliegues en producción trazables y predecibles en todos los entornos.
</Danger>

## Observabilidad

***

Los plugins deben ser **observables por diseño**, incluyendo:

* Logs estructurados
* Métricas específicas del dominio
* Tracing distribuido

Todos los datos de observabilidad deben integrarse con **OpenTelemetry (OTel)** y soportar exportaciones **OTLP**.

<Tip>
  Los destinos comunes incluyen Datadog, Prometheus y otras herramientas APM.
</Tip>

## Auditabilidad y trazabilidad

***

Si tu plugin maneja transacciones, debe integrarse con **Trillian** o una solución equivalente para:

* Logs de auditoría inmutables y verificables
* Verificación de integridad (compatible off-chain)

<Warning>
  Los plugins que impactan datos financieros sin auditabilidad no pasarán la homologación.
</Warning>

## Autenticación y autorización

***

Cada plugin debe integrarse con el Access Manager de Lerian, nuestro plugin de identidad y control de acceso.

<Note>
  Esto asegura una experiencia de autenticación unificada para los clientes. Para más información, consulta la [Guía de Access Manager](/es/platform/access-manager/access-manager).
</Note>