# Gestão e Histórico de Releases

<table data-path-to-node="4" id="bkmrk-%C2%A0-%C2%A0-c%C3%B3digo-do-docume" style="width: 99.0476%;"><tbody><tr><td style="width: 45.8498%;"><span data-path-to-node="4,1,0,0">Código do Documento: GES-HTR-REL-001</span></td><td style="width: 54.1502%;"><span data-path-to-node="4,1,1,0">Versão: 1.0</span></td></tr><tr><td style="width: 45.8498%;"><span data-path-to-node="4,2,0,0">Data de Emissão: Janeiro de 2026</span></td><td style="width: 54.1502%;"><span data-path-to-node="4,2,1,0">Classificação de Informação: Uso Interno / Clientes / Auditoria</span></td></tr><tr><td style="width: 45.8498%;"><span data-path-to-node="4,3,0,0">Área Responsável: Engenharia de Software / DevOps</span></td><td style="width: 54.1502%;"><span data-path-to-node="4,3,1,0">Aplica-se a: Todos os Serviços e Microsserviços</span></td></tr></tbody></table>


#### 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:

<table data-path-to-node="13" id="bkmrk-branch-%2F-ramo-ambien" style="width: 100%; height: 252.578px;"><tbody><tr style="height: 46.5938px;"><td style="width: 10.6124%; height: 46.5938px;">**Branch / Ramo**</td><td style="width: 18.589%; height: 46.5938px;">**Ambiente Associado**</td><td style="width: 70.7986%; height: 46.5938px;">**Finalidade e Critérios de Aprovação**</td></tr><tr style="height: 64.3281px;"><td style="width: 10.6124%; height: 64.3281px;"><span data-path-to-node="13,1,0,0">`main` / `master` / `prod`</span></td><td style="width: 18.589%; height: 64.3281px;"><span data-path-to-node="13,1,1,0">Produção (Prod)</span></td><td style="width: 70.7986%; height: 64.3281px;"><span data-path-to-node="13,1,2,0">Código em execução operacional. Alterações entram via Pull Requests (PRs) aprovados após validação em homologação e testes.</span></td></tr><tr style="height: 47.2188px;"><td style="width: 10.6124%; height: 47.2188px;"><span data-path-to-node="13,2,0,0">`staging` / `stage`</span></td><td style="width: 18.589%; height: 47.2188px;"><span data-path-to-node="13,2,1,0">Homologação (Stage)</span></td><td style="width: 70.7986%; height: 47.2188px;"><span data-path-to-node="13,2,2,0">Ambiente pré-produção utilizado para validação final e aprovação do time de produto/cliente.</span></td></tr><tr style="height: 47.2188px;"><td style="width: 10.6124%; height: 47.2188px;"><span data-path-to-node="13,3,0,0">`qa` / `testing`</span></td><td style="width: 18.589%; height: 47.2188px;"><span data-path-to-node="13,3,1,0">Qualidade / Testes (QA)</span></td><td style="width: 70.7986%; height: 47.2188px;"><span data-path-to-node="13,3,2,0">Ambiente dedicado para serviços aplicáveis, onde são executados testes de regressão e garantia de qualidade antes do merge para staging.</span></td></tr><tr style="height: 47.2188px;"><td style="width: 10.6124%; height: 47.2188px;"><span data-path-to-node="13,4,0,0">`feature/*` ou `fix/*`</span></td><td style="width: 18.589%; height: 47.2188px;"><span data-path-to-node="13,4,1,0">Desenvolvimento Local</span></td><td style="width: 70.7986%; height: 47.2188px;"><span data-path-to-node="13,4,2,0">Ramos isolados para implementação de melhorias ou correções específicas, originando Pull Requests para revisão de código.</span></td></tr></tbody></table>

#### 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 &amp; 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.