Visão Geral
ClientFlow é o módulo CRM do GitScrum para agências. Gerencie clientes, acompanhe receita com faturas e propostas, monitore a saúde dos projetos e identifique clientes em risco—tudo em um dashboard unificado para proprietários de agências.
ClientFlow é o módulo de gestão financeira e de clientes construído exclusivamente para proprietários de agências. Ele consolida tudo que você precisa para gerenciar relacionamentos com clientes, acompanhar receita e monitorar a saúde dos projetos em um único dashboard.
Requisito de acesso: ClientFlow está disponível apenas para usuários com a função agency_owner.
O Que o ClientFlow Gerencia
O ClientFlow conecta quatro entidades principais que impulsionam as operações da agência:
| Entidade | O Que Você Gerencia | Status Principais |
|---|---|---|
| Clientes | Contatos de empresas, relacionamentos | Ativo, com faturas, com atraso |
| Faturas | Cobrança e recebimentos | Rascunho, Pendente, Paga, Atrasada |
| Propostas | Pipeline de vendas e orçamentos | Rascunho, Enviada, Visualizada, Aprovada, Rejeitada, Expirada |
| Solicitações de Alteração | Mudanças de escopo e adicionais | Rascunho, Enviada, Aprovada, Rejeitada, Ajuste Solicitado |
| Projetos | Entrega e acompanhamento de orçamento | Ativo, status de saúde (Saudável, Atenção, Crítico) |
O Dashboard: Sete Abas de Visibilidade
Ao abrir o ClientFlow, você acessa o Dashboard—um centro de comando com sete abas e filtros de data configuráveis:
- MTD (mês até hoje)
- Últimos 30 dias
- QTD (trimestre até hoje)
- Últimos 90 dias
- YTD (ano até hoje)
- Últimos 6 meses
Aba 1: Visão Geral
Seu resumo matinal. Em uma tela:
| Métrica | O Que Mostra |
|---|---|
| Receita Total | Soma de todas as faturas pagas no período selecionado |
| Receita Pendente | Faturas enviadas mas ainda não pagas |
| Projetos Ativos | Projetos em andamento |
| Total de Clientes | Sua contagem completa de clientes |
Mais três visualizações:
- Gráfico de Status de Faturas: Pagas vs Pendentes vs Atrasadas (gráfico de rosca)
- Pipeline de Propostas: Rascunho → Enviada → Aprovada (funil)
- Solicitações de Alteração: Pendentes vs Aprovadas (comparação)
E alertas em tempo real para:
- Faturas atrasadas
- Propostas expirando em 7 dias
- Projetos em risco (acima de 90% do orçamento)
Aba 2: Pipeline de Receita
Acompanhe o fluxo completo de dinheiro:
| Seção | O Que Você Vê |
|---|---|
| Resumo de Faturas | Contagem de faturas em Rascunho, Pendentes e Pagas com totais |
| Tendência de Receita Mensal | Gráfico mostrando tendências de faturas pagas ao longo do tempo |
| Faturas Recentes | Suas 10 faturas mais recentes com status e valores |
| Faturas Atrasadas | Todas as faturas além da data de vencimento, ordenadas por dias de atraso |
| Propostas Pendentes | Propostas aguardando aprovação do cliente com dias de espera |
Aba 3: Aprovações Pendentes
Tudo que está parado esperando uma decisão:
| Tipo | O Que É Acompanhado |
|---|---|
| Propostas | Propostas enviadas/visualizadas aguardando aprovação do cliente |
| Solicitações de Alteração | Mudanças de escopo aguardando aprovação ou com ajuste solicitado |
| Faturas | Faturas enviadas aguardando pagamento |
Cada item mostra:
- Dias de espera
- Valor total
- Nível de urgência (normal, alto, crítico)
- Data de expiração se aplicável
Aba 4: Em Risco
Três tipos de risco, identificados automaticamente:
| Tipo de Risco | Gatilho | O Que Significa |
|---|---|---|
| Fatura Atrasada | Fatura além da data de vencimento | Cliente pode estar com problemas ou despriorizando você |
| Projeto Parado | Sem tempo registrado em 14+ dias em projeto ativo | Trabalho parou—intencionalmente ou não |
| Proposta Expirando | Data de validade da proposta em 7 dias | Feche ou perca |
Cada cliente em risco mostra:
- Nível de risco (Crítico, Alto, Médio, Baixo)
- Fatores de risco
- Valor em risco
- Ações sugeridas
Aba 5: Saúde dos Projetos
Monitore a saúde operacional de cada projeto ativo:
| Métrica | O Que Mede |
|---|---|
| Uso do Orçamento | Porcentagem do orçamento consumido (horas usadas ÷ horas orçadas) |
| Progresso de Tarefas | Tarefas concluídas ÷ total de tarefas |
| Status de Saúde | Saudável, Atenção ou Crítico |
| Prazo | Dias restantes ou atrasados |
Projetos são sinalizados:
- Atenção a 75% do orçamento consumido
- Crítico a 90% do orçamento consumido
- Acima do Orçamento quando excede 100%
Aba 6: Insights
Itens acionáveis gerados por IA, priorizados por urgência:
| Prioridade | Exemplos |
|---|---|
| Crítico | Faturas atrasadas requerendo acompanhamento imediato |
| Importante | Propostas pendentes há 7+ dias, propostas expirando |
| Oportunidade | Faturas em rascunho prontas para emissão, potencial de receita |
Cada insight inclui:
- Título e descrição
- Cliente relacionado
- Valor potencial (quando aplicável)
- Botão de ação para resolver
Aba 7: Classificação
Classifique clientes por contribuição:
| Métrica | O Que Mostra |
|---|---|
| Receita Total | Soma de faturas pagas no período |
| Receita Pendente | Valores de faturas em aberto |
| Faturas Pagas | Contagem de faturas pagas |
| Projetos Ativos | Contagem de projetos atuais |
| Pontuação de Confiabilidade | Porcentagem de faturas pagas em dia |
| Média de Dias para Pagamento | Média de dias da emissão ao pagamento |
Ordene por receita, projetos ou confiabilidade para encontrar seus melhores (e piores) clientes em desempenho.
Gestão de Clientes
Além do dashboard, o ClientFlow oferece gestão completa de clientes:
Lista de Clientes
- Navegue por todos os clientes com busca
- Filtre por: Todos, Com Faturas, Pagamento Pendente, Atrasado
- Ordene por diversos critérios
- Clique em qualquer cliente para abrir o painel de detalhes
Painel de Detalhes do Cliente
Seis abas por cliente:
| Aba | O Que Você Acessa |
|---|---|
| Empresa | Análises do cliente e métricas de desempenho |
| Insights | Insights de IA específicos do cliente |
| Propostas | Todas as propostas para este cliente (criar, visualizar, filtrar por status) |
| Solicitações de Alteração | Histórico de mudanças de escopo (criar, aprovar, rejeitar) |
| Faturas | Histórico completo de faturas (criar, emitir, marcar como paga) |
| Projetos | Projetos atribuídos a este cliente |
Ações Disponíveis
De qualquer cliente:
- Criar Fatura: Gerar nova fatura
- Criar Proposta: Enviar nova proposta de projeto
- Criar Solicitação de Alteração: Documentar mudanças de escopo
- Atribuir Projeto: Vincular projeto existente ao cliente
- Editar Cliente: Atualizar informações do cliente
- Excluir Cliente: Remover cliente (com confirmação)
Casos de Uso Reais
Para Agências de Desenvolvimento
Problema: Você tem 8 projetos simultâneos. Alguns são preço fixo, outros retainer. Você está perdendo dinheiro em pelo menos dois, mas não sabe quais.
Solução ClientFlow:
- Abra a aba Saúde dos Projetos
- Ordene por uso de orçamento
- Veja imediatamente: Projeto Alpha a 127% do orçamento (acima), Projeto Beta a 94% (crítico)
- Clique em Projeto Alpha → veja detalhamento de horas, identifique scope creep
- Crie uma Solicitação de Alteração para realinhar com o cliente
Para Estúdios de Design
Problema: Você enviou 12 propostas no último trimestre. Fechou 4. O que aconteceu com as outras 8?
Solução ClientFlow:
- Vá para Gestão de Clientes
- Filtre por entidade: Propostas
- Filtre por status: Expirada ou Rejeitada
- Veja padrões: Média de dias antes de expirar, pontos comuns de rejeição
- Use a aba Insights para identificar propostas expirando antes que morram
Para Agências de Marketing
Problema: Seu maior cliente está pagando com atraso ultimamente. Isso é um sinal de alerta?
Solução ClientFlow:
- Abra a aba Classificação
- Encontre o cliente → verifique Pontuação de Confiabilidade e Média de Dias para Pagamento
- Vá para a aba Em Risco → veja se estão sinalizados
- Verifique o Detalhe do Cliente → aba Faturas para histórico de pagamento
- Conversa proativa antes que o relacionamento deteriore
Dois Pontos de Entrada
Acesse o ClientFlow pela navegação principal:
- Dashboard (
/client-flow) — O centro de comando de sete abas para métricas de toda a agência - Clientes (
/client-flow/clients) — Gestão de clientes com painéis de detalhes
Ambos sincronizam em tempo real. Crie uma fatura pelo painel do cliente, veja imediatamente na aba Receita do dashboard.
Integrações Principais
Controle de Tempo → Orçamento do Projeto
O tempo registrado nas tarefas do projeto flui diretamente para os cálculos de orçamento do ClientFlow:
| Ação de Tempo | Impacto no ClientFlow |
|---|---|
| Iniciar cronômetro na tarefa | As horas se acumulam contra o orçamento do projeto |
| Completar registro de tempo | O uso do orçamento atualiza em tempo real |
| Registrar 8 horas | A saúde do projeto pode mudar (Saudável → Atenção → Crítico) |
A aba Saúde dos Projetos mostra o consumo do orçamento como porcentagem. Projetos sem tempo registrado em 14+ dias são marcados como Projeto Parado na aba Em Risco.
Propostas → Projetos
Propostas aprovadas podem ser convertidas diretamente em projetos do GitScrum:
- O cliente aprova sua proposta
- Clique em Converter para Projeto
- Selecione o workspace de destino
- O projeto é criado com os detalhes da proposta
A proposta rastreia seu estado de conversão—você verá Ver Projeto em vez de Converter para Projeto uma vez vinculado.
Propostas → Faturas
Gere faturas diretamente de propostas aprovadas:
- Abra a proposta aprovada
- Clique em Gerar Fatura
- Escolha valor total ou parcial
- A fatura é criada vinculada à proposta
A proposta rastreia:
- Valor total faturado
- Restante a faturar
- Badge Totalmente Faturada quando completo
Integração MCP
O ClientFlow é totalmente acessível através do Servidor MCP do GitScrum, permitindo que assistentes de IA gerenciem as operações da agência programaticamente.
Ferramentas MCP Disponíveis
| Ferramenta | Ações |
|---|---|
client | list, get, stats, create, update |
invoice | list, get, stats, create, update, issue, send, mark_paid |
proposal | list, get, stats, create, update, send, approve, reject, convert |
clientflow_dashboard | overview, revenue, at_risk, pending, health, insights, leaderboard, analytics |
clientflowcrossworkspace | Dados agregados de todos os workspaces |
Exemplos de Prompts
Com assistentes de IA como Claude, Cursor ou Windsurf:
"Mostre o dashboard de receita do workspace acme"
"Crie uma fatura para o cliente TechCorp"
"Liste todas as faturas atrasadas"
"Converta a proposta aprovada para projeto"
"Quais clientes estão em risco?"Consulte a documentação MCP do ClientFlow para a referência completa das ferramentas.
Primeiros Passos
O ClientFlow não requer configuração separada se você já usa GitScrum:
- Acesse o ClientFlow pelo menu principal (requer função agency_owner)
- Revise seus clientes — contatos de projetos existentes aparecem automaticamente
- Crie sua primeira fatura — a partir do tempo registrado no projeto
- Verifique o dashboard — veja a visão financeira da sua agência
Próximo: Guia de Início Rápido →