> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/solicitacoes-de-pull/visao-geral-das-solicitacoes-de-pull.md).

# Visão geral das solicitações de pull

{% hint style="warning" %}

#### Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral

Pull Requests são uma parte fundamental do fluxo de trabalho de DevOps na nuvem, permitindo atualizações de uma branch de origem para uma branch de destino. Eles foram projetados para oferecer suporte à colaboração por meio de revisões de código que devem ser aprovadas antes da mesclagem.

**Benefícios dos Pull Requests:**

* **Revisão de código**: Permite uma análise minuciosa das alterações antes da mesclagem.
* **Detecção de conflitos**: Identifica e trata conflitos logo no início do processo.
* **Histórico de release limpo**: Mantém um histórico do projeto organizado e claro.

{% hint style="info" %}

#### Smart Merge vs Pull Request

Smart Merge e Pull Request mesclam alterações de um branch de origem para um branch de destino, mas cada um é mais adequado a um fluxo de trabalho diferente.

**Smart Merge** é um processo simplificado, em uma única etapa, que mescla alterações diretamente entre branches sem exigir uma Pull Request ou aprovação da equipe. Ele funciona bem em situações sensíveis ao tempo, como correções urgentes ou mudanças críticas que precisam ser lançadas rapidamente.

Uma **Pull Request**, por outro lado, é um processo estruturado, em várias etapas, criado para a colaboração da equipe. Ele permite que vários revisores inspecionem as alterações, solicitem revisões e as aprovem formalmente antes da mesclagem.

Como regra geral, use uma Pull Request quando as alterações precisarem de supervisão ou aprovação de outros membros da equipe, e escolha o Smart Merge quando precisar integrar mudanças rapidamente.
{% endhint %}

Para saber mais sobre Smart Merge, veja o artigo a seguir.

* [Usando o Smart Merge](/devops/devops-pt-br/codigo/acoes-da-branch/usando-o-smart-merge.md)

## Página de visão geral do Pull Request <a href="#pull-request-overview-page" id="pull-request-overview-page"></a>

A página de visão geral do Pull Request fornece um panorama abrangente de todas as solicitações ativas. Servindo como hub central, ela facilita o acompanhamento do progresso e a prontidão para a mesclagem. Cada Pull Request exibe os seguintes detalhes.

{% hint style="info" %}

#### Pull Requests ativos

A página de visão geral do Pull Request lista apenas Pull Requests ativos. Assim que um Pull Request for **Mesclado** ou **Fechado**, ele é removido da lista de Pull Requests ativos.
{% endhint %}

<table data-header-hidden><thead><tr><th width="179.333251953125"></th><th></th></tr></thead><tbody><tr><td>Título e ID</td><td>O título e o número de ID do Pull Request. Cada Pull Request recebe um número de ID sequencial exclusivo.</td></tr><tr><td>Status</td><td>O status do Pull Request pode ser um dos seguintes: Criado, Revisão solicitada, Alterações solicitadas e Aprovado.</td></tr><tr><td>Autor</td><td>O usuário Flosum que criou o Pull Request.</td></tr><tr><td>Atividade mais recente</td><td>O tempo decorrido desde a atividade mais recente do Pull Request.</td></tr><tr><td>Destino e origem</td><td>As branches de destino e de origem são listadas com uma seta apontando da origem para o destino. Clicar em uma branch leva você à página principal da branch.</td></tr><tr><td>Revisores</td><td>Os usuários Flosum que estão atribuídos como revisores do Pull Request.</td></tr></tbody></table>

Clicar em um Pull Request leva você à página de visão geral da solicitação, onde você pode executar ações sobre ela.

O **Três pontos verticais** menu no final de um Pull Request oferece as seguintes opções:

* **Editar**: Leva você à página de edição do Pull Request para alterar: **branch de destino**, **branch de origem**, **Nome**, e **Descrição**.
* **Fechar**: Encerra o Pull Request sem mesclá-lo. Depois de fechado, o Pull Request não é mais exibido na lista de Pull Requests e nenhuma outra ação pode ser executada.

<figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FXjfw7wQIo2BtQgHyFw0c%2FOverviewOfPullRequests-Overview-01.png?alt=media&amp;token=c9eae665-830c-4f34-bb5b-ddfc7e49078d" alt=""><figcaption></figcaption></figure>

### Pesquisa, ordenação e filtragem

A página de Pull Requests pode ser pesquisada, filtrada e ordenada usando as seguintes ferramentas.

* **Pesquisar** – pesquise pelo nome ou ID do Pull Request.
* **Autores** – filtrar pelo criador do PR.
* **Status** – filtrar por estado (Criado, Revisão solicitada, Alterações solicitadas, Aprovado).
* **Revisores** – filtrar por revisores atribuídos.
* **Atividade mais recente** – ordenar Pull Requests por:
  * Ordenar por nome A–Z – ordem alfabética.
  * Ordenar por nome Z–A – ordem alfabética inversa.
  * Atividade mais recente – atualizações mais recentes primeiro.
  * Atividade mais antiga – atualizações mais antigas primeiro.
* **Intervalo de datas** – filtrar por período de criação ou atualização. Use o widget de data para informar um intervalo.

### Status do Pull Request <a href="#pull-request-statuses" id="pull-request-statuses"></a>

<table><thead><tr><th width="200">Status</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Criado</strong></td><td>Pull Request aberto, mas não revisado.</td></tr><tr><td><strong>Revisão solicitada</strong></td><td>Revisores atribuídos, mas aguardando o feedback deles.</td></tr><tr><td><strong>Alterações solicitadas</strong></td><td>Os revisores solicitaram revisões antes da aprovação.</td></tr><tr><td><strong>Aprovado</strong></td><td>O Pull Request foi aprovado pelos revisores e está pronto para ser mesclado.</td></tr></tbody></table>

## Processo de Pull Request

Pull Requests envolvem três etapas principais: criação, revisão e mesclagem. Se surgirem conflitos durante a criação, eles devem ser resolvidos antes da mesclagem. Orientações detalhadas para cada etapa são fornecidas nos artigos a seguir.

* [Etapa 1 da solicitação de pull: criação](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-1-da-solicitacao-de-pull-criacao.md)
* [Etapa 2 da solicitação de pull: revisão](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-2-da-solicitacao-de-pull-revisao.md)
* [Etapa 3 da solicitação de pull: mesclagem](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-3-da-solicitacao-de-pull-mesclagem.md)
* [Resolvendo conflitos da solicitação de pull](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/resolvendo-conflitos-da-solicitacao-de-pull.md)

{% hint style="success" %}

#### Melhores práticas

* Sempre revise um Pull Request antes de mesclar branches de recurso ou correção de bugs.
* Escreva títulos e descrições claros para os revisores.
* Atribua pelo menos um revisor para fins de responsabilidade.
* Resolva os conflitos do Pull Request antes de mesclar.
* Feche Pull Requests obsoletos para manter a lista limpa.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flosum.com/devops/devops-pt-br/solicitacoes-de-pull/visao-geral-das-solicitacoes-de-pull.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.