Referência de colunas do pipe¶

O que é¶

Aprofundamento coluna a coluna dos três boards do kanban-comercial (Comercial, Mesa F1, Mesa F2): para cada coluna, o que ela significa (o que o negócio está esperando ali), quais features/ações ficam disponíveis e como o card entra e sai. Esta página não repete o mapa evento→destino nem a tabela de regras por coluna já publicados em kanban-comercial — ela referencia e aprofunda. A máquina de estados formal (etapas, regras sempre válidas) está em pipe-e-etapa.

Pipe Comercial¶

Aguardando Apresentação¶

Responsabilidade: negócio pronto para o comercial se apresentar ao cliente — a análise já aprovou ou já existe proposta, mas ninguém "pescou" ainda.
Features disponíveis: botão Chat (Chatwoot); atribuicao-de-negocio (Pegar).
Movimentações: entra por analise.aprovada ou proposta.criada (ou já nasce aqui com dono, via herança — ver atribuicao-de-negocio); sai para Em Negociação ao Pegar.

Em Negociação¶

Responsabilidade: operador já é dono, conversando com o cliente sobre qual proposta fechar.
Features disponíveis: Chat; dialog de propostas (proposta); ✓ Aceito (avanco-do-negocio-comercial); atribuicao-de-negocio (Desatribuir).
Movimentações: entra por proposta.atribuida (Pegar); sai para Coleta de Documentos ao Aceitar uma proposta (forward-only, ver pipe-e-etapa). Regressão: Desatribuir não muda de coluna, só limpa o dono (fica na própria etapa até alguém pescar de novo).

Coleta de Documentos¶

Responsabilidade: proposta já aceita, aguardando os documentos do cliente ficarem completos para seguir à Mesa F2.
Features disponíveis: Chat; Docs OK (avanco-do-negocio-comercial).
Movimentações: entra por proposta.aceita (forward-only); sai para Mesa F2/Cadastrar CCB por proposta.docs-coletados — é a única saída do pipe Comercial que cruza para o pipe Mesa dentro do fluxo normal (fora de override manual).

Aguardando Assinatura¶

Responsabilidade: negócio voltou da formalização (F2) já efetivado; falta o cliente assinar o contrato.
Features disponíveis: Chat; Assinado (avanco-do-negocio-comercial).
Movimentações: entra por proposta.efetivada (round-trip Mesa F2 → Comercial, preserva o responsável — exceção às trocas de pipe, ver pipe-e-etapa); sai para Aguardando Pagamento ao marcar Assinado.

Aguardando Pagamento¶

Responsabilidade: contrato assinado, aguardando a liberação/compra do crédito na bancarizadora.
Features disponíveis: Chat (é a última etapa antes do terminal — sem ação de avanço manual, o gatilho é externo).
Movimentações: entra por proposta.contrato-assinado; sai para Concluído só pelo webhook PropostaPaga (FIDEM) — não existe botão que force esse avanço.

Concluído¶

Responsabilidade: pagamento confirmado; o negócio virou venda. status='concluido' libera o contato para um futuro refinanciamento (UNIQUE(contato_id) WHERE status='ativo' deixa de bloquear).
Features disponíveis: leitura (Ver/Simular propostas, histórico); nenhuma ação de avanço — é terminal.
Movimentações: entra por PropostaPaga; terminal em qualquer pipe (ver pipe-e-etapa) — não sai.

Pipe Mesa — Fase 1 (análise)¶

Nova Análise¶

Responsabilidade: contato acabou de entrar na Mesa (mesa aberta) e ainda não foi analisado.
Features disponíveis: botão ▶ Iniciar (abre analise-de-credito).
Movimentações: entra por contatos-mesa.criado (automático) ou contatos-mesa.reaberta; sai para Em Análise ao iniciar a análise (analista vira responsável).

Em Análise¶

Responsabilidade: analista avaliando o crédito do contato (Open Finance, score, decisão) — ver analise-de-credito para o ciclo completo de decisão.
Features disponíveis: botão 👁 Ver (abre a análise em andamento).
Movimentações: entra por analise.iniciada; sai para Criação de Propostas quando a análise é aprovada (analise.aprovada também é o gatilho que faz o negócio nascer/ transitar para o pipe Comercial, em paralelo — a etapa Mesa e o pipe Comercial não são mutuamente exclusivos no tempo de vida do contato); reprovação vai direto para Arquivado (contatos-mesa.recusado), ver arquivar-negocio.

Criação de Propostas¶

Responsabilidade: análise aprovada; falta gerar a(s) proposta(s) de crédito para o cliente.
Features disponíveis: botão ＋ Criar proposta.
Movimentações: entra por aprovação da análise; sai (o negócio já nasceu/transitou no Comercial em Aguardando Apresentação assim que proposta.criada é emitido) — esta etapa Mesa não tem saída própria de destino dentro da Mesa: a criação de proposta é o que destrava o card no Comercial, a etapa Mesa F1 permanece como "de onde veio".

Pipe Mesa — Fase 2 (formalização/bancarização)¶

Cadastrar CCB¶

Responsabilidade: negócio chegou da Coleta de Documentos do Comercial; falta vincular a proposta aceita e cadastrar a CCB na bancarizadora (FIDEM ou FIDUCIA).
Features disponíveis: cadastrar-ccb (dialog completo: vínculo de proposta + chooser de bancarizadora).
Movimentações: entra por proposta.docs-coletados (cruzando do Comercial); sai para Enviar Documentos por proposta.ccb-cadastrada. Não tem coluna Arquivado neste board (mostrarArquivados={false}) — arquivamento de negócios em formalização, se necessário, é feito no board Comercial/Mesa F1 ou via mover-negocio.

Enviar Documentos¶

Responsabilidade: CCB cadastrada; falta enviar os documentos do cliente para a bancarizadora e efetivar a operação.
Features disponíveis: aguardando-documentacao (mesma lógica embutida no card: botão Enviar Docs — dialog de upload — e Efetivar).
Movimentações: entra por proposta.ccb-cadastrada; sai (round-trip de volta ao pipe Comercial, etapa Aguardando Assinatura, preservando o responsável) ao Efetivar (proposta.efetivada) — é a etapa terminal do pipe Mesa nesse ciclo: o negócio não permanece na Mesa depois de efetivado, ele volta ao Comercial.

Colunas virtuais (cross-pipe)¶

Aprofundamento em board-comercial-controles (mecânica: cross-pipe, read-only, ausência condicional) e em pendencia (teoria da Pendência). Resumo de responsabilidade/entrada/saída:

Pendências/Bloqueados — responsabilidade: agrupar qualquer negócio (de qualquer pipe) que está congelado aguardando alguém resolver um bloqueio. Entra ao Pendenciar (nota obrigatória); sai ao Resolver — volta para a mesma etapa de onde saiu (não avança nem retrocede sozinho). Único caso de "saída" sem resolver: recusa ou pagamento, que vencem a pausa e movem o negócio mesmo pendenciado.
Em formalização (Mesa) — responsabilidade: dar visibilidade, só para o dono comercial, de que o negócio está fisicamente na Mesa F2. Sem features (read-only); entra/sai junto com as transições reais de Cadastrar CCB/Enviar Documentos (não tem gatilho próprio — é um espelho).
Arquivado/Reprovado — responsabilidade: registro de negócios que não vão virar venda. Entra por Arquivar manual ou por contatos-mesa.recusado automático; terminal (não sai).

Regras de negócio¶

⚠️ A documentar. Esta tela ainda não tem as regras de negócio levantadas do código.

O que entra aqui: invariante (o que nunca pode acontecer), permissão (quem pode fazer o quê), bloqueio (o que impede a ação e a mensagem que o usuário vê), cálculo (fórmula e arredondamento) e efeito colateral (o que mais muda quando isso acontece).

Regra só entra aqui com origem no código — arquivo e linha. Regra que alguém "acha que é assim" é pior que seção vazia, porque vira decisão de produto baseada em memória.

Relacionado¶

kanban-comercial · pipe-e-etapa · negocio · proposta · pendencia · board-read-only-orientado-a-eventos · atribuicao-de-negocio · avanco-do-negocio-comercial · cadastrar-ccb · aguardando-documentacao · arquivar-negocio · mover-negocio · board-comercial-controles · analise-de-credito · comercial · mesa

Histórico¶

2026-07-10: primeira ingestão — aprofundamento por coluna dos 3 boards (Comercial, Mesa F1, Mesa F2) e das 3 colunas virtuais, cruzado com o mapa evento→destino e a máquina de estados já existentes em kanban-comercial/pipe-e-etapa (sem duplicar a tabela).