@oondemand/oon-core-front 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,120 @@
+# @oondemand/oon-core-front
+
+Core de **frontend** para Centrais Oon. Uma Central de frontend passa a ser
+apenas **declaração**: você escreve um `central.ui.ts` (identidade + views) e
+sobe tudo com `oonCore-front dev`.
+
+Todo o resto — bootstrap, providers (React Query + Chakra), roteamento por
+metadata, autenticação, RBAC, layout, menu, SDK REST único do `/core/*`,
+auditoria e os componentes `Core*` (Coleção, Documento, Esteira, Multi-moedas,
+Assistente, Dashboard) — vive aqui dentro.
+
+É o par de frontend do [`@oondemand/oon-core-back`](../oonCore-back): o back
+descreve as models em `/core/metadata`; o front monta as telas a partir disso,
+sem código de UI por entidade.
+
+## Instalação
+
+```bash
+npm install @oondemand/oon-core-front
+# peers: react, react-dom, react-router-dom, @tanstack/react-query,
+#        @tanstack/react-table, @chakra-ui/react
+```
+
+## Uso mínimo
+
+`central.ui.ts`:
+
+```ts
+import { defineCollectionView, type OonCoreFrontConfig } from "@oondemand/oon-core-front";
+
+export const appConfig: OonCoreFrontConfig = {
+  app: { id: "minha-central", name: "Minha Central" },
+  api: { baseUrl: import.meta.env.VITE_API_URL },
+  auth: { mode: "bearer", tokenParam: "code" },
+  ui: {
+    views: [
+      // 100% dinâmico: nada além do nome da model. Grid, form, rota e menu
+      // são montados a partir de /core/models/Cotacao.
+      defineCollectionView({ model: "Cotacao", mode: "dynamic" }),
+    ],
+  },
+};
+```
+
+`src/main.tsx`:
+
+```ts
+import { start } from "@oondemand/oon-core-front";
+import { appConfig } from "../central.ui";
+
+start(appConfig);
+```
+
+`main.tsx` não conhece providers, router, auth, layout, menu nem serviços.
+
+## Três formas de declarar uma coleção (Seção 4.4)
+
+```ts
+// 1. JSON completo — colunas e form explícitos (mode "full").
+defineCollectionView({
+  model: "Pessoa",
+  mode: "full",
+  columns: [{ field: "nome", label: "Nome", sortable: true }],
+  form: [{ field: "nome", label: "Nome", required: true }],
+});
+
+// 2. Registro mínimo — só model + label; Core deriva tudo da metadata.
+defineCollectionView({ model: "Pessoa", label: "Prestadores", mode: "minimal" });
+
+// 3. 100% dinâmico — consome /core/models/Pessoa e monta sozinho.
+defineCollectionView({ model: "Pessoa", mode: "dynamic" });
+```
+
+Ou direto no JSX, sem registrar view:
+
+```tsx
+import { CoreCollection } from "@oondemand/oon-core-front";
+
+<CoreCollection model="Pessoa" />;
+```
+
+## CLI
+
+```bash
+oonCore-front dev             # vite dev
+oonCore-front build           # vite build
+oonCore-front preview         # vite preview
+oonCore-front sync:metadata   # baixa /core/metadata do back e cacheia em src/.oon/metadata.json
+```
+
+## Componentes Core
+
+| Componente       | Para quê                                                            |
+| ---------------- | ------------------------------------------------------------------- |
+| `CoreCollection` | CRUD genérico: grid + form (3 modos).                               |
+| `CoreDocument`   | Tipos documentais com aprovação/anexos sobre a coleção.             |
+| `CorePipeline`   | Esteira kanban agrupada por etapa (enum da metadata).               |
+| `CoreCurrency`   | Multi-moedas: lista + ação `actions/update-rates`.                  |
+| `CoreIntegration`| Painel de `/core/integrations` + reprocessar ativos.               |
+| `CoreAssistant`  | Chat de IA seguro — envia só `assistantCode`/`entity`/`message`.    |
+| `CoreDashboard`  | Widgets `count`/`sum`/`custom` declarados na Central.               |
+
+## Segurança por design
+
+- **Sem segredos no front**: o assistente nunca envia chave de IA — só
+  `assistantCode`, `entity` e `message`; o back resolve modelo/prompt/chave.
+- **Token encapsulado** em `tokenStorage` (try/catch, captura de `?code=` e
+  limpeza da URL); 401 dispara logout + redirect para o login externo.
+- **RBAC de UX**: `RouteGuard`/`PermissionGate` escondem o que o usuário não
+  pode usar — o back continua sendo a autoridade final.
+- **Auditoria**: toda mutação leva headers `x-oon-origin/module/entity`.
+
+## Contrato com o back
+
+| `/core/*` (back)        | Uso no front                                   |
+| ----------------------- | ---------------------------------------------- |
+| `GET /core/metadata`    | `useCoreMetadata()` — menu/dashboard/derivação |
+| `GET /core/models/:n`   | `useModelSchema(n)` — modo dynamic             |
+| CRUD em `basePath`      | `useOonResource(basePath)` — list/get/CRUD     |
+| `GET /auth/validar-token` | `AuthProvider` resolve o usuário             |

package/bin/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+"use strict";
+
+/**
+ * CLI do @oondemand/oon-core-front (Fase 3 — Seção 4.5).
+ *
+ *   oonCore-front dev            Sobe o Vite em modo dev.
+ *   oonCore-front build          Build de produção (vite build).
+ *   oonCore-front preview        Serve o build (vite preview).
+ *   oonCore-front sync:metadata  Baixa /core/metadata do back e cacheia em
+ *                                src/.oon/metadata.json para tipos/dev offline.
+ *
+ * O Core não impõe Vite ao consumidor: ele apenas encaminha para o binário
+ * local do projeto. `sync:metadata` lê a URL do back de OON_API_URL /
+ * VITE_API_URL no .env do projeto.
+ */
+
+const path = require("node:path");
+const fs = require("node:fs");
+const { spawnSync } = require("node:child_process");
+
+const cmd = process.argv[2];
+const cwd = process.cwd();
+
+function runVite(args) {
+  const bin = path.join(cwd, "node_modules", ".bin", process.platform === "win32" ? "vite.cmd" : "vite");
+  const exec = fs.existsSync(bin) ? bin : "vite";
+  const r = spawnSync(exec, args, { stdio: "inherit", cwd });
+  if (r.error) {
+    console.error("Falha ao executar vite:", r.error.message);
+    console.error("Instale o vite no projeto da Central: npm i -D vite");
+    process.exit(1);
+  }
+  process.exit(r.status || 0);
+}
+
+function readEnv(name) {
+  if (process.env[name]) return process.env[name];
+  const envPath = path.join(cwd, ".env");
+  if (!fs.existsSync(envPath)) return undefined;
+  const line = fs
+    .readFileSync(envPath, "utf8")
+    .split("\n")
+    .find((l) => l.trim().startsWith(`${name}=`));
+  return line ? line.split("=").slice(1).join("=").trim().replace(/^["']|["']$/g, "") : undefined;
+}
+
+async function syncMetadata() {
+  const apiUrl = readEnv("OON_API_URL") || readEnv("VITE_API_URL");
+  if (!apiUrl) {
+    console.error("Defina OON_API_URL ou VITE_API_URL (.env) apontando para o back da Central.");
+    process.exit(1);
+  }
+  const url = `${apiUrl.replace(/\/$/, "")}/core/metadata`;
+  console.log(`Baixando metadata de ${url} ...`);
+  const res = await fetch(url).catch((err) => {
+    console.error("Falha de rede:", err.message);
+    process.exit(1);
+  });
+  if (!res.ok) {
+    console.error(`Back respondeu ${res.status}.`);
+    process.exit(1);
+  }
+  const metadata = await res.json();
+  const outDir = path.join(cwd, "src", ".oon");
+  fs.mkdirSync(outDir, { recursive: true });
+  const outFile = path.join(outDir, "metadata.json");
+  fs.writeFileSync(outFile, JSON.stringify(metadata, null, 2));
+  const models = (metadata.models || []).length;
+  console.log(`Metadata cacheada em ${path.relative(cwd, outFile)} (${models} models).`);
+  process.exit(0);
+}
+
+async function main() {
+  switch (cmd) {
+    case "dev":
+      return runVite(["dev"]);
+    case "build":
+      return runVite(["build"]);
+    case "preview":
+      return runVite(["preview"]);
+    case "sync:metadata":
+      return syncMetadata();
+    default:
+      console.log(`oonCore-front <comando>
+
+Comandos:
+  dev             Sobe a Central em modo dev (vite dev).
+  build           Build de produção (vite build).
+  preview         Serve o build (vite preview).
+  sync:metadata   Baixa /core/metadata do back e cacheia em src/.oon/metadata.json.
+`);
+      process.exit(cmd ? 1 : 0);
+  }
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});