Caso de estudo · Produto

ClickBox CRM: o sistema em que assenta um negócio real

A ClickBox começou no plano gratuito do HubSpot. A personalização de que o negócio precisava exigia licenças por utilizador que uma empresa em arranque não podia pagar — e o HubSpot não permitia a lógica, os ecrãs e as automações à medida por trás da forma como o negócio faz reservas, contratos e recebe pagamentos. Por isso construí o meu próprio CRM — e depois reconstruí o cliente para telemóvel como uma app Android nativa e offline-first.

Função
Fundador, Full-Stack Engineer
Empresa
ClickBox
Período
2024 – hoje
Stack
Kotlin · Compose · Room · Express · SQLite · Claude · Voyage AI
Início do CRM: receitas, despesas, o que precisa de atenção, pipelineDeals do CRM agrupados por faseDetalhe de um deal no CRMInbox do CRM com etiquetas de lead e dealResumo de IVA, Segurança Social e salários no CRM

Início · Deals · Detalhe do deal · Inbox · ImpostosDados de demonstração genéricos

Porquê construí-lo

O meu terceiro CRM — o primeiro que construí

Já tinha implementado o HubSpot e estendido o Zoho para outras empresas. Foi assim que percebi quando é que configurar deixa de compensar e passa a valer a pena construir.

2024 · DSwissComprado: HubSpotLiderei a primeira implementação de CRM e limpei os dados de faturação corrompidos para que o CRM fosse fiável.
2025 – 26 · AralabEstendido: Zoho →Implementei-o e depois fui além do que vem de origem, com Deluge, client scripts e widgets à medida.
2024 – hoje · ClickBoxConstruído: ClickBox CRMGere um negócio que fatura +50 mil € por ano em +300 eventos — da reserva à fatura.
  1. CaptaçãoLead + dealOs formulários do website e o n8n criam o deal, visível no computador e no telemóvel.
  2. Front office com AIRedigir, pesquisar, aprovarUm LLM redige respostas a partir de emails anteriores; um humano aprova no Telegram.
  3. ContratoAssinatura eletrónica + faturaPDF, assinatura PKCS#7 com carimbo temporal fidedigno e, depois, a fatura.
  4. DinheiroEncaminhar + conciliarO sinal e o pagamento final seguem para o fornecedor certo de cada conta.
AI com um controlo humano

Ensinar um modelo a falar como o negócio

As respostas são redigidas a partir de um corpus embebido com a correspondência passada do próprio negócio, para soarem à ClickBox e não a um helpdesk. Nada é enviado automaticamente: cada rascunho passa primeiro pelo Telegram. Quando um é rejeitado, um segundo modelo, mais barato, classifica o motivo — para que as rejeições melhorem o rascunho seguinte em vez de se perderem.

Inbox e conversa do CRM na horizontal
Profundidade, não amplitude

Um assistente fiscal que verifica as próprias citações

Um bot de Telegram recebe um recibo e tem de decidir o tratamento em IVA. Não responde com base no que um modelo se lembra da lei fiscal: vai buscar os artigos relevantes a um código legal indexado localmente, lê apenas esses e confere cada citação com o que abriu. Uma citação de um artigo que nunca leu é removida e a resposta é bloqueada.

Decisão de produto

Porque troquei a WebView por nativo

Quadro de deals do CRM na horizontal
  • Sem rede, sem appOs espaços de eventos têm má cobertura. Agora, o Room é a fonte de verdade.
  • Tabelas de computador num telemóvelScroll horizontal em todo o lado; agora cada ecrã é desenhado para 412 dp.
  • Uma pilha de remendos frágeisReencaminhamento de cookies, um user agent falsificado — substituídos por um único header com device token.
  • Um teto de funcionalidadesA shell chegava a cerca de 56 dos 328 endpoints do backend.
294unit tests à máquina de estados dos deals, às contas das faturas, a contratos, salários e IVA
6módulos Gradle — a lógica de domínio pura separada da UI, da rede e do armazenamento
4formas de atualizar: um push, a app em primeiro plano, um job de 15 em 15 minutos, puxar a inbox para baixo
1WebView mantida de propósito — em sandbox, para o HTML de emails não fiáveis
Design system

Cores com significado

“Studio” — um só tema claro, uma única ação coral por ecrã e um mapeamento de tons fixo em todos os ecrãs, para que uma cor signifique sempre a mesma coisa.

  • Mentadinheiro a entrar
  • Pêssegodinheiro a sair
  • Céucorreio e informação
  • Limãodatas e prazos
  • Rosaperigo