Prompts do controle de clientes
Você vai construir, do zero, um controle de clientes: cadastro, status e data do próximo contato, com destaque para quem está atrasado. Cole cada prompt, na ordem, na aba Code do app do Claude. Antes de passar ao próximo, confira o que deveria aparecer.
Antes de começar
- Contas abertas no navegador: GitHub (onde o código fica guardado), Netlify (quem publica o site na internet) e Supabase (o banco de dados, onde os clientes ficam gravados).
- No app do Claude, aba Code, escolha uma pasta vazia, por exemplo
Documentos\crm-curso. Tudo que o Claude criar vai para lá. - Quando o Claude pedir permissão para criar arquivo ou rodar comando, leia o que ele quer fazer e aprove.
- Travou? A versão pronta está no
app-referenciado curso. Peça ao instrutor.
Criar o projeto e o CLAUDE.md
O CLAUDE.md é um bilhete que o Claude lê toda vez que abre esta pasta. Ali fica o que é o projeto e as regras.
Vamos criar um controle de clientes simples para a minha empresa. Sou dono de empresa, não programador: explique cada passo em palavras simples.
Comece criando nesta pasta um arquivo CLAUDE.md com:
O que é: controle de clientes com cadastro (nome, empresa, e-mail, telefone), status (lead, proposta, cliente, perdido) e data do próximo contato. A lista destaca quem está com o contato atrasado.
Como é feito:
- Página estática: index.html, app.js e estilo.css. Sem build, sem npm, sem framework.
- Dados no Supabase, com a biblioteca supabase-js carregada pelo CDN do jsDelivr.
- A URL e a anon key do Supabase ficam só no arquivo config.js.
- A tabela se chama "clientes". O SQL que a cria fica em schema.sql.
- O código vai para o GitHub, ligado ao Netlify, que publica a cada push.
Regras:
- Sem login: qualquer pessoa com o link lê e escreve. Por isso, só dados fictícios.
- Se o Supabase não estiver configurado ou der erro, mostrar uma mensagem amigável na tela, nunca deixar a página quebrar.
- Preferir recursos nativos do navegador (por exemplo, campo de data nativo).
- Textos da tela em português.
Só crie o CLAUDE.md por enquanto e me mostre o conteúdo.
O que você deve ver
Um arquivo CLAUDE.md na pasta, e o Claude mostrando o texto dele na conversa.
Se não funcionar
Se o Claude pedir permissão para criar o arquivo, aprove. Se ele começar a criar outros arquivos, diga: "pare, por enquanto só o CLAUDE.md". Se a pasta não estiver escolhida, selecione uma pasta vazia na aba Code e cole de novo.
Criar a tabela no Supabase
O Claude escreve o SQL (a "receita" que cria a tabela). Você cola no Supabase e roda. Ele não mexe na sua conta.
Crie o arquivo schema.sql para o Supabase com:
1. A tabela public.clientes com: id (uuid, gerado automaticamente), nome (obrigatório), empresa, email, telefone, status (só aceita lead, proposta, cliente ou perdido; padrão lead), proximo_contato (data) e criado_em (data e hora, preenchido automaticamente).
2. RLS ligado na tabela, com políticas explícitas para o papel anon poder ler, criar, editar e apagar. Dê um nome claro a cada política.
3. O grant dessas quatro operações para o papel anon.
4. Três clientes fictícios de exemplo, um deles com o próximo contato já atrasado.
5. No topo do arquivo, um comentário avisando que, sem login, qualquer pessoa com o link lê e escreve, e por isso só vale usar dados fictícios.
Faça o SQL poder rodar mais de uma vez sem erro. Depois me diga, passo a passo, onde colar no Supabase.
O que você deve ver
Um arquivo schema.sql. No Supabase, abra seu projeto, vá em SQL Editor, clique em New query, cole todo o conteúdo e clique em Run. Deve aparecer Success. No rows returned. Em Table Editor, a tabela clientes aparece com 3 linhas.
Se não funcionar
Copie a mensagem de erro vermelha do Supabase, cole aqui no Claude e escreva: "deu este erro no SQL Editor, corrija o schema.sql". Depois rode de novo o arquivo inteiro. Se o Supabase avisar de "operação destrutiva", confirme: são só os comandos que apagam e recriam as políticas.
Criar a página do CRM
Agora crie a página, seguindo o CLAUDE.md:
- index.html com o formulário de cadastro (nome, empresa, e-mail, telefone, status e próximo contato, com campo de data nativo) e, abaixo, a lista de clientes.
- No topo da página, um aviso fixo: "Este app não tem login: quem tiver o link vê e altera tudo. Use só dados fictícios."
- A lista mostra nome e empresa, e-mail e telefone, status e próximo contato, ordenada pela data do próximo contato (sem data vai para o fim).
- Na própria lista dá para trocar o status e a data, e apagar um contato (pedindo confirmação antes).
- Contato atrasado (data já passou e status diferente de perdido) fica com a linha em vermelho claro e uma etiqueta "atrasado desde dd/mm/aaaa".
- Acima da lista, um resumo com quantos há em cada status e quantos estão atrasados, e uma caixa "Mostrar só os atrasados".
- app.js com toda a lógica, usando a tabela clientes do Supabase.
- config.js com as constantes SUPABASE_URL e SUPABASE_ANON_KEY, ainda com valores de exemplo "COLE_AQUI_...".
- estilo.css com visual simples e limpo: fundo claro, cartões brancos com borda suave, letras grandes e legíveis, e que funcione no celular.
- Se o config.js ainda não estiver preenchido, a página mostra uma mensagem amigável explicando o que falta, em vez de dar erro.
- Carregue o supabase-js pelo jsDelivr, com a versão fixa.
O que você deve ver
Os arquivos index.html, app.js, config.js e estilo.css na pasta. Peça ao Claude para abrir o index.html no navegador, ou dê dois cliques nele. A página aparece com o formulário e um aviso: "Falta ligar o Supabase…". Isso é o esperado: ainda falta a configuração.
Se não funcionar
Página em branco ou sem aviso? Escreva: "abri o index.html e aparece [descreva o que vê]. Corrija para mostrar a mensagem amigável de configuração." Se puder, aperte F12, aba Console, copie o texto em vermelho e cole junto.
Conectar no Supabase
Pegue dois valores no Supabase, em Project Settings > API (em algumas contas, Data API): a Project URL e a anon public key. Troque os colchetes do prompt por eles.
Preencha o config.js com estes valores do meu Supabase:
Project URL: [cole aqui a Project URL]
anon key: [cole aqui a anon public key]
Depois abra o index.html no navegador e me diga se a lista carregou os três clientes de exemplo. Explique em uma frase por que a anon key pode ficar visível no site.
O que você deve ver
A lista com os três clientes de exemplo, um deles em vermelho (atrasado). Cadastre um contato inventado: ele aparece na lista e, no Supabase, em Table Editor > clientes.
Se não funcionar
- "Invalid API key": a chave foi colada pela metade. Copie de novo, inteira.
- "A tabela clientes existe?": rode o
schema.sqlde novo no SQL Editor (Prompt 2). - Outro erro: copie a mensagem da tela, cole no Claude e peça "corrija".
Subir para o GitHub
Um repositório (repo) é a pasta do projeto guardada no GitHub, com o histórico de cada mudança. Um push é enviar as mudanças do seu computador para lá.
Quero guardar este projeto no GitHub, num repositório novo chamado crm-curso.
1. Crie um .gitignore simples (arquivos do sistema e pastas de editor).
2. Inicie o git nesta pasta e faça o primeiro commit com todos os arquivos.
3. Crie o repositório crm-curso na minha conta do GitHub e faça o push.
Se você não conseguir criar o repositório sozinho, me guie: eu crio pelo site do GitHub (vazio, sem README) e te passo o endereço. Se aparecer uma janela pedindo login no GitHub, eu faço o login.
No fim, me dê o link do repositório.
O que você deve ver
O link github.com/seu-usuario/crm-curso. Abrindo, aparecem os arquivos: index.html, app.js, config.js, estilo.css, schema.sql e CLAUDE.md.
Se não funcionar
Se o Claude disser que falta o git ou o login, faça o que ele indicar, uma coisa de cada vez. Se a janela de login não abrir, crie o repositório pelo site (botão New, nome crm-curso, sem marcar nada) e cole o endereço no Claude: "criei, o endereço é …, faça o push".
Conferir no Netlify
O deploy é a publicação do site na internet. O Netlify faz isso sozinho a cada push no GitHub. Esta parte é no navegador; o Claude te guia.
Vou publicar no Netlify o repositório crm-curso que acabamos de subir. Me guie, um passo por vez, esperando eu dizer "feito" antes do próximo:
1. Importar o projeto do GitHub no Netlify.
2. Quais campos preencher (é página estática, sem build).
3. Onde encontrar o endereço do site depois de publicado.
Quando eu te passar o endereço, me diga o que conferir na página para saber se está tudo certo.
O que você deve ver
No Netlify, Add new site > Import an existing project > GitHub, escolha crm-curso. Build command e publish directory ficam vazios. Em 1 minuto, um endereço como nome-aleatorio.netlify.app abre o seu CRM, com a mesma lista do computador.
Se não funcionar
- "Page not found": confira se o
index.htmlestá na raiz do repositório, não dentro de uma subpasta. - Abre, mas com o aviso "Falta ligar o Supabase": o
config.jsnão foi preenchido antes do push. Peça ao Claude: "confira o config.js e faça o push de novo". - O repositório não aparece na lista do Netlify: clique em Configure the Netlify app on GitHub e libere o acesso a ele.
Personalizar: cor
Troque a cor principal do CRM para [escolha: verde, azul-marinho, vinho, laranja…] e ponha o nome da minha empresa no título: [nome fictício da empresa]. Mantenha o resto igual. Depois faça commit e push.
O que você deve ver
A página no computador já com a cor nova. No endereço do Netlify, a mudança aparece em cerca de 1 minuto (recarregue a página).
Se não funcionar
Não mudou no Netlify? Recarregue com Ctrl+F5. Ainda igual? Pergunte ao Claude: "o push foi feito?". Não gostou da cor? Diga qual quer, em palavras: "mais escuro", "menos vibrante".
Personalizar: campo novo
Um campo novo mexe em dois lugares: na tabela do Supabase e na página. O Claude prepara os dois.
Quero um campo novo no cadastro: [ex.: "valor estimado" em reais / "origem" com as opções indicação, Instagram, site, evento].
1. Me dê o SQL para acrescentar a coluna na tabela clientes, para eu colar no SQL Editor do Supabase. Atualize também o schema.sql.
2. Acrescente o campo no formulário e na lista.
3. Me avise quando eu puder rodar o SQL, e só faça commit e push depois que eu disser que rodei.
O que você deve ver
Depois de rodar o SQL e o push, o campo novo aparece no formulário e na lista, e um contato salvo com ele mostra o valor no Table Editor do Supabase.
Se não funcionar
Erro "column … does not exist" ou "schema cache": o SQL não foi rodado, ou foi rodado num projeto diferente. Rode de novo e aguarde uns segundos. Outro erro: cole a mensagem no Claude.
Gmail: quem me escreveu e não está no CRM?
Primeiro ligue o conector do Gmail no Claude (Configurações > Conectores > Gmail > Conectar) e autorize com a sua conta Google. Um conector é uma ponte que deixa o Claude ler um serviço seu, com a sua permissão.
Use o conector do Gmail para ver quem me escreveu nos últimos 7 dias.
1. Ignore newsletters, propagandas, notificações automáticas e e-mails "no-reply".
2. Leia a tabela clientes do Supabase (a URL e a anon key estão no config.js) e compare pelos e-mails.
3. Me mostre uma tabela só com quem NÃO está no CRM: nome, e-mail, empresa (se der para deduzir pela assinatura ou pelo domínio) e o assunto do e-mail.
4. NÃO grave nada ainda. Espere eu dizer quais entram.
5. Para os que eu aprovar, insira na tabela clientes com status "lead" e próximo contato daqui a 3 dias. Se não conseguir gravar direto, me dê o SQL de INSERT para eu colar no SQL Editor.
O que você deve ver
Uma tabela com os remetentes da semana que ainda não estão no CRM. Depois que você aprovar, eles aparecem na lista do site como "Lead", com o próximo contato marcado.
Se não funcionar
- O Claude diz que não tem acesso ao Gmail: confira se o conector está ligado nesta conversa e autorizado.
- Lista vazia: talvez ninguém novo tenha escrito. Peça a um colega para te mandar um e-mail de teste e rode de novo.
- Erro ao gravar: peça o SQL de INSERT e cole no SQL Editor do Supabase.