Saltar al contenido principal
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.
GitOps es obligatorio para asegurar despliegues en producción trazables y predecibles en todos los entornos.

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.
Los destinos comunes incluyen Datadog, Prometheus y otras herramientas APM.

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)
Los plugins que impactan datos financieros sin auditabilidad no pasarán la homologación.

Autenticación y autorización


Cada plugin debe integrarse con el Access Manager de Lerian, nuestro plugin de identidad y control de acceso.
Esto asegura una experiencia de autenticación unificada para los clientes. Para más información, consulta la Guía de Access Manager.