Zekro

SaaS de agendamento com Next.js, React, TypeScript e Supabase (Auth, PostgreSQL e Storage).

Endereço de produção: https://zekro.vercel.app. Oferta: teste de 7 dias e Zekro Pro por R$ 49,90/mês. Pagamento via Pix direto, com conferência administrativa e sem renovação automática. Veja a publicação e validação do banco e as pendências de lançamento. Endereço histórico: https://barberflow-pqueirozdev.vercel.app. Consulte o estado do ambiente para configuração e pendências de email/autenticação.

Executar

1. Instale Node.js 22 ou superior e execute npm ci.
2. Crie um projeto Supabase. Execute no SQL Editor, nesta ordem, uma vez por ambiente:
   • supabase/migrations/202609170001_platform.sql
   • supabase/migrations/202609170002_management.sql
   • supabase/migrations/202610080001_security_stability.sql
   • supabase/migrations/202610080002_trial.sql
   • supabase/migrations/202610080003_manual_pix.sql
   • supabase/migrations/202610080004_terms_acceptance.sql
   • As migrações Zekro 2.0 202610090001_onboarding.sql, 202610090002_product.sql e 202610090003_analytics.sql foram aplicadas em produção em 10/10/2026 e registradas no histórico Supabase. Em outros ambientes, confira as versões aplicadas antes de migrar; consulte docs/ZEKRO_2_DELIVERY.md. As quatro migrações de outubro já foram aplicadas ao banco de produção autorizado. Para outros bancos existentes, aplique somente as migrações ainda não aplicadas após homologação e autorização; siga as instruções de aplicação e rollback.
3. Copie .env.example para .env.local e substitua os valores:
   • NEXT_PUBLIC_SUPABASE_URL: URL do projeto.
   • NEXT_PUBLIC_SUPABASE_ANON_KEY: chave pública anon.
   • SUPABASE_SERVICE_ROLE_KEY: chave service_role, exclusiva do servidor, necessária para reservas e rate limiting.
   • NEXT_PUBLIC_APP_URL: origem da aplicação, inicialmente http://localhost:3000.
4. Em Supabase Authentication, configure Site URL com a origem e autorize os redirects http://localhost:3000/auth/callback e http://localhost:3000/auth/callback?next=/redefinir-senha. Adicione também os equivalentes de produção.
5. Configure o envio de emails no Supabase para confirmação e recuperação de senha conforme SMTP e templates. Nenhum provedor é habilitado automaticamente.
6. Execute npm run dev e abra http://localhost:3000.

Sem Supabase, a página inicial e /demonstracao apresentam a interface. A demonstração interativa usa dados fictícios locais e não grava no sistema. Contas e reservas reais exigem configuração.

Primeiro uso

Crie uma conta em /cadastro, confirme o email e conclua /onboarding. O assistente cria a barbearia, o primeiro serviço, o primeiro barbeiro e os horários. No dashboard, gerencie profissionais, serviços, horários, bloqueios, clientes, reservas e sua página pública. Vincule serviços aos novos profissionais e configure sua disponibilidade.

A página pública fica em /<slug>; /b/<slug> preserva links antigos. Clientes reservam sem criar conta. O banco valida duração, fuso horário e conflitos. Novas reservas exigem teste ou assinatura vigente; não existe plano gratuito permanente.

Para habilitar um administrador, um responsável pelo banco deve executar no SQL Editor após criar a conta:

update public.profiles set role = 'ADMIN' where id = '<UUID do usuário em Authentication>';

O painel /admin gerencia suspensão e plano. Não há checkout nem cobrança automática nesta versão. WhatsApp usa links para envio manual.

Validação

npm run typecheck
npm run lint
npm test
npm run build
npx playwright install chromium
npm run test:e2e

Os testes de banco usam PostgreSQL embarcado (PGlite) e simulação dos schemas Auth e Storage. Cobrem isolamento, permissões, disponibilidade, bloqueios e conflitos. Auth, emails e uploads ainda devem ser validados em um Supabase real. Os testes de navegador verificam navegação pública em desktop e celular, usando o build de produção.

Os testes de concorrência também iniciam PostgreSQL nativo local em diretório temporário, com conexões independentes. Não leem credenciais Supabase. test:e2e recompila com URLs de loopback e credenciais fictícias, inicia fixtures HTTP locais e verifica rate limiting, conflitos, entradas e origens. Usa Chrome instalado no Windows quando disponível. O build de teste não deve ser publicado: execute novo npm run build com o ambiente correto antes de publicação autorizada.

OWNER gerencia configurações, equipe, permissões e preços; MANAGER mantém agenda, clientes, serviços e horários. Preços são exclusivos de OWNER. Reservas públicas não sobrescrevem clientes existentes; correções cadastrais ocorrem na área autenticada. Assinaturas continuam provisionadas pelo ADMIN, sem checkout.

Consulte a auditoria, as dependências e pendências e o relatório de entrega. Esta branch também inclui a auditoria Zekro 2.0 e o relatório de entrega local e limitações.

Se o Chrome já estiver instalado, é possível dispensar o download do Chromium. No PowerShell, execute $env:PLAYWRIGHT_CHANNEL='chrome' antes de npm run test:e2e.

Para executar os testes de navegador contra produção, defina também $env:PLAYWRIGHT_BASE_URL='https://barberflow-pqueirozdev.vercel.app'. Isso dispensa o servidor local.

Para testar a integração real, inicie a aplicação em outra janela com npm start e execute no PowerShell:

$env:RUN_LIVE_TESTS='1'
node --env-file=.env.local tests/live.mjs

Esse teste cria uma conta temporária já confirmada, uma barbearia, uma reserva e uma imagem no projeto configurado. Verifica login HTTP, cookies, onboarding, páginas autenticadas, disponibilidade, conflito de reservas, cancelamento e Storage. Remove os próprios dados ao terminar, inclusive quando uma verificação falha. Não envia emails; entrega de confirmação e recuperação deve ser validada separadamente com um provedor SMTP configurado.

Para produção, configure as mesmas variáveis na hospedagem, ajuste a origem e redirects, aplique as migrações e execute npm run build e npm start. Na Vercel, o rate limit usa o IP da plataforma; fora dela, o limite é compartilhado e a identificação de IP deve ser adaptada ao proxy confiável da hospedagem.

prisma/ e docker-compose.yml são legados e não participam da aplicação atual. Não execute o seed antigo: use cadastro e onboarding. Consulte a arquitetura.

Configuração de Pix direto, Google OAuth e páginas legais: PIX_GOOGLE_LEGAL.md.