@oondemand/create-central-oon 0.1.0

package/LICENSE

@@ -0,0 +1,91 @@
+# LICENÇA DE USO RESTRITO DO CÓDIGO-FONTE OONDEMAND
+**ODR‑NC v1.0 — Non‑Commercial, Internal‑Use Only**
+
+Copyright (c) 2025 OonDemand. Todos os direitos reservados.
+
+## 1. Definições
+**“Licenciante”**: OonDemand.  
+**“Código”**: todo o conteúdo deste repositório e seus derivados.  
+**“Licenciada”** ou **“Usuário Autorizado”**: a pessoa jurídica nominalmente autorizada pela Licenciante (via contrato ou arquivo `AUTORIZACOES.md`).  
+**“Uso Interno Não Comercial”**: uso exclusivo dentro da organização da Licenciada, para suas próprias operações internas, sem disponibilização a terceiros e sem geração de receita direta ou indireta a partir do Código, incluindo sem se limitar a: revenda, prestação de serviços a terceiros, franquia, SaaS, consultoria, sublicenciamento, distribuição ou incorporação em produtos/serviços comercializados.
+
+## 2. Concessão Limitada
+Sujeito ao cumprimento integral desta Licença, a Licenciante concede à Licenciada uma licença **não exclusiva, intransferível e revogável** para **acessar, visualizar, modificar, compilar e executar** o Código **exclusivamente para Uso Interno Não Comercial**. Nenhum direito é concedido para **distribuir, publicar, sublicenciar, ceder** ou **oferecer a terceiros** o Código (ou obras derivadas).
+
+Qualquer **Uso Comercial** (incluindo oferta como serviço, SaaS, revenda, consultoria, integração para clientes externos ou uso em qualquer outra empresa do mesmo grupo econômico) **exige autorização prévia e expressa da Licenciante, por escrito** e com condições comerciais específicas. Na ausência de tal autorização, o Uso Comercial é **estritamente proibido**.
+
+## 3. Restrições e Obrigações
+A Licenciada se compromete a:
+1. **Não** remover ou alterar avisos de copyright, marcas, avisos de confidencialidade e desta Licença;
+2. **Não** publicar ou tornar o Código (ou parte significativa) acessível publicamente (incl. repositórios públicos, fóruns, pacotes);
+3. **Não** distribuir, vender, revender, licenciar, sublicenciar, alugar, arrendar, franquear, ceder ou transferir o Código a terceiros;
+4. **Não** utilizar o Código para treinar modelos de IA, realizar engenharia reversa de mecanismos de licenciamento ou produzir obra concorrente direta;
+5. Adotar controles de acesso (RBAC), registro de auditoria e medidas razoáveis de segurança para impedir uso não autorizado; e
+6. Garantir que terceiros (funcionários, prestadores) observem as mesmas obrigações de confidencialidade e uso restrito.
+
+## 4. Propriedade Intelectual
+O Código é protegido por leis de propriedade intelectual. **A titularidade integral permanece com a Licenciante**. Exceto pelos direitos limitados concedidos nesta Licença, **nenhum outro direito** (explícito, implícito, por estoppel) é concedido.
+
+## 5. Autorização Expressa para Uso Comercial
+Qualquer permissão de Uso Comercial deverá:
+- Ser **prévia e por escrito**, concedida pela Licenciante;
+- Constar em contrato específico **ou** no arquivo `AUTORIZACOES.md` deste repositório, com **razão social/CNPJ**, **escopo**, **prazo** e **condições comerciais**; e
+- Ser **revogável** por descumprimento.
+
+## 6. Cláusula Penal (Multa) por Uso Indevido
+O uso em desacordo com esta Licença (incluindo Uso Comercial sem autorização) sujeitará a Licenciada ao pagamento de **cláusula penal não compensatória** no valor de **R$ 600.000,00 (seiscentos mil reais) por infração**, **cumulável** com:
+- **R$ 5.000,00 (cinco mil reais) por dia** enquanto perdurar a infração; e
+- Indenização adicional por **perdas e danos** e **honorários advocatícios**.
+A aplicação desta cláusula penal **não limita** o direito da Licenciante de buscar tutela específica, inclusive **medidas liminares/inibitórias**.
+
+## 7. Confidencialidade
+O Código e a documentação correlata constituem **informação confidencial**. A Licenciada deve preservá-la com o mesmo grau de zelo usado para suas informações confidenciais, nunca inferior ao razoável.
+
+## 8. Ausência de Garantias; Limitação de Responsabilidade
+O Código é fornecido “**no estado em que se encontra**”, sem garantias de qualquer tipo. Na máxima extensão permitida em lei, a Licenciante **não responde** por danos indiretos, lucros cessantes, perda de dados ou danos especiais. A responsabilidade total da Licenciante, por qualquer teoria, **fica limitada ao valor total efetivamente pago** pela Licenciada em favor da Licenciante pelo direito de uso do Código, se houver.
+
+## 9. Vigência, Revogação e Auditoria
+Esta Licença vigora enquanto o Código estiver em posse da Licenciada e poderá ser **revogada** a qualquer tempo em caso de violação. A Licenciante poderá solicitar **evidências razoáveis de conformidade** (ex.: lista de usuários, ambientes de execução) mediante aviso prévio escrito de 5 dias úteis.
+
+## 10. Terceiros e Dependências
+Componentes de terceiros incluídos no repositório permanecem regidos por suas **próprias licenças**. Em caso de conflito, prevalece a licença do respectivo terceiro para tal componente.
+
+## 11. Lei Aplicável e Foro
+Aplica-se a legislação brasileira. Fica eleito o **Foro da Comarca de São Paulo/SP**, com renúncia a qualquer outro, por mais privilegiado que seja.
+
+## 12. Disposições Finais
+Se qualquer cláusula for considerada inválida, as demais permanecem válidas. Qualquer tolerância não implicará renúncia. Esta é a versão **ODR‑NC v1.0**. A Licenciante poderá publicar **atualizações** desta Licença; versões futuras não terão efeito retroativo sem aceite da Licenciada.
+
+---
+
+### Identificação de Autorização (opcional, para uso interno)
+> Este repositório está licenciado para uso interno por: **[RAZÃO SOCIAL]**, **CNPJ [XX.XXX.XXX/0001-XX]**, conforme autorização datada de **[DATA]** e/ou contrato específico. Escopo: **[DESCREVER]**.
+
+### Como cumprir esta Licença
+1) Mantenha este arquivo `LICENSE.md` na raiz do repositório;  
+2) Liste autorizações de uso comercial, se houver, em `AUTORIZACOES.md`; e  
+3) Inclua o cabeçalho de licença abaixo em **cada arquivo-fonte**.
+
+---
+
+## Cabeçalho de Licença para Arquivos-Fonte
+Copie e adapte o bloco conforme a linguagem:
+
+### Padrão (C/Java/JS/TS)
+/*
+ OonDemand — Código-Fonte Proprietário
+ Licença ODR‑NC v1.0 — Uso interno não comercial. Proibida revenda/redistribuição/uso comercial sem autorização expressa da OonDemand. Violação sujeita à multa, conforme LICENSE.md.
+ (c) 2025 OonDemand. Todos os direitos reservados.
+*/
+
+### Python
+"""
+OonDemand — Código-Fonte Proprietário
+Licença ODR‑NC v1.0 — Uso interno não comercial. Proibida revenda/redistribuição/uso comercial sem autorização expressa da OonDemand. Violação sujeita à multa, conforme LICENSE.md.
+(c) 2025 OonDemand. Todos os direitos reservados.
+"""
+
+### Shell/YAML
+# OonDemand — Código-Fonte Proprietário
+# Licença ODR‑NC v1.0 — Uso interno não comercial. Proibida revenda/redistribuição/uso comercial sem autorização expressa da OonDemand. Violação sujeita à multa, conforme LICENSE.md.
+# (c) 2025 OonDemand. Todos os direitos reservados.

package/README.md

@@ -0,0 +1,70 @@
+# @oondemand/create-central-oon
+
+Gerador de **Centrais Oon**. Cria, a partir do nome da Central, um `backend/` e
+um `frontend/` **mínimos** — só domínio e declaração — prontos para consumir o
+Core (`@oondemand/oon-core-back` e `@oondemand/oon-core-front`).
+
+Substitui os geradores legados `@oondemand/create-ooncore-back|front`, que
+copiavam o app inteiro. Aqui só nasce o esqueleto: nada de `server.js`,
+`app.js`, `db.js`, middlewares, Dockerfile, manifestos k8s à mão ou router
+manual — isso tudo vive no Core.
+
+## Uso
+
+```bash
+npx create-central-oon central-transtour
+npx create-central-oon central-transtour --template=omie-sidecar
+npx create-central-oon "Minha Loja" --template=multi-moedas --no-install
+npx create-central-oon --list
+```
+
+Aliases: o binário também responde por `scaffold-central-oon`.
+
+### Opções
+
+| Flag             | Efeito                                                         |
+| ---------------- | ------------------------------------------------------------- |
+| `--template=<t>` | Template inicial (default: `basic`). Veja `--list`.           |
+| `--here`         | Gera na pasta atual em vez de criar `<nome>/`.                |
+| `--force`        | Sobrescreve uma pasta existente não-vazia.                    |
+| `--no-install`   | Não roda `npm install` nos projetos gerados.                 |
+| `--list`         | Lista os templates e sai.                                     |
+
+## Templates
+
+| Template              | O que gera                                                    |
+| --------------------- | ------------------------------------------------------------- |
+| `basic`               | Uma coleção dinâmica (`Pessoa`).                              |
+| `omie-sidecar`        | Coleção + integração Omie (mapping de cliente + trigger).     |
+| `servicos-tomados`    | Prestadores + esteira de serviços por `statusProcessamento`.  |
+| `servicos-prestados`  | Clientes + esteira de serviços prestados por `etapa`.         |
+| `pedidos-marketplace` | Catálogo de produtos + esteira de pedidos por `status`.       |
+| `documentos-fiscais`  | Documento fiscal com aprovação (`CoreDocument`).              |
+| `multi-moedas`        | `Moeda` + `Cotacao` com o módulo currencies.                  |
+
+## Estrutura gerada
+
+```txt
+<central>/
+├── README.md
+├── backend/                 # consome @oondemand/oon-core-back
+│   ├── central.config.js     # identidade + módulos + paths de domínio
+│   ├── central.manifest.json # valores de deploy (render no Core)
+│   └── src/{models,validations,triggers,hooks,mappings,documents,
+│            pipelines,integrations,routes,controllers,services}/
+└── frontend/                # consome @oondemand/oon-core-front
+    ├── central.ui.json       # declaração das telas (coleções/esteiras/docs)
+    └── src/
+        ├── main.tsx          # só `startFromManifest(manifest, { apiBaseUrl })`
+        └── {collections,documents,pipelines,dashboards,overrides}/
+```
+
+## Próximos passos após gerar
+
+```bash
+cd <central>/backend  && cp .env.example .env && npm run dev   # expõe /core/metadata
+cd ../frontend        && cp .env.example .env && npm run dev   # renderiza pela metadata
+```
+
+Evoluir = criar models em `backend/src/models` e declarar telas em
+`frontend/central.ui.json`. Grid, form, rotas e menu são montados pelo Core.

package/bin/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * CLI do create-central-oon (Fase 4 — Seção 5/25).
+ *
+ *   npx create-central-oon <nome-da-central> [opções]
+ *
+ * Opções:
+ *   --template=<t>   Template inicial (default: basic). Veja --list.
+ *   --here           Gera na pasta atual em vez de criar <nome>/.
+ *   --force          Sobrescreve pasta existente.
+ *   --no-install     Não roda npm install nos projetos gerados.
+ *   --list           Lista os templates disponíveis e sai.
+ */
+
+const { run, listTemplates } = require("../src/index");
+
+function parseArgs(argv) {
+  const opts = { template: "basic", here: false, force: false, install: true, list: false };
+  const positionals = [];
+  for (const arg of argv) {
+    if (arg === "--here") opts.here = true;
+    else if (arg === "--force") opts.force = true;
+    else if (arg === "--no-install") opts.install = false;
+    else if (arg === "--list") opts.list = true;
+    else if (arg.startsWith("--template=")) opts.template = arg.slice("--template=".length);
+    else if (arg === "--template") opts.template = argv[argv.indexOf(arg) + 1];
+    else if (!arg.startsWith("-")) positionals.push(arg);
+  }
+  opts.name = positionals[0];
+  return opts;
+}
+
+async function main() {
+  const opts = parseArgs(process.argv.slice(2));
+
+  if (opts.list) {
+    console.log("Templates disponíveis:\n");
+    for (const t of listTemplates()) console.log(`  ${t.id.padEnd(20)} ${t.description}`);
+    process.exit(0);
+  }
+
+  if (!opts.name) {
+    console.error("Uso: npx create-central-oon <nome-da-central> [--template=basic]");
+    console.error("     npx create-central-oon --list");
+    process.exit(1);
+  }
+
+  try {
+    await run(opts);
+  } catch (err) {
+    console.error("\n✖", err.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@oondemand/create-central-oon",
+  "version": "0.1.0",
+  "description": "Gerador de Centrais Oon: cria backend + frontend mínimos (só domínio + declaração) prontos para consumir @oondemand/oon-core-back e @oondemand/oon-core-front.",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "bin": {
+    "create-central-oon": "bin/cli.js",
+    "scaffold-central-oon": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "oondemand",
+    "ooncore",
+    "central",
+    "scaffold",
+    "create",
+    "generator"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": { "access": "public" }
+}

package/src/index.js

@@ -0,0 +1,117 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const { copyTemplate } = require("./render");
+
+const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
+
+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")
+    .replace(/[\u0300-\u036f]/g, "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+function toPascal(slug) {
+  return slug
+    .split("-")
+    .filter(Boolean)
+    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+    .join("");
+}
+
+function toTitle(slug) {
+  return slug
+    .split("-")
+    .filter(Boolean)
+    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+    .join(" ");
+}
+
+function npmInstall(dir) {
+  const r = spawnSync("npm", ["install"], { stdio: "inherit", cwd: dir });
+  return !r.status && !r.error;
+}
+
+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.");
+
+  const tokens = { slug, name: toTitle(slug), pascal: toPascal(slug) };
+
+  const targetDir = opts.here ? process.cwd() : path.join(process.cwd(), slug);
+
+  if (!opts.here && fs.existsSync(targetDir)) {
+    const empty = fs.readdirSync(targetDir).length === 0;
+    if (!empty && !opts.force) {
+      throw new Error(`A pasta "${slug}" já existe e não está vazia. Use --force para sobrescrever.`);
+    }
+  }
+
+  console.log(`\n⚙  Criando Central "${tokens.name}" (template: ${template.id})`);
+
+  // 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);
+
+  console.log("✔ Arquivos gerados.");
+
+  if (opts.install) {
+    console.log("\n📦 Instalando dependências (best-effort)...");
+    const backOk = npmInstall(path.join(targetDir, "backend"));
+    const frontOk = npmInstall(path.join(targetDir, "frontend"));
+    if (!backOk || !frontOk) {
+      console.warn(
+        "\n⚠ npm install falhou em um dos projetos (esperado se os pacotes @oondemand/* ainda não foram publicados). Rode manualmente depois."
+      );
+    }
+  }
+
+  printNextSteps(tokens, opts);
+}
+
+function printNextSteps(tokens, opts) {
+  const cd = opts.here ? "" : `  cd ${tokens.slug}\n`;
+  console.log(`
+✅ Central "${tokens.name}" pronta.
+
+Próximos passos:
+${cd}  # Backend (só domínio — models/validations/triggers/...)
+  cd backend && cp .env.example .env && npm run dev
+
+  # Frontend (só declaração — central.ui.json)
+  cd ../frontend && cp .env.example .env && 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.
+`);
+}
+
+module.exports = { run, listTemplates, toSlug, toPascal, toTitle };

package/src/render.js

@@ -0,0 +1,74 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+/** Extensões tratadas como texto (recebem substituição de tokens). */
+const TEXT_EXT = new Set([
+  ".js",
+  ".jsx",
+  ".ts",
+  ".tsx",
+  ".json",
+  ".md",
+  ".html",
+  ".css",
+  ".env",
+  ".example",
+  ".gitignore",
+  ".gitkeep",
+  ".yml",
+  ".yaml",
+]);
+
+/** Nomes "seguros" no template -> dotfile real no destino gerado. */
+const DOTFILE_MAP = {
+  gitkeep: ".gitkeep",
+  gitignore: ".gitignore",
+  "env.example": ".env.example",
+  npmrc: ".npmrc",
+};
+
+function isText(file) {
+  if (path.basename(file).startsWith(".env")) return true;
+  return TEXT_EXT.has(path.extname(file));
+}
+
+/** Substitui __NAME__ / __SLUG__ / __PASCAL__ no conteúdo. */
+function applyTokens(content, tokens) {
+  return content
+    .replace(/__NAME__/g, tokens.name)
+    .replace(/__SLUG__/g, tokens.slug)
+    .replace(/__PASCAL__/g, tokens.pascal);
+}
+
+/**
+ * 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) {
+  if (!fs.existsSync(srcDir)) return;
+  fs.mkdirSync(destDir, { recursive: true });
+
+  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+    const from = path.join(srcDir, entry.name);
+    // Dotfiles ficam sem o ponto no template (npm não publica alguns dotfiles)
+    // e recebem o ponto ao gerar.
+    const destName = DOTFILE_MAP[entry.name] ?? entry.name;
+    const to = path.join(destDir, destName);
+
+    if (entry.isDirectory()) {
+      copyTemplate(from, to, tokens);
+    } else {
+      const raw = fs.readFileSync(from);
+      if (isText(from)) {
+        fs.writeFileSync(to, applyTokens(raw.toString("utf8"), tokens));
+      } else {
+        fs.writeFileSync(to, raw);
+      }
+    }
+  }
+}
+
+module.exports = { copyTemplate, applyTokens, isText };

package/templates/_base/README.md

@@ -0,0 +1,27 @@
+# __NAME__
+
+Central Oon gerada com `create-central-oon`. É composta por dois projetos
+mínimos que consomem o Core:
+
+- **backend/** — só domínio (`src/models`, `validations`, `triggers`, …).
+  Sobe com `oonCore-back dev`. Toda a infra (boot, db, auth, RBAC, metadata,
+  CRUD, deploy) vem do `@oondemand/oon-core-back`.
+- **frontend/** — só declaração (`central.ui.json`). Sobe com `oonCore-front
+  dev`. Shell, providers, roteamento, auth e telas vêm do
+  `@oondemand/oon-core-front`, renderizados a partir do `/core/metadata` do back.
+
+## Rodando
+
+```bash
+# backend
+cd backend && cp .env.example .env && npm install && npm run dev
+
+# frontend (noutro terminal)
+cd frontend && cp .env.example .env && npm install && npm run dev
+```
+
+## Evoluindo a Central
+
+1. Crie models em `backend/src/models` (só schema + CRUD).
+2. Declare as telas em `frontend/central.ui.json` (coleções/esteiras/documentos).
+3. O resto — grid, form, rotas, menu — é montado pelo Core automaticamente.

package/templates/_base/backend/central.config.js

@@ -0,0 +1,33 @@
+/**
+ * Configuração da Central __NAME__ (Seção 8). Apenas identidade, módulos
+ * ativos e os paths de domínio. Sem db/auth/deploy — isso vive no Core e nas
+ * variáveis de ambiente.
+ */
+module.exports = {
+  name: "__NAME__",
+  slug: "__SLUG__",
+
+  // Módulos opinativos do Core ligados nesta Central.
+  modules: {
+    collections: true,
+    documents: false,
+    pipelines: false,
+    integrations: false,
+    omie: false,
+    assistants: false,
+    currencies: false,
+  },
+
+  // Paths de domínio (carregados por convenção pelo Core no boot).
+  domain: {
+    models: "src/models",
+    validations: "src/validations",
+    triggers: "src/triggers",
+    hooks: "src/hooks",
+    mappings: "src/mappings",
+    documents: "src/documents",
+    pipelines: "src/pipelines",
+    integrations: "src/integrations",
+    routes: "src/routes",
+  },
+};

package/templates/_base/backend/central.manifest.json

@@ -0,0 +1,10 @@
+{
+  "SERVICE_NAME": "__SLUG__",
+  "NAMESPACE": "__SLUG__",
+  "IMAGE": "ghcr.io/oondemand/__SLUG__-backend",
+  "IMAGE_TAG": "latest",
+  "HOST": "__SLUG__.oondemand.com",
+  "REPLICAS": "1",
+  "HPA_MIN": "1",
+  "HPA_MAX": "3"
+}

package/templates/_base/backend/env.example

@@ -0,0 +1,12 @@
+# Identidade
+SERVICE_NAME=__SLUG__
+SERVICE_VERSION=0.1.0
+PORT=4000
+NODE_ENV=development
+
+# Banco
+MONGO_URI=mongodb://localhost:27017/__SLUG__
+
+# Autenticação (provedor padrão: Meus Apps)
+MEUS_APPS_BACKEND_URL=https://meus-apps.example.com
+APP_KEY=

package/templates/_base/backend/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__SLUG__-backend",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Backend da Central __NAME__ — só domínio, consome @oondemand/oon-core-back.",
+  "scripts": {
+    "dev": "oonCore-back dev",
+    "start": "oonCore-back start",
+    "activate": "oonCore-back activate",
+    "build:image": "oonCore-back build:image",
+    "k8s:render": "oonCore-back k8s:render",
+    "deploy": "oonCore-back deploy"
+  },
+  "dependencies": {
+    "@oondemand/oon-core-back": "^0.1.0"
+  }
+}

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

@@ -0,0 +1,9 @@
+{
+  "name": "__NAME__",
+  "slug": "__SLUG__",
+  "backend": { "metadataUrl": "/core/metadata" },
+  "navigation": { "mode": "auto" },
+  "collections": [],
+  "pipelines": [],
+  "documents": []
+}

package/templates/_base/frontend/env.example

@@ -0,0 +1,5 @@
+# URL do backend da Central (oonCore-back)
+VITE_API_URL=http://localhost:4000
+
+# Login externo (Meus Apps) — redirecionamento quando sem sessão
+VITE_MEUS_APPS_URL=https://meus-apps.example.com

package/templates/_base/frontend/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="pt-BR">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/_base/frontend/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "__SLUG__-frontend",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "oonCore-front dev",
+    "build": "oonCore-front build",
+    "preview": "oonCore-front preview",
+    "sync:metadata": "oonCore-front sync:metadata"
+  },
+  "dependencies": {
+    "@oondemand/oon-core-front": "^0.1.0",
+    "@chakra-ui/react": "^3.13.0",
+    "@emotion/react": "^11.14.0",
+    "@tanstack/react-query": "^5.65.0",
+    "@tanstack/react-table": "^8.20.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^6.28.2"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "typescript": "^5.5.0",
+    "vite": "^6.0.5"
+  }
+}

package/templates/_base/frontend/src/main.tsx

@@ -0,0 +1,12 @@
+import { startFromManifest } from "@oondemand/oon-core-front";
+import manifest from "../central.ui.json";
+
+/**
+ * Toda a Central __NAME__ inicia por aqui. Sem providers, router, auth, layout
+ * ou páginas — só o manifesto declarativo `central.ui.json`. O Core resolve as
+ * telas a partir do `/core/metadata` do backend.
+ */
+startFromManifest(manifest, {
+  apiBaseUrl: import.meta.env.VITE_API_URL ?? "http://localhost:4000",
+  meusAppsUrl: import.meta.env.VITE_MEUS_APPS_URL,
+});