Customs
📖 Docs 🏠 Edge

Customs registrados

Telas e relatórios React publicados por tenant. Clique em Preview para montar dentro desta página.

Lista

Ativar/Desativar não altera o código — só a visibilidade nos menus dos hosts.
Slug Título Host Menu Status Bundle Ações
Carregando…

Jobs agendados

Cron → fetch endpoint → render HTML → e-mail/webhook. Use Rodar agora para dispara síncrono (dry-run se SMTP_HOST não configurado).

Lista

Próxima execução mostrada no fuso local do seu navegador.
Slug Schedule Próxima execução Último status Ativo Ações
Carregando…

Testar endpoint

Chamadas diretas aos dados que os customs consomem. Útil para validar o backend antes de depurar o React.

Resposta:

Clique em um endpoint acima…

Como usar

Resumo do fluxo de trabalho com customs e jobs.

1. Navegar no admin

Esta mesma tela. Use a aba Customs para ver tudo registrado e Preview para renderizar aqui mesmo sem sair do edge.

2. Usar no MES

Customs com host=mes aparecem no sidebar do MES agrupados por menu_section:

3. Publicar seu próprio custom

npm install -g @simjob/customs-cli
simjob-customs login --edge=https://edge.demo3.simjob.net
  # API key no demo3: dev-key-12345

simjob-customs init meu-relatorio --host=mes
cd meu-relatorio
simjob-customs dev                     # HMR local
simjob-customs build
simjob-customs publish --tenant=SEU_TENANT
simjob-customs enable meu-relatorio --tenant=SEU_TENANT

4. Gerar custom com IA (DashScope)

Coloque PDFs/emails em edge/customs/<tenant>/_briefing/ e rode:

simjob-customs gen \
  --slug=meu-relatorio \
  --host=mes \
  --kind=report \
  --title="Meu Relatório" \
  --tenant=SEU_TENANT

5. Testar jobs agendados

Aba JobsRodar agora dispara o cron síncrono. Sem SMTP_HOST configurado, o runner entra em dry-run (loga destinatários, não envia de verdade).

🔑 Autenticação: no demo3 a API key é dev-key-12345. Em produção, use JWT obtido via POST /api/v1/auth/login.
🔐 Controle de acesso

Define quem pode ver e onde esse custom aparece. Perfis vazios = qualquer usuário autenticado. Plantas vazias = todas as plantas.

Perfis (required_roles)

Carregando…

Plantas ISA-95 (allowed_groups)

Carregando…