@oondemand/create-central-oon 0.5.0 → 0.5.2

package/docs/AUTH_ACTIVATION_RBAC.md

@@ -6,6 +6,12 @@ O backend verifica o token no escopo do App, resolve tenant e acesso, aplica a p
 
 Ativação de plataforma cria a identidade operacional usada por integrações autorizadas. Rotas de login, launch exchange, ativação e primeiro acesso não estão disponíveis no runtime local.
 
+## Catálogo público de perfis
+
+Todo App com RBAC declarado expõe `GET /core/role-catalog`. O contrato `schemaVersion: 1` contém apenas `appCode`, `enabled` e `roles[]` com `code`, `name`, `description` e `admin`. Permissões internas não são expostas.
+
+O catálogo serve para descoberta e seleção de perfis pelo Control Plane. Ele não concede acesso: o backend consumidor deve validar `schemaVersion` e `appCode`, consultar somente o Deployment resolvido pela plataforma, revalidar o perfil antes de persistir o grant e falhar fechado quando o catálogo estiver ausente ou inválido.
+
 ## Local
 
 O principal técnico é `local:developer`, sem usuário/tenant/licença na plataforma. O papel inicial é `developer` quando declarado, seguido por admin ou primeiro papel. A troca de perfil aceita apenas o manifesto e atualiza a sessão local.

package/docs/FRONTEND_MANIFEST_REFERENCE.md

@@ -444,3 +444,42 @@ Tipos de aba:
 - `customComponent`: chave de componente registrado.
 
 `apiAction.endpoint` aceita `:id`, `:parentId`, `:fieldName` e `:parent.fieldName`. `refresh` aceita `self`, `parent`, `all` ou ids de abas.
+
+
+## Opções remotas em campos de formulário
+
+Campos `enum` podem carregar opções de um endpoint dependente do formulário atual ou do registro pai. O contrato funciona em formulários principais e em criação/edição de `relatedGrid`.
+
+```ts
+{
+  field: "roleCode",
+  label: "Perfil",
+  kind: "enum",
+  optionsEndpoint: "/control-plane/app-role-catalogs/:appId?tenantId=:parentId",
+  optionsResponsePath: "options",
+  optionsValueField: "value",
+  optionsLabelField: "label",
+  optionsDescriptionField: "description",
+  optionsEditablePath: "editable",
+  optionsDependsOn: ["appId", "tenantId"],
+  fallbackOptions: [{ value: "admin", label: "Administrador" }],
+  readonlyOnFallback: true,
+  optionsUnavailableMessage: "Catálogo indisponível; perfil admin aplicado."
+}
+```
+
+| Campo | Uso |
+| --- | --- |
+| `optionsEndpoint` | Endpoint relativo. Aceita `:field`, `:parentId` e `:parent.field`; valores são codificados para URL. |
+| `optionsResponsePath` | Caminho da lista na resposta. Sem valor, a própria resposta deve ser um array. |
+| `optionsValueField` | Campo usado como valor da opção; padrão `value`. |
+| `optionsLabelField` | Campo usado como rótulo; padrão `label`. |
+| `optionsDescriptionField` | Campo opcional de descrição. |
+| `optionsEditablePath` | Booleano remoto que permite ou bloqueia a edição. |
+| `optionsDependsOn` | Campos que precisam estar preenchidos e cuja mudança invalida a seleção atual. |
+| `fallbackOptions` | Opções seguras usadas quando o endpoint falha ou retorna lista vazia. |
+| `readonlyOnFallback` | Bloqueia a seleção durante o fallback; padrão `true`. |
+| `optionsUnavailableMessage` | Mensagem explicando o fallback ao usuário. |
+| `readonly` | Bloqueia o campo em qualquer estado. |
+
+O backend continua responsável por validar o valor selecionado. Opções remotas melhoram a experiência, mas não substituem autorização nem validação de domínio.

package/docs/RBAC_SECURITY.md

@@ -22,6 +22,32 @@ Use o RBAC do Core para:
 - proteger rotas;
 - permitir evolução de permissões sem reconstruir telas.
 
+## Catálogo canônico de perfis
+
+```http
+GET /core/role-catalog
+```
+
+Resposta:
+
+```json
+{
+  "schemaVersion": 1,
+  "appCode": "central-compras",
+  "enabled": true,
+  "roles": [
+    {
+      "code": "viewer",
+      "name": "Consulta",
+      "description": "Somente leitura.",
+      "admin": false
+    }
+  ]
+}
+```
+
+Use esse endpoint para montar seletores e validar grants por App. Não mantenha códigos de perfil paralelos no frontend ou no Control Plane. O consumidor deve validar versão e App, bloquear redirects e destinos de rede privados, revalidar o perfil no backend e tratar catálogo inválido como indisponível. O endpoint usa cache público de cinco minutos e nunca expõe a lista de permissões; a autorização efetiva continua no App.
+
 ## Checklist de segurança para Agents
 
 Antes de concluir uma alteração, confirme:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oondemand/create-central-oon",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",

package/templates/_base/backend/package.json

@@ -12,6 +12,6 @@
     "deploy": "oonCore-back deploy"
   },
   "dependencies": {
-    "@oondemand/oon-core-back": "^0.5.0"
+    "@oondemand/oon-core-back": "^0.5.2"
   }
 }

package/templates/_base/frontend/package.json

@@ -11,7 +11,7 @@
     "sync:metadata": "oonCore-front sync:metadata"
   },
   "dependencies": {
-    "@oondemand/oon-core-front": "^0.5.0",
+    "@oondemand/oon-core-front": "^0.5.2",
     "@chakra-ui/react": "^3.13.0",
     "@emotion/react": "^11.14.0",
     "@tanstack/react-query": "^5.65.0",

package/templates/_base/package.json

@@ -13,6 +13,6 @@
     "dev:frontend": "npm run dev --prefix frontend"
   },
   "devDependencies": {
-    "@oondemand/create-central-oon": "0.5.0"
+    "@oondemand/create-central-oon": "0.5.2"
   }
 }