Feature flags nativas
Feature flags permite activar o desactivar una capacidad de una app sin publicar una nueva versión. Cada flag es booleana y queda aislada por empresa, aplicación DSL y entorno (development, staging o production). Solo las aplicaciones DSL propias de la empresa activa son válidas.
La administración requiere una sesión de usuario con rol OWNER o ADMIN. El backend vuelve a comprobar la membresía vigente en cada petición y deriva la empresa desde el contexto autenticado. No se acepta un companyId enviado por el cliente.
Obtener el identificador de evaluación
Cada combinación de app y entorno tiene un identificador público estable. Un OWNER o ADMIN lo obtiene o crea con:
POST /feature-flags/clients
Authorization: Bearer <token>
Content-Type: application/json
{
"applicationId": "<uuid-de-app-dsl-tenant>",
"environment": "development"
}La respuesta 200 contiene publicClientId, applicationId y environment. El ID puede incluirse en la configuración de la app cliente para evaluar las flags de ese scope. No es un secreto y no da acceso administrativo.
Administrar flags
POST /feature-flags
Authorization: Bearer <token>
Content-Type: application/json
{
"applicationId": "<uuid-de-app-dsl-tenant>",
"environment": "development",
"key": "new_dashboard",
"name": "New dashboard",
"enabled": false
}La creación responde 201 y devuelve el ID de la flag.
keyes única dentro de la empresa, app y entorno; admite letras, números, punto, guion y guion bajo, y debe comenzar con una letra.- Si se omite
enabled, se guarda comofalse. GET /feature-flags?applicationId=<uuid>&environment=developmentlista el scope.GET /feature-flags/:idlee una flag;PATCH /feature-flags/:idmodificakey,nameoenabled;DELETE /feature-flags/:idla elimina y devuelve 204.- Una flag de otra empresa no se revela y responde 404.
Evaluación pública
GET /feature-flags/public/<publicClientId>/evaluateLa ruta no requiere sesión y no acepta companyId, applicationId ni environment. El servidor resuelve el scope desde el identificador guardado y devuelve únicamente las claves configuradas y sus valores booleanos:
{
"flags": {
"new_dashboard": false
}
}Las claves que no existen no aparecen; el consumidor puede aplicar su valor predeterminado. El SDK Browser integra la evaluación con OpenFeature y debe degradar a esos valores predeterminados si el servicio no está disponible.
Límites de seguridad y alcance
Una flag controla presentación o comportamiento de la interfaz. No reemplaza autorización, permisos, roles ni entitlements del backend: cada operación protegida debe volver a validar esas reglas en el servidor. La primera versión no incluye targeting por usuario, segmentos, rollout porcentual, variantes ni experimentos.