Agendou
Tudo o que sua barbearia precisa para funcionar melhor. Gestão completa para barbearias, em dois pilares: (1) gestão essencial — agenda, clientes, atendimentos e financeiro para qualquer barbearia; (2) crescimento e recorrência — planos mensais opcionais, integrados à agenda e ao financeiro.
SaaS de agendamento para barbearias: agendamento público sem login (link para Instagram/WhatsApp), CRM com dashboard e filtros, importação de clientes de outros sistemas (CSV/Excel) e painel do dono. Visual escuro premium com aurora quente.
| Funciona de verdade | Depende de configuração externa |
|---|
Agendamento público, "sem preferência", remarcar/cancelar pelo link, .ics | WhatsApp automático: cada barbearia conecta o próprio número na API oficial da Meta (docs/WHATSAPP.md). Sem isso, há envio manual pelo WhatsApp do barbeiro |
| Planos mensais (opcional): planos, assinaturas, mensalidades, uso de benefício na agenda sem cobrança duplicada | Cobrança automática de mensalidade (hoje o pagamento é registrado pelo barbeiro; depende de gateway) |
| Painel, CRM, relatórios, exportação CSV | Pagamento real (hoje só sandbox: nenhum valor é cobrado) |
| Importação CSV/Excel com validação e duplicados | Integrações de importação por API (estrutura pronta, nenhum conector) |
| Banco embutido ou Supabase com RLS | Link absoluto nas mensagens (APP_URL) |
Rodar no Windows (jeito fácil)
Dê dois cliques em iniciar-agendou.bat. Na primeira vez ele instala as dependências (alguns minutos) e depois abre o navegador.
Rodar pelo terminal
npm install
npm run dev
O banco é criado sozinho em .data/pglite (Postgres embutido) com dados fictícios. Para zerar, apague a pasta .data.
Testar pagamentos (sandbox)
- Pix: gere o código e clique em Simular pagamento aprovado (teste). O contador expira no prazo configurado.
- Cartão (cliente logado no Histórico):
4111 1111 1111 1111 aprova; 4000 0000 0000 0002 é recusado. Qualquer validade futura e CVV.
- Nenhum valor real é cobrado.
Banco no Supabase
- No painel do Supabase, abra SQL Editor → New query, cole o conteúdo de
supabase/migrations/20261021150000_agendou_schema.sql e clique em Run. Depois faça o mesmo com
supabase/migrations/20261021180000_crm_importacao.sql.
Ele cria as 18 tabelas, os relacionamentos, os índices, as travas de integridade e as políticas de RLS (cada empresa só enxerga os próprios dados).
- Em Project Settings → Database → Connection string (URI), copie a string e coloque em
DATABASE_URL.
- Rode o app. Com o banco vazio, ele cria a empresa de exemplo. Para não criar, use
SEED=0.
Quem usa a CLI do Supabase pode rodar supabase db push, que aplica a mesma migration.
Variáveis de ambiente (opcionais) — ver .env.example
| Variável | Para quê |
|---|
DATABASE_URL | Usar Postgres/Supabase em vez do banco embutido |
SEED=0 | Não criar a empresa de exemplo num banco vazio |
APP_URL | Endereço público do app (ex.: https://agenda.suabarbearia.com.br), usado nos links das mensagens |
WHATSAPP_CHAVE_CRIPTO, WHATSAPP_APP_SECRET, WHATSAPP_WEBHOOK_VERIFY_TOKEN | Integração com o WhatsApp (API oficial). Cada barbearia conecta o número no painel → WhatsApp. Ver docs/WHATSAPP.md |
CRON_SECRET | Proteger POST /api/cron/expirar e POST /api/cron/lembretes |
PAGAMENTOS_SANDBOX=0 | Desliga o botão de simular pagamento |
LEMBRETE_HORAS_ANTES | Quantas horas antes enviar o lembrete (padrão 3) |
ROTINAS_INTERNAS=0 | Desliga as rotinas de 1 em 1 minuto (use as rotas /api/cron/* em serverless) |
Verificações
npm run lint && npx tsc --noEmit && npm run build
npm run lint:typed # lint com tipos (mais lento, ~20 s); fora do CI
# quality gates: eslint-rules/*.cjs (teto de 350 linhas, sem console direto, sem banco nas telas) — baseline em docs/LOG.md
O GitHub Actions (.github/workflows/ci.yml) roda essas três verificações a cada push.
Documentação
docs/MAPA_DE_TELAS.md, docs/MODELO_DE_DADOS.md, docs/REGRAS_DE_NEGOCIO.md, docs/ESTRUTURA_DO_APP.md e o diário do projeto em docs/LOG.md.
