Analisador de Contratos com IA
Na Biofy Technologies, inovação é o nosso core. Este desafio foi desenhado para avaliar suas habilidades em arquitetura backend e integração com Inteligência Artificial Generativa.
Não buscamos apenas código funcional, mas sim engenharia de software sólida. Queremos ver como você estrutura, documenta e resolve problemas complexos de forma elegante.
Objetivo da Missão
Desenvolver uma API RESTful (Python) que receba upload de contratos (.pdf/.docx), extraia insights vitais usando LLMs (Gemini/Groq) e armazene os dados estruturados para consulta rápida.
Upload
Ingestão de Arquivos
Processamento IA
Extração de Dados
Persistência
Armazenamento SQL
Requisitos Funcionais
Segurança & Acesso
O sistema deve ser fechado para o mundo exterior.
-
Rota
POST /loginpara gerar Token JWT. - Middleware de proteção (Bearer Token) nas rotas privadas.
Core: Upload & IA
O coração da aplicação. Extração inteligente de dados não estruturados.
Dados a extrair:
Consulta (Retrieval)
Rota GET /contracts/{id_ou_nome} para recuperar o JSON estruturado que foi salvo no banco.
Stack Recomendada
Ferramentas modernas para um problema moderno. Você tem liberdade de escolha, mas valorizamos o padrão de mercado.
Critérios de Sucesso
Clean Code & PEP8
Organização de pastas, nomes de variáveis significativos e type hints.
Design da API
Uso correto dos verbos HTTP (GET, POST), Status Codes (200, 201, 401, 422).
Prompt Engineering
A qualidade da instrução enviada à IA para garantir JSON válido e consistente.
Tratamento de Erros
A API não deve "explodir" com arquivos inválidos ou falhas na IA.
Pronto para Enviar?
1. Repositório
Código versionado, commits semânticos e estrutura clara.
2. Documentação
Um README.md que ensina como rodar seu projeto do zero.
- ✓ Pré-requisitos (Python, Docker?)
- ✓ Como configurar variáveis (.env)
- ✓ Exemplo de Request/Response
Bônus Points
Docker • Testes Automatizados • Frontend Simples