CRMAppy Docs Negócios
v0.1.6
💼 Capítulo 07

Negócios

O módulo de gestão de orçamentos do CRMAppy — um kanban visual com drag & drop para mover propostas entre os estágios Em Espera, Ganha e Perdida, com controle de motivo de perda e arquivamento.

📋 Visão Geral

O módulo Negócios é o painel de controle de orçamentos e propostas comerciais do CRMAppy. Exibe todos os orçamentos vinculados a ações do Cockpit organizados em um kanban de três colunas: Em Espera, Ganha e Perdida.

O usuário arrasta os cards entre as colunas para registrar o resultado de cada proposta. Ao mover para Ganha, um som de celebração é tocado. Ao mover para Perdida, o sistema exige o registro do motivo da perda antes de confirmar. Orçamentos concluídos podem ser arquivados para manter o kanban limpo.

🖥️ Anatomia do Kanban

🗄 Arquivados (3)
Em Espera 4
Proposta Sistema de Gestão
Clínica São Lucas
Follow-up proposta Q2
Renovação Contrato Anual
Distribuidora ABC
Negociação renovação
Ganha 2
Implantação CRM
Farmácia Central
Proposta aceita
Perdida 1
Consultoria Estratégica
Indústria XYZ
Proposta recusada
⚠ Cliente optou por solução concorrente com preço menor.

📊 As Três Colunas

🟡 Em Espera
Orçamentos enviados e aguardando resposta do cliente. É a coluna de entrada — todo orçamento começa aqui. Pode permanecer neste estágio enquanto a negociação estiver em andamento.
🟢 Ganha
Proposta aceita pelo cliente — negócio fechado. Ao mover um card para cá, o sistema toca um som de celebração automaticamente. Cards ganhos podem ser arquivados para limpar o kanban.
🔴 Perdida
Proposta recusada ou negócio não concluído. Exige o registro do motivo da perda (mínimo 3 palavras) antes de confirmar a movimentação. Cards perdidos também podem ser arquivados.

🃏 Card de Orçamento — Anatomia

Cada card representa um orçamento vinculado a uma ação do Cockpit. A cor de fundo é gerada automaticamente a partir do nome da empresa — mantendo consistência visual para a mesma empresa em diferentes cards.

Proposta Sistema de Gestão
Clínica São Lucas
Follow-up proposta Q2
28 mai. 2026
Descrição Título do orçamento. Se não houver descrição, exibe "Orçamento sem descrição".
Empresa Nome da empresa vinculada à ação do Cockpit.
Assunto Assunto da ação (chat) à qual o orçamento está vinculado.
Valor (R$) Valor do orçamento formatado em reais. Exibe "R$ -" se não informado.
Data Data da última atualização do orçamento.
✏️ Editar Abre o campo de edição do motivo da perda dentro do card (disponível em qualquer coluna).
🗄 Arquivar Disponível apenas nas colunas Ganha e Perdida. Move o orçamento para o arquivo morto.
Cor de fundo Gerada automaticamente a partir do nome da empresa. Consistente para a mesma empresa.

🖱️ Drag & Drop — Como Funciona

AçãoComportamento
Arrastar um card Clique e segure o card (mínimo 8px de movimento para ativar). O card original fica com 50% de opacidade. Uma cópia com rotação e sombra aparece seguindo o cursor.
Soltar na mesma coluna Reordena os cards dentro da coluna. A nova ordem é salva.
Soltar em outra coluna Move o card para a nova coluna. O status é atualizado automaticamente no banco.
Mover para Ganha Status atualiza para Ganha e um som de celebração é tocado automaticamente.
Mover para Perdida O card vai para a coluna Perdida e o campo de motivo da perda abre automaticamente dentro do card. O status só é salvo definitivamente após preencher o motivo.
Cancelar arraste Soltar fora de qualquer coluna válida cancela a operação e o card volta à posição original.
🔴 Motivo da perda obrigatório Ao mover um card para a coluna Perdida, o campo de motivo abre automaticamente. O motivo deve ter no mínimo 3 palavras. Enquanto não for preenchido e salvo, o card fica em modo de edição e não pode ser arrastado novamente. Pressione Enter para salvar ou Esc para cancelar.

🗄 Orçamentos Arquivados

Cards das colunas Ganha e Perdida podem ser arquivados para manter o kanban focado apenas nos negócios ativos. Os arquivados ficam acessíveis em um painel separado.

ElementoComportamento
Botão "Arquivados (N)"
Canto superior direito
Abre o modal de orçamentos arquivados. O número entre parênteses mostra quantos orçamentos estão arquivados.
Modal de Arquivados Lista todos os orçamentos arquivados com: descrição, empresa, assunto, status (badge colorido) e valor. Fecha ao clicar fora ou no botão X.
Botão Desarquivar Devolve o orçamento ao kanban na coluna correspondente ao seu status (Ganha ou Perdida).
Ícone 🗄 no card Visível apenas em cards das colunas Ganha e Perdida. Clique para arquivar o orçamento imediatamente.
ℹ️ Arquivar não é excluir Orçamentos arquivados permanecem no banco de dados e continuam aparecendo nos relatórios e KPIs da Visão 360°. O arquivamento serve apenas para remover o card do kanban ativo.

▶️ Fluxo de Uso

  1. 1
    Abra Negócios pelo menu lateral

    O kanban carrega com todos os orçamentos ativos organizados nas três colunas. O botão "Arquivados" no topo mostra quantos orçamentos estão no arquivo.

  2. 2
    Localize o orçamento desejado

    Cada card mostra descrição, empresa, assunto, valor e data. A cor de fundo identifica visualmente a empresa.

  3. 3
    Arraste o card para o novo estágio

    Clique, segure e arraste o card até a coluna correta. Solte sobre a coluna ou entre outros cards para posicionar na ordem desejada.

  4. 4
    Se mover para Perdida: informe o motivo

    O campo de texto abre automaticamente. Digite o motivo (mínimo 3 palavras) e pressione Enter ou clique no botão ✓ para confirmar.

  5. 5
    Arquive quando concluído

    Cards Ganhos ou Perdidos que não precisam mais de atenção podem ser arquivados clicando no ícone 🗄 do card. Isso limpa o kanban sem perder o registro.

⚠️ Pontos de Atenção

⚠️ Os orçamentos vêm do Cockpit Orçamentos são criados dentro de ações no Cockpit — não diretamente no módulo Negócios. Para criar um novo orçamento, registre uma ação no Cockpit e vincule o orçamento a ela. O módulo Negócios é o painel de gestão e movimentação, não de criação.
💡 Som de celebração Ao mover um orçamento para a coluna Ganha, o sistema toca automaticamente um som de comemoração. É um feedback positivo para reforçar o fechamento de negócios — funciona via Web Audio API, sem dependências externas.