Mapa público de normalização dos workflows n8n

Objetivo

Este documento apresenta a versão pública do padrão de nomenclatura e tags da
1Nort para workflows n8n. Ele descreve como dar nomes consistentes, facilitar a
pesquisa e registrar responsabilidade sem expor identificadores internos,
arquitetura, métricas, credenciais ou dados de clientes.

Os exemplos são fictícios e servem apenas para demonstrar o padrão. Eles não
representam o inventário de nenhum ambiente.

Padrão v2 do nome visível

ÍCONE [CONTEXTO] ETAPA/TOTAL | FUNÇÃO | Verbo + objeto

O emoji fica solto, sem colchetes. Somente o contexto usa [colchetes].

ETAPA/TOTAL é opcional. Exemplos:

⚪ [LEADS] 1/2 | ENTRADA | Receber cadastro do site
🔴 [GHL] 2/2 | PROCESSAMENTO | Qualificar lead recebido
🟢 [WHATSAPP] | PROCESSAMENTO | Conduzir conversa com o cliente
🔵 [CLICKUP] | SINCRONIZAÇÃO | Atualizar painel operacional
🟠 [1NORT] | UTILITÁRIO | Normalizar dados de contato

Cada parte do nome responde a uma pergunta:

Não usar no nome expressões como final, novo, corrigido, cópia, datas
ou identificadores técnicos. Uma versão, como v2, só aparece no final quando
duas versões precisam coexistir temporariamente.

Ícone do gatilho primário

Quando houver vários gatilhos, o nome continua com apenas um ícone. A escolha
segue esta ordem:

1. tratamento de erro, quando essa for a finalidade do workflow;
2. subfluxo, quando ele for um componente compartilhado sem entrada externa
   independente;
3. entrada externa que representa o contrato principal;
4. agendamento que inicia a rotina recorrente;
5. início manual ou evento interno, apenas quando forem o contrato real.

Os demais gatilhos de produção são registrados em tags. Se dois gatilhos
iniciarem responsabilidades diferentes, a recomendação é separar as entradas e
reutilizar um subfluxo comum.

Publicar em uma fila não torna o workflow um consumidor de fila. Da mesma
forma, usar um serviço na infraestrutura não significa que ele deva aparecer no
nome ou nas tags técnicas; a dependência deve ser explícita na lógica do
workflow.

Contexto pesquisável

O contexto é a âncora principal de pesquisa. Exemplos permitidos:

[LEADS] [WHATSAPP] [GHL] [CLICKUP] [1NORT]

Usar somente um contexto no nome. Sistemas secundários ficam em tags Usa | .... A grafia deve ser estável: se o padrão adotado for [GHL], não alternar
com variações do mesmo nome.

Funções controladas

Evitar sinônimos desnecessários. Por exemplo, usar ENTRADA em vez de criar
variações como INPUT, RECEBIMENTO ou HANDLER.

Cadeias e numeração de etapas

A fração 1/3 só deve aparecer quando:

• a cadeia for fixa e estiver documentada;
• todas as etapas compartilharem o mesmo nome de cadeia;
• o contexto só mudar quando a responsabilidade realmente passar para outro
  domínio ou sistema;
• cada posição for única;
• todas usarem o mesmo denominador;
• a ligação entre as etapas estiver confirmada.

Exemplo fictício:

⚪ [1NORT] 1/3 | ENTRADA | Receber solicitação operacional
🔴 [1NORT] 2/3 | PROCESSAMENTO | Consumir solicitação da fila
🟠 [1NORT] 3/3 | PROCESSAMENTO | Executar rotina solicitada

Tags da cadeia:

Cadeia | 1Nort - Ops
Etapa | 1 de 3

Cada workflow recebe apenas a tag da própria etapa. Se a cadeia tiver
ramificações frequentes ou o número de passos mudar, omitir a fração do nome e
documentar o fluxo em seu manifesto.

Modelo público de tags

As tags visíveis usam o padrão Categoria | Valor, em português natural, e
o rótulo completo deve ter no máximo 24 caracteres.

Obrigatórias

Governança e operação

Criticidade | Baixa
Criticidade | Média
Criticidade | Alta
Criticidade | Crítica

Escopo | Interno
Escopo | Compartilhado
Escopo | Cliente

Status | Em revisão
Status | Aprovado
Status | Legado

Dependências e ações

Registrar apenas dependências usadas diretamente pelo workflow:

Usa | WhatsApp
Usa | GHL
Usa | ClickUp
Usa | PostgreSQL
Usa | RabbitMQ

Preferir ações específicas e pesquisáveis:

Ação | Capturar lead
Ação | Validar lead
Ação | Criar contato
Ação | Nova oportunidade
Ação | Enviar mensagem
Ação | Sincronizar dados
Ação | Gerar relatório
Ação | Notificar erro

Evitar ações vagas como Processar, Executar ou Geral.

Criador e responsável

Todo workflow governado registra autoria histórica e responsabilidade atual:

Criador | Nome curto
Responsável | Nome curto

• Criador identifica quem criou originalmente o workflow. É um registro
  histórico e não muda quando a manutenção troca de pessoa.
• Responsável identifica quem responde atualmente pela manutenção e operação.
  Pode mudar e pode existir mais de um quando a responsabilidade for realmente
  compartilhada.
• criar um workflow não torna alguém responsável para sempre;
• assumir a responsabilidade não altera o registro do criador;
• não usar e-mail, identificador de conta ou nome completo público; usar o nome
  curto controlado internamente.

Quando a informação ainda não foi confirmada, usar placeholders explícitos:

Criador | A confirmar
Responsável | Pendente
Revisão | Criador
Revisão | Responsável
Status | Em revisão

Um workflow não deve avançar para produção enquanto o responsável permanecer
sem confirmação.

Exemplos completos e fictícios

Entrada de leads

⚪ [LEADS] 1/2 | ENTRADA | Receber cadastro do site

Contexto | Leads
Função | Entrada
Gatilho | Webhook
Ação | Capturar lead
Cadeia | Leads cadastro
Etapa | 1 de 2
Criador | Nome curto
Responsável | Nome curto
Status | Em revisão
Criticidade | Alta
Escopo | Compartilhado

Processamento no CRM

🔴 [GHL] 2/2 | PROCESSAMENTO | Qualificar lead recebido

Contexto | GHL
Função | Processamento
Gatilho | RabbitMQ
Ação | Qualificar lead
Ação | Nova oportunidade
Usa | GHL
Usa | RabbitMQ
Cadeia | Leads cadastro
Etapa | 2 de 2
Criador | Nome curto
Responsável | Nome curto
Status | Aprovado
Criticidade | Alta
Escopo | Compartilhado

Atendimento no WhatsApp

🟢 [WHATSAPP] | PROCESSAMENTO | Conduzir conversa com o cliente

Contexto | WhatsApp
Função | Processamento
Gatilho | Chat
Ação | Enviar mensagem
Usa | WhatsApp
Criador | Nome curto
Responsável | Nome curto
Status | Em revisão
Criticidade | Média
Escopo | Cliente

Sincronização com o ClickUp

🔵 [CLICKUP] | SINCRONIZAÇÃO | Atualizar painel operacional

Contexto | ClickUp
Função | Sincronização
Gatilho | Agendamento
Ação | Sincronizar dados
Usa | ClickUp
Criador | Nome curto
Responsável | Nome curto
Status | Aprovado
Criticidade | Média
Escopo | Interno

Como pesquisar

Aplicação segura

1. auditar o gatilho e o resultado principal;
2. confirmar contexto, função e ações;
3. validar cadeias e numeração de etapas;
4. confirmar criador e responsáveis;
5. aplicar primeiro as tags a um conjunto piloto;
6. validar as pesquisas usadas pela equipe;
7. renomear de forma gradual;
8. registrar a alteração na documentação versionada;
9. revisar duplicidades e legado somente depois da validação funcional.

Uma sugestão de nomenclatura nunca autoriza automaticamente desativar,
arquivar ou excluir um workflow.