discussão: reintroduzir ganho de XP por contribuições no GitHub (PR, issue, commit, review, comentário)

[hefeus]

O que construir

• Reintroduzir a concessão de XP (Character.experience) para contribuições do ecossistema GitHub — hoje IncrementExperience só cobre mensagem de texto e voz no Discord
• Definir pesos de XP por ActivityType do GitHub (PrOpened, PrMerged, Review, ReviewComment, Comment, Commit, Issue)
• Criar um consumidor (listener/Action) do evento InteractionTracked (ou de GithubContributionRecorded/Changed diretamente) que resolva o Character a partir do external_identity_id/user_id da Interaction e credite o XP correspondente

Critérios de aceite

• Cada ActivityType do GitHub tem um valor de XP definido e documentado
• Ao registrar uma Interaction de tipo elegível, o Character vinculado ao usuário recebe o XP correspondente
• Reprocessar o mesmo evento de contribuição (ex: reentrega de webhook) não credita XP duas vezes
• Contribuições sem Character/identidade vinculada não geram erro, apenas não creditam XP

Funcionalidade: Ganho de XP por contribuições no GitHub

# language: pt

  Cenário: Usuário ganha XP ao abrir um Pull Request
    Dado que um usuário possui um Character vinculado à sua identidade externa do GitHub
    E o tipo de contribuição "pr_opened" concede um valor de XP definido
    Quando uma Interaction do tipo "pr_opened" é registrada para esse usuário
    Então o Character do usuário deve receber o XP correspondente ao tipo "pr_opened"

  Cenário: Usuário ganha XP ao comentar em uma issue ou PR
    Dado que um usuário possui um Character vinculado à sua identidade externa do GitHub
    E o tipo de contribuição "comment" concede um valor de XP definido
    Quando uma Interaction do tipo "comment" é registrada para esse usuário
    Então o Character do usuário deve receber o XP correspondente ao tipo "comment"

  Cenário: Usuário ganha XP ao aprovar um Pull Request (review)
    Dado que um usuário possui um Character vinculado à sua identidade externa do GitHub
    E o tipo de contribuição "review" concede um valor de XP definido
    Quando uma Interaction do tipo "review" é registrada para esse usuário
    Então o Character do usuário deve receber o XP correspondente ao tipo "review"

  Cenário: Contribuição não deve gerar XP duplicado
    Dado que uma Interaction já teve XP creditado ao Character correspondente
    Quando o mesmo evento de contribuição é reprocessado
    Então nenhum XP adicional deve ser creditado ao Character

  Cenário: Contribuição sem Character vinculado não credita XP
    Dado que uma Interaction é registrada para uma identidade externa sem Character vinculado
    Quando o consumidor de XP processa essa Interaction
    Então nenhum XP deve ser creditado
    E nenhum erro deve ser lançado

[GabrielFVDev]

É legal a ideia, mas eu ajustaria umas coisas.

Cenário: Usuário ganha XP ao abrir um Pull Request
Dado que um usuário possui um Character vinculado à sua identidade externa do GitHub
E o tipo de contribuição "pr_opened" concede um valor de XP definido
Quando uma Interaction do tipo "pr_opened" é registrada para esse usuário
Então o Character do usuário deve receber o XP correspondente ao tipo "pr_opened"

Esse cenario, eu só adaptaria para caso a PR seja aceita ou negada.
Eu tenho a impressao que se deixar para o pessoal abrir PR e ganhar XP, podem começar a abrir PR desenfreado (não que seja ruim)

E acho q seria legal caso o usuario dá um approve, e o PR seja mergeado depois, ele ganhar o XP, inves de só ir, clicar em "Aprove" e vida q segue.

Os outros, achei lesgal, é até bom que incentiva o povo a se colocar na issue, ao inves de deixar uma issue orfã

[stherzada]

Tem essa task aqui aberta tem um tempo, acho legal validar #19

[hefeus]

Esse cenario, eu só adaptaria para caso a PR seja aceita ou negada.
Eu tenho a impressao que se deixar para o pessoal abrir PR e ganhar XP, podem começar a abrir PR desenfreado (não que seja ruim)

Faz sentido nisso que você falou @GabrielFVDev, poderia ter um cenário de abrir PR por exemplo se ela vim de uma issue que foi lapidada. Que é o que é mais pedido hoje de não abrir PR sem ter uma issue, principalmente para trackeamento. Ou somente que nem falou na hora do merge do PR. Mas ai penso que tem o cenário de onde um PR valido foi aberto, mas somente não foi aceita, mas ainda sim poderia valer uma xp.

[hefeus]

Tem essa task aqui aberta tem um tempo, acho legal validar #19

@stherzada certo, mas lendo ela vejo que só foi introduzida no ambito do discord, que hoje os unicos meios de ganhar exp dentro do sistema da He4rt é por meio de mensagens ou estando dentro de chats de voz. Queria extender isso pro Github.

[stherzada]

Acho eu q já está rolando n? @danielhe4rt dê a voz