$ cat ~/projetos/jobpilot-ai/CASE.md
JobPilot AI
Busca de vagas, análise de currículo e acompanhamento de candidaturas em uma plataforma.
- Status
- em desenvolvimento
- Papel
- Projeto pessoal — desenvolvimento e integração de funcionalidades
- Python
- FastAPI
- Next.js
- PostgreSQL
- Celery
- Redis
- Docker
O problema
A busca por oportunidades envolve reunir vagas, comparar requisitos e acompanhar candidaturas em várias ferramentas. O projeto concentra esse processo em um fluxo único.
Implementação
A API em FastAPI reúne autenticação, vagas, currículos, agenda e candidaturas. O frontend em Next.js apresenta o pipeline e as análises em uma interface integrada.
Workers Celery executam ingestão de vagas, análises e notificações em segundo plano. PostgreSQL mantém os dados e Redis apoia filas e cache.
A análise pode usar um provedor de LLM ou um analisador local. A busca usa embeddings de API compatível ou vetorização local, com ranqueamento em NumPy. A demonstração pública utiliza dados capturados; upload, chat e coleta externa dependem do backend.
Decisões técnicas
- 01
Provedores intercambiáveis
A integração suporta OpenAI, Anthropic, Gemini, NVIDIA NIM, Ollama e OpenRouter. As chaves são criptografadas com Fernet antes da persistência.
- 02
Operação sem chave de API
O analisador local calcula compatibilidade e compõe textos com os dados disponíveis. Ele permite explorar o produto com resultados mais simples que os de um LLM.
O que dá para verificar
- Demonstração
- Interface navegável com dados de demonstração documentada no README.
- Qualidade
- README documenta testes de backend e CI com lint, build e gate de cobertura.
- Infraestrutura
- Docker Compose, migrations e guias de implantação.
- Autenticação
- Login, sessões e integração com LinkedIn OAuth.
Competências desenvolvidas
O projeto reúne prática de APIs, processamento assíncrono e integração com IA. O principal desafio de engenharia é manter as funções essenciais utilizáveis mesmo quando um provedor externo não está configurado.