Rastreador de candidaturas

Sistema web para acompanhar candidaturas a vagas (estágio, trainee, CLT, PJ, temporário ou freela), do "quero me candidatar" até a proposta. Tem quadro Kanban com arrastar e soltar, linha do tempo de cada vaga, próximos passos com prazo e um painel com o funil e a taxa de resposta. Também acompanha concursos públicos: cronograma, contagem até a prova, matérias, leitor de edital e busca diária de editais abertos.

Demonstração: rastreador-de-candidaturas.vercel.app. Clique em Explorar a demonstração: a conta já vem com dados de exemplo, e eles voltam ao original todo dia.

Objetivo

Procurar estágio ou emprego vira uma planilha bagunçada rápido: vagas em várias plataformas, testes online com prazo, entrevistas em etapas diferentes e nenhuma noção de onde o processo costuma travar. Este projeto resolve isso para uso diário e, ao mesmo tempo, serve de vitrine técnica: CRUD completo com back-end, banco relacional com regras de segurança por usuário, login, testes e deploy.

Funcionalidades

• Login e cadastro com e-mail e senha, recuperação de senha e login com Google (opcional).
• Quadro Kanban com uma coluna por etapa. Arraste os cards entre colunas (ou use o teclado). A mudança é salva na hora, entra na linha do tempo e pode ser desfeita pelo aviso. As colunas finais (Aprovada, Reprovada, Desisti) podem ser recolhidas.
• Tipo de vaga (estágio, trainee, CLT, PJ, temporário, freela) e remuneração (bolsa ou salário), com etiqueta no card, filtro na lista e coluna no CSV.
• Lista com busca (ignora acentos), filtros por etapa, tipo de vaga, plataforma, modelo e prioridade, e ordenação por coluna. Os filtros ficam na URL, então dá para favoritar uma busca.
• Página de detalhe com todos os dados, observações, linha do tempo das etapas (com quanto tempo a vaga ficou em cada uma) e próximos passos com prazo.
• Criar, editar, duplicar e excluir (com confirmação).
• Automação gratuita pela caixa de entrada: os e-mails das plataformas e das empresas viram sugestões ("Nuvem Pay → Entrevista técnica, prazo 23/10"), e as inequívocas (confirmação de inscrição, reprovação clara) são aplicadas sozinhas. Também dá para colar uma mensagem do WhatsApp ou do LinkedIn, ou compartilhar direto pelo Android. Veja Automação gratuita.
• Resumo diário por e-mail (prazos, o que mudou, vagas paradas, datas dos concursos, vagas e concursos novos, números) e assistente no WhatsApp que responde "resumo", "prazos", "andamento", "concursos" ou o nome de uma empresa, e transforma mensagens encaminhadas de recrutadores em sugestões. Tudo grátis.
• Caça-vagas diário: a pessoa diz o que procura (cargos, cidade, modelo, tipo de vaga, remuneração mínima, palavras-chave do currículo) e todo dia o app busca vagas abertas na Gupy e nas páginas de carreira de empresas (Greenhouse e Lever). Cada vaga ganha uma nota de compatibilidade com os motivos ("92%: Cargo: Estágio em Dados · Estágio · Híbrido em São Paulo · SQL, Python") e entra no quadro com um clique. O cartão mostra também bolsa ou salário, horário e benefícios quando a vaga informa. Veja Caça-vagas.
• Currículo em PDF: o app lê as habilidades, os idiomas, o curso e a cidade, usa as habilidades na nota das vagas, avisa quando a vaga pede um idioma acima do que o currículo diz e sugere cargos e tipo de vaga para o perfil. Veja Currículo.
• Concursos públicos: cadastro com cronograma, matérias e próximos passos, quadro por etapa, contagem até a prova, leitor de edital (cola o texto ou o link e o app preenche órgão, cargo, banca, salário e datas) e caça-concursos diário no Diário Oficial da União e nos diários oficiais das cidades. O app só leva ao site oficial: nunca faz a inscrição nem guarda CPF ou dados de pagamento. Veja Concursos públicos.
• Painel com total, em andamento, taxa de resposta, aprovações, funil, aprovação por etapa, candidaturas por plataforma, ritmo semanal, próximos prazos (atrasados, hoje e próximos 7 dias, de candidaturas e concursos) e a agenda dos concursos, com alerta de inscrição e boleto vencendo em 7 dias.
• Exportar em CSV as candidaturas e os concursos, pronto para abrir no Excel em português, e o cronograma em .ics para o Google Agenda ou o calendário do celular.
• Dados de exemplo com um clique e conta de demonstração que se restaura sozinha todo dia.
• Atalhos de teclado: N nova candidatura, / buscar, Ctrl+K paleta de comandos, G e depois P/Q/L/C/V/O para navegar, ? mostra todos os atalhos.
• Modo claro e escuro, avisos leves (toast), estados vazios com ação e layout responsivo: no celular o Kanban vira uma lista agrupada por etapa.

Quadro	Detalhe
Lista	Modo escuro
Caixa de entrada	Celular
Vagas sugeridas

Tecnologias

Camada	Escolha
Framework	Next.js 16 (App Router, Server Components, Server Actions, Cache Components) com TypeScript
Interface	Tailwind CSS v4, shadcn/ui (Radix), lucide-react, Sonner (toasts), next-themes
Banco e login	Supabase: PostgreSQL, Auth e Row Level Security, via @supabase/ssr
Formulários	React Hook Form + Zod (o mesmo schema valida no navegador e no servidor)
Arrastar e soltar	dnd-kit (mouse, toque e teclado, com anúncios para leitores de tela)
Gráficos	Recharts (pelos componentes de gráfico do shadcn) e barras em HTML/CSS
Testes	Vitest
Deploy	Vercel (com Cron diário para a conta demo)

Como funciona por dentro

Modelo de dados

auth.users ──┬──< applications ──┬──< stage_history   (preenchida por trigger)
             │                   ├──< tasks
             │                   └──< inbox_items      (sugestões da caixa de entrada)
             ├──  user_settings                        (token do e-mail e automação)
             ├──  job_profiles                         (perfil do caça-vagas)
             ├──< job_leads                            (vagas sugeridas, com nota)
             ├──  resumes                              (o que foi lido do currículo)
             ├──< concursos ──┬──< concurso_stage_history (preenchida por trigger)
             │                ├──< concurso_dates           (cronograma)
             │                ├──< concurso_subjects        (matérias)
             │                └──< tasks                    (a mesma tabela das candidaturas)
             ├──  concurso_profiles                    (perfil do caça-concursos)
             ├──< concurso_leads >── concurso_notices  (sugestões; o catálogo é compartilhado)
             └── (user_id em todas as tabelas, para o RLS)

• applications: empresa, cargo, tipo de vaga, link, plataforma, local, modelo, remuneração (em centavos, para não ter erro de arredondamento), data da candidatura, etapa, prioridade, observações e a posição do card na coluna.
• stage_history: cada mudança de etapa (de → para, com data e hora). Quem grava é um trigger no PostgreSQL, então nenhuma mudança escapa do histórico, venha do Kanban, do formulário ou de outro cliente.
• tasks: próximos passos com prazo opcional, ligados a uma candidatura ou a um concurso (uma regra CHECK exige exatamente um dos dois). Assim o painel lê todos os prazos de um lugar só.
• inbox_items: sugestões vindas de e-mails ou de mensagens coladas (tipo, etapa sugerida, empresa, cargo, prazo, trecho da mensagem e o que foi feito com ela).
• user_settings: hash do token pessoal do e-mail e a preferência de aplicar sozinho.
• job_profiles: o que a pessoa procura (cargos, tipos, modelos, cidade, palavras-chave, fontes) e o resumo da última busca.
• job_leads: vagas encontradas, com nota, motivos, avisos, bolsa ou salário, horário, benefícios e situação (nova, adicionada ao quadro ou descartada). A mesma vaga nunca é sugerida duas vezes, nem depois de descartada.
• resumes: um por pessoa. Guarda onde está o PDF e só o que a busca usa (habilidades, idiomas, curso, situação do curso, cidade e sugestões). O texto completo do currículo não é guardado.
• concursos: órgão, cargo, banca, esfera, escolaridade, área, salário em centavos, vagas, cadastro reserva, cidade e UF, links do edital e da inscrição, observações, prioridade, etapa e posição no quadro. concurso_stage_history guarda as mudanças de etapa (por trigger, como nas candidaturas).
• concurso_dates: o cronograma (início e fim das inscrições, pedido de isenção, vencimento do boleto, prova, gabarito, recurso, resultado e validade), com hora e observação opcionais.
• concurso_subjects: matérias com peso, número de questões, situação (não estudado, estudado, revisado) e ordem.
• concurso_profiles: o que a pessoa procura em concursos (escolaridade, áreas, cargos, esferas, cidades, estados, salário mínimo, bancas preferidas, se aceita mudar de cidade) e o resumo da última busca.
• concurso_notices: o catálogo compartilhado de editais de abertura encontrados. É o mesmo para todo mundo (o arquivo do DOU é grande e igual para todos), só o cron grava nele e quem está logado só lê. concurso_leads é a sugestão de cada pessoa, com nota, motivos e avisos, única por pessoa e edital: o mesmo edital nunca é sugerido duas vezes.

As etapas são fixas e definidas em um só lugar (src/lib/stages.ts): nome, cor, ordem no funil e tipo. As mesmas chaves estão travadas no banco por restrições CHECK. As etapas dos concursos ficam em src/lib/concurso-stages.ts, do mesmo jeito.

Segurança

• Row Level Security ligado em todas as tabelas: cada usuário só lê e altera as próprias linhas ((select auth.uid()) = user_id). Tarefas e histórico ainda conferem se a candidatura ligada é do mesmo usuário.
• O servidor valida a sessão com getClaims() (confere a assinatura do token) e toda Server Action revalida a entrada com Zod, mesmo que o navegador já tenha validado.
• A chave secreta do Supabase só é usada no servidor (crons, assistente do WhatsApp e script da conta demo) e nunca tem o prefixo NEXT_PUBLIC_.
• A conta demo é protegida no próprio Auth, não só na tela: um gatilho em auth.users recusa trocar o e-mail dela e só aceita trocar a senha para a senha oficial, guardada criptografada no Vault do Supabase. Assim, nem chamando supabase.auth.updateUser() direto pelo navegador um visitante consegue tomar a conta. O Supabase não tem um Auth Hook que rode antes de alterar um usuário, por isso a regra fica no banco. O cron de reset continua funcionando porque registra a senha oficial (função protect_demo_account, só para a chave secreta) antes de redefini-la.
• Currículos em bucket privado do Storage, só PDF e até 4 MB, cada pessoa na própria pasta (<user_id>/curriculo.pdf). O servidor confere a assinatura do arquivo (%PDF-), não só o tipo informado pelo navegador, e o PDF só abre por um link temporário de 1 minuto. Na conta demo, enviar e apagar currículo é recusado pelas próprias regras do banco e do Storage (uma função em private, fora da API, diz se a conta é protegida), porque a conta é compartilhada.
• O CSV exportado neutraliza "injeção de fórmula" (=, +, -, @ no início de um campo).
• Concursos: o app nunca faz a inscrição nem guarda CPF, documentos ou dados de pagamento. O botão "Ir para a inscrição" só abre o site oficial. O leitor de edital baixa links só por http(s), recusa endereços internos (inclusive depois de redirecionar, porque confere o IP na hora de conectar), segue no máximo 3 redirecionamentos e para em 10 MB ou 20 segundos.
• Os e-mails entram por uma função do banco (inbox_ingest) que só aceita um token pessoal: o banco guarda apenas o hash (SHA-256) dele e grava só na conta dona do token. O Supabase avisa que essa função pode ser chamada sem login. Isso é intencional: quem chama é o script do Google, que não tem sessão, e sem um token válido a função recusa a chamada.

Métricas

As métricas usam a etapa mais avançada que cada vaga alcançou, a partir do histórico. Uma vaga reprovada depois da entrevista com RH continua contando como "chegou à entrevista com RH". E uma vaga que pulou o teste online conta como tendo passado por ele.

• Taxa de resposta: das candidaturas enviadas, quantas tiveram retorno (avançaram ou foram reprovadas).
• Aprovação por etapa: das que chegaram a uma etapa, quantas chegaram à seguinte.

A lógica fica em src/features/dashboard/metrics.ts e tem testes.

Ordem dos cards no Kanban

Cada card tem uma position decimal. Ao soltar um card entre dois outros, ele recebe a média das posições vizinhas, então só o card movido é salvo no banco. A interface atualiza antes da resposta do servidor e volta ao estado anterior se algo der errado.

Estrutura de pastas

src/
  app/                      Rotas (App Router)
    (auth)/                 login, cadastro, recuperar e redefinir senha
    (app)/                  painel, quadro, lista, caixa-de-entrada, vagas, conexoes, candidaturas/[id], nova, editar
    (app)/concursos/        lista, quadro, sugeridos, perfil, ler-edital, novo, [id], [id]/editar
    api/export/             download do CSV (candidaturas e /concursos)
    api/concursos/          edital (leitor), buscar ("Buscar agora") e agenda (.ics)
    api/cron/concursos/     busca diária de concursos (DOU e Querido Diário)
    api/cron/reset-demo/    restauração diária da conta demo
    api/cron/vagas/         busca diária de vagas para todos os perfis
    api/vagas/buscar/       busca de quem está logado (ao abrir o app e no botão "Buscar agora")
    api/inbox/email/        recebe os e-mails enviados pelo script do Google
    api/report/             resumo diário (chamado pelo script do Google)
    api/whatsapp/webhook/   assistente do WhatsApp (API oficial da Meta)
    auth/callback/          retorno dos e-mails e do Google
  features/                 Código organizado por funcionalidade
    applications/           schema (Zod), actions, queries, filtros, CSV, componentes
    board/                  lógica do Kanban (pura e testada) e componentes
    dashboard/              cálculo das métricas e gráficos
    tasks/                  próximos passos
    auth/                   sessão, actions e formulários de login
    demo/                   dados de exemplo e conta demo
    inbox/                  leitor de mensagens (regras), plano de cada sugestão, script do Google
    report/                 montagem do resumo diário (e-mail, WhatsApp e prévia)
    whatsapp/               assistente: comandos, vinculação por código, webhook
    job-search/             caça-vagas: fontes (Gupy, Greenhouse, Lever), nota, bolsa e benefícios, busca
    resume/                 currículo: leitura do PDF, habilidades, idiomas, curso, sugestões
    concursos/              concursos: cronograma, matérias, leitor de edital, agenda, .ics, CSV
    concursos/search/       caça-concursos: DOU, Querido Diário, catálogo, nota, perfil
  components/               Componentes compartilhados (app-shell, ui do shadcn, etc.)
  lib/                      Supabase, etapas, opções, formatação pt-BR, CSV, erros
  types/database.ts         Tipos do banco
supabase/migrations/        SQL do banco (tabelas, trigger, RLS, índices)
scripts/seed-demo.ts        Cria/recria a conta demo
tests/                      Testes (Vitest)
assets/fonts/               Fonte Geist (licença OFL) usada na imagem de compartilhamento
assets/demo/                Currículo fictício da conta demo (também usado nos testes)
.github/workflows/ci.yml    CI: lint, testes e build a cada push e pull request

Configurar o Supabase

1. Crie uma conta em supabase.com e clique em New project. Escolha a região South America (São Paulo) e guarde a senha do banco.

2. Crie as tabelas: no menu lateral, abra SQL Editor → New query. Cole o conteúdo de cada arquivo da pasta supabase/migrations e clique em Run, um por vez e nesta ordem:

   1. 20261019000000_init.sql
   2. 20261019000100_stage_history_immutable.sql
   3. 20261020000000_job_type_and_salary.sql
   4. 20261020010000_inbox.sql
   5. 20261020010100_inbox_ingest_anon_only.sql
   6. 20261021000000_report_and_whatsapp.sql
   7. 20261022000000_job_search.sql
   8. 20261027000000_protect_demo_account.sql
   9. 20261028000000_job_lead_details.sql
   10. 20261028010000_resumes.sql (cria também o bucket curriculos do Storage)
   11. 20261029000000_concursos.sql
   12. 20261029010000_concurso_search.sql
   13. 20261029020000_concurso_report.sql

   Confira em Table Editor se apareceram applications, stage_history, tasks, inbox_items, user_settings, job_profiles, job_leads, concursos, concurso_dates, concurso_subjects, concurso_profiles, concurso_notices e concurso_leads, todas com o selo de RLS ativado.

   Se você usa a CLI do Supabase: npx supabase link --project-ref <id> e npx supabase db push.

3. Copie as chaves para o .env.local (copie o .env.example primeiro):

Login com Google (opcional)

1. No Google Cloud Console, crie um projeto e configure a tela de consentimento OAuth (tipo "Externo").
2. Em APIs e serviços → Credenciais → Criar credenciais → ID do cliente OAuth, escolha Aplicativo da Web e preencha:
   • Origens JavaScript autorizadas: http://localhost:3000 e https://SEU-APP.vercel.app.
   • URIs de redirecionamento autorizados: a Callback URL que aparece no Supabase em Authentication → Sign In / Providers → Google (algo como https://xxxx.supabase.co/auth/v1/callback).
3. No Supabase, ative o provedor Google e cole o Client ID e o Client Secret.
4. No .env.local (e na Vercel), defina NEXT_PUBLIC_GOOGLE_AUTH_ENABLED=true. O botão "Continuar com Google" só aparece com essa variável ligada.

Conta de demonstração

1. Preencha SUPABASE_SECRET_KEY, DEMO_EMAIL e DEMO_PASSWORD no .env.local. O e-mail não precisa existir (ex.: [email protected]): o script cria a conta pela API administrativa, já confirmada. Só a tela de cadastro comum exige um domínio que receba e-mails; o Supabase recusa até @example.com ali.
2. Rode npm run seed:demo. O script cria a conta (já confirmada) com 20 candidaturas de empresas fictícias, histórico e tarefas, e as datas ficam relativas ao dia em que ele roda.
3. A tela de login passa a mostrar Explorar a demonstração. A senha nunca vai para o navegador: o login da demo acontece no servidor.
4. Em produção, o Cron da Vercel chama /api/cron/reset-demo todo dia às 3h (horário de Brasília) e restaura dados e senha. Dentro da conta demo também há um botão Restaurar agora.
5. O script e o cron marcam a conta como protegida: o e-mail e a senha dela não mudam nem por chamadas diretas ao Supabase (veja Segurança).
6. O script e o cron também colocam na demo um currículo fictício (assets/demo/curriculo-demo.pdf), lido como qualquer currículo enviado. Os visitantes não conseguem trocar nem apagar esse currículo.
7. A demo também ganha 5 concursos de órgãos fictícios (um com inscrição e boleto vencendo nesta semana, um com prova daqui a algumas semanas e matérias pela metade, um com prova feita, um encerrado e um só acompanhado), o perfil de concursos e 3 editais fictícios sugeridos. Os editais ficam no catálogo com a fonte exemplo, que a busca de verdade ignora, e todos os links são de example.com.

Qualquer outra conta pode carregar os mesmos dados de exemplo pelo botão Carregar dados de exemplo, que aparece quando a conta está vazia (na página de concursos, o botão carrega os concursos de exemplo).

Automação gratuita

O app não enxerga o que você faz no navegador nem no celular. Ele recebe sinais de três lugares, e todos viram sugestões na Caixa de entrada:

De onde vem	Como chega	Configuração
E-mails (Gupy, LinkedIn, sites de vagas, recrutadores)	Um script do Google Apps Script, rodando na sua conta Google, confere o Gmail a cada 10 minutos e envia só os e-mails de processos seletivos	Uma vez, cerca de 2 minutos
Mensagens (WhatsApp, LinkedIn, qualquer texto)	Botão Colar mensagem	Nenhuma
Compartilhar no Android	Com o app instalado no celular, ele aparece no menu Compartilhar	Instalar o app pelo navegador

O que o app entende (regras em português, sem IA e sem custo, em src/features/inbox/parser.ts):

• confirmação de inscrição, teste online, dinâmica ou case, entrevista com RH, entrevista técnica, proposta, aprovação e reprovação;
• empresa, cargo, plataforma e prazos ("até 25/10", "dia 3 de novembro", "amanhã");
• a próxima etapa, e não a que já passou ("seu case ficou ótimo, vamos marcar a entrevista");
• alertas de "novas vagas para você" são descartados.

Automático ou com confirmação: confirmações de inscrição e reprovações com frase clara são aplicadas sozinhas quando o app abre (dá para desligar na Caixa de entrada). O resto aparece como sugestão com uma prévia ("Nuvem Pay → Entrevista técnica · próximo passo até 23/10") e é aplicado com um clique. A etapa nunca anda para trás (um e-mail atrasado não tira a vaga da entrevista) e vagas já encerradas não mudam.

Conectar o Gmail: na Caixa de entrada, clique em Conectar e-mail e siga os passos. O app gera um script com o seu token pessoal; você cola em script.google.com, roda a função configurar uma vez e autoriza. O script precisa do endereço publicado (Vercel), porque o Google não alcança o localhost do seu computador.

Custo zero para todo mundo: cada pessoa conecta o próprio e-mail, e o script roda na conta Google dela. Não há serviço pago no caminho. Um botão "Conectar com Google" de um clique exigiria que o Google auditasse o app (processo pago) para ler o Gmail de outras pessoas. O script evita isso.

Resumo diário por e-mail

O mesmo script do Google manda, todo dia no horário escolhido (padrão: 7h), um resumo para o Gmail da própria pessoa: prazos atrasados, de hoje e da semana; o que mudou desde ontem; sugestões esperando na caixa de entrada; vagas em andamento sem novidade há 14 dias ou mais; as vagas novas do caça-vagas; as datas dos concursos na semana (fim das inscrições, boleto, prova...) e os concursos novos sugeridos; e os números da semana. A prévia aparece na página Conexões. O envio usa a cota gratuita de e-mails da própria conta Google, então não custa nada.

Assistente no WhatsApp (opcional)

Pela API oficial da Meta. Ele só responde quando a pessoa escreve, e por isso é grátis: a Meta não cobra até 1.000 respostas por mês por número (regra em vigor desde 1º/10/2026). Mensagens que a empresa inicia, como um relatório enviado sozinho todo dia, são cobradas. Por isso o resumo automático vai por e-mail e o WhatsApp funciona sob demanda.

O que a pessoa pode mandar: resumo, prazos, andamento, sugestões, vagas, concursos (alertas de inscrição e boleto da semana, as próximas datas e os concursos novos), o nome de uma empresa ("como está a Nuvem Pay?") ou uma mensagem encaminhada de recrutador, que vira sugestão na caixa de entrada. Para conectar, ela gera um código em Conexões e manda vincular CÓDIGO para o assistente, o que prova que o número é dela. Mandar desvincular desconecta.

Como configurar (quem publica o app faz uma vez):

1. Em developers.facebook.com, crie um app do tipo Business e adicione o produto WhatsApp. A Meta já oferece um número de teste grátis.
2. Em WhatsApp → Configuração da API, copie o Phone number ID e gere um token de acesso. O token temporário dura 24 horas; para um permanente, crie um usuário do sistema nas configurações do negócio com a permissão whatsapp_business_messaging. Para testar, adicione o seu número na lista de destinatários: o número de teste só conversa com até 5 números cadastrados.
3. Em Configurações do app → Básico, copie a Chave secreta do app (App Secret).
4. Em WhatsApp → Configuração → Webhook, use a URL https://SEU-APP.vercel.app/api/whatsapp/webhook, invente um token de verificação (o mesmo de WHATSAPP_VERIFY_TOKEN) e assine o campo messages.
5. Preencha na Vercel: WHATSAPP_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_APP_SECRET, WHATSAPP_VERIFY_TOKEN, NEXT_PUBLIC_WHATSAPP_BOT_NUMBER (o número do assistente, com DDI e DDD) e SUPABASE_SECRET_KEY. Faça um novo deploy.
6. Para qualquer pessoa usar (não só os 5 números de teste), cadastre um número de verdade, como um chip novo, no gerenciador do WhatsApp da Meta.

Sem WHATSAPP_TOKEN e WHATSAPP_PHONE_NUMBER_ID, o assistente fica em modo de teste: as respostas aparecem no log e na resposta do webhook, sem envio pela Meta.

WhatsApp pessoal: não existe um meio oficial de um app ler as suas conversas, e as ferramentas não oficiais podem banir o número. Por isso as mensagens de recrutadores entram pelo Colar mensagem, pelo Compartilhar do Android ou encaminhadas para o assistente.

Caça-vagas

Na página Vagas sugeridas, a pessoa monta um perfil de busca uma vez: cargos (até 5), tipos de vaga, modelos de trabalho, cidade e estado, remuneração mínima, palavras-chave do currículo, palavras para evitar e as fontes. A partir daí o app busca vagas todo dia e mostra as mais compatíveis.

Fontes (todas públicas, sem login e sem custo):

Fonte	Como o app lê	Observação
Gupy	A mesma busca pública que o portal de vagas da Gupy usa no navegador, por cargo, tipo de vaga, estado e vagas remotas	Não é uma API oficial: se a Gupy mudar o formato, a busca registra o erro e as outras fontes seguem funcionando
Greenhouse	Job Board API, a listagem pública oficial de cada empresa	Não tem busca geral, por isso existe uma lista pronta de 16 empresas com vagas no Brasil (QuintoAndar, Stone, C6 Bank, Inter, XP, BTG, VTEX, EBANX, Wellhub e outras)
Lever	Postings API, também oficial e pública	Lista pronta com CI&T, Neon, Swile e dLocal

A pessoa pode acrescentar outras empresas colando o link da página de vagas (boards.greenhouse.io/... ou jobs.lever.co/...). A lista pronta fica em src/features/job-search/boards.ts. LinkedIn e Indeed ficam de fora: não têm listagem pública e proíbem a coleta automática.

Nota de compatibilidade (regras em src/features/job-search/score.ts, sem IA): cargo 45 pontos, tipo de vaga 20, local e modelo 20, palavras-chave e habilidades do currículo 15. O cargo é comparado sem acentos e com sinônimos em português e inglês ("Dados" = "Data", "Desenvolvedor" = "Developer"). Cada ponto vira um motivo na tela. Ficam de fora, em vez de ganhar nota baixa: outro tipo de vaga, nível sênior ou de liderança (quando o cargo do perfil não pede), outra cidade em vaga presencial ou híbrida, vaga fora do Brasil, inscrições encerradas, banco de talentos, jovem aprendiz e títulos com palavras a evitar. Remuneração abaixo do mínimo vira aviso e desconta pontos. Só entram vagas com nota a partir de 60, no máximo 30 novas por busca.

Bolsa, horário e benefícios (regras em src/features/job-search/details.ts): nenhuma fonte informa isso de forma organizada, então o app lê a descrição da vaga. Pega o valor só perto de "bolsa", "salário" ou "remuneração" (e ignora "bolsa de estudos", "bolsa de valores", valor por hora e "R$ 10 milhões"), a jornada ("6h por dia", "30h por semana", "das 9h às 15h") e 20 benefícios comuns (vale-transporte, vale-refeição, plano de saúde, Wellhub/Gympass, auxílio home office, PLR, day off...). Os benefícios só são lidos a partir da parte de benefícios da vaga, para não confundir com a apresentação da empresa ("somos líderes em plano de saúde"). Na dúvida, a informação fica de fora. A Gupy já manda a descrição completa na busca. O Greenhouse não: a lista com todas as descrições pesa megabytes por empresa, então o app baixa a descrição (cerca de 17 KB) só das vagas que já passaram no filtro e refaz a nota com ela.

Quando roda:

• Todo dia cedo, pelo Cron da Vercel (/api/cron/vagas, às 5h de Brasília), para todos os perfis com busca automática. Os downloads das páginas das empresas são reaproveitados entre os perfis. Precisa da SUPABASE_SECRET_KEY.
• Ao abrir o app, se a última busca foi há mais de 20 horas. Assim funciona mesmo sem o cron.
• No botão "Buscar agora", no máximo uma vez a cada 2 minutos.

As vagas novas aparecem no menu (com o número), na página Vagas sugeridas, no resumo diário por e-mail e no comando vagas do assistente do WhatsApp. Adicionar ao quadro cria a candidatura em "Quero me candidatar" com empresa, cargo, link, local, modelo, tipo e a nota. Descartar tira a vaga da lista para sempre (com desfazer).

Currículo

No Perfil de busca, a pessoa envia o currículo em PDF (até 4 MB). O texto sai do PDF com a biblioteca unpdf (o pdf.js da Mozilla, sem dependências nativas) e é lido por regras, sem IA (src/features/resume/extract.ts):

• Habilidades: um dicionário com mais de 100 ferramentas e conhecimentos, com os outros jeitos de escrever ("MS Excel", "PostgreSQL" vale SQL, "PowerBI"). Só palavras inteiras: "excelente" não é Excel e "JavaScript" não é Java.
• Idiomas e nível ("Inglês: avançado", "English (B2)").
• Curso e situação: procurado na parte de formação ("Formação acadêmica", "Escolaridade") ou depois de "graduação em", "bacharelado em"... Datas futuras e palavras como "cursando" ou "previsão" dizem que o curso está em andamento.
• Cidade e estado, só no começo do currículo, onde ficam os dados de contato.

Com isso, o app sugere cargos (do curso e das áreas com mais habilidades: "Estágio em Dados"), tipos de vaga (estágio para quem estuda; trainee para quem se forma em até um ano ou se formou há até dois) e a cidade. Nada muda sozinho: a pessoa marca o que quer, clica em Usar no perfil, confere e salva.

Nas buscas, as habilidades do currículo somam com as palavras-chave do perfil na nota e aparecem como motivo ("Do currículo: Pandas"). Quando a vaga pede inglês ou espanhol avançado e o currículo diz menos (ou não cita o idioma), a vaga ganha um aviso ("Inglês avançado: seu currículo diz intermediário"). Enviar, trocar ou apagar o currículo libera uma busca nova.

Privacidade: nome, e-mail, telefone, endereço e documentos não são lidos nem guardados. O PDF fica no bucket privado e pode ser apagado a qualquer momento, junto com o que foi lido dele. PDF escaneado (só imagem) não tem texto: o app avisa e pede para exportar de novo pelo Word ou pelo Google Docs.

Concursos públicos

Concurso não segue as etapas de uma vaga (não tem entrevista nem proposta), então tem um módulo próprio, no menu Concursos (atalho G e depois O), com o mesmo padrão das candidaturas: lista com filtros, quadro Kanban, página de detalhe, linha do tempo e próximos passos.

Etapas: Acompanhando · Edital publicado · Inscrição feita · Taxa paga · Prova marcada · Prova feita · Resultado · Aprovação · Nomeação · Sem aprovação · Desisti. Os nomes falam da etapa, não da pessoa ("Inscrição feita", e não "Inscrita").

Página do concurso: cronograma em linha do tempo (o que já passou fica apagado, inscrição e boleto vencendo em 7 dias ficam em destaque), contagem até a prova, matérias com barra de progresso pelo peso de cada uma, próximos passos, histórico, Ir para a inscrição (abre o site oficial) e Adicionar à agenda, que baixa o cronograma em .ics com lembrete na véspera. No celular, basta abrir o arquivo; no Google Agenda pelo computador, use Configurações → Importar e exportar. Na lista, o menu ao lado de "Novo concurso" exporta os concursos em CSV e a agenda de todos eles.

Leitor de edital (Ler edital): a pessoa cola o texto ou o link do edital (PDF, página do órgão ou do Diário Oficial) e o app preenche órgão, cargos, banca, esfera, escolaridade, salário, taxa, vagas, cadastro reserva, local, links e o cronograma. É por regras, sem IA e sem custo (src/features/concursos/notice-parser.ts), testado com trechos reais de editais do DOU. A pessoa confere tudo antes de salvar. Sites que só funcionam com JavaScript (como o do Cebraspe) não entregam o texto: o app avisa e pede o link do PDF.

Caça-concursos

No Perfil de concursos, a pessoa diz a escolaridade, as áreas e os cargos que interessam, as esferas, as cidades (no formato Cidade/UF), os estados, o salário mínimo, as bancas preferidas e se aceita mudar de cidade. O app procura editais de abertura e mostra os que combinam em Concursos sugeridos, com nota, motivos e destaque para inscrições que terminam em até 7 dias. Acompanhar cria o concurso com o cronograma já preenchido; Descartar tira a sugestão para sempre.

Fontes:

Fonte	Como o app lê	Cadastro
Diário Oficial da União, Seção 3 pelo INLABS	Baixa o ZIP de XML do dia e separa as matérias do tipo "Edital" que abrem concurso (extratos, homologações e retificações ficam de fora)	Precisa de conta, gratuita e pessoal: crie em inlabs.in.gov.br e preencha INLABS_EMAIL e INLABS_PASSWORD (veja o .env.example)
DOU pela página de Dados Abertos da Imprensa Nacional	O mesmo XML, num ZIP por mês (cerca de 60 MB), atualizado todo dia	Nenhum. É a reserva automática quando o INLABS não está configurado ou está fora do ar
Querido Diário (Open Knowledge Brasil)	API pública com os diários oficiais das prefeituras. O app busca "concurso público" e "edital" nas cidades dos perfis e aceita só trechos de edital de abertura (nomeações e licitações ficam de fora)	Nenhum

Cobertura do Querido Diário em Minas Gerais (conferida em 27/10/2026): 55 cidades aparecem na lista, mas só 20 têm diários. Estão em dia Betim, Campo Belo, Candeias, Carmo da Cachoeira, Carmo do Rio Claro, Contagem, Crucilândia, Itajubá, Itaúna, Januária, Juatuba, Nova Serrana, Onça de Pitangui, Piranguinho, Salinas, Taiobeiras, Uberaba e Várzea da Palma. Belo Horizonte parou em 25/03/2026 e Uberlândia em 05/03/2026. Outras 35 (entre elas Juiz de Fora, Montes Claros, Ipatinga, Divinópolis e Sete Lagoas) estão listadas sem nenhum diário. A página do perfil mostra a situação de cada cidade da pessoa.

O que fica de fora, de propósito:

• Sites das bancas: só seriam lidos com termos de uso que permitam ou com RSS oficial, e nenhuma passou. Os termos da FGV proíbem ferramentas automatizadas e a reprodução do conteúdo; o IBFC bloqueia acesso automático; Cebraspe, Fundep, Vunesp e Consulplan não publicam termos de uso nem RSS (o robots.txt liberar robôs não é autorização para usar os dados).
• PCI Concursos e outros agregadores, que proíbem copiar os dados.
• Concursos estaduais e de cidades fora do Querido Diário entram pelo cadastro manual e pelo Ler edital.

Nota de compatibilidade (regras em src/features/concursos/search/score.ts, sem IA): cargo e área 40 pontos, escolaridade 20, local 20, salário 10, banca preferida 10. Ficam de fora, em vez de ganhar nota baixa: inscrições encerradas, esfera fora do perfil, escolaridade acima da pessoa e outra cidade ou estado para quem não aceita mudar. Salário abaixo do mínimo vira aviso. Só entram editais com nota a partir de 55, no máximo 30 novos por busca.

Quando roda:

• Todo dia cedo, pelo Cron da Vercel (/api/cron/concursos, às 6h de Brasília): lê o DOU uma vez, consulta o Querido Diário nas cidades de todos os perfis, grava no catálogo e dá a nota para cada perfil. Precisa da SUPABASE_SECRET_KEY, porque só o cron grava no catálogo.
• Ao abrir Concursos sugeridos, se a última busca foi há mais de 20 horas, e no botão Buscar agora, no máximo uma vez a cada 2 minutos. Sem a chave secreta, essas buscas dão a nota só com o catálogo que já existe.

No resto do app: a agenda dos concursos aparece no painel (alertas de inscrição, isenção e boleto vencendo em 7 dias, e as próximas datas), as tarefas dos concursos entram em Próximos prazos, e o resumo diário e o comando concursos do WhatsApp trazem os prazos da semana e os concursos novos. O link Quais órgãos federais mais abrem vagas? leva ao Radar de carreira, outro projeto com dados públicos.

Rodar localmente

Requisitos: Node.js 20.9 ou mais novo e um projeto no Supabase (seção acima).

npm install
cp .env.example .env.local   # e preencha as chaves
npm run dev                  # http://localhost:3000

Comando	O que faz
npm run dev	Servidor de desenvolvimento
npm run build / npm start	Build e servidor de produção
npm test	Roda os testes (Vitest)
npm run lint	ESLint
npm run typecheck	Checagem de tipos do TypeScript
npm run seed:demo	Cria ou recria a conta de demonstração

Testes

Os testes cobrem as partes que mais importam:

• Criação: validação do formulário (mensagens em português, link, valor em reais, datas, tipo de vaga) e a Server Action createApplication (grava para o usuário certo, não toca no banco com dados inválidos, traduz erros do banco).
• Mudança de etapa: a Server Action moveApplication (filtra pelo dono, recusa etapa inválida, posição padrão no topo), a edição pelo formulário e a lógica do Kanban (mover, reordenar, desfazer).
• Métricas: etapa mais avançada, funil, taxa de resposta, aprovação por etapa, plataformas e ritmo semanal, incluindo os casos sem dados.
• Resumo diário e WhatsApp: prazos, novidades, vagas paradas e números do resumo; o e-mail escapa o texto do usuário; os comandos do assistente, a vinculação por código, a empresa citada, a mensagem encaminhada que vira sugestão, mensagens repetidas ignoradas, a assinatura da Meta e as rotas /api/report e /api/whatsapp/webhook.
• Caça-vagas: a leitura de cada fonte no formato real (Gupy, Greenhouse e Lever), nomes de empresas, estados e cidades, tipo e nível pelo título ("Internal Audit" não é estágio), a nota e cada motivo para deixar uma vaga de fora, a busca com fonte fora do ar, o reaproveitamento dos downloads no cron, vagas já sugeridas ou já no quadro, o perfil e a candidatura criada a partir da vaga. Bolsa, horário e benefícios, inclusive os falsos positivos ("bolsa de valores", "de 1 a 3 anos", plano de saúde na apresentação da empresa), e a descrição do Greenhouse baixada depois.
• Currículo: o PDF de exemplo lido de ponta a ponta, habilidades, idiomas, curso e situação, cidade, o que não é guardado (nome, e-mail, telefone), a nota com as habilidades, os avisos de idioma, e a rota /api/curriculo (grava na pasta da pessoa, recusa arquivo que não é PDF e a conta demo).
• Automação: o leitor de mensagens (confirmação da Gupy e do LinkedIn, reprovação, teste, entrevistas, case, proposta, aprovação, mensagem colada do WhatsApp, alertas de vagas ignorados, datas), a escolha da candidatura e da etapa (nunca para trás) e a rota que recebe os e-mails.
• Conta demo protegida: o reset (ensureDemoUser e a rota /api/cron/reset-demo) registra a senha oficial antes de redefini-la, nasce protegida quando é criada, não segue adiante se a proteção falhar e recoloca o currículo fictício. Com SUPABASE_INTEGRATION=1 npm test, um teste extra entra na demo de verdade com a chave pública, como um visitante, e confere que updateUser não troca senha nem e-mail.
• Concursos: o leitor de edital com trechos reais de cinco editais do DOU (datas em tabela, por extenso e em intervalos, datas de leis que não são do cronograma, cargos, banca, salário, taxa e vagas) e a rota que baixa o link (endereços internos recusados, PDF e página do DOU); a leitura do XML real do DOU e de uma resposta real do Querido Diário salvos em arquivos (nomes e CPFs mascarados); a nota e cada motivo de exclusão; mudança de etapa com desfazer; dias até a prova; progresso das matérias; a agenda (alertas que somem quando a inscrição já foi feita ou a taxa paga); o (fuso, dia inteiro, lembretes, linhas de até 75 bytes); o CSV; e os concursos e sugestões de exemplo da demo.

O CI roda npm ci, lint, testes e build a cada push e pull request, com variáveis de ambiente falsas (o build não acessa o Supabase).

Deploy na Vercel

1. Suba o projeto para um repositório no GitHub.
2. Em vercel.com, clique em Add New → Project e importe o repositório. A Vercel detecta o Next.js sozinha, então não precisa mudar nada no build.
3. Em Environment Variables, adicione as mesmas variáveis do .env.local:
   • NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY (obrigatórias)
   • NEXT_PUBLIC_SITE_URL = https://SEU-APP.vercel.app
   • SUPABASE_SECRET_KEY (conta demo, assistente do WhatsApp, busca diária de vagas e catálogo de concursos)
   • INLABS_EMAIL, INLABS_PASSWORD (opcionais: o DOU pelo INLABS no caça-concursos)
   • DEMO_EMAIL, DEMO_PASSWORD (conta demo)
   • CRON_SECRET: um valor aleatório longo (por exemplo, gerado com openssl rand -hex 32)
   • NEXT_PUBLIC_GOOGLE_AUTH_ENABLED=true (se configurou o Google)
   • As variáveis WHATSAPP_* e NEXT_PUBLIC_WHATSAPP_BOT_NUMBER (se for usar o assistente do WhatsApp)
4. Clique em Deploy.
5. Com o endereço final em mãos, volte ao Supabase (Authentication → URL Configuration) e coloque-o como Site URL, com https://SEU-APP.vercel.app/auth/callback nas Redirect URLs. Se usa Google, adicione o domínio também nas origens autorizadas do Google Cloud.
6. O arquivo vercel.json já agenda os três crons diários: a restauração da conta demo, a busca de vagas e a busca de concursos. Como o CRON_SECRET está definido, a Vercel envia esse valor no cabeçalho e as rotas aceitam a chamada. O plano grátis da Vercel permite crons uma vez por dia. O mesmo arquivo coloca o servidor em São Paulo (gru1), perto do banco do Supabase: se o seu projeto do Supabase estiver em outra região, troque por uma próxima dele.
7. No plano grátis, o Supabase pausa o projeto depois de uma semana sem uso. Os crons diários (com a SUPABASE_SECRET_KEY configurada) e o script do Gmail mantêm o banco ativo. Se pausar, reative em Project → Restore no painel do Supabase.

Variáveis NEXT_PUBLIC_ são embutidas no build. Se mudar alguma depois, faça um novo deploy (Deployments → ⋯ → Redeploy).

Decisões e próximos passos

• Etapas fixas em vez de personalizáveis: deixam o funil e as métricas bem definidos. Para permitir etapas próprias, o caminho seria uma tabela stages por usuário com uma "categoria" que as métricas continuariam usando.
• Cache Components (Next.js 16): a moldura das páginas (menu, títulos) é pré-renderizada e aparece na hora; os dados do usuário chegam por streaming, com esqueletos no lugar.
• Concursos em tabelas próprias, e não como um tipo de candidatura: as etapas, o cronograma e as matérias não cabem no modelo de vaga, e o funil das candidaturas continuaria misturado. O que é igual (Kanban, linha do tempo, tarefas) é reaproveitado: o quadro é genérico e as tarefas têm application_id ou concurso_id.
• Currículo lido por regras, sem IA: grátis, explicável e funciona na demo e no CI sem nenhuma chave. Uma IA entenderia currículos mais variados, mas precisaria de uma chave paga e mandaria o texto do currículo para fora. A leitura fica numa função só (extractResume), fácil de trocar.
• Ideias para o futuro: lembretes por e-mail dos prazos, guardar qual versão do currículo foi enviada para cada vaga, currículo em Word (.docx), contatos de recrutadores e importação de vagas por link.

Licença

MIT. A fonte Geist, em assets/fonts, é distribuída pela Vercel sob a SIL Open Font License.