Agendê

SaaS para profissionais da beleza e clientes finais. O produto reúne agenda, catálogo, clientes, equipe, gestão operacional e uma experiência própria para a cliente.

Stack

• Next.js 16 (App Router) + TypeScript
• Tailwind CSS 4 + shadcn/ui
• Supabase Auth + PostgreSQL + Row Level Security
• Deploy previsto na Vercel
• Node.js 22 ou superior

Identidade

Uma pessoa tem uma conta (auth.users + profiles). Capacidades são compostas:

• client_profiles → área gratuita /cliente
• workspaces + workspace_members → negócio / tenant
• subscriptions pertencem ao workspace, não ao usuário

intended_use no cadastro é apenas roteamento inicial. Não é autorização.

Rotas

Rota	Acesso
/	pública
/cadastro /login /verificar-email	autenticação
/onboarding	e-mail confirmado, sem workspace
/app	membro de workspace
/app/agenda	agenda interna (dia/semana)
/app/equipe	cadastro de profissionais da equipe
/app/equipe/[member]/disponibilidade	jornada, pausas e bloqueios
/app/servicos	catálogo de serviços do workspace
/app/clientes	clientes internos do estabelecimento
/app/estoque /app/pacotes	estoque e pacotes via RPC
/app/financeiro /app/relatorios	visão financeira e indicadores dos agendamentos
/app/avaliacoes	avaliações imutáveis (appointment_reviews)
/cliente	client_profiles
/cliente/agendamentos	próximos horários e histórico da cliente
/cliente/avaliacoes	envio de avaliações de atendimentos concluídos
/auth/callback /auth/confirm	troca de código / token de e-mail

Rotas privadas são barradas no servidor (proxy + getUser() + RLS).

Trial

• Só começa ao criar o primeiro workspace, em transação no Postgres.
• 7 dias, status = trialing, datas com clock_timestamp().
• professional_trial_claims impede trial extra após apagar/recriar.

Segurança

• RLS deny-by-default em todas as tabelas públicas relevantes
• Funções SECURITY DEFINER no schema app, com search_path vazio
• Usuário autenticado não tem GRANT de INSERT/UPDATE/DELETE em subscriptions, workspace_members ou trial
• Colunas críticas protegidas por trigger
• Convites armazenam só sha256(token)

Desenvolvimento

cp .env.example .env.local
npm ci
npm run dev

Variáveis:

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=
NEXT_PUBLIC_SITE_URL=

Nunca coloque service role em NEXT_PUBLIC_*.

No dashboard do Supabase:

1. Confirm email ativado
2. Site URL e Redirect URLs apontando para o app (/auth/callback, /auth/confirm)

Scripts

npm run lint
npm run typecheck
npm run test
npm run build
npm run test:e2e
npm run test:e2e:staging

test:e2e sobe o build local com backend sintético (PASS LOCAL). Requer npm run build e Chromium do Playwright (npx playwright install chromium). Porta e evidências: AGENDE_E2E_PORT, AGENDE_E2E_EVIDENCE. Nunca aponta para produção.

test:e2e:staging só navega com AGENDE_STAGING_ACCEPTANCE + AGENDE_STAGING_ORIGIN autorizados. Sem isso, marca BLOQUEADO e sai 0. Detalhes: docs/homologation/e2e.md.

Banco

Migrations versionadas em supabase/migrations. Schema app não é exposto na Data API.

Não reescreva migrations já aplicadas no projeto remoto. Correções de banco entram em uma nova migration.

As migrations 20260927014947_launch_readiness_reviews e 20261008131859_launch_hardening_reviews_force_rls estão no Git e ainda não constam do snapshot remoto de 27/09/2026. Validação e ordem de aplicação: docs/migrations/launch-readiness-2026-10-08.md. Não aplicar em produção sem revisão humana.

Testes SQL da fundação

Os arquivos em supabase/tests/ são executáveis: falham com RAISE EXCEPTION se uma regra quebrar.

Requerem uma conexão privilegiada (postgres / service_role), porque criam usuários em auth.users.

psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/helpers.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/foundation.sql

O segundo arquivo imprime a lista de casos que passaram. Usuários de teste usam o domínio @agende-foundation.test e são removidos ao final (também em caso de falha).

Catálogo (equipe, serviços, clientes do estabelecimento):

psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/helpers.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/catalog.sql

Agenda (jornada, conflitos, snapshots e IDOR):

psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/helpers.sql
psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f supabase/tests/agenda.sql

Agenda

• weekday 0–6 = domingo–sábado (EXTRACT(DOW) / Date.getDay()).
• Fuso único: app.product_timezone() e src/lib/time/timezone.ts (America/Sao_Paulo).
• Conflito: EXCLUDE USING gist em appointments ativos + pg_advisory_xact_lock no profissional. cancelled e no_show não ocupam horário.
• price_cents e duration_minutes são snapshot; override de professional_services ganha do catálogo. O browser não define preço, duração nem ends_at.
• Receptionist agenda e bloqueia horários, mas não edita jornada nem preços.
• Slots são calculados (não pré-gerados), passo de 15 minutos.