# Open Source Project Intelligence

Leia as evidências por trás de um projeto open source.

[HTML](https://leohteixeira.com/pt/projects/opensource-project-intelligence) · Leonardo Teixeira

## O produto

Open Source Project Intelligence coleta atividade de repositórios e transforma commits, issues, pull requests, releases e sinais de contribuidores em evidências sobre saúde, sustentabilidade, ritmo e risco de abandono. Catálogo e detalhes públicos convivem com ferramentas autenticadas de workspace e administração.

Stack: Go, React, TypeScript, PostgreSQL, NATS JetStream, S3, Valkey, OpenTelemetry

## O fluxo principal

1. **Coletar e normalizar** — Workers com concorrência limitada coletam atividade do GitHub por um adaptador e convertem os dados do provedor em registros canônicos, preservando evidências da coleta.

2. **Calcular sinais determinísticos** — Definições versionadas, janelas e datas de corte tornam as métricas reproduzíveis. Desconhecido, não aplicável e dados insuficientes são estados distintos; ausência nunca vira zero.

3. **Comparar e explicar** — Detalhes, comparações e execuções de IA governadas expõem evidências. Aprovação humana limita ações do assistente; exports preservam resultados duráveis.

## Arquitetura

```text
GitHub → adaptador de coleta → workers limitados → registros canônicos PostgreSQL
Outbox PostgreSQL → NATS JetStream · evidências → S3 · cache descartável → Valkey
React ↔ API Go versionada → métricas / comparações / execuções de IA governadas
```

### Núcleo Go modular

API e worker são binários separados com pacotes de negócio compartilhados. PostgreSQL mantém os dados duráveis; outbox transacional entrega pelo NATS JetStream. S3 guarda evidências e Valkey fornece aceleração descartável.

### Evidência antes da interpretação

O React usa um cliente HTTP versionado gerado. Métricas e sincronização são determinísticas; a indisponibilidade do modelo afeta a análise por IA, não esses cálculos.

## Disponibilidade e limites

Implementação em evolução, sem garantia sobre o futuro de um projeto. A disponibilidade de métricas depende das evidências e das janelas de coleta. Workspace e administração exigem autenticação. A demo pública só é exibida quando seu destino está configurado.

Demo pública não configurada.

[Código no GitHub](https://github.com/leohteixeira/opensource-project-intelligence)