@oondemand/create-central-oon 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,6 +6,12 @@ O backend verifica o token no escopo do App, resolve tenant e acesso, aplica a p
6
6
 
7
7
  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.
8
8
 
9
+ ## Catálogo público de perfis
10
+
11
+ 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.
12
+
13
+ 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.
14
+
9
15
  ## Local
10
16
 
11
17
  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.
@@ -22,6 +22,32 @@ Use o RBAC do Core para:
22
22
  - proteger rotas;
23
23
  - permitir evolução de permissões sem reconstruir telas.
24
24
 
25
+ ## Catálogo canônico de perfis
26
+
27
+ ```http
28
+ GET /core/role-catalog
29
+ ```
30
+
31
+ Resposta:
32
+
33
+ ```json
34
+ {
35
+ "schemaVersion": 1,
36
+ "appCode": "central-compras",
37
+ "enabled": true,
38
+ "roles": [
39
+ {
40
+ "code": "viewer",
41
+ "name": "Consulta",
42
+ "description": "Somente leitura.",
43
+ "admin": false
44
+ }
45
+ ]
46
+ }
47
+ ```
48
+
49
+ 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.
50
+
25
51
  ## Checklist de segurança para Agents
26
52
 
27
53
  Antes de concluir uma alteração, confirme:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oondemand/create-central-oon",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "repository": {
5
5
  "type": "git",
6
6
  "url": "git+https://github.com/oondemand/oon-platform.git",
@@ -12,6 +12,6 @@
12
12
  "deploy": "oonCore-back deploy"
13
13
  },
14
14
  "dependencies": {
15
- "@oondemand/oon-core-back": "^0.5.0"
15
+ "@oondemand/oon-core-back": "^0.5.1"
16
16
  }
17
17
  }
@@ -11,7 +11,7 @@
11
11
  "sync:metadata": "oonCore-front sync:metadata"
12
12
  },
13
13
  "dependencies": {
14
- "@oondemand/oon-core-front": "^0.5.0",
14
+ "@oondemand/oon-core-front": "^0.5.1",
15
15
  "@chakra-ui/react": "^3.13.0",
16
16
  "@emotion/react": "^11.14.0",
17
17
  "@tanstack/react-query": "^5.65.0",
@@ -13,6 +13,6 @@
13
13
  "dev:frontend": "npm run dev --prefix frontend"
14
14
  },
15
15
  "devDependencies": {
16
- "@oondemand/create-central-oon": "0.5.0"
16
+ "@oondemand/create-central-oon": "0.5.1"
17
17
  }
18
18
  }