> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promete.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Git Flow

> Estratégia de branching e versionamento do projeto

## Git Flow

<Info>
  Esta seção deve ser preenchida pela equipe de engenharia com a estratégia de branching adotada. Abaixo está uma estrutura sugerida.
</Info>

## Estratégia de Branching

| Branch      | Finalidade                     | Proteção                 |
| ----------- | ------------------------------ | ------------------------ |
| `main`      | Código em produção             | Protegida (merge via PR) |
| `develop`   | Código em desenvolvimento      | Protegida (merge via PR) |
| `feature/*` | Novas funcionalidades          | Livre                    |
| `bugfix/*`  | Correções de bugs              | Livre                    |
| `hotfix/*`  | Correções urgentes em produção | Livre                    |
| `release/*` | Preparação de releases         | Livre                    |

## Convenção de Commits

Sugere-se o uso de **Conventional Commits** para padronizar as mensagens:

```
<tipo>(<escopo>): <descrição>

feat(relacionamento): adicionar endpoint de busca por território
fix(comunicacao): corrigir envio duplicado de templates
docs(api): atualizar documentação de autenticação
```

## Pull Requests

Toda alteração em branches protegidas (`main`, `develop`) deve passar por Pull Request com revisão de pelo menos um membro da equipe, testes automatizados passando, descrição clara das alterações e referência à tarefa ou issue relacionada.