← CursoEncontro 2 · material

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.

Só dados fictícios. Este app não tem login. Qualquer pessoa com o link consegue ler, alterar e apagar o que estiver lá. Use nomes inventados, como "Ana Exemplo, Padaria Fictícia". Nada de cliente de verdade.

Antes de começar

Prompt 1

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.

Prompt 2

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.
Política anônima quer dizer: o site, sem login, pode tudo nessa tabela. É ótimo para aprender e péssimo para dado real. Aqui, só dados fictícios.

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.

Prompt 3

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.

Prompt 4

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.
A anon key é pública por desenho: ela vai junto com o site para o navegador de quem abre. Quem protege os dados são as políticas (RLS) da tabela. Por isso, sem login, vale a regra dos dados fictícios. A service_role key é outra coisa: essa é secreta e nunca vai para o site nem para o chat.

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

Prompt 5

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".

Prompt 6

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

Prompt 7

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".

Prompt 8

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.

Prompt 9

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.

O banco deste curso é aberto: quem tiver o link do site lê tudo. Quem te escreveu é gente de verdade. Por isso, o prompt só lista e não grava nada sem o seu OK. Grave apenas contatos de teste, como e-mails trocados entre colegas da turma com nomes inventados. Dado de cliente real só depois de pôr login no app.
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