Base/labs | Manual CRM
Manual 01 / 06

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-*:

1
/swl-init-proposta
Cria repo, Drive e deal
2
/swl-montar-proposta
Escreve o conteúdo
3
/swl-publicar-proposta
Publica online

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:

swl-crm/
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:

1
brands/<MARCA>/sections/
override de marca
2
templates/<TEMPLATE>/sections/
seed padrão

4.2Scripts utils/bin/

ScriptFunção
run.mjsCLI principal — wrapper de dev/build/publish; parseia --proposta e --template
generate-pdf.mjsSobe servidor local, renderiza /pdf/ via Playwright → proposta.pdf
publish-to-r2.mjsUpload paralelo (8 workers) para o R2 Cloudflare
manage-users.mjsGerencia 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