O CRM próprio da SWL
Estamos construindo o nosso próprio CRM — sob medida para o jeito do grupo trabalhar, sem depender de ferramenta de terceiros. Este manual mostra como usá-lo no dia a dia.
1O que é o CRM da SWL
O CRM da SWL centraliza empresas, contatos, oportunidades, leads, tarefas e propostas das quatro marcas do grupo (Base2, Base/labs, MeloQA, Crowdtest) num único banco de dados que é nosso — construído internamente, no nosso ritmo, com a estrutura que faz sentido para a nossa operação.
A construção é incremental. Em vez de adotar de uma vez uma plataforma fechada, começamos pelo essencial e vamos somando capacidades. O que está descrito neste manual é o estado de hoje — e ele cresce a cada iteração.
2Fase 1: banco + conector MCP
Nesta primeira fase, o CRM é deliberadamente simples — e poderoso pela simplicidade:
- Um banco de dados PostgreSQL (no Supabase) que guarda todos os dados do CRM.
- Um conector MCP que liga o Claude diretamente a esse banco. Você manipula os dados conversando em português — o Claude traduz seu pedido em SQL e executa.
Não há (ainda) uma interface web com telas e botões. A interface é o Claude: você pede "liste os deals abertos da Base/labs acima de 50 mil" ou "crie um contato para a Maria na empresa Acme", e ele faz. Isso nos dá um CRM funcional e flexível desde o primeiro dia, sem o custo de construir telas para cada operação.
Como começar
A página CRM mostra o banco de dados, como pegar sua credencial e configurar o conector MCP no Claude. A Instalação cobre o setup das ferramentas.
3Propostas com o Claude Code
Além de manipular dados, o CRM traz comandos do Claude Code que agilizam a tarefa mais frequente do time comercial: criar, escrever e publicar propostas. São os comandos /swl-*:
Em vez de copiar templates e formatar à mão, você conversa com o Claude e ele cuida da parte técnica de ponta a ponta. Os detalhes de cada comando estão na página Propostas.
4O projeto base: swl-crm
Tudo gira em torno de um único repositório no GitHub: swl-crm (em swl-informatica/swl-crm). É o projeto base que todos do time devem ter clonado na máquina.
Ele reúne o que faz o CRM funcionar: os comandos /swl-* do Claude Code, os templates de proposta, a identidade visual das marcas e a engine de build. Tê-lo clonado e com os comandos ativados é o que habilita você a usar o fluxo de propostas de qualquer lugar do terminal.
Primeiro passo
Se você ainda não tem o swl-crm na máquina, comece pela Instalação — ela mostra como clonar o repositório e ativar os comandos no Claude.
4.1Estrutura do repositório
É a partir do swl-crm que cada proposta é criada. Em alto nível, ele reúne:
brands/ ← tokens e seções por marca
templates/ ← receitas de tipos de proposta
src/astro/ ← engine Astro compartilhada
utils/bin/ ← scripts CLI (build, PDF, publicação)
workers/propostas-auth/ ← Cloudflare Worker (auth + serve R2)Resolução de seções em build — o engine monta uma coleção única a partir de duas fontes, nesta ordem de prioridade:
4.2Scripts utils/bin/
| Script | Função |
|---|---|
run.mjs | CLI principal — wrapper de dev/build/publish; parseia --proposta e --template |
generate-pdf.mjs | Sobe servidor local, renderiza /pdf/ via Playwright → proposta.pdf |
publish-to-r2.mjs | Upload paralelo (8 workers) para o R2 Cloudflare |
manage-users.mjs | Gerencia usuários e senhas de acesso no Cloudflare KV |
O duplo hífen
Para passar flags via npm, o -- é obrigatório: npm run build -- --proposta=acme