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

1. Crie um repositório privado agenda-insper-ai.
2. 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)

1. New project → região South America (São Paulo). Guarde a senha do banco.
2. 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ó.
3. 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.
4. Project Settings → API: copie Project URL, a chave anon / publishable e a chave service_role / secret para o .env.local.
5. 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).
6. 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)

1. Novo projeto Agenda Insper AI.
2. 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.
3. Credentials → Create credentials → OAuth client ID → Web application. Em Authorized redirect URIs cole só a Callback URL do Supabase (B.6).
4. 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)

1. 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.
2. 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.
3. Deploy. Copie o domínio gerado.
4. 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.