Gestão e Histórico de Releases

Documento de Evidência Técnica de Controle de Versões e Mudanças (FOR-24)


Código do Documento: DEC-REL-024	Versão: 1.0
Data de Emissão: Janeiro de 2026	Classificação de Informação: Uso Interno / Clientes / Auditoria
Área Responsável: Engenharia de Software / DevOps	Aplica-se a: Todos os Serviços e Microsserviços

1. OBJETIVO

Esta declaração formal visa comprovar a existência e a aplicação contínua de processos padronizados de gestão de releases, controle de versão e auditoria de alterações no código-fonte dos sistemas e serviços mantidos pela organização.

2. ESTRUTURA E REPOSITÓRIO DE CÓDIGO (GITHUB)

A gestão de versões de todos os serviços da organização é centralizada no provedor GitHub, utilizando repositórios privados e seguros. O controle de mudanças e histórico de lançamentos é rastreado de forma automatizada atrelado à esteira de integração e entrega contínuas (CI/CD).

2.1. Modelo de Ramificação (Branching Strategy)

Os repositórios seguem um fluxo de trabalho estruturado, com ramificações (branches) específicas destinadas à segregação de ambientes e garantia de qualidade:

Branch / Ramo	Ambiente Associado	Finalidade e Critérios de Aprovação
`main` / `master` / `prod`	Produção (Prod)	Código em execução operacional. Alterações entram via Pull Requests (PRs) aprovados após validação em homologação e testes.
`staging` / `stage`	Homologação (Stage)	Ambiente pré-produção utilizado para validação final e aprovação do time de produto/cliente.
`qa` / `testing`	Qualidade / Testes (QA)	Ambiente dedicado para serviços aplicáveis, onde são executados testes de regressão e garantia de qualidade antes do merge para staging.
`feature/` ou `fix/`	Desenvolvimento Local	Ramos isolados para implementação de melhorias ou correções específicas, originando Pull Requests para revisão de código.

3. MEIOS DE REGISTRO E RASTREABILIDADE DE HISTÓRICO

O histórico completo de revisões, modificações relevantes e pacotes liberados em produção é mantido através das seguintes ferramentas nativas do GitHub:

GitHub Releases & Tags: As versões oficiais enviadas para produção são marcadas por meio de Tags e consolidadas na aba Releases do repositório, adotando versionamento semântico (ex.: v2.5.0).
Commits Auditáveis: Cada commit contém autor, data, hora e mensagem descritiva da alteração realizada no sistema.
Rastreabilidade por Pull Requests (PRs): Todo envio de código para as branches de qa, stage e prod exige abertura de PR, vinculando a alteração à tarefa correspondente.
GitHub Actions / CI-CD Logs: Cada alteração aprovada aciona pipelines automatizadas cujos históricos de compilação, testes e deploy permanecem salvos e auditáveis.