CodexCode Validator

Qualidade de código medida, explicada e acompanhada.

Trabalho de Conclusão de Curso que reúne análise estática e revisão opcional por inteligência artificial para avaliar repositórios do GitHub.

Explorar aplicação em produção

O conteúdo permanece disponível sem JavaScript. Ative-o para usar os controles de idioma, tema e ampliação das capturas.

01 / Visão geral

Do achado isolado à avaliação do repositório.

O Codex organiza sinais de lint, segurança, complexidade, testes e documentação em uma avaliação de 0 a 1000, acompanhada de um relatório. A nota sintetiza o resultado; os achados e as recomendações oferecem contexto para a revisão humana. Não é uma certificação de qualidade.

02 / Funcionalidades

Recursos implementados.

Autenticação com GitHub e seleção de repositórios; endpoint da API para análise de URL pública sem login.
Análise estática por linguagem e revisão opcional com Gemini, Claude ou OpenRouter.
Progresso por SSE, com alternativa de acompanhamento por polling.
Relatório com score, indicadores de qualidade e achados filtráveis por origem e severidade.
Comparação entre base e head de pull requests.
Histórico e cache por commit com PostgreSQL configurado; reanálise de pushes em repositórios públicos por webhook configurado.

03 / Funcionamento

Do repositório ao relatório.

Preparar

O pedido entra na fila. O backend faz a verificação de tamanho, clona o repositório temporariamente e consulta o cache pelo commit.
Analisar

As ferramentas estáticas produzem achados e métricas; os metadados são consultados na API do GitHub.
Revisar

Quando habilitada, a IA recebe métricas e amostras de código para elaborar a revisão qualitativa.
Apresentar

O frontend exibe o relatório. A nota híbrida combina 40% da análise estática e 60% da revisão; sem IA, usa a nota estática.

04 / Arquitetura e tecnologias

Interface, processamento e persistência.

Frontend

Next.js 15, React 19, TypeScript, Tailwind CSS e ícones lucide-react. Interface para repositórios, jobs, relatórios e comparações.

Backend

Python, FastAPI, Uvicorn, httpx e asyncio. Análise com ruff, bandit e radon para Python, Biome para JavaScript/TypeScript e golangci-lint para Go quando disponível.

Integrações

GitHub OAuth e REST API, provedores de IA opcionais e PostgreSQL com asyncpg. Docker Compose organiza frontend, backend e banco.

Tokens ficam no servidor e os clones temporários são removidos após o processamento. Sessões e jobs são mantidos em memória; sem banco, não há persistência de histórico ou cache. Ferramentas ausentes são sinalizadas no resultado.

05 / Demonstração visual

Capturas reais da página pública.

As telas abaixo mostram a apresentação publicada. Os exemplos de repositórios, achados e notas são demonstrativos, não resultados de análises autenticadas.

Página pública do Codex com proposta e demonstração do pipeline — Visão geral: análise estática e revisão por IA.

Explicação do fluxo de conexão com GitHub, análise estática e revisão por IA — Pipeline: três etapas integradas.

Apresentação de sugestões, comparação de PRs, histórico e achados com exemplos demonstrativos — Recursos: exemplos demonstrativos do relatório.

Simulador público da nota de qualidade na escala de 0 a 1000 — Score: simulador público, não uma análise real.