Topa?
Eventos, hackathons, programas e bolsas pra estudantes. Site público que reúne oportunidades abertas para estudantes (hackathons, eventos, programas de embaixador, competições e olimpíadas, estágios e bolsas), com prazo, elegibilidade e link oficial. O plano completo está em PLANO.md. O visual do site (cores, fontes, componentes e regras de animação) está em docs/design/.
Estado atual (Fase 1, em andamento): lista hackathons do Devpost e da MLH e eventos dos GDGs brasileiros, ordenados pelo prazo ou, sem prazo, pela data de início.
Fontes
| Fonte | Como é coletada |
|---|
| Devpost | JSON público devpost.com/api/hackathons (não oficial) |
| MLH | JSON embutido na página da temporada (mlh.com/seasons/<ano>/events) |
| GDG | Sitemaps mensais de eventos e JSON-LD de cada página de evento. O robots.txt proíbe /api/ e pede 2 s entre requisições. Só capítulos brasileiros, listados em src/collectors/gdg-chapters-br.ts |
| dev.events | JSON-LD da página dev.events/SA/BR e link oficial na página de cada evento. Só presenciais e híbridos; o estado vem da cidade pela lista do IBGE. Eventos que apontam para o GDG ficam com o coletor do GDG |
| Agenda Tech Brasil | src/db/database.json do repositório aberto agenda-tech-brasil/agenda-tech-brasil no GitHub: eventos de tecnologia do Brasil todo, mantidos pela comunidade. O repositório não declara licença; usamos só os fatos (nome, datas, cidade, link) e o detalhe credita a fonte |
| SBC | API pública do plugin de eventos do site da Sociedade Brasileira de Computação (sbc.org.br/wp-json/tribe/events/v1/events): simpósios, escolas regionais (como a ERI-MT) e a Maratona SBC. Modalidade pelas categorias; cidade e UF pelo local ("Várzea Grande/MT") |
| Editais da UFMT | API do portal da UFMT (api-portal.ufmt.br, uso autorizado pelo dono do projeto) para PROEG, PRAE, PROPESQ e PROCEV: editais para estudantes dos últimos 60 dias. O PDF de cada um é lido por regras (src/lib/edital-text.ts): período de inscrição, resumo, valor da bolsa e câmpus. Sem prazo lido, o site mostra "veja no edital". Só aparecem para quem marcou UFMT (e o câmpus) no perfil |
| Editais da UNEMAT | Busca do próprio site (unemat.br/editais, robots.txt libera tudo), uma por categoria de estudante (bolsas, auxílios, monitoria, estágios). O PDF de cada edital é lido pelas mesmas regras. Ficam de fora editais de anos anteriores e os que já publicaram resultado final |
| Editais do IFMT | API pública do WordPress do IFMT (ifmt.edu.br/wp-json/wp/v2/edital), filtrada pelo público-alvo (estudante do médio, superior ou pós) e pela unidade (câmpus). Os PDFs ficam no Google Drive, cujo robots.txt proíbe download automático: prazo, valor e resumo saem do texto do post. Sem prazo lido, o edital fica 30 dias |
| Luma | Feed iCal público de cada calendário listado em data/luma-calendars.yaml (comunidades brasileiras). Só eventos futuros, no Brasil ou online; cidade pelas coordenadas do evento |
| Programas recorrentes | Lista curada em data/programs.yaml (embaixadores, competições e olimpíadas, estágios e mentorias pagas, bolsas), conferida à mão na página oficial |
O Sympla não é coletado: os termos de uso proíbem robôs e mineração de dados (item 13.3, "Segurança da Plataforma Sympla").
Duplicatas e reportes de erro
O mesmo evento pode vir de duas fontes. O site junta os itens com a mesma data de início, a mesma cidade (ou os dois online) e títulos iguais depois de tirar acentos, pontuação e o ano, ou um título contido no outro (src/lib/dedupe.ts). Fica um só, e o painel de detalhe mostra "também em" com o link da outra fonte.
O botão "reportar erro" do painel grava na tabela reports (migração 0006) sem identificar quem enviou. Qualquer pessoa pode enviar e ninguém lê pelo site. A coleta diária (npm run reports) junta os reportes novos numa issue com a etiqueta reporte.
Aviso quando um programa abre
Nos programas fechados, o botão "Me avise quando abrir" guarda o pedido (no navegador e, com conta, na tabela program_watches, migração 0010). A coleta diária roda npm run program-alerts, que manda um e-mail quando o programa passa a aceitar inscrições e marca o aviso como enviado. Usa os mesmos segredos do Gmail do resumo semanal. Detalhes em docs/design/melhorias-2026-11.md.
Resumo semanal por e-mail
Quem tem conta pode ligar, no perfil, um resumo que chega toda segunda às 07:00 (horário de Cuiabá): oportunidades novas que servem para o perfil e os prazos dos salvos que fecham em até 7 dias. Começa desligado; o link "Parar de receber" de cada e-mail desliga sem login (/alertas/cancelar). Design em docs/superpowers/specs/2026-10-28-alertas-email-design.md.
O workflow .github/workflows/alerts.yml roda npm run alerts. O envio sai de um Gmail do projeto com senha de app. Segredos necessários, além dos do Supabase:
GMAIL_USERGMAIL_APP_PASSWORD
Para conferir antes de enviar:
npm run alerts -- --dry-run # grava o HTML de cada e-mail em alerts-preview/, sem enviar
npm run alerts -- --to=voce@email # envia só para esse endereço
Programas recorrentes e monitor
Os programas ficam em data/programs.yaml, com um comentário no topo explicando cada campo; type diz se é embaixador, competição, estágio ou bolsa. Cada item registra a data em que a página oficial foi conferida (checked_on). O site mostra também os programas fechados, com o mês em que costumam abrir.
O monitor (npm run monitor) baixa a página oficial de cada programa todo dia, compara o texto visível com o da véspera e, se mudou, a coleta diária abre uma issue com a etiqueta monitor (ou comenta na que já estiver aberta). Nada é publicado automaticamente: confira a página, atualize o YAML e feche a issue.
Distância e "Perto de você"
A coleta dá a cada evento presencial no Brasil as coordenadas da sua cidade, procurando cidade e UF na lista de municípios do IBGE (data/municipios.json). Cidades que não batem aparecem no log da coleta como aviso; o evento continua no site, ordenado por estado em vez de distância.
No site, a cidade do perfil é procurada no arquivo do estado (public/municipios/<UF>.json), no próprio navegador, e "Perto de você" mostra o que está dentro do raio escolhido no perfil (50 a 500 km, padrão 100). A cidade não é enviada a nenhum serviço de mapas.
A lista vem de kelvins/municipios-brasileiros (MIT, dados do IBGE). Para atualizar: npx tsx scripts/build-municipalities.ts.
Stack
- Next.js (App Router, TypeScript, Tailwind)
- Supabase (Postgres e login)
- Coletores em Node, executados com
tsx
- Zod para validar os dados de cada fonte
- Vitest para os testes
Como rodar
Requer Node 24.
npm install
cp .env.example .env.local # preencha as variáveis
npm run collect # coleta o Devpost e grava no Supabase
npm run dev # http://localhost:3000
Para testar a coleta sem gravar nada: npm run collect -- --dry-run.
Sem as variáveis do Supabase, o site abre e mostra um aviso no lugar da lista.
Banco de dados
O esquema está em supabase/migrations/. Para aplicar em um projeto novo, cole cada arquivo no SQL Editor do Supabase, em ordem numérica, e execute.
opportunities: leitura pública; escrita só com a service role (usada pelo coletor).open_opportunities: view com o que não fechou e ainda está no prazo.profiles: cada pessoa lê e altera só o próprio perfil (RLS). Apagar a conta apaga o perfil.
Login
Login pelo Supabase Auth de dois jeitos: e-mail e senha (o que a tela mostra primeiro), ou código de 6 dígitos (e link mágico) por e-mail, no botão "Entrar com código por e-mail". Quem sempre entrou pelo código cria uma senha em "Esqueci minha senha" ou em Ajustes › Conta; o link de senha nova abre /entrar/nova-senha. A sessão fica no navegador, e o RLS garante que cada pessoa só lê e altera o próprio perfil e os próprios salvos. Sem conta, o perfil fica só no navegador.
Configuração no painel do Supabase:
- Authentication > URL Configuration: Site URL com o endereço da Vercel; em Redirect URLs,
https://<seu-site>/entrar, https://<seu-site>/entrar/nova-senha e os mesmos com http://localhost:3000.
- Authentication > Emails > Magic Link: o modelo precisa incluir
{{ .Token }} (o código) além do link.
- Para uso real, configure um SMTP próprio: o envio padrão do Supabase tem limite baixo de e-mails por hora.
A conta pode ser apagada pela própria pessoa (função delete_my_account, migração 0004). A política de privacidade fica em /privacidade; ao mudá-la, atualize PRIVACY_VERSION em src/lib/account.ts.
Estrutura
src/app/ páginas
src/lib/ esquema da oportunidade, conversão para o banco, leitura do Supabase
src/collectors/ um arquivo por fonte, com teste e resposta salva em __fixtures__
scripts/collect.ts roda os coletores do GitHub (lógica em src/collectors/run.ts) e grava no Supabase
data/ programas curados e municípios com coordenadas
supabase/ migrações SQL
Coleta diária
O workflow .github/workflows/collect.yml roda todo dia às 09:17 UTC (05:17 em Cuiabá), e também pode ser disparado à mão na aba Actions. Ele roda os testes e depois a coleta. Uma fonte que falha mantém os dados da véspera. O site atualiza a lista em até uma hora.
Duas fontes recusam os servidores do GitHub, que ficam nos EUA: a UFMT só responde a endereços do Brasil, e o dev.events responde 403. Elas rodam na rota /api/collect-br, uma função da Vercel fixada em São Paulo (gru1) e chamada pelo cron do vercel.json às 08:00 UTC. A lista de fontes e onde cada uma roda (runsIn) fica em src/collectors/run.ts. Do seu computador, npm run collect -- --only=ufmt,devevents coleta as duas.
Cada execução grava em source_health (migração 0011) quantas vezes seguidas a fonte falhou. A coleta do GitHub só termina com erro, e o GitHub só manda e-mail, quando uma fonte falha 3 vezes seguidas ou fica 48 horas sem ser coletada. O log diz qual e por quê.
Segredos necessários no repositório (Settings > Secrets and variables > Actions):
SUPABASE_URLSUPABASE_SERVICE_ROLE_KEY
Variáveis necessárias na Vercel (Settings > Environment Variables, ambiente Production), para a rota de São Paulo:
SUPABASE_SERVICE_ROLE_KEYCRON_SECRET: um texto aleatório longo; a Vercel o envia ao chamar o cron e a rota recusa quem não tem.
O GitHub desativa workflows agendados de repositórios públicos depois de 60 dias sem commits. Se isso acontecer, reative na aba Actions.
Regras dos coletores
- No máximo uma requisição por segundo por site, com User-Agent que identifica o robô.
- Se a coleta de uma fonte falhar ou vier vazia, os dados dela no banco ficam como estavam.
- Só dados factuais (nome, datas, local, link). Nada de descrições inteiras ou imagens.
Testes
npm test
