@oondemand/create-central-oon 0.5.6 → 0.6.1

package/docs/PORTAL_COCKPIT_PATTERNS.md

@@ -1,150 +1,15 @@
-# Portal/Cockpit com OonCore
+# Portais e cockpits code-first
 
-Este padrão atende aplicações como **Meus Apps**, Portal do Cliente, Portal de Parceiros, Suporte, Copilotos e outros Cockpits first-party.
+Portais e cockpits usam o mesmo contrato de frontend dos demais Apps. Defina o
+App com `defineOonApp`, componha rotas com `defineOonRoutes` e inicialize com
+`startOonApp`.
 
-O objetivo é evitar que um portal precise recriar Shell, Router, AuthProvider, Menu, Guards e SDK HTTP. O portal deve usar o `central.ui.json` + `startFromManifest` e registrar apenas os componentes realmente customizados.
+Use páginas locais para jornadas transversais e components do Core para
+autenticação, autorização, tenant, shell, estados e acesso HTTP. O `appKind` não
+cria uma exceção arquitetural nem restringe customização local.
 
-## Perfis arquiteturais
+Para jornadas multi-tenant, passe o tenant específico da operação ao cliente
+HTTP. A seleção visual nunca substitui a autorização do backend.
 
-O OonCore diferencia três perfis:
+Consulte `FRONTEND_CODE_FIRST.md`, `FRONTEND_API.md` e `RBAC_SECURITY.md`.
 
-| Perfil | Uso |
-| --- | --- |
-| `root-central` | Central de Ativações, raiz de confiança. |
-| `member-central` | Central cliente/licenciada, ativada por instância. |
-| `portal-cockpit` | Portal/Cockpit first-party, autenticado por AppClient/BFF. |
-
-## Auth modes
-
-| `auth.mode` | Uso |
-| --- | --- |
-| `bearer` | Token local simples, compatível com Centrais existentes. |
-| `cookie` | Sessão futura via cookie HTTP-only. |
-| `external-sso` | Redireciona para login externo. |
-| `central-instance` | Central membro usando instância ativada. |
-| `central-client` | Portal/Cockpit usando AppClient/BFF. |
-
-## Capabilities no manifesto
-
-Além de `permissions`, o manifesto pode declarar `capabilities`. Elas são permissões dinâmicas vindas da Central de Ativações e evitam criar campos fixos para cada produto.
-
-Exemplos:
-
-```txt
-apps:read
-users:manage
-tickets:read
-tickets:assign
-copilots:read
-copilots:test
-billing:read
-```
-
-O Core trata `permissions` e `capabilities` como requisitos de UI. A segurança real continua no backend.
-
-## Manifesto recomendado
-
-```json
-{
-  "schemaVersion": 2,
-  "name": "Portal Cliente",
-  "slug": "portal-cliente",
-  "appKind": "portal-cockpit",
-  "auth": {
-    "mode": "central-client",
-    "tokenParam": "code"
-  },
-  "layout": {
-    "shell": "portal",
-    "sidebar": "core",
-    "topbar": "none",
-    "header": "none",
-    "footer": "core"
-  },
-  "navigation": {
-    "mode": "manual",
-    "items": [
-      { "label": "Meus Apps", "href": "/apps", "capabilities": ["apps:read"], "order": 10 },
-      { "label": "Suporte", "href": "/suporte", "capabilities": ["tickets:read"], "order": 20 },
-      { "label": "Copilotos", "href": "/copilotos", "capabilities": ["copilots:read"], "order": 30 },
-      { "label": "Usuários", "href": "/usuarios", "capabilities": ["users:manage"], "order": 40 }
-    ]
-  },
-  "pages": [
-    { "path": "/apps", "label": "Meus Apps", "component": "AppsPortalPage", "capabilities": ["apps:read"] },
-    { "path": "/suporte", "label": "Suporte", "component": "SupportPage", "capabilities": ["tickets:read"] },
-    { "path": "/copilotos", "label": "Copilotos", "component": "CopilotsPage", "capabilities": ["copilots:read"] },
-    { "path": "/usuarios", "label": "Usuários", "component": "UsersPermissionsPage", "capabilities": ["users:manage"] }
-  ],
-  "collections": [],
-  "pipelines": [],
-  "documents": []
-}
-```
-
-## Bootstrap recomendado
-
-```ts
-import { startFromManifest } from "@oondemand/oon-core-front";
-import manifest from "../central.ui.json";
-import { AppsPortalPage } from "./custom/AppsPortalPage";
-import { SupportPage } from "./custom/SupportPage";
-import { CopilotsPage } from "./custom/CopilotsPage";
-import { UsersPermissionsPage } from "./custom/UsersPermissionsPage";
-
-startFromManifest(manifest, {
-  apiBaseUrl: import.meta.env.VITE_API_URL,
-  appKind: "portal-cockpit",
-  auth: {
-    mode: "central-client"
-  },
-  customComponents: {
-    AppsPortalPage,
-    SupportPage,
-    CopilotsPage,
-    UsersPermissionsPage
-  }
-});
-```
-
-## Contrato esperado do BFF
-
-O frontend conversa apenas com o BFF do portal. O BFF fala com a Central de Ativações usando AppClient.
-
-Rotas genéricas esperadas no BFF podem espelhar a Central de Ativações:
-
-```http
-GET /api/portal/contexto
-GET /api/portal/apps
-GET /api/portal/apps/:appCode
-GET /api/portal/apps/:appCode/capabilities
-POST /api/portal/apps/:appCode/authorize
-```
-
-O BFF também pode expor rotas de domínio próprias, como:
-
-```http
-GET /api/suporte/tickets
-POST /api/suporte/tickets
-GET /api/copilotos/assistentes
-POST /api/copilotos/assistentes/:id/testar
-```
-
-Essas rotas de domínio validam capability na Central de Ativações antes de executar a ação.
-
-## Regra de segurança
-
-O frontend nunca deve receber `clientSecret`, `x-oon-instance-token`, hash de credencial ou segredo completo. Portais devem falar com um BFF próprio, e o BFF fala com a Central de Ativações usando AppClient.
-
-## Quando usar página custom
-
-Use página custom apenas quando a tela não for CRUD/esteira/documento declarativo, por exemplo:
-
-- cards de apps licenciados;
-- matriz de permissões;
-- cockpit de status;
-- tickets de suporte;
-- gestão de copilotos;
-- onboarding orientado por negócio.
-
-Mesmo nesses casos, o Shell, Router, Auth, Menu, Guards e SDK HTTP devem continuar no Core.

package/docs/REACTIVE_DOMAIN_FORMULAS.md

@@ -2,7 +2,7 @@
 
 A partir do contrato declarativo de domínio, campos com `computed` são recalculados imediatamente nos formulários padrão do `@oondemand/oon-core-front`.
 
-A Central não precisa repetir a fórmula em `central.ui.json` nem criar componentes React específicos. A declaração continua existindo uma única vez no `central.domain.json` do backend.
+O App não precisa repetir a fórmula no frontend nem criar componentes React específicos. A declaração continua existindo uma única vez no `central.domain.json` do backend.
 
 ## Fluxo
 
@@ -21,7 +21,7 @@ A Central não precisa repetir a fórmula em `central.ui.json` nem criar compone
 - formulário principal em modal com abas (`CoreTabbedDetail`);
 - criação e edição;
 - formulários derivados integralmente da metadata;
-- formulários com overrides de apresentação no `central.ui.json`, desde que a model continue sendo carregada pela metadata do Core.
+- formulários com apresentação local, desde que a model continue sendo carregada pela metadata do Core.
 
 ## Exemplo
 

package/docs/releases/0.6.0.md

@@ -0,0 +1,23 @@
+# OonCore 0.6.0
+
+A linha 0.6 substitui o bootstrap orientado a manifesto por uma API pública code-first, preservando a governança da Plataforma Oon.
+
+## Destaques
+
+- bootstrap com `defineOonApp` e `startOonApp`;
+- rotas, menus, páginas, componentes e temas tipados;
+- scaffold único e neutro em `_base`;
+- `central.app.json` schema v2;
+- remoção integral dos templates selecionáveis, Omie e provider genérico de integrações;
+- resolução de capabilities técnicas pela Plataforma Oon, sem expor detalhes de implementação aos Apps;
+- documentação distribuída atualizada para desenvolvimento assistido por Agents.
+
+## Upgrade
+
+- alinhe `@oondemand/oon-core-back`, `@oondemand/oon-core-front` e `@oondemand/create-central-oon` na linha `0.6.x`;
+- declare compatibilidade `>=0.6.0 <0.7.0`;
+- migre o frontend para `defineOonApp`/`startOonApp`;
+- remova flags e módulos legados;
+- execute docs check, conformance, typecheck, testes e smoke offline antes da publicação.
+
+A versão 0.6 é incompatível com os contratos removidos da linha 0.5.

package/package.json

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

package/schemas/central.app.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.oondemand.com.br/central.app.v1.schema.json",
+  "$id": "https://schemas.oondemand.com.br/central.app.v2.schema.json",
   "title": "Oon Central App Manifest",
   "type": "object",
   "additionalProperties": false,
@@ -19,7 +19,7 @@
       "type": "string"
     },
     "schemaVersion": {
-      "const": 1
+      "const": 2
     },
     "id": {
       "type": "string",
@@ -67,14 +67,6 @@
         "rbac"
       ]
     },
-    "accessPolicy": {
-      "enum": [
-        "tenant_members",
-        "explicit_users",
-        "rbac"
-      ],
-      "description": "Compatibilidade legada. Novos manifestos devem usar accessMode e authorizationMode."
-    },
     "deploymentMode": {
       "enum": [
         "singleton",
@@ -105,12 +97,6 @@
         "pipelines": {
           "type": "boolean"
         },
-        "integrations": {
-          "type": "boolean"
-        },
-        "omie": {
-          "type": "boolean"
-        },
         "assistants": {
           "type": "boolean"
         },

package/src/conformance.js

@@ -5,19 +5,7 @@ const path = require("node:path");
 
 const IGNORED_DIRS = new Set([".git", ".ooncore", "node_modules", "dist", "build", "coverage"]);
 const EXECUTABLE_EXTENSIONS = new Set([".js", ".cjs", ".mjs", ".ts", ".tsx", ".jsx"]);
-const TECHNICAL_MODEL_NAMES = new Set([
-  "IntegrationExecution",
-  "IntegrationOutbox",
-  "IntegrationInbox",
-  "WebhookInbox",
-  "ExecutionHistory",
-  "ProviderRegistry",
-  "DistributedLock",
-  "OmieConfiguracao",
-  "OmieCategoria",
-  "OmieContaCorrente",
-  "OmieBaixaPagamento",
-]);
+const PUBLIC_FRONT_SUBPATHS = new Set(["ui", "routing", "theme", "hooks", "testing"]);
 
 function normalize(relativePath) {
   return relativePath.split(path.sep).join("/");
@@ -49,15 +37,15 @@ function fallbackValidateAppManifest(manifest) {
   ];
   const missing = required.filter((key) => manifest?.[key] === undefined);
   if (missing.length) throw new Error(`campos obrigatórios ausentes: ${missing.join(", ")}.`);
-  if (manifest.schemaVersion !== 1) throw new Error("schemaVersion deve ser 1.");
+  if (manifest.schemaVersion !== 2) throw new Error("schemaVersion deve ser 2.");
   if (!Array.isArray(manifest.capabilities)) throw new Error("capabilities deve ser uma lista.");
-  const hasCanonicalAccess = manifest.accessMode !== undefined && manifest.authorizationMode !== undefined;
-  const hasLegacyAccess = manifest.accessPolicy !== undefined;
-  if (!hasCanonicalAccess && !hasLegacyAccess) {
-    throw new Error("informe accessMode e authorizationMode (ou accessPolicy em manifesto legado).");
+  if (manifest.accessMode === undefined || manifest.authorizationMode === undefined) {
+    throw new Error("informe accessMode e authorizationMode.");
   }
-  if (hasCanonicalAccess && hasLegacyAccess) {
-    throw new Error("accessPolicy não pode ser combinado com accessMode/authorizationMode.");
+  const supportedModules = new Set(["collections", "documents", "pipelines", "assistants", "currencies"]);
+  for (const [moduleName, enabled] of Object.entries(manifest.modules || {})) {
+    if (!supportedModules.has(moduleName)) throw new Error(`módulo não suportado: ${moduleName}.`);
+    if (typeof enabled !== "boolean") throw new Error(`modules.${moduleName} deve ser booleano.`);
   }
 
   const optionalDimensions = {
@@ -78,16 +66,11 @@ function fallbackValidateAppManifest(manifest) {
     "member-central": { tenancyModel: "single_tenant", availability: "licensed", accessMode: "explicit_users", authorizationMode: "rbac", deploymentMode: "dedicated" },
     "portal-cockpit": { tenancyModel: "multi_tenant", availability: "common", accessMode: "tenant_members", authorizationMode: "none", deploymentMode: "shared" },
   }[manifest.appKind] || {};
-  const legacy = {
-    tenant_members: { accessMode: "tenant_members", authorizationMode: "none" },
-    explicit_users: { accessMode: "explicit_users", authorizationMode: "none" },
-    rbac: { accessMode: "explicit_users", authorizationMode: "rbac" },
-  }[manifest.accessPolicy] || {};
   const dimensions = {
     tenancyModel: manifest.tenancyModel || defaults.tenancyModel,
     availability: manifest.availability || defaults.availability,
-    accessMode: manifest.accessMode || legacy.accessMode || defaults.accessMode,
-    authorizationMode: manifest.authorizationMode || legacy.authorizationMode || defaults.authorizationMode,
+    accessMode: manifest.accessMode || defaults.accessMode,
+    authorizationMode: manifest.authorizationMode || defaults.authorizationMode,
     deploymentMode: manifest.deploymentMode || defaults.deploymentMode,
   };
   if (dimensions.tenancyModel === "none" && dimensions.accessMode === "tenant_members") {
@@ -137,72 +120,21 @@ function checkAppManifest(root, issues) {
   }
 }
 
-function appKind(root) {
-  try {
-    return JSON.parse(readText(root, "central.app.json")).appKind;
-  } catch {
-    return null;
-  }
-}
-
-function isPortalExtension(candidate) {
-  return candidate.startsWith("frontend/src/portal/");
-}
-
 function checkBootstrap(root, files, issues) {
-  const portalCockpit = appKind(root) === "portal-cockpit";
   const file = files.find((candidate) => /^frontend\/src\/main\.(?:t|j)sx?$/.test(candidate));
   if (!file) {
     addIssue(issues, "FRONTEND_BOOTSTRAP_REQUIRED", "frontend/src/main.tsx", "bootstrap gerado não encontrado.");
     return;
   }
   const source = readText(root, file);
-  if (!/\bstart(?:Central)?FromManifest\b/.test(source)) {
+  if (!/\bstartOonApp\b/.test(source)) {
     addIssue(
       issues,
       "FRONTEND_BOOTSTRAP_INVALID",
       file,
-      "deve iniciar o Core com startCentralFromManifest.",
+      "deve iniciar o Core com startOonApp.",
     );
   }
-  const forbidden = [
-    /structuredClone\s*\(/,
-    /\b(?:configure|prepare|transform)[A-Z_a-z0-9]*\s*\(/,
-    /\b(?:registry|pageComponents|cellRenderers|fieldRenderers|cardRenderers|layoutSlots)\b/,
-    /\.find\s*\(/,
-    /\.push\s*\(/,
-    /Object\.assign\s*\(/,
-  ];
-  for (const pattern of forbidden) {
-    if (pattern.test(source)) {
-      addIssue(issues, "FRONTEND_BOOTSTRAP_TRANSFORM", file, `transform local detectado: ${pattern}.`);
-    }
-  }
-  const localImports = [...source.matchAll(/from\s+["'](\.\.?\/[^"']+)["']/g)]
-    .map((match) => match[1])
-    .filter((value) => !value.endsWith(".json"));
-  const forbiddenLocalImports = portalCockpit
-    ? localImports.filter((value) => !value.startsWith("./portal/"))
-    : localImports;
-  if (forbiddenLocalImports.length) {
-    addIssue(
-      issues,
-      "FRONTEND_BOOTSTRAP_LOCAL_CODE",
-      file,
-      `imports locais executáveis não permitidos: ${forbiddenLocalImports.join(", ")}.`,
-    );
-  }
-
-  const extraFrontendSources = files.filter(
-    (candidate) => candidate.startsWith("frontend/src/")
-      && candidate !== file
-      && candidate !== "frontend/src/vite-env.d.ts"
-      && path.basename(candidate) !== ".gitkeep"
-      && !(portalCockpit && isPortalExtension(candidate)),
-  );
-  for (const extra of extraFrontendSources) {
-    addIssue(issues, "FRONTEND_LOCAL_EXTENSION", extra, "frontend declarativo deve manter somente o bootstrap gerado.");
-  }
 }
 
 function checkCentralConfig(root, files, issues) {
@@ -222,42 +154,46 @@ function checkCentralConfig(root, files, issues) {
   }
 }
 
-function checkDomainManifest(root, issues) {
-  const file = "backend/central.domain.json";
-  if (!fs.existsSync(path.join(root, file))) return;
-  try {
-    const manifest = JSON.parse(readText(root, file));
-    for (const model of manifest.models || []) {
-      if (TECHNICAL_MODEL_NAMES.has(model.name) || /(?:Outbox|Inbox|Execution|Provider|Lock|Webhook|Omie)/i.test(model.name)) {
-        addIssue(issues, "TECHNICAL_MODEL", file, `model técnica não permitida na Central: ${model.name}.`);
-      }
-    }
-  } catch (error) {
-    addIssue(issues, "DOMAIN_MANIFEST_INVALID", file, error.message);
-  }
-}
-
 function checkExecutableFiles(root, files, issues) {
-  const suspiciousPath = /(?:^|\/)(?:workers?|runtime|registr(?:y|ies)|clients?|patches?|infrastructure|infra)(?:\/|\.)/i;
-  const omieClient = /(?:^|\/)(?:omie[-_.]?(?:client|http|service)|clients?\/omie)(?:\.|\/)/i;
-  const genericPage = /^frontend\/src\/(?:pages|components)\/(?:Core|Integration|Integracao|Settings|Configurac)/i;
   const mongoosePatch = /mongoose\.(?:Model|Query|Document)\.prototype|\.prototype\.(?:save|updateOne|findOneAndUpdate)\s*=|patchMongoose/i;
-  const registryCode = /\b(?:pageComponents|cellRenderers|fieldRenderers|cardRenderers|actionRenderers|layoutSlots)\b/;
+  const remoteCode = /(?:import\s*\(\s*|from\s+|src\s*=\s*)["']https?:\/\//i;
+  const dynamicCode = /\b(?:eval|Function)\s*\(/;
+  const secretInBundle = /(?:import\.meta\.env|process\.env)\.[A-Z0-9_]*(?:SECRET|PASSWORD|TOKEN|PRIVATE_KEY|API_KEY)/;
+  const disabledGuard = /enable(?:RouteGuard|PermissionGate)\s*:\s*false/;
 
   for (const file of files) {
     if (!EXECUTABLE_EXTENSIONS.has(path.extname(file))) continue;
-    if (suspiciousPath.test(file)) addIssue(issues, "GENERIC_RUNTIME", file, "runtime/worker/registry local não permitido.");
-    if (omieClient.test(file)) addIssue(issues, "OMIE_CLIENT", file, "cliente Omie deve pertencer ao adaptador nativo do Core.");
-    if (genericPage.test(file)) addIssue(issues, "GENERIC_PAGE", file, "página genérica deve pertencer ao OonCore.");
-
     const source = readText(root, file);
     if (mongoosePatch.test(source)) addIssue(issues, "MONGOOSE_PATCH", file, "patch de Mongoose não permitido na Central.");
-    if (file !== "frontend/src/main.tsx" && file.startsWith("frontend/") && registryCode.test(source)) {
-      addIssue(issues, "LOCAL_REGISTRY", file, "registry de componentes padrão não permitido na Central.");
+    if (!file.startsWith("frontend/")) continue;
+    if (remoteCode.test(source) || dynamicCode.test(source)) addIssue(issues, "FRONTEND_REMOTE_CODE", file, "código remoto ou avaliação dinâmica não é permitido no bundle.");
+    if (secretInBundle.test(source)) addIssue(issues, "FRONTEND_SECRET", file, "secret, token, senha ou chave privada não pode entrar no bundle frontend.");
+    if (disabledGuard.test(source)) addIssue(issues, "FRONTEND_SECURITY_GUARD", file, "guards obrigatórios do OonCore não podem ser desabilitados.");
+    for (const match of source.matchAll(/@oondemand\/oon-core-front\/([^"'\s)]+)/g)) {
+      const subpath = match[1].split("/")[0];
+      if (!PUBLIC_FRONT_SUBPATHS.has(subpath)) addIssue(issues, "FRONTEND_INTERNAL_IMPORT", file, `subpath interno do OonCore não permitido: ${match[0]}.`);
     }
   }
 }
 
+function checkFrontendDependencies(root, issues) {
+  const file = "frontend/package.json";
+  if (!fs.existsSync(path.join(root, file))) return;
+  try {
+    const manifest = JSON.parse(readText(root, file));
+    const dependencies = { ...manifest.dependencies, ...manifest.devDependencies, ...manifest.optionalDependencies };
+    for (const [name, spec] of Object.entries(dependencies)) {
+      if (typeof spec !== "string" || !spec.startsWith("file:")) continue;
+      const target = path.resolve(root, "frontend", spec.slice(5));
+      const relative = path.relative(path.join(root, "frontend"), target);
+      if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) continue;
+      addIssue(issues, "FRONTEND_FILE_DEPENDENCY", file, `dependência ${name} aponta para fora de frontend/: ${spec}.`);
+    }
+  } catch (error) {
+    addIssue(issues, "FRONTEND_PACKAGE_INVALID", file, error.message);
+  }
+}
+
 function checkAllowedExtensions(files, issues) {
   const allowed = new Set([
     "", ".json", ".md", ".txt", ".yml", ".yaml", ".js", ".cjs", ".mjs", ".ts", ".tsx", ".jsx",
@@ -295,8 +231,8 @@ function checkConformance({ cwd = process.cwd() } = {}) {
   checkAppManifest(root, issues);
   checkBootstrap(root, files, issues);
   checkCentralConfig(root, files, issues);
-  checkDomainManifest(root, issues);
   checkExecutableFiles(root, files, issues);
+  checkFrontendDependencies(root, issues);
   checkAllowedExtensions(files, issues);
   checkLocalRuntimeSafety(root, files, issues);
   return { ok: issues.length === 0, root, filesChecked: files.length, issues };

package/src/index.js

@@ -11,20 +11,6 @@ const PACKAGE_ROOT = path.join(__dirname, "..");
 const TEMPLATES_DIR = path.join(PACKAGE_ROOT, "templates");
 const DOCS_DIR = path.join(PACKAGE_ROOT, "docs");
 
-const TEMPLATES = [
-  { id: "basic", description: "Central mínima com uma coleção dinâmica (Pessoa)." },
-  { id: "omie-sidecar", description: "Coleção + integração Omie (mapping de cliente)." },
-  { id: "servicos-tomados", description: "Serviços tomados com esteira por status." },
-  { id: "servicos-prestados", description: "Serviços prestados com esteira por etapa." },
-  { id: "pedidos-marketplace", description: "Pedidos de marketplace com esteira." },
-  { id: "documentos-fiscais", description: "Documentos fiscais com aprovação." },
-  { id: "multi-moedas", description: "Moedas + cotações (módulo currencies)." },
-];
-
-function listTemplates() {
-  return TEMPLATES;
-}
-
 function toSlug(value) {
   return String(value)
     .normalize("NFD")
@@ -307,13 +293,6 @@ function checkDocs(opts = {}) {
 }
 
 async function run(opts) {
-  const template = TEMPLATES.find((t) => t.id === opts.template);
-  if (!template) {
-    throw new Error(
-      `Template "${opts.template}" não existe. Use --list para ver os disponíveis.`
-    );
-  }
-
   const slug = toSlug(opts.name);
   if (!slug) throw new Error("Nome de Central inválido.");
 
@@ -328,14 +307,12 @@ async function run(opts) {
     }
   }
 
-  console.log(`\n⚙  Criando Central "${tokens.name}" (template: ${template.id})`);
+  console.log(`\n⚙  Criando oon-app "${tokens.name}"`);
 
-  // 1. Estrutura comum (backend + frontend mínimos, só domínio/declaração).
+  // Fundação canônica única. Não existem overlays ou templates funcionais.
   copyTemplate(path.join(TEMPLATES_DIR, "_base"), targetDir, tokens);
-  // 2. Overlay do template escolhido (vence sobre o _base).
-  copyTemplate(path.join(TEMPLATES_DIR, template.id), targetDir, tokens, { mergeCentralUi: true });
 
-  // 3. Contexto local neutro para Agents derivado da versão instalada.
+  // Contexto local neutro para Agents derivado da versão instalada.
   syncDocs({ cwd: targetDir });
 
   console.log("✔ Arquivos gerados.");
@@ -371,13 +348,12 @@ ${cd}  # Sincronizar/validar documentação local do Core para Agents
   npm run dev
 
 O backend expõe /core/metadata; o frontend renderiza as telas a partir dele.
-Edite backend/src/models e frontend/central.ui.json para evoluir a Central.
+Crie páginas, componentes e features em frontend/src e modele o domínio no backend.
 `);
 }
 
 module.exports = {
   run,
-  listTemplates,
   toSlug,
   toPascal,
   toTitle,

package/src/render.js

@@ -42,32 +42,12 @@ function applyTokens(content, tokens) {
     .replace(/__PASCAL__/g, tokens.pascal);
 }
 
-function mergePages(basePages = [], overlayPages = []) {
-  const merged = [...basePages];
-  for (const page of overlayPages) {
-    const index = page?.path
-      ? merged.findIndex((candidate) => candidate?.path === page.path)
-      : -1;
-    if (index >= 0) merged[index] = page;
-    else merged.push(page);
-  }
-  return merged;
-}
-
-function mergeCentralUiManifest(base, overlay) {
-  return {
-    ...base,
-    ...overlay,
-    pages: mergePages(base.pages, overlay.pages),
-  };
-}
-
 /**
  * Copia recursivamente `srcDir` para `destDir`, substituindo tokens em
  * arquivos de texto. Arquivos já existentes no destino são sobrescritos
  * (overlay): o template escolhido vence sobre o _base.
  */
-function copyTemplate(srcDir, destDir, tokens, options = {}) {
+function copyTemplate(srcDir, destDir, tokens) {
   if (!fs.existsSync(srcDir)) return;
   fs.mkdirSync(destDir, { recursive: true });
 
@@ -79,18 +59,12 @@ function copyTemplate(srcDir, destDir, tokens, options = {}) {
     const to = path.join(destDir, destName);
 
     if (entry.isDirectory()) {
-      copyTemplate(from, to, tokens, options);
+      copyTemplate(from, to, tokens);
     } else {
       const raw = fs.readFileSync(from);
       if (isText(from)) {
         const rendered = applyTokens(raw.toString("utf8"), tokens);
-        if (options.mergeCentralUi === true && entry.name === "central.ui.json" && fs.existsSync(to)) {
-          const base = JSON.parse(fs.readFileSync(to, "utf8"));
-          const overlay = JSON.parse(rendered);
-          fs.writeFileSync(to, JSON.stringify(mergeCentralUiManifest(base, overlay), null, 2) + "\n");
-        } else {
-          fs.writeFileSync(to, rendered);
-        }
+        fs.writeFileSync(to, rendered);
       } else {
         fs.writeFileSync(to, raw);
       }
@@ -98,4 +72,4 @@ function copyTemplate(srcDir, destDir, tokens, options = {}) {
   }
 }
 
-module.exports = { copyTemplate, applyTokens, isText, mergeCentralUiManifest };
+module.exports = { copyTemplate, applyTokens, isText };

package/templates/_base/README.md

@@ -1,16 +1,17 @@
 # __NAME__
 
-Central Oon declarativa gerada com `create-central-oon`.
+App Oon code-first gerado com `create-central-oon`.
 
 ## Fronteira arquitetural
 
 - `central.app.json` declara identidade, `appKind`, módulos, capabilities e compatibilidade com o OonCore;
 - `backend/central.domain.json` declara models e regras do domínio;
-- `frontend/central.ui.json` declara telas, formulários, grids e esteiras;
+- `frontend/src/app` compõe rotas, navegação, layouts e temas;
+- `frontend/src/{pages,components,features}` contém a experiência local;
 - `backend/central.config.js` fica reservado a extensões excepcionais de runtime;
-- `frontend/src/main.tsx` é um bootstrap gerado e não deve transformar manifestos.
+- `frontend/src/main.tsx` chama o bootstrap code-first `startOonApp`.
 
-Autenticação, shell, roteamento, RBAC, metadata, CRUD, páginas genéricas e infraestrutura pertencem ao OonCore.
+Autenticação, guards, shell, RBAC, metadata, CRUD e infraestrutura pertencem ao OonCore.
 
 ## Documentação e conformidade
 
@@ -39,8 +40,8 @@ O comando inicia backend e frontend exclusivamente em loopback, abre uma sessão
 ## Evoluindo a Central
 
 1. Declare domínio e fórmulas em `backend/central.domain.json`.
-2. Declare telas em `frontend/central.ui.json`.
+2. Crie rotas, páginas, componentes, layouts e temas no frontend.
 3. Use validações, triggers, hooks, mappings e regras somente para comportamento específico do negócio.
 4. Execute `npm run check` antes de abrir o PR.
 
-O OonCore implementa como a aplicação funciona; a Central declara o que pertence ao negócio.
+O OonCore fornece a fundação; o App implementa sua experiência e seu domínio.

package/templates/_base/backend/package.json

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