Agenda · Insper AI
Calendário compartilhado da Insper AI: eventos, aulas, reuniões e prazos. Três níveis: a diretoria cria e edita tudo e marca, em cada evento, se membros e/ou trainees também veem; membros criam e editam os próprios eventos; trainees só veem. Pedidos de disponibilidade (estilo when2meet) com link curto e prévia no WhatsApp. Quem entra sem estar cadastrado pede acesso pelo site e um admin aprova. Login com Google ou com código no e-mail. Modo claro/escuro, instalável no celular (PWA). Feed .ics por pessoa para conectar ao Google Agenda / Apple Calendar.
Estado atual, infraestrutura e pendências: docs/estado.md. Convenções de trabalho: CLAUDE.md.
Stack: Next.js 16 (App Router) na Vercel (região gru1) · Supabase em São Paulo (Postgres + Auth com Google e OTP por e-mail) · Tailwind v4 com os tokens do Playbook de Marca · Motion, GSAP e lucide-react na interface.
1. Rodar localmente
npm install
cp .env.local.example .env.local # preencha com as chaves do passo 2
npm run dev -- -p 3002 # http://localhost:3002 (a porta precisa estar nas Redirect URLs do Supabase)
npm test # testes da lógica pura (recorrência, .ics, níveis, disponibilidade, login…)
npm run lint && npm run typecheck
2. Configurar as contas (uma vez)
Já está tudo configurado em produção (ver docs/estado.md); estes passos servem para recriar do zero. A ordem importa: Supabase → Google Cloud → Vercel.
A. GitHub
- Crie um repositório privado
agenda-insper-ai.
- Dentro desta pasta:
git init && git add -A && git commit -m "Agenda da Diretoria" && git branch -M main && git remote add origin <url> && git push -u origin main.
B. Supabase (supabase.com, plano Free)
- New project → região
South America (São Paulo). Guarde a senha do banco.
- SQL Editor → cole
supabase/migrations/0001_init.sql inteiro → Run. Depois, uma query nova para cada uma, em ordem: 0002_niveis.sql, 0003_publico_e_pedidos.sql, 0004_votacoes.sql, 0005_diretoria_acompanha.sql, 0006_link_curto.sql, 0007_membros_criam.sql e 0008_membros_pedem_disponibilidade.sql → Run. Cada migração roda uma vez só.
- Abra
supabase/seed.sql, troque o e-mail pelo da sua conta Google e o nome, cole no SQL Editor → Run. Você é o primeiro admin.
- Project Settings → API: copie Project URL, a chave anon / publishable e a chave service_role / secret para o
.env.local.
- Authentication → URL Configuration:
- Site URL:
http://localhost:3000 (depois do deploy, troque pela URL da Vercel).
- Redirect URLs:
http://localhost:3000/** e https://agenda-insper-ai.vercel.app/** (ajuste ao domínio real).
- Authentication → Providers → Google → Enable. Copie a Callback URL mostrada (
https://<ref>.supabase.co/auth/v1/callback). Deixe a aba aberta para colar o Client ID/Secret do passo C.
C. Google Cloud (console.cloud.google.com, grátis)
- Novo projeto Agenda Insper AI.
- APIs & Services → OAuth consent screen: tipo External, nome "Agenda da Diretoria — Insper AI", e-mail de suporte, escopos padrão (
openid, email, profile). Depois Publish app (sem isso, só 100 "test users" conseguem entrar). Não precisa de verificação para esses escopos.
- Credentials → Create credentials → OAuth client ID → Web application. Em Authorized redirect URIs cole só a Callback URL do Supabase (B.6).
- Copie Client ID e Client secret → cole no provider Google do Supabase → Save.
C2. Login por código no e-mail (para quem não tem Google)
Precisa de SMTP próprio (o envio padrão do Supabase só entrega para o time do projeto). Passo a passo e template do e-mail em docs/estado.md → Pendências.
Pronto para testar local: npm run dev → /entrar → Google → /agenda.
D. Vercel (vercel.com, plano Hobby)
- Entre com o GitHub → Add New → Project → importe
agenda-insper-ai. Framework: Next.js. O vercel.json já fixa as funções em gru1 (perto do banco) e o cron diário.
- Environment Variables (Production e Preview): as cinco do
.env.local.example. NEXT_PUBLIC_SITE_URL = URL de produção; CRON_SECRET = qualquer string longa aleatória.
- Deploy. Copie o domínio gerado.
- Volte ao Supabase (B.5): Site URL = domínio da Vercel; confirme que ele está nas Redirect URLs. Na Vercel, ajuste
NEXT_PUBLIC_SITE_URL se mudou e faça Redeploy.
Para adicionar as pessoas: mande o link do site; quem não está cadastrado cai em Sem acesso e pede acesso ali (aparece em Membros → Pedidos, com contador na barra). Ou cadastre em Membros uma a uma (e-mail da conta Google, nome, nível, cargo) ou Colar uma lista com linhas email, nome, nível, cargo copiadas de uma planilha.
3. Como funciona
| Peça | Onde |
|---|
| Esquema, triggers de auditoria, RLS | supabase/migrations/0001_init.sql |
| Níveis (diretoria/membro/trainee) | supabase/migrations/0002_niveis.sql, lib/niveis.ts |
Pedidos de disponibilidade (estilo when2meet; no código e no banco, votacao) e convidados individuais em eventos | supabase/migrations/0004_votacoes.sql, lib/votacao.ts, components/votacao/ |
Público por evento (publico) e pedidos de acesso | supabase/migrations/0003_publico_e_pedidos.sql, app/sem-acesso/, components/admin/PedidosAcesso.tsx |
Tema claro/escuro (light-dark() + cookie tema) | app/globals.css, lib/tema.ts |
Link curto /d/<codigo> com prévia (Open Graph) | app/d/[codigo]/, lib/og.tsx, supabase/migrations/0006_link_curto.sql |
| Membros criam eventos / pedidos | supabase/migrations/0007_membros_criam.sql, 0008_membros_pedem_disponibilidade.sql, lib/niveis.ts |
| Login com código no e-mail | app/entrar/EntrarComEmail.tsx, lib/login.ts |
| Celular: PWA, barra de abas, folhas, gestos | app/manifest.ts, components/layout/BarraAbas.tsx, components/ui/Dialogo.tsx, app/globals.css |
Portão de membro (logado mas fora da lista → /sem-acesso) | app/(app)/layout.tsx, proxy.ts |
| Expansão de séries (semanal/quinzenal/mensal + exceções) | lib/recorrencia.ts |
Serializador .ics (RRULE / EXDATE / RECURRENCE-ID) | lib/ics.ts, app/api/feed/[token]/route.ts |
| Cores das categorias | app/globals.css (--cat-*) + lib/categorias.ts |
| Vistas mês / semana / próximos | components/agenda/Vista*.tsx |
Recorrência: uma linha "mestre" guarda freq + until. Editar/excluir só esta ocorrência cria uma linha filha com series_id + original_start (ou cancelled = true). Editar toda a série atualiza o mestre e propaga título/local/etc. para as filhas; mudar horário ou repetição apaga as filhas (o app avisa antes).
Permissões: só e-mails em members entram. Cada evento tem publico (membro e/ou trainee; a diretoria sempre vê); a RLS só devolve o que o nível da pessoa pode ver, e a diretoria cria/edita/exclui tudo, membros só os próprios eventos (sempre visíveis para membros) e trainees só veem (0007). Só admins alteram members, e admin precisa ser da diretoria (constraint). O último admin não pode ser removido (trigger). created_by/updated_by são preenchidos por trigger, não pelo cliente.
Feed: GET /api/feed/<token> é público, autenticado só pelo token (48 hex) do membro. Como usa a service role (sem RLS), filtra pelo nível do dono do token com visiveisPara(). Em Conectar dá para copiar, abrir no Google/Apple e gerar um novo token.
4. Verificação manual
- Dois perfis do Chrome: A (admin do seed) e B (não cadastrado). B entra →
/sem-acesso. A adiciona B em Membros → B recarrega → vê a agenda. A remove B → próxima navegação de B cai em /sem-acesso.
- Crie uma reunião semanal; exclua só esta numa semana; mova outra para o dia seguinte; confira em Mês, Semana e Próximos.
curl -i https://<site>/api/feed/<token> → 200 + text/calendar; token errado → 404. Cole o corpo em https://icalendar.org/validator.html.- Google Agenda → Outras agendas → + → Por URL: a série aparece sem a ocorrência excluída e com a movida no dia certo.
