> ## 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.
# Fundamentos del licenciamiento
> Entiende cómo Lerian licencia funciones empresariales y plugins, por qué existen las licencias y cómo se estructura el modelo de monetización modular.
Midaz, nuestro Core source-available, es gratuito. Pero cuando se trata de monetizar el resto del portafolio de Lerian — productos, funciones y plugins empresariales, ya sean desarrollados por Lerian o nuestros socios — dependemos de un sistema de licencias para gestionar el acceso.
## Por qué importan las licencias
***
Sin licencias, no podemos **asegurar el pago** antes del uso, **adaptar el acceso** por cliente, o **escalar el soporte** y las operaciones comerciales con confianza.
Las licencias nos ayudan a proteger los ingresos, simplificar operaciones y asegurar que los clientes obtengan lo que pagaron; ni más, ni menos.
## Cómo monetiza Lerian
***
El modelo de negocio de Lerian es modular. Cada línea de producto puede requerir una licencia para desbloquear el acceso:
| Línea de ingresos | Descripción |
| :------------------------------ | :----------------------------------------------------------------------------------------------- |
| **Soporte** | Soporte técnico + acceso a plugins empresariales como paquete |
| **Marketplace / Plugins** | Licencias individuales de plugins, facturadas mensualmente. Incluye plugins de Lerian y terceros |
| **Aprendizaje y certificación** | Cursos y certificaciones relacionados con Midaz y su ecosistema |
| **Servicios profesionales** | Consultoría personalizada y entrega de proyectos |
Las funciones empresariales incluidas en el plan de Soporte son en realidad plugins — pero con licencia como un paquete unificado en lugar de uno por uno.
## Escenarios de licenciamiento soportados
***
Tu plugin debe soportar todos los siguientes casos de uso:
| Escenario | Descripción |
| :-------------------------------- | :---------------------------------------------------------------- |
| **Comunidad** | Solo OSS. No se requiere licencia |
| **Solo soporte** | Una licencia global para funciones empresariales de Lerian |
| **Soporte + plugins de Lerian** | Una licencia global + licencias individuales por plugin de Lerian |
| **Soporte + plugins de terceros** | Una licencia global + licencias individuales por plugin de socio |
| **Soporte + plugins mixtos** | Configuración combinada: licencias de Lerian + socios |
Nuestro sistema también debe soportar modelos SaaS futuros, permitiendo a los socios licenciar y distribuir sus propios plugins de forma independiente.
## Cómo funciona el Gestor de licencias
***
### Impulsado por KeyGen
Usamos [KeyGen](https://keygen.sh/) para gestionar las claves de licencia y su ciclo de vida. Soporta:
* Generación de claves de licencia
* Control de estado (activa, expirada, revocada)
* Validación periódica
* Integración con flujos de facturación futuros
Aunque actualmente usamos ciclos de facturación mensuales, nuestro sistema está preparado para otros intervalos, como quincenal, trimestral o anual.
## Flujo de validación de licencias
***
Cada plugin o función empresarial debe validar regularmente su licencia usando el SDK oficial **una vez por semana**.
El SDK maneja el almacenamiento en caché, lógica de reintentos y degradación elegante, por lo que no necesitas construir esa lógica tú mismo.
### Resultados de estado
| Estado | Comportamiento |
| :------------------------------------------------------------------------- | :------------------------------------------------------------------------------ |
| **Licencia activa** | Acceso completo y cliente en buen estado. |
| **Licencia expirada** | Continuar acceso (período de gracia de 2 semanas) y mostrar advertencia. |
| **Licencia revocada** | Bloquear acceso después del período de gracia hasta que se restaure la licencia |
## Arquitectura
***
### Vista general de validación de licencias
Cada plugin usa el **SDK de Licencias** para verificar si la licencia proporcionada por el cliente es válida. Esto es lo que sucede detrás de escena:
1. El SDK envía la clave de licencia y la información del cliente al servidor de Lerian.
2. Lerian verifica el estado de la licencia:
* ¿Está activa?
* ¿Está expirada, pero aún dentro de un período de gracia?
* ¿Ha sido revocada?
3. El servidor responde con una respuesta que tu plugin puede usar para permitir, advertir o bloquear el acceso.
4. Para mejorar el rendimiento, este resultado se almacena en una caché local para no tener que verificarlo cada vez.
**Lo que necesitas hacer**: Incluye el SDK de Licencias en tu plugin. Se encargará de la validación y el almacenamiento en caché automáticamente.
### Cómo usa cada plugin el licenciamiento
Cada plugin o función empresarial — ya sea desarrollada por Lerian o un socio — usa el **SDK de Licencias** para validar su licencia.
* Cada plugin tiene su propia clave de licencia.
* El SDK verifica la licencia comunicándose con el sistema de licencias de Lerian.
* Lerian verifica que la licencia sea válida usando un backend seguro (impulsado por KeyGen).
* En versiones futuras, las licencias se gestionarán automáticamente según la facturación.
**Lo que necesitas hacer**: Agrega el SDK de Licencias a tu plugin y asegúrate de que llame a `validateLicense()` antes de exponer cualquier función de pago.
## Beneficios para los socios
***
El Gestor de Licencias es más que solo un guardián; es una base para escalar de manera responsable y sostenible.
### Resuelve
* Uso no autorizado de funciones de pago
* Seguimiento y revocación manual de licencias
* Riesgos legales y de cumplimiento
### Habilita
* Monetización transparente de plugins de socios
* Modelos flexibles de reventa y agrupación
* Políticas de licenciamiento configurables: pruebas, renovaciones, ventanas de tolerancia
Las versiones futuras se integrarán con nuestro sistema de facturación para automatizar la revocación y renovación de licencias.