How pi-grupo/aprova works
aPRova é um GitHub App para analisar mudanças de Pull Request em sandbox isolado, avaliar risco e produzir uma decisão auditável; o README ressalva que esta ainda é a fundação do produto. O fluxo principal vai do webhook à execução e avaliação pelo worker, com recibos assinados e publicação de resultados. A API também oferece consultas, verificação de recibos e ações remotas. O protótipo inclui visões gerais e fila de aprovação. O mapa usa chamadas visíveis nos trechos e relações descritas no README; subsistemas não amostrados aparecem apenas quando documentados, sem presumir suas ligações internas.
Main entry points: worker/main.go Worker · etapas.go Etapas de análise · api/main.go Servidor API · webhooks.go Webhooks PR
Components 21
Entrada e API
- Servidor API
cmd/api/main.go - Webhooks PR
internal/api/webhooks.go - Consultas de análise
internal/api/consulta_analises.go - Ações remotas
internal/acaoremota/contratotentativas/contrato.go
Análise e execução
- Worker
cmd/worker/main.go - Etapas de análise
internal/worker/etapas.go - Sandbox multi-linguagem
internal/sandbox/python/etapas.go
Risco e evidências
- Regras de risco
internal/calibracao/regra.go - Calibração histórica
internal/calibracao/calibrador.go - Recibos assinados
internal/receipt/conteudo.go - Verificador de recibos
cmd/verificar-recibo/main.go - Publicação no GitHub
internal/publicacao/publicador.go - Textos de decisão
internal/publicacao/textos.go - Envio SARIF
internal/sarif/envio.go
Dados e consultas
- Repositório PostgreSQL
internal/repository/postgres.go - Fila de trabalho
internal/repository/fila.go
Interface de análise
- Visão geral
design/prototipo/src/lib/visao-geral.ts - Mapa de calor
design/prototipo/src/componentes/MapaDeCalor.tsx - Lista da célula
design/prototipo/src/componentes/ListaDaCelula.tsx - Fila de aprovação
design/prototipo/src/telas/FilaDeAprovacao.tsx
Other components
- GitHub
Connections 17
- GitHub → Webhooks PR: envia webhook
README.md - Webhooks PR → Repositório PostgreSQL: registra PR
internal/api/webhooks.go - Worker → Etapas de análise: constrói motor
cmd/worker/main.go - Worker → Fila de trabalho: cria pool
cmd/worker/main.go - Etapas de análise → Sandbox multi-linguagem: executa testes
internal/worker/etapas.go - Etapas de análise → Regras de risco: avalia risco
internal/worker/etapas.go - Etapas de análise → Recibos assinados: emite recibo
internal/worker/etapas.go - Worker → Calibração histórica: configura calibração
cmd/worker/main.go - Worker → Publicação no GitHub: configura publicação
cmd/worker/main.go - Publicação no GitHub → Textos de decisão: formata decisão
internal/publicacao/textos.go - Worker → Envio SARIF: configura SARIF
cmd/worker/main.go - Envio SARIF → GitHub: envia SARIF
internal/sarif/envio.go - Servidor API → Consultas de análise: registra rotas
cmd/api/main.go - Servidor API → Repositório PostgreSQL: configura repositório
cmd/api/main.go - Verificador de recibos → Recibos assinados: verifica recibo
cmd/verificar-recibo/main.go - Visão geral → Mapa de calor: apresenta métricas
- Mapa de calor → Lista da célula: renderiza lista
design/prototipo/src/componentes/MapaDeCalor.tsx