Skip to content

feat: ingestão de contribuições do GitHub e retrospectiva da comunidade#304

Draft
Clintonrocha98 wants to merge 1 commit into
4.xfrom
feat/community-retrospective
Draft

feat: ingestão de contribuições do GitHub e retrospectiva da comunidade#304
Clintonrocha98 wants to merge 1 commit into
4.xfrom
feat/community-retrospective

Conversation

@Clintonrocha98
Copy link
Copy Markdown
Member

@Clintonrocha98 Clintonrocha98 commented Jun 3, 2026

O que este PR faz

Hoje a comunidade não tem um jeito automático de saber quem está contribuindo nos repositórios públicos. Este PR cria essa base: o sistema passa a guardar as contribuições do GitHub (pull requests, reviews, issues, comentários e commits) e a mostrar tudo numa página de retrospectiva — no espírito do "Quem fez a He4rt bater".

Como funciona, em linguagem simples

1. De onde vêm os dados

  • Histórico: com um clique no painel (ou um comando), o sistema busca tudo o que já aconteceu num repositório e guarda.
  • Tempo real: quando alguém abre um PR, comenta ou faz um commit, o GitHub avisa o sistema na hora e a contribuição é registrada sozinha.

2. Quais repositórios contam

  • Um administrador escolhe, pelo painel, quais repositórios entram na conta. Adicionar um novo é só cadastrar — sem mexer em código.

3. Quem aparece

  • Todo mundo que contribui é contado, seja membro cadastrado ou não.
  • Robôs (bots) ficam de fora.
  • PRs que não foram aceitos ainda contam como participação, mas aparecem separados dos que foram aceitos — pra dar crédito ao esforço sem confundir com o que de fato entrou.

4. A página

  • Uma página pública no portal mostra o ranking por período (você escolhe as datas): quem mais participou, com quantos PRs, reviews, issues e comentários.

O que muda pra quem usa

  • Para o admin: uma tela nova ("Repositórios") pra escolher o que entra e um botão "Backfill agora" pra puxar o histórico. Se o GitHub limitar as requisições, aparece um aviso claro pedindo pra tentar de novo depois (e nada é perdido — dá pra continuar de onde parou).
  • Para a comunidade: a página de retrospectiva.

Substitui a versão provisória

A primeira tentativa era um comando solto, rodado na mão, que jogava um JSON num link temporário. Isso foi removido e trocado por essa base que vive dentro da arquitetura do projeto, guarda os dados de verdade e se atualiza sozinha.

Para funcionar em produção (configuração)

Precisa configurar duas chaves (GITHUB_API_TOKEN e GITHUB_WEBHOOK_SECRET) e registrar o webhook na organização do GitHub. Sem isso, o histórico pelo painel ainda funciona; só o tempo real fica desligado.

Nota: ainda em draft — falta a configuração das chaves/webhook no ambiente e uma passada final de revisão.

@Clintonrocha98 Clintonrocha98 requested a review from a team June 3, 2026 17:56
Copy link
Copy Markdown

@fernanduandrade fernanduandrade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(comentário do contexto provisório anterior — removido)

@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@he4rt he4rt deleted a comment from coderabbitai Bot Jun 5, 2026
@Clintonrocha98 Clintonrocha98 changed the title feat: comando de retrospectiva semanal da comunidade feat: ingestão de contribuições do GitHub e retrospectiva da comunidade Jun 5, 2026
@Clintonrocha98 Clintonrocha98 marked this pull request as draft June 5, 2026 13:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants