Este documento define o padrão de colaboração para todos os repositórios da organização uniarpdev. Como trabalhamos com bibliotecas compartilhadas (NuGet), a integridade da branch main e o versionamento correto são críticos.

É estritamente proibido realizar push diretamente na branch main. Mesmo que o sistema não bloqueie a ação no plano gratuito, todos os colaboradores devem utilizar o fluxo de Pull Requests para garantir a revisão de código.

O fluxo padrão para qualquer alteração (correção ou nova funcionalidade) segue estes passos:

Garanta que sua branch local está atualizada antes de começar:

• git checkout main
• git pull origin main

Crie uma branch de funcionalidade com nome semântico:

• git checkout -b feature/nome-da-mudanca

Antes de finalizar, abra o arquivo .csproj do projeto alterado e incremente a tag <Version> seguindo o Semantic Versioning:

• Patch (1.0.x): Correções de bugs.
• Minor (1.x.0): Novas funcionalidades que não quebram compatibilidade.
• Major (x.0.0): Alterações que quebram a compatibilidade atual.

Realize o commit e suba a branch:

• git add .
• git commit -m "feat: descrição curta da mudança"
• git push origin feature/nome-da-mudanca

Ao abrir um PR, certifique-se de:

1. Utilizar o GitHub CLI (gh pr create) ou a interface web.
2. Preencher o checklist que aparecerá automaticamente no corpo do PR.
3. Aguardar a revisão do mantenedor.

A publicação oficial no GitHub Packages é realizada apenas após o merge na main e exclusivamente através do script de automação:

• ./scripts/publish.sh NomeDoProjeto

Nota: Apenas colaboradores autorizados possuem o Token (PAT) necessário para a publicação final.