← VOLTAR PARA PROJETOS
💅
Nicolash

Site com agendamento online

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

Desenvolvimento full-stackClaude CodeProduto
Mockup de um aplicativo de agendamento online para um estúdio de beleza, com calendário, horários disponíveis e painel administrativo.
ℹ️

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.

Papel
Desenvolvedor full-stack
Tipo
Desenvolvimento web · Produto
Habilidades
Prompt engineering para Claude CodeArquitetura full-stackMigração de hospedagemSegurança e criptografia de dadosUX mobile-first

Ferramentas utilizadas

Claude CodeVercelHostGatorcPanel
O desafio

O Problema

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.

A abordagem

A Solução

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.

Resultados

O Impacto

100%
Paridade de funcionalidades na migração

Agendamento, painel administrativo e autenticação funcionando de forma idêntica depois de trocar toda a hospedagem e a linguagem do back-end.

0
Conflitos de horário

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.

2
Arquiteturas completas

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.

Como aconteceu

O Processo

Contexto: um negócio pequeno, uma necessidade real

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.

Do Figma ao Claude Code

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.

Do briefing ao código

Como o projeto saiu de uma conversa com a cliente e chegou em produção

1

Cliente

Briefing inicial: fotos, preços, manutenção e cancelamento.

2

Figma

Design original: referências de estilo, estrutura e identidade.

3

Claude Design

Refino de interface, handoff preparado para implementação.

4

Claude Code

Projeto Next.js real, pronto para produção.

A partir daí, o processo foi:

  1. Reconstrução do handoff como um projeto Next.js real, usando os ativos de imagem fornecidos.
  2. Definição da pilha tecnológica: a melhor linguagem, o melhor framework, publicado de forma gratuita. A resposta foi Next.js, justamente por poder ser hospedado na Vercel com deploy automático a cada commit, sem configuração manual de servidor, além do custo zero para validar o produto.
  3. Iteração orientada por feedback visual, a partir de prints de tela e observações sobre a interface, tratadas como padrão de design reaproveitável, e não como ajuste pontual.
  4. Responsividade mobile como requisito desde a primeira entrega, já que a maior parte do público de um estúdio de beleza local acessa pelo celular.
Os quatro passos do processo

Do handoff reconstruído ao critério de aceite mobile-first

1

Reconstrução do handoff

Handoff reconstruído como projeto Next.js real.

2

Pilha tecnológica

Melhor linguagem, grátis: Next.js na Vercel.

3

Iteração visual

Prints de tela viram padrão reaproveitável.

4

Mobile-first

Critério de aceite desde a primeira entrega.

A virada: de vitrine para sistema de agendamento

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.

A virada: de vitrine para agendamento

Ideia do desenvolvedor, a partir do fluxo manual via WhatsApp e Instagram

ANTES

Nicolash

Serviços e preços

Volume RussoR$ 200
Alongamento Fio a FioR$ 150
Design de SobrancelhasR$ 60
Agendar pelo WhatsApp

Sem agenda real, sem controle de conflitos

DEPOIS

Nicolash

Agendamento online

STQQSS
345678
09:0011:0014:30

Nome e telefone preenchidos pela cliente

Confirmar agendamento

Confirmação instantânea, sem trocar mensagem

As regras de negócio vieram todas em linguagem natural, no mesmo estilo de conversa:

Regras de negócio, em linguagem natural

Como a cliente descreveu, do jeito que ela descreveu

1

Confirmação instantânea

Sem aprovação manual, a reserva nasce confirmada.

2

Sem intervalo

Agenda corrida, atendimentos emendados um no outro.

3

Cancelamento por WhatsApp

Nunca pelo site, sempre direto com a profissional.

4

Sem limite por cliente

Qualquer pessoa marca quantos horários quiser.

5

Multa de 30%

Para cancelar com menos de 24h de antecedência.

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.

Segurança antes de ir ao ar

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.

Linha do tempo do projeto

Do site institucional à migração de hospedagem

1

Site institucional

Design → Next.js → Vercel. Serviços, fotos, preços, responsivo mobile.

2

Agendamento online

Calendário + confirmação. Sem horários sobrepostos, cancelamento via WhatsApp.

3

Painel administrativo

Mobile-first, /admin. Agenda, bloqueios, status dos horários.

4

Segurança dos dados

Criptografia + conformidade. LGPD, sessão segura, senha com hash.

5

Migração de hospedagem

Vercel → PHP/MySQL. cPanel + Git Version Control, custo menor.

O gatilho da migração: custo

Hospedagem mensal na Vercel ficou alta para um negócio pequeno

O problema do custo, e por que migrar de hospedagem

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:

Quanto custa cada caminho

Comparando o 1º ano de cada plano de entrada, em reais

Vercel · plano Pro
≈ R$ 1.270/ano*
US$ 240/ano · US$ 20/mês por assento
até10×mais barato
HostGator · Plano P
R$ 121/ano
R$ 10,09/mês no 1º ano
≈ R$ 551/ano na renovação**

*Conversão aproximada em 29/10/2026, câmbio de referência ~R$ 5,30. O plano Pro da Vercel é cobrado em dólar, por assento, mais uso acima do crédito incluso. **Preço de lista antes do desconto promocional de entrada, conforme exibido no site da HostGator.

Dois caminhos possíveis para publicar com Claude Code

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:

Caminho inicial
Linguagem

TypeScript/JavaScript de ponta a ponta, front-end e back-end no mesmo projeto.

Deploy

Automático a cada push no GitHub, sem configuração manual de servidor.

Banco de dados

Postgres gerenciado (Neon, neste projeto), com variáveis de ambiente sincronizadas automaticamente.

Segurança de infraestrutura

Certificado HTTPS automático, rede de borda, isolamento de funções, tudo gerenciado pela plataforma.

Custo

Gratuito para validar, mas o plano pago soma rápido quando convertido para reais, especialmente para um negócio pequeno.

Melhor para

Validar um produto rápido, projetos com orçamento para hospedagem gerenciada, ou produtos que vão escalar de verdade.

Mecânica da migração

Vercel/Next.js → cPanel/PHP, passo a passo

1

GitHub

Repositório privado: só o que vai para produção.

2

Chave SSH

Somente leitura, sem usar a senha pessoal da conta.

3

cPanel

Git Version Control clona o projeto, "pull" publica.

4

MySQL

Esquema e dados migrados do Postgres via phpMyAdmin.

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

Como foi feita a migração, na prática

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.

cPanel, Git Version Control e o primeiro deploy

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:

1

Arquivo de configuração do cPanel

O projeto é preparado com um arquivo de configuração próprio do cPanel, que define exatamente quais arquivos vão para a pasta pública do site, e bloqueia explicitamente tudo que é interno: código-fonte, dependências, controle de versão.

2

Repositório privado no GitHub

Um repositório privado é criado no GitHub, só com o que deve ir para produção.

3

Chave SSH somente leitura

É gerada uma chave SSH de deploy, sem senha, cadastrada no GitHub como chave somente leitura. Isso evita usar a senha pessoal da conta e limita o acesso ao mínimo necessário.

4

Git Version Control no cPanel

Dentro do cPanel, a função Git Version Control recebe a URL do repositório e a chave, clona o projeto e, a cada atualização, basta um "pull" para publicar a versão mais nova.

5

Banco de dados via phpMyAdmin

O banco de dados é criado via cPanel/phpMyAdmin, o esquema SQL é importado e os dados que já existiam em produção são migrados com um script próprio.

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.

Do problema ao impacto

Problema identificado, decisões tomadas e resultado final

Problema identificado

  • Agendamento só por WhatsApp, demora para confirmar
  • Risco de duas pessoas marcarem o mesmo horário
  • Custo de hospedagem alto para o tamanho do negócio

Decisões tomadas com Claude Code

  • Sistema de agendamento com trava de concorrência
  • Criptografia de dados + conformidade com a LGPD
  • Migração de Next.js/Vercel para PHP e MySQL

Impacto

100%

Paridade de funcionalidades na migração

0

Conflitos de horário

2

Arquiteturas completas

Resultado

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.

Próximo projeto
Case MSIIDF
→