Pular para o conteúdo principal

Módulos opinativos

O Core possui módulos opcionais que adicionam capacidades verticais. São ativados em central.config.js:

backend/central.config.js
module.exports = {
  name: "Minha Central",
  modules: {
    collections:  true,   // sempre ativo
    omie:         true,   // integração ERP Omie
    currencies:   true,   // cotações multi-moedas
    pipelines:    false,  // esteiras kanban
    documents:    false,  // documentos com aprovação
    assistants:   false,  // assistentes IA
    integrations: false,  // webhooks externos
  },
};

Visão geral dos módulos​

collections — CRUD dinâmico​

Sempre ativo. Ativa o CRUD automático para todas as models registradas com defineModel.

omie — Integração ERP​

Sincronização bidirecional com o ERP Omie. Use defineOmieMapping para mapear campos de uma model para entidades do Omie (clientes, fornecedores, etc.).

defineOmieMapping("Cliente", {
  entity: "clientes",
  fields: { nome: "nome_fantasia", email: "email" },
  direction: "both",
});

currencies — Multi-moedas​

Converte valores em tempo real usando cotações do Banco Central. Use os field types fields.currency, fields.currencyCode e fields.currencyConverted.

pipelines — Esteiras​

Kanban de tickets com etapas configuráveis. Use definePipeline no backend e CorePipeline ou definePipelineView no frontend.

documents — Documentos​

Fluxo de aprovação para documentos (contratos, NFs, laudos). Use defineDocument + CoreDocument.

assistants — Assistentes IA​

Assistentes contextuais integrados à Central. Requer assistantBaseUrl na config do frontend.

Módulos independentes de packages​

Cada módulo é autocontido — ativar omie: false não inclui nenhum código relacionado ao Omie no bundle. O carregamento é feito sob demanda no loadCentral.