Skip to content

README.md

Latest commit

 

History

History
126 lines (106 loc) · 2.82 KB

README.md

File metadata and controls

126 lines (106 loc) · 2.82 KB

ATSFlow Engine

Ferramenta gratuita da AI Career Suite para análise de currículo com foco em compatibilidade ATS.
Projeto de portfólio: simples, explicável e pronto para demonstração técnica.

O que o app entrega

  • Score ATS com pesos fixos e transparentes
  • Diagnóstico de estrutura, legibilidade e força de conteúdo
  • Palavras-chave encontradas e ausentes
  • Sugestões objetivas de melhoria
  • Relatório em Markdown
  • Histórico local das análises

Princípios do projeto

  • Sem microserviços
  • Sem autenticação
  • Sem billing
  • Sem filas
  • Backend simples e organizado para entrevista técnica

Stack

  • Node.js + Express
  • SQLite por padrão
  • Postgres/Supabase via DATABASE_URL
  • Parser de PDF
  • Frontend leve servido pelo backend

Arquitetura

src/
  app.js
  server.js
  config/
  controllers/
  routes/
  services/
  engines/
  repositories/
  helpers/
  utils/
  middlewares/
  prompts/
  lib/llm/
  public/

Responsabilidades:

  • controllers: entrada HTTP e validação básica
  • services: orquestração do fluxo
  • engines: regras de negócio (scoring/heurísticas)
  • repositories: persistência (SQLite/Postgres)
  • lib/llm: providers e fallback

Scoring ATS

Pesos usados no score final:

  • keyword_match_score: 40%
  • structure_score: 25%
  • readability_score: 20%
  • content_strength_score: 15%

LLM (com fallback resiliente)

Ordem de execução:

  1. Groq (llama-3.1-8b-instant)
  2. Ollama local (llama3.1:8b)
  3. Fluxo determinístico/heurístico

Se o LLM falhar, o app continua funcionando.

Endpoints

  • GET /health
  • GET /
  • POST /api/v1/analyze-text
  • POST /api/v1/analyze-pdf
  • GET /api/v1/analyses
  • GET /api/v1/analyses/:id
  • GET /api/v1/analyses/:id/report
  • POST /api/v1/feedback

Rodar localmente

npm install
npm run dev

Padrão: http://localhost:3001

Variáveis de ambiente

Use .env.example como base:

PORT=3001
DATABASE_URL=
SQLITE_DB_PATH=data/atsflow.db
LLM_PROVIDER=groq
GROQ_API_KEY=
GROQ_MODEL=llama-3.1-8b-instant
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama3.1:8b
LLM_TIMEOUT_MS=30000

Supabase (opcional)

Se definir DATABASE_URL, o app usa Postgres/Supabase.
Se não definir, usa SQLite local automaticamente.

Exemplo:

DATABASE_URL=postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:5432/postgres?sslmode=require

Deploy (Render)

  • Build command: npm install
  • Start command: npm start
  • Configurar no serviço:
    • DATABASE_URL (opcional)
    • GROQ_API_KEY (opcional)

render.yaml já incluído no repositório.

Limitações conhecidas

  • Não garante aprovação em vagas
  • Extração de PDF pode variar conforme o arquivo
  • A resposta da IA pode variar em estilo

Licença de uso do projeto

Projeto de portfólio para demonstração e uso gratuito.