
Minilição 10 de 30 · Tornar seu site útil
Defina o que significa salvar
Para quem é esta lição?
Para quem quer salvar envios de um site. Um assistente de programação pode aplicar a configuração fornecida e conectar o formulário; não precisa escrever SQL nem código de servidor.
O registro precisa existir fora da página atual do navegador.
Objetivo desta lição
- Envie um registro de formulário para armazenamento real.
- Verifique a persistência na visualização de tabela do provedor.
- Rejeite entradas inválidas sem expor os registros de todas as pessoas.
Explicação, exemplo resolvido e prática
Antes de começar
Você precisa do seu projeto Supabase descartável e de um projeto Netlify Functions de prática. Use os arquivos completos e um assistente para configurar. Mantenha credenciais privadas do banco no servidor e teste apenas mensagens fictícias. As respostas resolvidas são exemplos ilustrativos, não testes realizados na sua conta. Troque as observações de exemplo pelos seus resultados ou indique a etapa que continua bloqueada.
Confira os conhecimentos iniciais
São habilidades úteis, não cursos obrigatórios bloqueados. Se já as domina, comece aqui; caso contrário, abra a preparação. Os arquivos fornecidos dispensam um site pessoal anterior.
- Como publicar seu site pelo GitHub
Conecte um repositório de prática à hospedagem.
Tempo estimado: 20–37 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A configuração da conta é adicional. Este laboratório restrito não é um serviço público de comentários anônimos; revise limites duradouros contra abuso antes de adaptar ao uso público.
Entenda a ideia
Abra o formulário pronto com seu assistente e escolha uma mensagem fictícia distinta. Vamos salvá-la pelo servidor fornecido num banco de prática separado.
Um valor ainda visível na página não comprova armazenamento no banco. Planeje encontrar a mesma mensagem no provedor e após reabrir.
Um exemplo concreto
A tabela do provedor e a página atual do navegador são lugares diferentes. Uma mensagem que permanece na tabela depois de fechar a aplicação demonstra mais do que uma frase ainda exibida ao lado de enviar.
Use o projeto fornecido de armazenamento de comentários. Ajude a aplicar seu esquema apenas ao meu banco Supabase de prática separado e configurar o ambiente privado do servidor. Mantenha restrito o acesso dos visitantes à tabela de comentários. Inicie o formulário, mostre a visualização de tabela do provedor e ajude a verificar que dados válidos persistem e solicitações inválidas não criam linhas. Explique minhas verificações, não a sintaxe SQL.Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Onde você procurará para verificar se sua mensagem foi realmente salva?
Mostrar uma solução comentada
Resposta de exemplo: Vou enviar o texto fictício “D1 — blue notebook”, localizar essa mensagem exata na tabela feedback do responsável, fechar e reabrir a aplicação e conferir que ela continua lá. Um rótulo no formulário é só a primeira resposta visível.
O que uma boa resposta inclui
- Identifica o registro correspondente no provedor do banco como prova de armazenamento.
- Inclui reabrir/recarregar, em vez de confiar em uma mensagem temporária de sucesso.
Como funciona (opcional)
Armazene um registro fora do navegador
Uma linha salva deve continuar existindo depois de fechar a página.
Uma variável JavaScript desaparece ao fechar a página. O armazenamento local fica naquele navegador. Um banco guarda registros em um serviço que a aplicação acessa sob permissões explícitas.
Usaremos uma tabela privada Supabase e uma função de servidor. O navegador envia uma mensagem pequena; o servidor valida e escreve a linha. Esta lição não expõe um endpoint público que lista as mensagens de todos.
Exemplo resolvido
Depois de enviar “Database test D1”, feche a página e encontre a mensagem exata no editor de tabelas do projeto. Uma mensagem exibida só na página não prova armazenamento.
Exercício técnico complementar
A página mostra a mensagem enviada a partir de uma variável local. Isso prova que o banco salvou?
Mostrar uma solução comentada
Não. Verifique a linha real no banco. O navegador poderia mostrar a entrada mesmo sem uma solicitação ao servidor.
- Separa estado exibido de armazenamento.
- Verifica a linha correspondente por uma visualização autorizada do banco.

Etapa 1 · Como salvar envios de formulário em um banco de dados
Prepare o projeto de armazenamento isolado
Peça ao assistente para aplicar a configuração fornecida com segurança.
Explicação, exemplo resolvido e prática
Entenda a ideia
Crie ou escolha seu projeto Supabase descartável. Peça ao assistente para revisar e ajudar a aplicar schema.sql nele, configurar os valores privados e executar o projeto completo usando run-locally.txt.
Confirme o projeto correto antes de aplicar alterações. Não permita que visitantes públicos consultem todos os comentários; use o Table Editor do proprietário para examinar a linha de teste.
Um exemplo concreto
A tabela feedback fornecida tem mensagem, ID gerado e data de criação. O responsável pelo projeto pode inspecioná-la no provedor; os visitantes não precisam de permissão para ler todas as mensagens para esse teste funcionar.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Qual projeto de prática você preparou e consegue identificar sua visualização de tabela do proprietário?
Mostrar uma solução comentada
Registro de configuração de exemplo: O assistente aplicou schema.sql somente no meu projeto descartável, definiu os valores privados e iniciou a aplicação fornecida. Como responsável, posso inspecionar feedback no Table Editor. Visitantes públicos continuam sem poder consultar a tabela.
O que uma boa resposta inclui
- Identifica o projeto descartável e se a preparação do esquema/servidor foi concluída ou bloqueada.
- Localiza o Table Editor de feedback do responsável sem liberar a leitura aos visitantes.
Como funciona (opcional)
Crie uma tabela privada de prática
Ative segurança em nível de linha e mantenha fechado o acesso direto do navegador neste caminho.
Execute este esquema apenas no projeto Supabase isolado identificado na configuração. O acesso do navegador é restrito de propósito; verifique como proprietário em Dashboard → Table Editor. Não execute este esquema em produção.
Crie um projeto Supabase separado e execute schema.sql no editor SQL. A tabela tem ID gerado, mensagem com restrições e data e hora do servidor. Não execute mudanças de exemplo em um banco de produção sem relação.
O script ativa segurança de linha e remove privilégios da tabela dos papéis de navegador. A chave secreta/service-role pode fazer a escrita privilegiada e deve continuar no servidor. Uma chave publicável é diferente e não concede essas permissões administrativas.
Abra Table Editor no painel Supabase para examinar a linha; não é o console do navegador. Se a inserção falhar, examine a resposta do servidor e a configuração de banco e esquema. Não ative SELECT anônimo apenas para ver se inseriu.
Para a sequência local completa, abra run-locally.txt: prepare o ambiente privado da raiz, vincule apenas o projeto de prática e inicie o proxy de funções do Netlify. server-env.example.txt lista nomes de variáveis sem segredos reais. Abrir apenas o HTML não executa o servidor.
Exemplo resolvido
Nenhuma política ampla que permite tudo é necessária neste laboratório mediado por servidor. Abrir SELECT anônimo para investigar também exporia mensagens enviadas.
create table public.feedback (
id uuid primary key default gen_random_uuid(),
message text not null check (char_length(message) between 1 and 1000),
created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.
Supabase: segurança em nível de linha · Node.js: estado de suporte das versões
Exercício técnico complementar
Uma consulta do navegador é negada. Você deve permitir que anônimos leiam toda a tabela de comentários para corrigir?
Mostrar uma solução comentada
Não. O desenho nega leituras do navegador intencionalmente. Confira a escrita do servidor e examine a tabela como proprietário.
- Preserva o limite pretendido de dados privados.
- Usa a rota do servidor ou painel autorizado em vez de abrir leitura global.

Etapa 2 · Como salvar envios de formulário em um banco de dados
Envie um registro pela página
Deixe o servidor pronto realizar a gravação.
Explicação, exemplo resolvido e prática
Entenda a ideia
Abra o aplicativo de prática local ou hospedado real e envie uma mensagem como D1. Peça ao assistente para manter apenas os campos de visitante pretendidos no registro salvo.
Encontre o texto exato D1 na tabela do provedor e examine sua identificação e horário gerados. Mantenha valores secretos da conta fora de capturas e notas compartilhadas.
Um exemplo concreto
Envie D1 e localize esse texto exato em feedback. O ID gerado distingue a linha de uma mensagem antiga parecida; o visitante não deve escolher nem substituir essa identidade.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
O que apareceu no formulário e no provedor para D1?
Mostrar uma solução comentada
Registro de gravação de exemplo: O formulário informou que salvou a mensagem. Na tabela feedback do provedor de prática, achei “D1 — blue notebook” com ID e data de criação gerados. Guardei o ID nas minhas notas privadas para reconhecer a mesma linha depois.
O que uma boa resposta inclui
- Relaciona o texto D1 exato enviado a uma linha com identidade/data geradas pelo provedor.
- Relata separadamente página e armazenamento, sem compartilhar configuração privada.
Como funciona (opcional)
Conecte uma escrita validada de servidor
O servidor escolhe tabela e campos permitidos; quem chama fornece só a mensagem.
Configure as três variáveis nomeadas e implante ou execute o projeto separado. Quem testa digita o código de acesso. Ele autoriza este endpoint restrito, não a conta Supabase.
Leia mini-feedback.mjs: a função verifica método, código, tamanho e mensagem antes de chamar o provedor. Ignora IDs e nomes de tabela do cliente e só retorna sucesso de armazenamento após uma inserção bem-sucedida.
Exemplo resolvido
Uma solicitação com um campo admin extra não vira atualização administrativa: o servidor constrói outro objeto contendo apenas message.
Exercício técnico complementar
Por que construir {message} em vez de encaminhar todo o JSON do navegador ao banco?
Mostrar uma solução comentada
Isso mantém explícito o esquema aceito e impede campos inesperados de virarem escritas. Valide a mensagem também; só selecionar campos não basta.
- Limita os campos graváveis.
- Não confia em IDs, datas ou privilégios controlados pelo cliente.

Etapa 3 · Como salvar envios de formulário em um banco de dados
Verifique persistência e falha
Repita a ação após fechar a primeira página.
Explicação, exemplo resolvido e prática
Entenda a ideia
Feche e reabra o aplicativo e confirme que D1 continua no armazenamento. Experimente entradas ausentes ou grandes demais e um código de prática errado na configuração descartável.
Tentativas inválidas não devem criar novas linhas. Uma mensagem de sucesso anterior não deve permanecer como se uma tentativa posterior com falha também tivesse sido salva.
Um exemplo concreto
Registre a linha válida antes dos testes negativos e depois confira a tabela. “O formulário mostrou erro” e “nenhuma linha inválida foi adicionada” são duas partes úteis da verificação.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
Experimente
Quais registros permaneceram após reabrir e o que aconteceu nas tentativas inválidas?
Mostrar uma solução comentada
Registro de teste negativo de exemplo: Depois de fechar e reabrir a página, D1 permaneceu na tabela. Tentativas vazias, grandes demais e com código incorreto não criaram linhas. A tentativa que falhou mostrou erro, em vez de manter a mensagem Saved anterior como se também valesse para ela.
O que uma boa resposta inclui
- Verifica que o registro válido identificado continua presente após reabrir.
- Confere que entradas/acessos inválidos não criam linhas nem deixam um estado de sucesso enganoso.
Como funciona (opcional)
Verifique persistência e falhas
Use registros distintos e examine o banco independentemente da página.
Envie D1 com o código correto e examine a linha correspondente. Feche e reabra a página e confirme que a linha continua existindo. Registre ID e data e hora sem compartilhar segredos de conta.
Tente mensagem ausente, grande demais e código incorreto. Nenhum deve criar linha. Em um ambiente descartável, verifique se configuração ausente do servidor produz falha honesta.
Exemplo resolvido
Um registro válido e duas solicitações inválidas rejeitadas informam mais que três cliques bem-sucedidos repetidos. Evite comentários pessoais reais no primeiro laboratório.
Exercício técnico complementar
O endpoint retorna erro, mas o navegador ainda diz “Saved” (salvo) de uma tentativa anterior. O que verificar?
Mostrar uma solução comentada
Confira se o valor novo tem uma linha. A interface deve mostrar a falha atual e um sucesso anterior não deve contar como resultado desta tentativa.
- Verifica a resposta atual e um novo valor distinto de teste.
- Não reutiliza um sucesso antigo como evidência de solicitação com falha.

Etapa 4 · Como salvar envios de formulário em um banco de dados
Adicione um assunto sem abrir os dados
Use um assistente para alterar o campo e examine o resultado.
Explicação, exemplo resolvido e prática
Entenda a ideia
Peça ao assistente para adicionar Project e Question ao formulário, à preparação do armazenamento e à validação do servidor. Os valores são project e question. A referência fornecida é uma comparação para abrir depois da tentativa, não o lugar em que você precisa descobrir o requisito.
Crie um registro controlado por assunto e tente o assunto não permitido other com a ajuda do assistente. Verifique os dois valores salvos e a rejeição, mantendo feedback privado para os visitantes.
Um exemplo concreto
Adicione dois assuntos permitidos, Project e Question. Cada valor escolhido deve ser salvo junto da mensagem. Other é um teste de rejeição; só um seletor bonito não conclui a mudança de armazenamento.
Arquivos desta etapa
Comece aquiArquivos da oficina
Abra ou baixe os arquivos abaixo. Ao salvar o projeto, mantenha as pastas indicadas nos nomes dos arquivos.
- schema.sqlBaixar este arquivo
- netlify/functions/mini-feedback.mjsBaixar este arquivo
- storage-record.txtBaixar este arquivo
- worksheet.htmlBaixar este arquivo
- reference/assignment-walkthrough.txtBaixar este arquivo
- reference/START-HERE.txtBaixar este arquivo
- reference/public/index.htmlBaixar este arquivo
- reference/public/app.jsBaixar este arquivo
- reference/netlify/functions/mini-feedback.mjsBaixar este arquivo
- reference/add-topic.sqlBaixar este arquivo
Experimente
Apresente a alteração de assunto e os resultados observados de armazenamento válido e inválido.
O que entregar: Um registro de armazenamento com dados sensíveis ocultados mostrando persistência válida e tentativas inválidas rejeitadas.
Mostrar uma solução comentada
Registro de extensão de exemplo: “D2 — project test” persistiu com topic project; “D3 — question test” com topic question. O valor não permitido other foi rejeitado e não criou linha. Inspecionei como responsável; o acesso dos visitantes à tabela completa permaneceu restrito.
O que uma boa resposta inclui
- Salva os valores Project e Question com os registros controlados correspondentes.
- Rejeita um assunto não permitido e mantém os visitantes sem acesso à tabela completa.
Como funciona (opcional)
Sua tarefa: armazenar um assunto validado
Amplie o modelo e o servidor juntos sem abrir permissões do navegador.
Acrescente uma coluna topic restrita a project ou question. Atualize o servidor para validar a lista permitida e construir explicitamente o objeto inserido. Acrescente o controle correspondente no formulário.
Crie um registro por assunto permitido e rejeite um valor não aceito. Mantenha IDs e datas gerados sob controle do banco.
DEFAULT atribui question às linhas existentes neste exercício. Sem valor ou padrão, acrescentar uma coluna NOT NULL pode falhar se já há linhas. Em uma migração real, escolha o preenchimento conforme os dados, não copiando este padrão.
Exemplo resolvido
A restrição do banco reforça a validação do servidor. Nenhuma substitui o papel da outra em erros claros e integridade dos dados.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
check (topic in ('project','question'));Exercício técnico complementar
Acrescente o assunto e prove que dados válidos persistem e inválidos são rejeitados.
Mostrar uma solução comentada
As três camadas precisam concordar: select no navegador, lista permitida no servidor e coluna e restrição no banco. ALTER TABLE da referência trata linhas existentes atribuindo o assunto padrão documentado antes de aplicar a restrição.
O servidor escreve apenas {message,topic}. Precisa rejeitar um assunto não aceito antes de usar a credencial secreta. Também ignora IDs e tabelas do cliente e informa uma falha de escrita do provedor como falha.
Examine mensagem e assunto exatos em Table Editor do Supabase, não em um parágrafo de sucesso do cliente. Recarregue ou feche o navegador e verifique o mesmo registro. Use diagnósticos da sua conta; não exponha leituras anônimas para investigar.
- A validação do assunto existe no servidor e no banco.
- Linhas válidas correspondentes persistem e valores não aceitos não criam linhas.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.