central.config.js

O arquivo central.config.js é a identidade da Central. O Core o lê no boot e mescla as opções na configuração de runtime.

Exemplo completo

central.config.js

module.exports = {
  // Identidade
  name: "Gestão de Serviços",
  slug: "gestao-servicos",

  // Módulos opinativos ativos nesta Central
  modules: {
    collections:  true,
    omie:         false,
    currencies:   false,
    pipelines:    true,
    documents:    false,
    assistants:   false,
    integrations: false,
  },

  // Paths de domínio (os defaults abaixo raramente precisam ser alterados)
  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",
  },
};

Referência de opções

Campo	Tipo	Descrição
name	string	Nome legível da Central
slug	string	Identificador URL-safe
modules	object	Módulos ativos (veja Módulos)
domain	object	Paths de cada pasta de domínio

Usando variáveis de ambiente

central.config.js

module.exports = {
  name: process.env.SERVICE_NAME || "Minha Central",
  slug: "minha-central",
  modules: {
    collections: true,
    omie: process.env.OMIE_ENABLED === "true",
  },
};

---

Autenticação local em desenvolvimento

Em desenvolvimento é comum não ter o Meus Apps disponível. O central.config.js aceita um auth.verifyToken customizado para esses casos. O scaffold já gera esse bloco automaticamente:

central.config.js

// Aceita DEV_TOKEN sem chamar o Meus Apps — só em NODE_ENV=development
const devAuth =
  process.env.NODE_ENV === "development" && process.env.DEV_TOKEN
    ? {
        verifyToken: async (token) => {
          if (token !== process.env.DEV_TOKEN) {
            const err = new Error("Token inválido.");
            err.statusCode = 401;
            throw err;
          }
          return { tipo: "admin", nome: "Dev Local", email: "dev@local" };
        },
      }
    : undefined;

module.exports = {
  name: "Minha Central",
  slug: "minha-central",
  auth: devAuth,
  // ...
};

Configure DEV_TOKEN no .env e acesse o frontend com ?code=<DEV_TOKEN>:

DEV_TOKEN=dev-local

http://localhost:5173/?code=dev-local

atenção

O bloco devAuth só é ativado quando ambas as condições são verdadeiras: NODE_ENV=development e DEV_TOKEN definido. Em produção (sem DEV_TOKEN), o Core usa o Meus Apps normalmente.