$ cat ~/projetos/code-analyzer-ai/CASE.md
Code Analyzer AI
API Java para revisão de código assistida por IA local.
- Status
- em desenvolvimento
- Papel
- Projeto pessoal — desenvolvimento e integração de funcionalidades
- Java
- Spring Boot
- WebFlux
- Ollama
- SSE
- OpenAPI
O problema
Revisar código envolve identificar problemas e explicar possíveis melhorias. O projeto transforma essa análise em uma API que pode ser integrada a outras ferramentas de desenvolvimento.
Implementação
Controllers recebem as requisições e serviços separam detecção de linguagem, análise e comunicação com o Ollama. DTOs organizam entradas, resultados e erros.
As respostas apresentam problemas, severidades e sugestões de alteração. Um endpoint SSE transmite a saída progressivamente, enquanto Swagger/OpenAPI documenta o contrato da API.
As avaliações são sugestões geradas por um modelo de linguagem e precisam de revisão humana; não substituem testes ou análise estática.
Decisões técnicas
- 01
IA local com Ollama
Permite executar a análise com um modelo no ambiente configurado pelo desenvolvedor.
- 02
Serviços e contratos separados
A divisão entre controller, DTOs e serviços facilita entender o fluxo e alterar integrações.
O que dá para verificar
- API
- Endpoints de análise, streaming, detecção de linguagem e health check.
- Documentação
- Swagger/OpenAPI e exemplos de requisição no README.
- Stack
- Java 17, Spring Boot e WebFlux.
- Erros
- Handler global e exceções específicas para integração com IA.
Competências desenvolvidas
O projeto aplica fundamentos de Java e Spring em um serviço integrado a LLMs, com atenção a contratos de API, tratamento de falhas e entrega progressiva de respostas.