Pular para conteúdo

Auditoria de prontidão — SotuHire v0.4

Escopo

Auditoria da entrega conjunta:

v0.2 — UX/UI e automação básica
v0.3 — IA estruturada, Resume Tailor e exports
v0.4 — tracker local, histórico e dashboard

Baseline

Antes desta evolução:

  • arquivos rastreados: 152;
  • Markdown rastreados: 74;
  • testes: 39 passed;
  • Ruff: passou;
  • MkDocs strict: passou;
  • Streamlit health check: ok.

Auditoria inicial

Gaps encontrados:

  • interface parecida com formulário de teste;
  • preenchimento manual excessivo;
  • sem parser de vaga;
  • currículo limitado a TXT;
  • sem provider estruturado/fallback;
  • Resume Tailor sem bullets/evidências explícitas;
  • sem exports;
  • sem histórico;
  • sem tracker funcional;
  • sem dashboard.

Gaps corrigidos

  • interface guiada com seis abas;
  • modo rápido e avançado;
  • parsers TXT/PDF/DOCX e descrição de vaga;
  • revisão assistida;
  • mock provider e Gemini opcional;
  • exports JSON/Markdown;
  • tracker JSON local e privacidade explícita;
  • histórico, status e dashboard;
  • testes obrigatórios adicionados.

Segurança e limites

  • nenhum auto-apply;
  • nenhum envio automático para recrutador;
  • nenhum scraping agressivo;
  • nenhuma coleta privada/logada;
  • PyTorch fora das dependências obrigatórias;
  • Concurso Mode continua futuro experimental;
  • texto bruto do currículo não é salvo no histórico.

Docs auditados

README, CHANGELOG, MkDocs, docs index, roadmap, implementação v0.1, regras do Resume Tailor e Opportunity Fit, provider strategy e Gemini Structured Output foram expandidos.

Resultado final

Resultados medidos no fechamento:

  • versão entregue: 0.4.0;
  • arquivos rastreados: 184;
  • Markdown rastreados: 80;
  • arquivos Markdown em docs/: 77;
  • Markdown existentes reduzidos: 0;
  • links internos locais quebrados: 0;
  • docs fora da navegação MkDocs: 0;
  • Ruff check: passou;
  • Ruff format check: 86 arquivos formatados;
  • pytest: 59 passed;
  • MkDocs strict build: passou;
  • Streamlit AppTest: 6 abas, 0 exceptions;
  • Streamlit headless health check: ok.

Comandos executados:

ruff format .
ruff check .
ruff format . --check
python -m pytest -q
mkdocs build --strict
streamlit run app.py --server.headless=true

Verificações adicionais:

BROKEN_LINKS=0
DOCS_OUTSIDE_NAV=0
REDUCED_MARKDOWN=0

Arquivos e módulos adicionados

  • schemas e parsers de currículo/vaga;
  • providers mock e Gemini opcional;
  • structured analysis e exporters;
  • storage local e modelos;
  • tracker, status e dashboard;
  • testes obrigatórios;
  • seis novos documentos de arquitetura/desenvolvimento/auditoria.

Decisão de versão

As três etapas foram concluídas, documentadas e testadas:

  • v0.2 UX/parsers: concluída;
  • v0.3 structured AI/exports: concluída;
  • v0.4 tracker/histórico/dashboard: concluída.

Portanto, a versão real entregue é v0.4.0.

Próximos passos

  1. validar parsers com fixtures fictícias diversas;
  2. adicionar filtros e tendências ao dashboard;
  3. avaliar RAG simples de carreira;
  4. manter automações futuras assistivas e revisáveis.