%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart LR
    accTitle: Merge request review workflow
    accDescr: Flow from merge request creation through review, approval, and merge stages with decision points for reviewers and approvals.
A[Your<br>merge request] --> B{Reviewers<br>added?}
B-->|Yes| D[<strong>Review<br>requested</strong>]
B -.->|No| C[<strong>Your merge<br>requests</strong>]
D -->|Approved| E[<strong>Approved<br>by others</strong>]
D -..->|Changes<br>requested| F[<strong>Returned<br>to you</strong>]
F -->|You make<br>changes| D
E -->G{All<br>approvals?}
G -->|Yes| K[Ready to merge]
G -.-&gt;|No| J[Remains in&lt;br&gt;&lt;strong&gt;Waiting for approvals&lt;/strong&gt;]</code></pre></details></div>

이 리뷰 흐름은 리뷰어가 Start a review와 Submit a review 기능을 사용한다고 가정합니다.
Role 보기는 머지 리퀘스트에서 맡은 역할을 기준으로 머지 리퀘스트를 정렬합니다.
머지 리퀘스트 홈페이지 보기#
히스토리
GitLab 17.9에서 머지 리퀘스트 홈페이지가 merge_request_dashboard라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
GitLab 17.9의 GitLab.com에서 기능 플래그 merge_request_dashboard가 활성화되었습니다.
GitLab 18.1의 GitLab.com에서 기능 플래그 mr_dashboard_list_type_toggle가 활성화되었습니다.
GitLab 18.2에서 기능 플래그 merge_request_dashboard가 기본적으로 활성화되었습니다.
Feature flag
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다.
자세한 내용은 히스토리를 참고합니다.

GitLab은 모든 페이지의 오른쪽 위에 Active 머지 리퀘스트의 총 개수를 표시합니다.
예를 들어 이 사용자의 현황은 다음과 같습니다.

이 사용자의 현황은 다음과 같습니다.

열린 이슈 8건([work-item-issue])
활성 머지 리퀘스트 3건([merge-request-open])
할 일 항목 6건([todo-done])

머지 리퀘스트 홈페이지에는 이 머지 리퀘스트에 대한 더 많은 정보가 표시됩니다. 홈페이지를 보려면
다음 방법 중 하나를 사용합니다.

Shift+m 키보드 단축키를 사용합니다.
왼쪽 사이드바에서 Merge requests ([merge-request-open])를 선택합니다.
상단 바에서 Search or go to를 선택한 다음 드롭다운 목록에서 Merge requests를 선택합니다.

지금 확인해야 할 항목에 집중할 수 있도록 GitLab은 머지 리퀘스트 홈페이지를
세 개의 탭으로 구성합니다.


Active: 본인 또는 팀원의 조치가 필요한 머지 리퀘스트입니다.
Merged: 최근 14일 이내에 머지된 머지 리퀘스트입니다. 본인의 작업이거나 본인의 리뷰가 포함된 머지 리퀘스트입니다.
Search: 모든 머지 리퀘스트를 검색하고 필요에 따라 필터링합니다.



Status: 머지 리퀘스트의 현재 상태입니다.
Title: 다음을 포함한 머지 리퀘스트의 주요 메타데이터입니다.

머지 리퀘스트 제목.
담당자의 아바타.
추가·삭제된 파일 수와 줄 수(+ / -).
마일스톤.


Author: 작성자의 아바타입니다.
Reviewers: 리뷰어의 아바타입니다. 녹색 체크 표시가 있는 리뷰어는 머지 리퀘스트를 승인한 리뷰어입니다.
Checks: 머지 가능 여부를 압축해 보여줍니다.

머지 충돌이 있으면 경고([warning-solid])가 표시됩니다.
0 of 3과 같은 미해결 스레드 수.
현재 필수 승인 상태.
가장 최근 파이프라인 상태.
마지막 업데이트 날짜.



표시 기본 설정 지정#
히스토리
GitLab 18.6에서 Show your drafts 기본 설정이 도입되었습니다.
머지 리퀘스트 홈페이지 오른쪽 위에서 Display preferences ([preferences])를 선택합니다.

Show labels를 전환하여 각 머지 리퀘스트의 레이블을 표시하거나 숨깁니다.
정렬 기본 설정: Workflow 또는 Role.

Workflow는 머지 리퀘스트를 상태별로 묶습니다. GitLab은 작성자인지 리뷰어인지와
무관하게 확인이 필요한 머지 리퀘스트를 먼저 표시합니다.
Role은 본인이 리뷰어인지 작성자인지를 기준으로 머지 리퀘스트를 묶습니다.


Show your drafts를 전환하여 Your merge requests 목록에서 초안 머지 리퀘스트를 표시하거나 숨깁니다.

활성 머지 리퀘스트는 왼쪽 사이드바에 표시되는 총 개수에 포함됩니다. GitLab은 Inactive
머지 리퀘스트를 리뷰 개수에서 제외합니다.
워크플로 보기: 활성 상태#
다음 머지 리퀘스트는 확인이 필요합니다. 왼쪽 사이드바에 표시되는 총 개수에 포함됩니다.

Your merge requests: 본인이 머지 리퀘스트 작성자 또는 담당자입니다. 리뷰어를 추가해 리뷰 프로세스를 시작합니다.
상태:

Draft: 머지 리퀘스트가 초안입니다.
Reviewers needed: 머지 리퀘스트가 초안은 아니지만 리뷰어가 없습니다.


Review requested: 본인이 리뷰어입니다. 머지 리퀘스트를 리뷰하고 피드백을 제공합니다. 필요하면
승인하거나 변경을 요청합니다. 상태:

Changes requested: 리뷰어가 변경을 요청했습니다. 변경 요청은 머지 리퀘스트를 차단하지만
우회할 수 있습니다.
Reviewer commented: 리뷰어가 댓글은 남겼으나 변경은 요청하지 않았습니다.


Returned to you: 리뷰어가 피드백을 제공했거나 변경을 요청했습니다. 리뷰어 댓글에 대응하고
제안된 변경을 적용합니다. 상태:

Changes requested: 리뷰어가 변경을 요청했습니다.
Reviewer commented: 리뷰어가 댓글은 남겼으나 변경은 요청하지 않았습니다.



워크플로 보기: 비활성 상태#
지금 당장 조치가 필요하지 않으므로 GitLab은 다음 머지 리퀘스트를 활성 개수에서 제외합니다.

Waiting for assignee: 본인이 작성자이면 머지 리퀘스트가 리뷰를 기다리는 상태입니다. 본인이
리뷰어이면 변경을 요청한 상태입니다. 상태:

You requested changes: 리뷰를 마치고 변경을 요청했습니다.
You commented: 댓글은 남겼으나 리뷰를 마치지 않았습니다.


Waiting for approvals: 승인을 기다리는 본인 담당 머지 리퀘스트와 본인이 변경을 요청한
리뷰입니다. 상태:

Approvals required: 남은 필수 승인 수입니다.
Approved: 본인이 승인했거나 필수 승인이 모두 충족되었습니다.
Waiting for approvals.


Approved by you: 본인이 리뷰하고 승인한 머지 리퀘스트입니다.
상태:

Approved: 본인이 승인했고 필수 승인이 모두 충족되었습니다.
Approval required: 본인은 승인했으나 필수 승인이 모두 충족되지는 않았습니다.


Approved by others: 다른 팀원의 승인을 받은 머지 리퀘스트입니다.
모든 요건이 충족되면 머지할 수 있는 상태입니다. 상태:

Approved: 머지 리퀘스트가 필요한 승인을 받았습니다.



역할 보기#
Role 보기는 본인이 담당자 또는 리뷰어인 머지 리퀘스트를 묶어서 보여줍니다.

Reviewer (Active): 본인의 리뷰를 기다리는 머지 리퀘스트입니다.
Reviewer (Inactive): 본인이 이미 리뷰한 머지 리퀘스트입니다.
Your merge requests (Active)
Your merge requests (Inactive)

Active 목록의 머지 리퀘스트는 왼쪽 사이드바에 표시되는 총 개수에 포함됩니다.
관련 주제#

머지 리퀘스트 리뷰