Produção: https://match-cv-app.vercel.app/
Plataforma web para candidaturas a vagas de TI. Dá para usar sem login. O usuário envia o currículo em PDF e a descrição da vaga, escolhe um provedor de IA, informa a própria API key e recebe cinco materiais:
- CV em PDF compatível com ATS, alinhado à vaga
- E-mail para a empresa (com botão de copiar)
- Cover letter (com botão de copiar e conversão para PDF)
- Roteiro de entrevista em seções expansíveis
- Faixa salarial estimada, com as fontes citadas e um link para o Glassdoor
O modelo é BYOK (bring your own key): cada usuário paga o próprio uso de IA. Sem conta, a chave fica na memória da página (ou, se o usuário pedir, num cookie cifrado). Com conta, a chave e as candidaturas podem ir para o Postgres. A arquitetura está em docs/auth-architecture.md.
Por padrão só o CV vem marcado. E-mail, cover letter, entrevista e faixa salarial são gerados pelo botão Gerar de cada aba. O usuário ainda pode marcar mais de um antes de começar.
| Camada | Escolha |
|---|---|
| Framework | Next.js 16 (App Router, Route Handlers em src/app/api) |
| UI | React 19, TypeScript, Tailwind CSS 4, shadcn/ui (Base UI), lucide-react |
| Runtime | Node.js 24 LTS (mínimo 22, exigido pelo AI SDK 7) |
| IA | Vercel AI SDK 7 (ai) com @ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google e @ai-sdk/openai-compatible |
| Schemas | Zod 4 + Output.object |
| Leitura do CV | unpdf (só PDF com texto) |
@react-pdf/renderer no navegador, com prévia em blob |
|
| Salário | Busca nativa do provedor na web pública e link de referência do Glassdoor |
| Telemetria | @vercel/otel, @langfuse/otel opcional e @sentry/nextjs opcional |
| Conta | Better Auth + Drizzle sobre Postgres, só quando DATABASE_URL e BETTER_AUTH_SECRET existem |
| Testes | Vitest |
| Hospedagem | Vercel |
MatchCV/
├─ .env.example
├─ favicon.ico # pedido na raiz; o Next não serve este arquivo sozinho
├─ next.config.ts # headers de segurança e proxyTimeout
├─ src/
│ ├─ instrumentation.ts # OpenTelemetry no Node e init do Sentry
│ ├─ instrumentation-client.ts
│ ├─ sentry.server.config.ts
│ ├─ sentry.edge.config.ts
│ ├─ proxy.ts # CSP com nonce; /monitoring fica de fora
│ ├─ app/
│ │ ├─ favicon.ico # ícone que o Next serve
│ │ ├─ icon.png
│ │ ├─ apple-icon.png
│ │ ├─ page.tsx # Home
│ │ ├─ gerar/page.tsx # formulário, processamento e resultados
│ │ └─ api/
│ │ ├─ key/validate/
│ │ ├─ parse/
│ │ ├─ brief/ # perfil curto do CV e resumo da vaga
│ │ ├─ generate/[artifact]/
│ │ ├─ cv/pdf/
│ │ ├─ salary/
│ │ └─ verify/ # nota CV × vaga e checagem de fidelidade
│ ├─ components/matchcv/
│ ├─ lib/
│ │ ├─ ai/ # catálogo, buildModel, telemetria
│ │ ├─ client/
│ │ ├─ pdf/
│ │ ├─ salary/
│ │ ├─ verification/ # nota CV × vaga e checagem de fidelidade
│ │ ├─ schemas/
│ │ ├─ security/
│ │ └─ text/
│ └─ prompts/
└─ vitest.config.mts
O favicon.ico da raiz do repositório não é servido pelo Next. O ícone da aba é o de src/app/favicon.ico (os mesmos bytes: 16, 32, 48, 64 e 256). A arte parte de src/lib/brand/mark.svg.
Pré-requisitos: Node.js 24 (o .nvmrc aponta para ele; o mínimo é 22) e npm.
npm install
cp .env.example .env.local
npm run devAbra http://localhost:3000.
| Comando | O que faz |
|---|---|
npm run lint |
ESLint |
npm run typecheck |
Gera os tipos de rota e roda o tsc |
npm test |
Vitest |
npm run build / npm start |
Build e servidor de produção |
As chaves de IA não ficam no .env. Cada usuário digita a própria chave no formulário.
-
No seletor: Google, OpenRouter, OpenAI, Anthropic e Together. Cada modelo tem badge Gratuito ou Pago. O padrão inicial é o Gemini gratuito (
gemini-3.8-flash). O filtro "Mostrar apenas gratuitos" esconde o que exige plano pago. A lista está emsrc/lib/ai/catalog.ts. -
No navegador: a chave fica no estado do React. "Lembrar nesta aba" usa
sessionStoragee some ao fechar a aba. O app não usalocalStorage. Um UUID anônimo separado (matchcv:anon-session) identifica a sessão na telemetria. -
No envio: a chave vai no corpo de um POST para as rotas
/apido próprio app, nunca na URL. -
No servidor:
buildModel(provider, modelId, apiKey)cria o provider dentro do handler, a cada request. AsbaseURLde Together e OpenRouter são fixas. A chave não é logada, persistida nem devolvida. -
Modo de exemplo: com
MATCHCV_ENABLE_AIdiferente detrue, as rotas devolvem dados fictícios. Para ligar as chamadas reais:MATCHCV_ENABLE_AI=true
As gerações de texto rodam com concorrência 2 (1 no Google), retry em 429 e 5xx, e um prazo de 100 s. Se o modelo gratuito estoura o prazo, a rota devolve JSON 504 com a mensagem "O modelo gratuito demorou demais ou atingiu o limite. Tente outro modelo."
POST /api/brief roda antes de qualquer material: CV, faixa salarial, e-mail, cover letter ou entrevista. O resultado fica no estado do fluxo, no navegador, e as gerações seguintes da mesma sessão reutilizam esse objeto, inclusive o botão Gerar de cada aba. Nada disso é gravado no servidor.
O brief traz contato, senioridade, anos de experiência, cargo canônico para busca (normalizedSearchTitle), modelo de trabalho e empresa só quando o nome real da contratante está na vaga. O CV ATS continua recebendo o texto bruto do currículo e usa o brief como mapa da vaga. O nome do PDF usa a empresa do brief e só cai no regex se esse campo vier vazio.
Os prompts de CV, cover letter e e-mail incluem src/prompts/anti-ai-rules.ts. Depois da geração, src/lib/text/humanize-validator.ts corrige o que é seguro e, se ainda houver violação, pede uma reescrita. A entrevista não passa por esse validador.
- A busca usa primeiro o cargo, a empresa, a senioridade e o local extraídos no brief. O regex de
analyzeJobsó preenche o que veio vazio e ignora cabeçalho genérico, menção solta no meio da vaga e falso positivo de empresa (América Latina,Brasil,Time de ...,Nossa Equipe,Scale). - Com a IA ligada, OpenAI, Anthropic e Google usam a busca nativa. O OpenRouter usa o sufixo
:online(atalho do plugin web) no modelo de salário. Se o modelo não devolver citação estruturada, a faixa numérica ainda entra e o link só aparece quando há URL citável. Together continua sem busca na web. - Sem números, a rota responde 200 com "faixa não disponível". Não é erro.
- O link do Glassdoor aparece sempre. É uma busca por palavra-chave em
glassdoor.com.br(Salários/<termo>-salário-SRCH_KO0,N.htm), com o cargo na frente da empresa. O app não raspa o Glassdoor e não busca o id interno da empresa. - Com
MATCHCV_ENABLE_AIdiferente detrue,/api/salarydevolve um exemplo e não consulta a web.
A tela de resultados mostra a nota de 0 a 100 (cobertura dos requisitos, palavras-chave, senioridade e experiências do CV original) e o status de cada afirmação gerada: com apoio, sem apoio ou em conflito com o currículo. POST /api/verify faz essa conta no servidor.
Sem TYPESAFE_API_KEY, a checagem é local e em português. Com a chave, a nota e o status passam pela API do Jev (https://api.typesafe.ai/v1/systemone). Se essa chamada falhar, o verificador local assume. A chave não sai do servidor e entra no mascaramento de redactSecrets.
Cada generateText liga experimental_telemetry com recordInputs e recordOutputs desligados. Não há streamText no app. O span e o log levam só cinco campos: sessão anônima, provedor, modelo, artefato e tentativa. Currículo, vaga, chave e IP não entram.
A sessão vai no header x-matchcv-session. A tentativa vai em x-matchcv-attempt.
src/instrumentation.ts registra o OpenTelemetry com @vercel/otel. Na Vercel, os spans aparecem em Observability. O uso de tokens sai no log da função como uma linha JSON com "event":"model_usage". Dá para filtrar por esse texto em Logs.
O Langfuse só é criado se LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY e LANGFUSE_BASEURL existirem. Sem as três, o exporter não sobe. Quando sobe, mascara padrões de chave e só exporta spans com o atributo matchcv.artifact.
As chamadas de saída para OpenAI, Anthropic, Google, Together, OpenRouter e Sentry ficam de fora do tracing de fetch, para os headers de autorização não virarem span.
O Sentry é opcional. Sem SENTRY_DSN e NEXT_PUBLIC_SENTRY_DSN, o SDK não inicializa e o app funciona como antes. O build não precisa de SENTRY_AUTH_TOKEN: o upload de source maps só acontece quando o token existe.
O @vercel/otel continua dono do tracing no Node. O Sentry não registra um segundo provider (enableOpenTelemetrySetup: false) e não define tracesSampleRate nesse runtime, para não duplicar span. Com DSN, os spans que o OpenTelemetry já cria seguem também para o Sentry por OTLP, na taxa SENTRY_TRACES_SAMPLE_RATE (padrão 0.1). No browser e no edge a mesma taxa vai em tracesSampleRate. Não há Session Replay.
O browser envia eventos para /monitoring no próprio app (tunnelRoute). A CSP permanece connect-src 'self'. O src/proxy.ts não intercepta essa rota.
beforeSend, beforeSendTransaction e beforeSendSpan removem Authorization, x-api-key, x-goog-api-key, apiKey, app_key, cookies, o corpo do request e o texto do CV e da vaga, com o mesmo redactSecrets dos logs. O SDK 11 não tem mais sendDefaultPii; dataCollection deixa IP, cookies, corpos e texto de IA desligados.
Erros das rotas /api/generate, /api/brief, /api/salary, /api/parse, /api/cv/pdf, /api/key/validate e /api/verify passam por logApiError, que envia ao Sentry as tags route, artifact, provider e model. A chave não entra. src/app/global-error.tsx captura erro de render do App Router.
O projeto já existe na org amador-gabriel-rc, com o nome match-cv (SaaS, sentry.io). SENTRY_DSN e NEXT_PUBLIC_SENTRY_DSN já estão na Vercel. Para o npm run dev local, copie o DSN do projeto para o .env.local:
SENTRY_DSN=https://…@….ingest.sentry.io/…
NEXT_PUBLIC_SENTRY_DSN=https://…@….ingest.sentry.io/…
SENTRY_ORG=amador-gabriel-rc
SENTRY_PROJECT=match-cv
withSentryConfig usa SENTRY_ORG e SENTRY_PROJECT quando existem. Sem elas, o fallback é amador-gabriel-rc e match-cv. O DSN e o SENTRY_AUTH_TOKEN não ficam no código.
- Opcional: em Settings → Auth Tokens, crie um token com
project:releaseseorg:reade definaSENTRY_AUTH_TOKENpara o build enviar source maps. Sem o token,npm run buildtermina do mesmo jeito e só não publica os mapas. - Opcional:
SENTRY_TRACES_SAMPLE_RATE=0.1eNEXT_PUBLIC_SENTRY_TRACES_SAMPLE_RATE=0.1. - Reinicie o
npm run dev.
Com o DSN preenchido, o erro precisa nascer no app. O console do navegador não conta.
No cliente, um botão temporário em qualquer componente com "use client":
<button type="button" onClick={() => { throw new Error("Sentry Test Error"); }}>
Testar Sentry
</button>No servidor, um throw new Error("Sentry server test") temporário dentro de um route handler. Erros já capturados pelas rotas de API aparecem com as tags de rota, artefato, provedor e modelo. Tire o código de teste antes de commitar. O evento deve chegar em Issues sem a chave, sem cookie e sem o texto do CV.
- Importe o repositório em https://vercel.com/new.
- Para IA real, cadastre
MATCHCV_ENABLE_AI=true. Langfuse é opcional. O Sentry liga comSENTRY_DSNeNEXT_PUBLIC_SENTRY_DSN(já presentes na Vercel).SENTRY_ORGeSENTRY_PROJECTsão opcionais: sem elas o build usaamador-gabriel-rcematch-cv.SENTRY_AUTH_TOKENsó entra se o build for enviar source maps. - Para o rate limit durável, crie o Redis Upstash no Marketplace e conecte a este projeto. O passo a passo está na seção seguinte. Sem essas variáveis o limite continua em memória.
- Use Node.js 24.
O plano Hobby é gratuito e vale para uso pessoal e não comercial.
- CSP com nonce em
src/proxy.ts(connect-src 'self',frame-src 'self' blob:,object-src blob:).style-srcainda temunsafe-inline. O túnel/monitoringdo Sentry fica fora do proxy. Os outros headers de segurança ficam emnext.config.ts. - A saída do modelo é texto puro, sem
dangerouslySetInnerHTML. - Rate limit por IP em todas as rotas de API. Com Upstash Redis a janela deslizante vale entre instâncias. Sem as variáveis, ou se o Redis falha, o limite em memória desta instância assume.
logApiErrorelogApiWarningmascaramsk-,sk-ant-,sk-or-,AIza,Bearer,app_key,TYPESAFE_API_KEY, URLspostgres://e os valores deDATABASE_URL,BETTER_AUTH_SECRETeKEY_ENCRYPTION_SECRET, além dos segredos passados na chamada. A resposta de erro não devolve a chave nem o corpo.
As rotas /api contam pedidos por IP no Upstash Redis (REST, @upstash/redis e @upstash/ratelimit) quando as credenciais existem. A janela é deslizante e o contador é o mesmo em todas as instâncias. A chave é matchcv:rl:<rota>:<hash>. O IP em claro não vai para o Redis: o que entra é o SHA-256, com o sal RATE_LIMIT_IP_SALT quando ele existe.
A chamada sai da Vercel Function. A CSP da página continua com connect-src 'self'. A URL do Upstash não entra nela.
- No projeto da Vercel, abra Storage (ou Integrations) e escolha Upstash Redis no Marketplace. Pelo CLI:
vercel integration add upstash. - Conecte o banco a este projeto, em Production e Preview. A integração grava as variáveis.
- O app lê o par
KV_REST_API_URLeKV_REST_API_TOKEN, que é o nome usado pela integração do Marketplace. Se esse par não estiver completo, lêUPSTASH_REDIS_REST_URLeUPSTASH_REDIS_REST_TOKEN. Um par não completa o outro. - Opcional: defina
RATE_LIMIT_IP_SALTcom uma string longa e aleatória. Sem ela o hash ainda acontece, só que sem sal. - Faça um novo deploy. No ambiente local, copie as variáveis para o
.env.localse quiser exercitar o Redis. Sem elas,npm run deve os testes usam o limite em memória.
Se o Redis falhar ou não responder em 1,5 s, a rota continua no ar. O limite em memória desta instância entra no lugar e o log recebe um aviso rate_limit_fallback, já passado pelo mascaramento.
Ao estourar o limite a resposta é HTTP 429, com header Retry-After e o JSON { "error": { "code": "rate_limited", "message": "Muitas requisições. Tente de novo em instantes." } }.
| Rota | Prefixo | Pedidos na janela de 60 s | O próximo responde 429 |
|---|---|---|---|
/api/salary |
matchcv:rl:salary |
5 | 6º |
/api/parse |
matchcv:rl:parse |
20 | 21º |
/api/brief |
matchcv:rl:brief |
20 | 21º |
/api/generate/[artifact] |
matchcv:rl:generate |
30 | 31º |
/api/cv/pdf |
matchcv:rl:cv-pdf |
30 | 31º |
/api/key/validate |
matchcv:rl:key-validate |
10 | 11º |
/api/verify |
matchcv:rl:verify |
20 | 21º |
/api/keys |
matchcv:rl:keys |
20 | 21º |
/api/applications |
matchcv:rl:applications |
30 | 31º |
/api/account |
matchcv:rl:account |
10 no DELETE, 30 no GET | o seguinte |
/api/auth |
matchcv:rl:auth |
30 | 31º |
Num disparo seguido, com a janela anterior vazia, o pedido da última coluna recebe 429. Perto da fronteira da janela, o peso da janela anterior também conta.
Opcional. Sem as variáveis, npm run dev e os testes seguem no modo anônimo.
- Better Auth (magic link, GitHub e Google) e Drizzle sobre Postgres quando
DATABASE_URLeBETTER_AUTH_SECRETexistem. O schema está emsrc/lib/db/schema.ts.npm run db:pushaplica as tabelas. - Chave salva com envelope AES-256-GCM. O navegador só vê provedor, últimos 4 caracteres e status. A decifragem fica no handler (
useSavedKey: true). Sem banco, a chave vai para o cookieHttpOnlymatchcv_key_vault. - Dashboard em
/dashboard: empresa, vaga, data, status (aplicado,entrevista,oferta,recusado), busca, anotações, os cinco materiais e exclusão. Sem sessão, a lista fica emlocalStorage. - LGPD: o menu Conta tem "Excluir conta e todos os dados (LGPD)".
DELETE /api/accountapaga usuário, sessões, chaves e candidaturas no banco e limpa o cofre local.
Variáveis: DATABASE_URL, BETTER_AUTH_SECRET, BETTER_AUTH_URL, KEY_ENCRYPTION_SECRET, KEY_ENCRYPTION_KEK_VERSION, KEY_ENCRYPTION_SECRET_PREVIOUS, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, RESEND_API_KEY, EMAIL_FROM. O exemplo está no .env.example.
- A
TYPESAFE_API_KEYé opcional e só serve para a checagem Jev. Sem ela, a nota CV × vaga continua local. - DOCX e PDF escaneado. O app aceita só PDF com texto e responde "Por enquanto só aceitamos CV em PDF." ou, no PDF sem texto, que o arquivo parece escaneado.