@oondemand/create-central-oon 0.2.0 → 0.3.0

package/README.md

@@ -2,14 +2,18 @@
 
 📖 **[Documentação completa → ooncoredoc.vercel.app](https://ooncoredoc.vercel.app)**
 
-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`).
+Gerador de **Centrais Oon**. Cria, a partir do nome da Central, um `backend/` de domínio e um `frontend/` declarativo 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.
+Toda Central gerada nasce com o padrão visual e operacional consolidado na **Central Minexco**:
+
+- identidade visual Oon/CST com Poppins, azul `#0474AF` e fundo `#F8F9FA`;
+- menu lateral compacto, responsivo e agrupado por seções;
+- datagrids densos com busca, ordenação, paginação, badges e ações;
+- formulários em diálogo, duas colunas e validação detalhada por campo;
+- campos relacionados com seleção pesquisável;
+- esteiras horizontais com colunas `#E8ECEF` e cartões operacionais brancos.
+
+O padrão fica no `@oondemand/oon-core-front`; os templates funcionais apenas declaram domínio, coleções, documentos e esteiras. Assim, não é necessário copiar ou manter um frontend diferente para cada Central.
 
 ## Uso
 
@@ -24,15 +28,17 @@ Aliases: o binário também responde por `scaffold-central-oon`.
 
 ### Opções
 
-| Flag             | Efeito                                                         |
+| Flag             | Efeito                                                        |
 | ---------------- | ------------------------------------------------------------- |
-| `--template=<t>` | Template inicial (default: `basic`). Veja `--list`.           |
+| `--template=<t>` | Template funcional 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.                 |
+| `--no-install`   | Não roda `npm install` nos projetos gerados.                  |
 | `--list`         | Lista os templates e sai.                                     |
 
-## Templates
+## Templates funcionais
+
+Todos utilizam o mesmo frontend padrão Minexco.
 
 | Template              | O que gera                                                    |
 | --------------------- | ------------------------------------------------------------- |
@@ -49,24 +55,23 @@ Aliases: o binário também responde por `scaffold-central-oon`.
 ```txt
 <central>/
 ├── README.md
-├── backend/                 # consome @oondemand/oon-core-back
+├── 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)
+└── frontend/                 # consome o frontend padrão Minexco do OonCore
+    ├── central.ui.json       # menu e telas (coleções/esteiras/documentos)
     └── src/
-        ├── main.tsx          # só `startFromManifest(manifest, { apiBaseUrl })`
+        ├── main.tsx          # 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
+cd <central>/backend  && cp .env.example .env && npm run dev
+cd ../frontend        && cp .env.example .env && npm run dev
 ```
 
-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.
+Evoluir a Central significa criar models em `backend/src/models` e declarar as telas em `frontend/central.ui.json`. Menu, rotas, datagrids, formulários e esteiras são montados pelo Core mantendo o padrão Minexco.

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@oondemand/create-central-oon",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oondemand/oon-platform.git",
     "directory": "packages/create-central-oon"
   },
-  "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.",
+  "description": "Gerador de Centrais Oon com backend declarativo e frontend padrão Central Minexco: menu, datagrids, formulários e esteiras.",
   "main": "src/index.js",
   "exports": {
     ".": "./src/index.js"

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

@@ -21,6 +21,8 @@ const devAuth =
     : undefined;
 
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

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

@@ -4,6 +4,8 @@
   "IMAGE": "ghcr.io/oondemand/__SLUG__-backend",
   "IMAGE_TAG": "latest",
   "HOST": "__SLUG__.oondemand.com",
+  "CENTRAL_ATIVACAO_URL": "https://central-ativacao.example.com",
+  "APP_CODE": "__SLUG__",
   "REPLICAS": "1",
   "HPA_MIN": "1",
   "HPA_MAX": "3"

package/templates/_base/backend/env.example

@@ -7,10 +7,13 @@ 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=
+# Autenticação e autorização pela Central de Ativações
+# Deve apontar para o backend da Central de Ativações, nunca para este Core.
+CENTRAL_ATIVACAO_URL=http://localhost:4100
+APP_CODE=__SLUG__
+AUTH_PROVIDER_TIMEOUT_MS=10000
+# Compatibilidade temporária: MEUS_APPS_BACKEND_URL e APP_KEY também são aceitas.
 
-# Token de desenvolvimento local (sem Meus Apps)
-# Acesse: http://localhost:5173/?code=dev-local
+# Token de desenvolvimento local (quando a Central sobrescrever verifyToken).
+# Deve ser igual ao VITE_DEV_TOKEN configurado no frontend.
 DEV_TOKEN=dev-local

package/templates/_base/backend/package.json

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

package/templates/_base/frontend/env.example

@@ -1,5 +1,9 @@
 # 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
+# Opcional: login externo/SSO. Sem essa variável, o Core usa /login.
+# VITE_MEUS_APPS_URL=https://login.example.com
+
+# Desenvolvimento local: deve ser igual ao DEV_TOKEN do backend.
+# O frontend envia este token para /auth/validar-token antes de qualquer redirect.
+VITE_DEV_TOKEN=dev-local

package/templates/_base/frontend/index.html

@@ -4,12 +4,11 @@
     <meta charset="UTF-8" />
     <link rel="icon" type="image/png" href="/favicon.png" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#0474AF" />
+    <meta name="description" content="__NAME__ — Central Oon para governança e automação operacional." />
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=Roboto:ital,wght@0,100;0,300;0,400;0,500;0,700;0,900;1,300;1,400;1,500;1,700;1,900&display=swap"
-      rel="stylesheet"
-    />
+    <link href="https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400;1,500&display=swap" rel="stylesheet" />
     <title>__NAME__</title>
   </head>
   <body>

package/templates/_base/frontend/package.json

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

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

@@ -9,4 +9,7 @@ import manifest from "../central.ui.json";
 startFromManifest(manifest, {
   apiBaseUrl: import.meta.env.VITE_API_URL ?? "http://localhost:4000",
   meusAppsUrl: import.meta.env.VITE_MEUS_APPS_URL,
+  // O valor só entra no bundle servido pelo Vite em modo de desenvolvimento.
+  // O backend continua validando se ele coincide com DEV_TOKEN.
+  devToken: import.meta.env.DEV ? (import.meta.env.VITE_DEV_TOKEN ?? "dev-local") : undefined,
 });

package/templates/documentos-fiscais/backend/central.config.js

@@ -3,6 +3,8 @@
  * do Core (aprovação, anexos, status).
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

package/templates/multi-moedas/backend/central.config.js

@@ -3,6 +3,8 @@
  * (cotações, conversão).
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

package/templates/omie-sidecar/backend/central.config.js

@@ -4,6 +4,8 @@
  * declaramos o mapping de domínio.
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

package/templates/pedidos-marketplace/backend/central.config.js

@@ -3,6 +3,8 @@
  * esteira de pedidos.
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

package/templates/servicos-prestados/backend/central.config.js

@@ -3,6 +3,8 @@
  * dos serviços prestados ao cliente.
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",
 

package/templates/servicos-tomados/backend/central.config.js

@@ -3,6 +3,8 @@
  * (pipelines) do Core para acompanhar o processamento dos serviços.
  */
 module.exports = {
+  ecosystem: { role: "member" },
+  activation: { enabled: true, configurationVersion: 1, fields: [] },
   name: "__NAME__",
   slug: "__SLUG__",