@oondemand/create-central-oon 0.5.5 → 0.5.6

package/package.json

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

package/src/index.js

@@ -333,7 +333,7 @@ async function run(opts) {
   // 1. Estrutura comum (backend + frontend mínimos, só domínio/declaração).
   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);
+  copyTemplate(path.join(TEMPLATES_DIR, template.id), targetDir, tokens, { mergeCentralUi: true });
 
   // 3. Contexto local neutro para Agents derivado da versão instalada.
   syncDocs({ cwd: targetDir });

package/src/render.js

@@ -42,12 +42,32 @@ 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) {
+function copyTemplate(srcDir, destDir, tokens, options = {}) {
   if (!fs.existsSync(srcDir)) return;
   fs.mkdirSync(destDir, { recursive: true });
 
@@ -59,11 +79,18 @@ function copyTemplate(srcDir, destDir, tokens) {
     const to = path.join(destDir, destName);
 
     if (entry.isDirectory()) {
-      copyTemplate(from, to, tokens);
+      copyTemplate(from, to, tokens, options);
     } else {
       const raw = fs.readFileSync(from);
       if (isText(from)) {
-        fs.writeFileSync(to, applyTokens(raw.toString("utf8"), tokens));
+        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);
+        }
       } else {
         fs.writeFileSync(to, raw);
       }
@@ -71,4 +98,4 @@ function copyTemplate(srcDir, destDir, tokens) {
   }
 }
 
-module.exports = { copyTemplate, applyTokens, isText };
+module.exports = { copyTemplate, applyTokens, isText, mergeCentralUiManifest };

package/templates/_base/backend/package.json

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

package/templates/_base/frontend/central.ui.json

@@ -1,7 +1,57 @@
 {
   "schemaVersion": 2,
-  "backend": { "metadataUrl": "/core/metadata" },
-  "navigation": { "mode": "auto" },
+  "backend": {
+    "metadataUrl": "/core/metadata"
+  },
+  "navigation": {
+    "mode": "auto"
+  },
+  "pages": [
+    {
+      "path": "/",
+      "label": "Início",
+      "title": "Boas-vindas ao __NAME__",
+      "order": 10,
+      "blocks": [
+        {
+          "type": "markdown",
+          "content": "Seu oon-app já está pronto para receber o domínio da solução. Esta Home é declarativa e renderizada pelo OonCore."
+        },
+        {
+          "type": "section",
+          "title": "O que o OonCore já entrega",
+          "description": "A base técnica comum está pronta para você concentrar a implementação nas regras do negócio.",
+          "blocks": [
+            {
+              "type": "markdown",
+              "content": "• Autenticação integrada, sessão e contexto do tenant.\n• Shell responsivo, navegação, roteamento e estados de carregamento e erro.\n• RBAC, catálogo de perfis e gestão de Usuários e Acessos.\n• Metadata, CRUD, formulários, tabelas, filtros, dashboards e esteiras declarativas.\n• Contratos para documentos, integrações, auditoria, validação e observabilidade."
+            }
+          ]
+        },
+        {
+          "type": "section",
+          "title": "O que a Plataforma Oon entrega",
+          "description": "O ciclo operacional do app permanece governado pela plataforma.",
+          "blocks": [
+            {
+              "type": "markdown",
+              "content": "• Repositório GitHub privado e código-fonte versionado.\n• Publicação automática em Dev a partir da branch main.\n• Ambiente isolado com aplicação, banco de dados, URL pública, certificado e secrets.\n• Acompanhamento no Workspace e no Meus Apps, com promoção controlada entre ambientes.\n• Documentação técnica e funcional centralizada no Oon Docs."
+            }
+          ]
+        },
+        {
+          "type": "section",
+          "title": "Próximos passos",
+          "blocks": [
+            {
+              "type": "markdown",
+              "content": "1. Rode npm install e npm run ooncore:docs para sincronizar a documentação local.\n2. Leia .ooncore/AGENTS.md e o contexto da versão instalada.\n3. Modele o domínio em backend/src/models e declare as telas em frontend/central.ui.json.\n4. Acrescente permissões de negócio e distribua-as entre os perfis no central.app.json.\n5. Rode npm run check, publique o repositório e acompanhe o ambiente de Dev."
+            }
+          ]
+        }
+      ]
+    }
+  ],
   "collections": [],
   "pipelines": [],
   "documents": []

package/templates/_base/frontend/package.json

@@ -11,7 +11,7 @@
     "sync:metadata": "oonCore-front sync:metadata"
   },
   "dependencies": {
-    "@oondemand/oon-core-front": "^0.5.5",
+    "@oondemand/oon-core-front": "^0.5.6",
     "@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.5"
+    "@oondemand/create-central-oon": "0.5.6"
   }
 }