Adicionar
Define como criar ou inserir registros no ME — orientando qual verbo usar, onde posicionar o CTA, e qual feedback confirma a ação.
Boas Práticas
Criar, Adicionar e Gerar compartilham a intenção de introduzir algo novo no sistema, mas diferem no escopo, na permanência e no fluxo disparado. A ação deve deixar claro o que será criado, onde será aplicado e qual impacto terá — antes do clique.
Contextos
Criar e Adicionar ocorrem em contextos muito distintos no ME. O posicionamento do CTA muda conforme o escopo da ação — global (Subheader), contextual (toolbar de tabela, card) ou local (formulário). Cada nível tem regras de hierarquia visual próprias.
O botão primário fica à esquerda do Subheader, ao lado dos secundários e da busca. É único por tela, sempre visível — ação única (sem split) que abre direto a página de criação. Abaixo, a filter bar mostra os critérios ativos; o índice não tem título de seção.
O split button fica à esquerda do Subheader. O chevron abre um dropdown flutuante, ancorado ao próprio botão e sobreposto ao conteúdo — lista só o tipo do documento, sem repetir o verbo.
Em tabelas de documento (cotação, pedido), as ações de adição ficam na toolbar da própria tabela — nunca no Subheader global.
Hierarquia
1 — Criar / Novo (primário global)
Definição
- Gera uma nova entidade mestre que não existia no sistema — registro permanente criado do zero
- Representa o objetivo principal da tela; deve ser único e visualmente dominante
Características
- Botão primário sólido (bg-primary) no Subheader — máximo destaque visual
- Ícone i-lucide-plus como reforço da intenção de criação
- Rótulo sempre com objeto explícito: "Novo Fornecedor", não apenas "Novo"
- Sempre visível — nunca oculto em menu de overflow ou Mais ações
Heurísticas aplicadas
- Correspondência com o mundo real — "Novo Fornecedor", "Adicionar item" e "Novo documento → Cotação" mapeiam intenções reais do usuário
- Reconhecimento em vez de memorização — o objeto no rótulo elimina ambiguidade: o usuário sabe o que cria antes de clicar
- Controle e liberdade — o CTA primário está sempre visível no Subheader, nunca oculto em overflow ou menus
- Prevenção de erros — distinção clara entre Criar (permanente), Adicionar (contextual) e Gerar (fluxo) evita ações equivocadas
Quando usar
- Índices de entidades de cadastro mestre: Fornecedores, Produtos, Usuários, Empresas, Cargos, Catálogos
- Sempre que o resultado é um novo registro independente e permanente no sistema
2 — Adicionar (secundário / contextual)
Definição
- Insere um item em um contêiner já existente — o registro original não é criado nem alterado
- Ação contextual: restrita ao escopo do componente (tabela, card, lista)
Características
- Estilo outlined (border primary) na toolbar da tabela — hierarquia abaixo do primário do Subheader
- Ou ghost / link-button em formulários e campos dinâmicos de baixa prioridade
- Ícone i-lucide-plus mantém consistência visual com o padrão de criação
- Pode ser múltiplo — uma ação de adicionar por tabela ou por card, sem conflito entre si
Heurísticas aplicadas
- Consistência e padrões — "Novo [Entidade]" para cadastros; "Adicionar [item]" para listas; "Novo documento → [Tipo]" para fluxos de procurement
- Eficiência e flexibilidade — split button concentra os 5 tipos de documento de transação num único CTA sem poluir o Subheader
- Visibilidade do status do sistema — feedback imediato (Toast) confirma o que foi criado; para fluxos, indica o próximo passo
Quando usar
- Tabelas de documento: "Adicionar item" na toolbar da tabela de itens da cotação ou pedido
- Carrinhos de catálogo: "Adicionar ao carrinho" por card de produto
- Listas de relacionamento: "Adicionar fornecedor", "Adicionar aprovador"
- Campos dinâmicos e formulários: "Adicionar campo", "Adicionar anexo"
3 — Gerar (documentos de fluxo)
Definição
- Dispara a criação de um documento via fluxo automático e estruturado de procurement
- Diferencia-se de "Criar" porque inicia um processo com etapas definidas — não é apenas persistir um registro
Características
- Sempre via split button "Novo documento" no Subheader do Index de Transações
- A parte esquerda do split dispara o fluxo mais frequente (Requisição por padrão)
- O chevron abre dropdown com os 5 tipos: Requisição, Cotação, Pedido, Leilão, Nota Fiscal
- O dropdown lista apenas o tipo do documento — Requisição, Cotação, Pedido, Leilão, Nota Fiscal — sem repetir o verbo
Heurísticas aplicadas
- Correspondência com o mundo real — "Novo documento" deixa claro que o resultado é um documento de fluxo, não um cadastro mestre; o dropdown revela o tipo sem ambiguidade
- Prevenção de erros — concentrar Requisição, Cotação, Pedido, Leilão e NF no split button evita que o usuário escolha o tipo errado por engano
Quando usar
- Exclusivamente no Index de Transações — via split button "Novo documento"
- Para qualquer um dos 5 documentos de procurement: Requisição, Cotação, Pedido, Leilão e Nota Fiscal
Ações de criação mapeadas no produto ME
Ações por escopo de hierarquia
Labeling
O verbo correto depende do contexto e do tipo de criação. Usar o verbo errado comunica intenção diferente — "Adicionar Requisição" soa como inserção em lista, não como início de fluxo de procurement. A escolha do verbo é a decisão mais importante no labeling de ações de criação.
As regras gerais de copy e rótulo (Novo · Adicionar · Gerar; verbo + entidade; idioma) vivem em Foundations › Voz e conteúdo — esta seção cobre o específico de criação.
Gera um novo registro mestre que não existia — entidade permanente criada do zero.
Índices de dados cadastrais: fornecedores, produtos, usuários, empresas, cargos
Não se aplica em: Documentos de fluxo ou itens dentro de listas existentes
Insere um item em um contêiner já existente. O registro original não é alterado.
Tabelas de documento, carrinhos, listas de aprovadores, campos dinâmicos, cotação → fornecedores
Não se aplica em: Entidades de cadastro mestre ou documentos de fluxo estruturado
Inicia um documento de fluxo estruturado de procurement via split button — o tipo é escolhido no dropdown, sem repetir o verbo.
Split button "Novo documento" no índice de Transações
Não se aplica em: Cadastros mestres ou inserções em listas — esses usam Criar ou Adicionar
Verbos de criação no produto ME — quando usar cada um
Entidade nova — não existia antes. Fornecedor, Produto, Usuário, Empresa.
Cadastro mestreItem inserido em contêiner existente. Tabela de documento, carrinho, lista de aprovadores.
ContextualDocumento de fluxo de procurement. Requisição, Cotação, Pedido, Leilão, NF.
Fluxo estruturadoMesma semântica de "Adicionar" — informal e sem distinção clara no produto.
Prefira AdicionarSigla técnica ou símbolo isolado — fora do padrão textual do produto.
Não usar| Verbo | Objeto | Resultado |
|---|---|---|
| Novo | Fornecedor | Novo Fornecedor |
| Nova | Empresa | Nova Empresa |
| Novo documento | → Cotação | Novo documento → Cotação |
| Novo documento | → Requisição | Novo documento → Requisição |
| Adicionar | item | Adicionar item |
| Adicionar | aprovador | Adicionar aprovador |
- Seja explícito sobre o impacto quando ele não é óbvio:"Criar pedido (inicia fluxo de aprovação)" — o parêntese comunica consequência sem alarmar.
- Use o objeto sempre."Novo Fornecedor", "Novo documento → Cotação", "Adicionar item" — o usuário sabe exatamente o que será criado sem contexto adicional.
- "Novo documento" é o CTA para documentos de procurement no ME. O dropdown lista apenas o tipo (Requisição, Cotação…) sem repetir o verbo — padrão do split button.
- Não use"Novo" como CTA isolado — é um adjetivo, não uma ação. "Novo Produto" funciona; "Novo" sozinho não comunica o que será criado.
- Não use"Salvar" quando a ação cria algo novo — implica atualização de registro existente. Para criação, use "Criar", "Adicionar" ou "Gerar".
- Não use"Adicionar" para documentos de fluxo ME — use o split button "Novo documento"; o dropdown seleciona o tipo sem repetir o verbo.
Exemplos de uso
Criar e Adicionar aparecem em contextos muito distintos no ME — desde o CTA global de um índice de cadastro até o botão por card de um catálogo. A escolha errada do verbo, do estilo ou do posicionamento quebra a hierarquia visual e confunde o usuário sobre o escopo da ação.
CTA de criação no Subheader — único e sempre visível
O botão "Novo Fornecedor" ocupa a posição primária do Subheader. É o único primário da tela, sempre visível, nunca oculto em overflow. O objeto no rótulo elimina qualquer dúvida sobre o que será criado.
"Adicionar" isolado no Subheader, sem objeto
"Adicionar" sem o objeto "Fornecedor" não comunica intenção. O usuário precisa interpretar o contexto para entender o resultado — viola o princípio de reconhecimento em vez de memorização.
Split button no Index de Transações — todos os documentos num único CTA
O split button "Novo documento" com chevron concentra Requisição, Cotação, Pedido, Leilão e NF. A parte esquerda dispara o fluxo mais frequente; o chevron expande as opções. Nenhum botão extra polui o Subheader.
Um botão separado por tipo de documento no Subheader
Cinco botões primários concorrentes — "Gerar Req.", "Gerar Cot.", "Gerar Ped."… — sobrecarregam o Subheader e forçam o usuário a escanear antes de agir. O split button resolve isso com um único ponto de entrada.
"Adicionar item" outlined na toolbar da tabela de documento
"Adicionar item" usa estilo outlined (border primary) na toolbar da tabela de itens da cotação. Não aparece no Subheader global — que permanece com seus CTAs de fluxo (Aprovar, Enviar). Hierarquia clara: global > contextual.
"Adicionar item" como botão primário sólido no Subheader do documento
Elevar a ação da tabela ao Subheader global cria dois primários concorrentes: a ação de aprovação e a de adição de itens. A toolbar da tabela é o local correto — mantém o foco do Subheader no fluxo principal.
"Adicionar ao carrinho" outlined por card, sem disputar com o Subheader
Cada card do catálogo tem seu próprio CTA outlined. O botão é contextual ao card — não global. Ao clicar, feedback imediato (Toast ou atualização do contador de carrinho) confirma a ação sem bloquear o fluxo.
Botão primário sólido "Adicionar" dentro do card quando já existe primário global
Usar `bg-primary` dentro de um card cria dois focos de alta hierarquia na mesma tela — o primário do Subheader e o do card. Destaque máximo é reservado ao CTA global.
Ícone "+" como reforço visual consistente em todas as variantes de adição
O ícone `i-lucide-plus` acompanha todos os CTAs de criação, independente do estilo (primário, outlined, ghost). Cria consistência visual entre "Novo Fornecedor", "Adicionar item" e "Novo documento".
Ícones inconsistentes entre CTAs do mesmo padrão
Usar `i-lucide-upload` em "Novo Produto", `i-lucide-plus-circle` em "Adicionar item" e nenhum ícone em "Novo documento" quebra a consistência visual. O usuário não consegue identificar rapidamente o padrão de criação.
Feedback para Adicionar
Criar é uma ação de alta intenção — o sistema deve confirmar imediatamente o que foi criado e, quando relevante, indicar o próximo passo. O nível de feedback deve ser proporcional ao impacto: Toast discreto para adições simples, Alert para fluxos que disparam etapas subsequentes.
Use para confirmar criações simples — discreto, imediato e sem bloquear o fluxo.
Ex: "Fornecedor criado." / "Item adicionado."
Use quando o usuário precisa navegar imediatamente ao registro criado. O link no Toast evita que precise buscar manualmente.
Ex: "Novo Produto criado. Ver produto →"
Use quando a criação dispara um fluxo subsequente que exige ação do usuário — aprovação, envio, configuração.
Ex: "Requisição gerada e enviada para aprovação."