Como um estúdio de beleza foi do zero a um site com agendamento online e painel administrativo, construído do início à publicação com Claude Code

Este case documenta, de forma didática, uma jornada real de desenvolvimento com Claude Code, do design à publicação. Nome do negócio, cidade e valores foram alterados para preservar a privacidade da cliente.
Um negócio local de estética cresceu pelo Instagram, mas sem controle real de agenda: horários eram marcados por mensagem direta, sem visão de conflitos e sem histórico organizado para a profissional.
O site institucional inicial resolveu a vitrine, mas não resolveu o problema real por trás do pedido, marcar e gerenciar horários de forma confiável, sem depender de troca manual de mensagens.
Construí, com Claude Code, o site institucional e, na sequência, um sistema completo de agendamento online com confirmação instantânea, regras de cancelamento e disponibilidade em tempo real, além de um painel administrativo mobile-first para a proprietária gerenciar a agenda, com nome e telefone das clientes protegidos por criptografia e as práticas de dados alinhadas à LGPD.
Quando o custo mensal da hospedagem deixou de fazer sentido para o tamanho do negócio, todo o back-end foi reescrito de Next.js/Node para PHP/MySQL, mantendo exatamente o mesmo contrato de API e publicado via cPanel com Git Version Control, sem a cliente perceber qualquer diferença de uso.
Agendamento, painel administrativo e autenticação funcionando de forma idêntica depois de trocar toda a hospedagem e a linguagem do back-end.
Um lock de concorrência no banco de dados impede que dois agendamentos caiam no mesmo horário, mesmo com dois back-ends diferentes ao longo do projeto.
O back-end foi escrito duas vezes com o mesmo contrato de API, uma em Node.js/Postgres (Vercel) e outra em PHP/MySQL (HostGator), sem diferença perceptível para quem usa o site.
O ponto de partida foi um pedido comum entre pequenos negócios locais: uma profissional de estética, que neste case chamo de Nicolash, já tinha presença no Instagram, mas não tinha um site. As clientes marcavam horário por mensagem direta, sem visão real de agenda, sem histórico organizado e sem nenhuma forma de a profissional controlar conflitos de horário.
O objetivo inicial era simples: construir um site institucional bonito, responsivo, com os serviços e os preços. Esse objetivo mudou bastante ao longo do projeto, o que é, na prática, o retrato mais honesto de como um projeto real evolui.
Antes de qualquer tela ser desenhada, o briefing inicial foi coletado diretamente com a cliente: fotos dos procedimentos e do espaço para usar no site, a tabela de preços de cada serviço, e também as próprias regras que ela já usava informalmente no dia a dia, como política de manutenção de esmalte ou cílios e a política de retirada, ou seja, de cancelamento de horário. Esse material básico foi o que alimentou o design no Figma.
O projeto começou no Figma, reunindo referências de estilo, estrutura de seções e identidade visual a partir desse briefing. Esse material foi levado ao Claude Design, onde a interface foi refinada e preparada como handoff, e então entregue ao Claude Code como ponto de partida para a implementação.
A partir daí, o processo foi:
Com o site publicado, a virada não veio de um pedido da cliente, e sim de observar o processo que já existia por trás da vitrine: toda cliente final chamava no WhatsApp ou mandava mensagem no Instagram para marcar um horário, e cada marcação exigia conferir manualmente um Google Agenda antes de confirmar qualquer coisa. Acompanhando esse fluxo de perto, ficou claro que ali havia um diferencial em aberto: transformar aquela conferência manual em um sistema de agendamento próprio, onde a própria cliente final escolhe um serviço, vê um calendário com os horários livres, escolhe dia e horário, preenche nome e telefone, e tem a reserva confirmada na hora, sem depender de mensagem. A ideia partiu dessa observação, não de uma solicitação, e na prática resolveu exatamente a dor que já existia nos agendamentos.
As regras de negócio vieram todas em linguagem natural, no mesmo estilo de conversa:
Essas regras viraram lógica de disponibilidade no código: grade de horários de 30 em 30 minutos, ocupação do primeiro horário livre de cada intervalo, antecedência mínima de reserva e horizonte máximo de 90 dias à frente, tudo calculado no fuso horário correto, para evitar o clássico bug de horário errado em sistemas de agenda.
Junto com o agendamento veio o pedido de um painel administrativo, pensado mobile-first porque é assim que a proprietária do negócio ia usar no dia a dia: ver a agenda do dia, quantos horários livres, confirmados, concluídos e cancelados, bloquear horários manualmente e também inserir agendamentos feitos por telefone, caso em que o telefone passa a ser opcional, mas o nome continua obrigatório.
Antes de publicar o agendamento em produção, surgiu uma pergunta simples e muito importante: como isso vai para a produção, e como garantir que, se alguém tiver acesso indevido ao banco de dados, os dados das clientes continuem protegidos.
Essa pergunta foi a virada do projeto de "site bonito" para "sistema que guarda dado de cliente real", e mudou a arquitetura:
Esse tipo de decisão normalmente não aparece em um pedido de cliente, mas é exatamente o tipo de responsabilidade que entra quando um projeto de portfólio vira um sistema usado por pessoas reais.
Com tudo funcionando, veio a pergunta que praticamente todo pequeno negócio faz, mais cedo ou mais tarde, sobre produto digital: esse custo mensal faz sentido para o tamanho do meu negócio? Na versão em Next.js/Vercel, o custo mensal real passou a pesar mais do que fazia sentido para um negócio desse porte, e isso disparou uma busca ativa por outras possibilidades de hospedagem.
A Vercel é excelente para validar produto rápido, mas o plano adequado para manter banco de dados gerenciado e funções de servidor em produção, fora do nível gratuito, cobra por mês, em dólar. Para um site institucional de um negócio pequeno e local, esse custo recorrente, convertido para reais, deixa de fazer sentido rapidamente.
Entre as alternativas avaliadas, a que fez mais sentido foi a hospedagem compartilhada tradicional, no caso HostGator, com cPanel, PHP e MySQL, por uma fração do custo mensal, já incluindo e-mail profissional e um painel de gestão conhecido por qualquer agência ou freelancer brasileiro. Essa escolha trouxe uma mudança real de arquitetura, não só de provedor: o back-end inteiro, que rodava em Node.js sobre a infraestrutura da Vercel, precisou ser reescrito em PHP, e o banco de dados, de Postgres gerenciado para MySQL via phpMyAdmin, mantendo o mesmo contrato de API para a cliente não perceber nenhuma diferença no uso do site.
Comparando os números oficiais de cada plano de entrada:
Esse projeto, na prática, virou dois caminhos possíveis para quem quer construir um site com Claude Code até a publicação. Vale comparar os dois diretamente, clicando em cada um:
Nenhum dos dois caminhos é o certo de forma absoluta. O caminho 1 prioriza velocidade e infraestrutura gerenciada, o caminho 2 prioriza custo e um modelo de hospedagem mais familiar para quem já usa serviços brasileiros tradicionais. A decisão certa depende do estágio e do orçamento do negócio, aqui ela mudou no meio do projeto, porque o negócio real mudou de "vamos validar uma ideia" para "isso já é usado por clientes todos os dias, e precisa custar pouco para se manter".
Para não arriscar o site que já estava em produção, a reescrita para PHP foi feita em paralelo, em um branch e uma worktree separados do projeto principal, sem tocar no que já estava publicado na Vercel. O front-end em Next.js foi configurado para exportação estática, saída puramente em HTML, CSS e JS, sem servidor Node por trás, e cada rota de API foi recriada em PHP, com os mesmos nomes de endpoint e os mesmos formatos de resposta.
Antes de qualquer coisa ir para o servidor real, foi montado um ambiente local, com PHP e MySQL instalados na própria máquina, simulando a hospedagem de produção, para testar todos os fluxos: agendamento criado com sucesso, tentativa de agendar em cima de um horário já ocupado e corretamente bloqueada, login do painel, criação manual de agendamento pela administradora, bloqueio de horário. Tudo validado localmente antes de subir.
Na prática, o deploy em hospedagem compartilhada usando Git funciona de um jeito parecido com um pipeline de CI/CD simplificado. Passe o mouse ou clique em cada etapa:
Esse foi um passo a passo guiado em tempo real, com a cliente enviando print de cada tela do cPanel, criação do banco, importação da chave, configuração do Git Version Control, permissões de arquivo, para confirmar, antes de cada clique, que o caminho era o correto. É o tipo de acompanhamento que normalmente falta em tutoriais escritos, porque hospedagem compartilhada tem nome diferente para a mesma coisa em cada provedor, e um clique no lugar errado pode derrubar o site.
Um ponto que pega a maioria de quem passa por isso pela primeira vez: a URL temporária gerada pela hospedagem, antes de apontar um domínio próprio, não migra automaticamente quando o domínio definitivo é configurado. A melhor prática é registrar o domínio antes de configurar qualquer coisa em produção, e não depois.
Hoje, o fluxo da cliente final é escolher o serviço, ver o calendário com os horários realmente livres, escolher dia e horário, confirmar com nome e telefone, e receber a confirmação na hora, sem trocar mensagem com ninguém antes de garantir o horário. A proprietária acompanha tudo pelo celular, em um painel que mostra a agenda do dia, pode bloquear horários, inserir agendamentos feitos por telefone, e nunca vê o nome e o telefone das clientes em texto puro em lugar nenhum do banco de dados.
E o site inteiro, agendamento, painel administrativo e autenticação inclusos, roda hoje em uma hospedagem compartilhada tradicional, com um custo mensal compatível com o tamanho real do negócio.