Versionado y lanzamiento
La disciplina de versionado y lanzamiento es crítica para asegurar la previsibilidad para los clientes y la interoperabilidad en todo el ecosistema de Lerian. Todos los plugins deben seguir las mismas reglas de versionado y alinearse con el ciclo de lanzamiento oficial de Lerian.
Versionado
Todos los plugins deben usar Semantic Versioning 2.0.0.- MAJOR: cambios incompatibles en la API o el comportamiento.
- MINOR: adiciones de funcionalidades compatibles con versiones anteriores.
- PATCH: correcciones de errores compatibles con versiones anteriores.
Consulta nuestra página simplificada de Versionado para ejemplos prácticos.
Ciclo de lanzamiento
Todos los lanzamientos de plugins deben alinearse con el calendario oficial de lanzamientos de Lerian. Esto asegura previsibilidad y actualizaciones fluidas para los clientes compartidos.- Los flujos de desarrollo interno permanecen independientes
- Los lanzamientos públicos deben seguir el ciclo de Lerian
- Las versiones patch para hotfixes o actualizaciones críticas pueden lanzarse fuera del ciclo
Los lanzamientos desalineados pueden ser rechazados para publicación en el Lerian Marketplace.
Documentación técnica
La documentación clara y consistente es obligatoria para cada plugin en el ecosistema de Lerian. Tus clientes dependen de ella para adoptar, integrar y operar tu solución de manera efectiva. Toda la documentación oficial de plugins debe alojarse en el Lerian Documentation Hub para asegurar una experiencia unificada.
Documentación requerida
Cada plugin debe proporcionar al menos:- Guías: para reglas de negocio, configuración y uso.
- Referencia de API: para todos los endpoints expuestos y documentación técnica.
Puedes alojar tu propia documentación, pero los clientes deben ser redirigidos al sitio oficial de Lerian para contenido técnico autorizado.
Estándares y plantillas
Para garantizar consistencia y usabilidad, toda la documentación debe seguir los Estándares de escritura de Lerian.Por qué esto importa
La documentación de calidad es un requisito de cumplimiento, no un extra. Reduce la fricción de incorporación, previene el mal uso y mantiene el soporte al cliente eficiente.Los plugins sin documentación adecuada no serán aprobados para publicación.
Proceso de aprobación
Antes de que un plugin pueda publicarse en el Lerian Marketplace, debe pasar un estricto proceso de homologación. Esto asegura que cada solución cumpla con los estándares de calidad, seguridad y cumplimiento de Lerian.
Los plugins que no pasen alguna de estas verificaciones no serán aprobados para publicación. Todos los problemas identificados deben resolverse antes de volver a enviar.
Requisitos de homologación
Antes de ser publicados, todos los plugins deben pasar una revisión formal, que incluye:- Checklist técnico — arquitectura, estándares de codificación, observabilidad y cumplimiento de API.
- Checklist de seguridad — pentests, auditorías y controles de protección de datos.
- Verificaciones de calidad y rendimiento — cobertura de pruebas, escalabilidad y reportes de pruebas de estrés.
- Revisión de cumplimiento regulatorio — verificación contra BACEN y otros organismos reguladores.
- Pruebas end-to-end — validación con Midaz u otras soluciones de Lerian para confirmar la interoperabilidad.
SLAs basados en severidad
Si tu plugin se distribuye bajo un acuerdo de soporte donde tú, como socio de desarrollo, eres responsable del mantenimiento, debes seguir las directrices de SLA basadas en severidad de Lerian. Estas reglas aseguran la resolución oportuna de problemas y una experiencia consistente para los clientes en todo el ecosistema.
Por qué esto importa
Cumplir con los SLAs refuerza la confianza en el ecosistema de Lerian. Los clientes pueden confiar en tiempos de respuesta predecibles, mientras que los socios demuestran responsabilidad y profesionalismo en el soporte de sus soluciones.Plazos de resolución
Estos SLAs definen el tiempo máximo permitido para entregar una corrección, según la severidad del problema reportado:| Severidad | Tiempo de resolución requerido |
|---|---|
| Alta | Corrección en 5 días hábiles |
| Media | Corrección en 10 días hábiles |
| Baja | Corrección en 30 días hábiles |
Los plazos se refieren a días hábiles y aplican desde el momento en que se confirma el problema.Estos SLAs son obligatorios para todos los plugins con soporte de socios.