💬 파일 코멘트와 @멘션 협업
산출물을 올리고 승인/반려하는 것만으로는 검토가 끝나지 않습니다. "여기 카피를 바꿔 주세요", "이 버전이 맞나요?" 같은 세부 의견은 승인/반려와 별개로 오가야 합니다. 파트너포털은 파일 묶음(번들)마다 코멘트 영역을 두고, @멘션으로 특정 협업자(내부 팀원과 파트너 모두)를 콕 집어 알릴 수 있게 합니다. 누가 어떤 의견을 남겼는지가 역할 뱃지와 함께 기록으로 쌓여, 검토 맥락이 흩어지지 않습니다.
💡 진입 경로: 프로젝트 선택 후 파일 탭에서 검토할 묶음(번들)을 열면, 상세 패널 하단에 파일 코멘트 영역이 있습니다.
이 문서에서 다루는 내용
- 코멘트와 멘션이 필요한 이유
- 코멘트 영역 화면 구성
- 코멘트는 번들(묶음) 단위로 쌓인다
- 코멘트 작성하기
- @멘션으로 사람 지목하기
- 내부 팀원과 파트너를 함께 멘션 - 누가 후보에 뜨나
- 역할 뱃지로 보는 발화 주체
- 멘션 알림 - 누가 어떤 알림을 받나
- 코멘트 정렬·확대·새로고침
- 운영 팁 & 자주 묻는 질문
관련 문서: 파일 업로드·승인 흐름은 [파일 관리와 승인 워크플로우] 문서를, 알림을 모아 보는 방법은 [알림 센터] 문서를 함께 참고하세요.
1. 코멘트와 멘션이 필요한 이유
승인/반려는 "통과/수정"이라는 결정만 전달합니다. 그 결정에 이르기까지의 대화 - 무엇이 마음에 걸리는지, 어떻게 고치면 좋을지, 누가 확인해야 하는지 - 는 코멘트로 나눕니다.
| 수단 | 무엇을 전달하나 |
|---|---|
| 승인/반려 | "결정"만 전달합니다 (통과 / 수정 필요 + 사유) |
| 코멘트·멘션 | "대화"를 전달합니다 (세부 의견, 질문, 확인 요청) |
| @멘션 | 대화에서 특정 인물을 지목해 알립니다 |
| 수단 | 역할 | 예시 |
|---|---|---|
| 승인/반려 | 산출물의 합격 여부 결정 | "v2 승인" / "여백 조정 필요로 반려" |
| 코멘트 | 자유로운 세부 의견 교환 | "서브 카피 폰트가 가이드와 다릅니다" |
| @멘션 | 코멘트에서 특정 사람 호출 | "@도원 이OO 반영해서 v3로 올릴게요" |
💡 코멘트는 반려 사유와 함께 검토 맥락을 이루는 자산입니다. "왜 이렇게 결정했는지"가 남아 있어야 같은 지적이 반복되지 않습니다.
2. 코멘트 영역 화면 구성
번들 상세 패널을 열면 파일 정보·버전 히스토리 아래에 파일 코멘트 영역이 있습니다. 상단에는 코멘트 개수, 새로고침, 확대 버튼이 있고, 가운데에는 대화 목록(최신 코멘트가 맨 위), 맨 아래에 입력창이 놓입니다. 각 코멘트에는 작성자 프로필 이미지(아바타) 가 함께 표시되며, 이미지가 없으면 이름 첫 글자가 동그라미로 대신 들어갑니다(내부는 회색, 파트너는 초록 바탕).
| 영역 | 내용 |
|---|---|
| 헤더 | 번들명 · 버전 · 유형 · 상태 배지 |
| 상단 | 파일 정보 / 버전 히스토리 / 파일 상세 리스트 |
| 코멘트 | 개수 표시와 [↻] 새로고침 · [⤢] 확대 |
| 입력창 | 하단에서 코멘트 작성 |
| 영역 | 설명 |
|---|---|
| 코멘트 개수 | 제목 옆 뱃지로 현재 코멘트 수 표시 |
| 새로고침(↻) | 다른 사람이 방금 남긴 코멘트를 즉시 불러옴 |
| 확대(⤢) | 코멘트 영역만 크게 펼쳐 긴 대화를 편하게 열람 |
| 대화 목록 | 발화 주체에 따라 좌/우로 정렬된 말풍선, 최신 코멘트가 맨 위 |
| 프로필 아바타 | 작성자 프로필 이미지, 없으면 이름 첫 글자 동그라미(내부 회색·파트너 초록) |
| 입력창 | 코멘트를 쓰고 `@`로 멘션을 추가하는 곳 |
3. 코멘트는 번들(묶음) 단위로 쌓인다
코멘트는 개별 파일이 아니라 묶음(번들) 한 건에 달립니다. 예를 들어 이미지 5장을 "1차 시안"이라는 묶음으로 올렸다면, 5장을 통틀어 하나의 코멘트 흐름이 생깁니다. 검토자와 제출자가 같은 줄기에서 대화하므로 의견이 흩어지지 않습니다.
⚠️ 코멘트는 파일이 아니라 번들에 붙습니다. 한 번들에 파일이 여러 개여도 코멘트는 그 번들 하나에 모여 쌓입니다. 특정 파일에 대한 의견이라면 코멘트 본문에 파일명을 적어 주세요.
또한 코멘트는 버전을 묶는 묶음 전체가 아니라 보고 있는 그 버전(예: v2)의 묶음에 귀속됩니다. 새 버전(v3)을 올리면 그 버전의 코멘트 흐름이 새로 이어집니다. 과거 버전을 다시 열면 그때 오갔던 코멘트가 그대로 보존되어 있습니다.
💡 어떤 버전에서 어떤 지적이 나왔는지 거슬러 보고 싶다면, 버전 히스토리에서 해당 버전을 골라 그 버전의 코멘트를 확인하세요(버전·최종본 관리는 [파일 관리와 승인 워크플로우] 문서 참고).
4. 코멘트 작성하기
4.1 기본 작성
- 번들 상세 패널 하단 파일 코멘트 입력창에 내용을 입력합니다.
- 보내기 버튼을 누르면 즉시 목록에 반영됩니다.
- 빈 내용은 등록되지 않습니다(보내기 버튼이 비활성화).
4.2 자동으로 함께 기록되는 정보
코멘트를 남기면 본문 외에 다음이 자동으로 함께 저장되어, 나중에 "누가 언제 무슨 입장에서" 말했는지 알 수 있습니다.
| 함께 기록되는 정보 | 설명 |
|---|---|
| 작성자 이름 | 로그인한 사용자(또는 파트너) 표시 이름 |
| 역할 | 슈퍼관리자 / 팀장 / 팀원 / 파트너 중 하나(7장) |
| 작성 시각 | "○시간 전"처럼 상대 시각으로 표시 |
| 멘션 대상 | 본문에서 `@`로 지목한 사람들(5장) |
💡 작성자 이름·역할은 직접 입력하는 항목이 아니라 로그인 정보에서 자동으로 채워집니다. 본문에만 집중하면 됩니다.
5. @멘션으로 사람 지목하기
코멘트 본문에서 `@`를 입력하면 멘션 후보 목록이 떠오릅니다. 후보를 고르면 그 사람이 코멘트에 색이 입혀진 뱃지(`@이름`)로 들어가고, 등록 시 그 사람에게 개인 알림이 갑니다.
5.1 멘션하는 방법
입력창에서 @ 를 치면 멘션 후보 목록이 뜹니다. 내부 팀원과 파트너가 함께 나오며, 파트너에게는 [파트너] 배지가 붙어 구분됩니다. 후보를 고르면 본문에 멘션이 삽입됩니다.
| 단계 | 동작 |
|---|---|
| `@` 입력 | 프로젝트 참여자 후보 목록이 뜸 |
| 후보 선택 | 코멘트에 `@이름` 뱃지가 삽입됨 |
| 등록 | 멘션된 사람에게 개인 알림 발송(8장) |
5.2 멘션 표시 방식
등록된 코멘트에서 멘션은 `@이름` 형태의 색 뱃지로만 보입니다. 내부적으로 사람을 구분하는 식별 정보는 화면에 노출되지 않으므로, 읽는 사람은 깔끔하게 "누구를 호명했는지"만 보게 됩니다.
💡 한 코멘트에서 여러 명을 멘션할 수 있습니다. 같은 사람을 두 번 적어도 알림은 한 번만 갑니다.
6. 내부 팀원과 파트너를 함께 멘션: 누가 후보에 뜨나
이 기능의 핵심은 내부 수행팀과 외부 파트너를 한 입력창에서 함께 지목할 수 있다는 점입니다. 디자인 검토에서 고객사 담당자를, 동시에 우리 쪽 팀원을 한 코멘트로 호출하는 식입니다.
6.1 멘션 후보에 포함되는 사람
멘션 후보에 뜨는 사람은 이렇게 정해집니다.
- 프로젝트에 참여 중인 내부 팀원
- 프로젝트에 참여 중인 파트너
- 단, 나 자신은 후보에서 빠집니다
- 단, 비활성·퇴사자도 빠집니다
| 구분 | 후보 포함 여부 |
|---|---|
| 프로젝트 내부 팀원(팀장·팀원 등) | 포함 |
| 프로젝트 파트너(고객사 담당자) | 포함, "(파트너)" 표시로 구분 |
| 나 자신 | 제외(자기 자신은 멘션 불가) |
| 프로젝트에서 빠진 사람·비활성 계정 | 제외 |
6.2 파트너는 한눈에 구분된다
멘션 후보 목록에서 파트너는 이름 옆에 "파트너" 뱃지가 붙어 내부 팀원과 명확히 구분됩니다. 코멘트 본문에 들어간 뒤에는 `@이름`만 깔끔하게 표시됩니다.
💡 내부 사용자와 파트너는 서로 다른 체계로 관리되지만, 같은 멘션 입력창에서 자연스럽게 함께 호명됩니다. 사용자는 "이름 옆에 파트너 뱃지가 있는지"만 보면 됩니다.
⚠️ 후보 목록에 보이고 싶은 사람이 안 보인다면, 그 사람이 이 프로젝트에 참여 중인지 그리고 활성 상태인지를 먼저 확인하세요. 프로젝트에서 빠졌거나 비활성화된 계정은 후보에 나타나지 않습니다.
7. 역할 뱃지로 보는 발화 주체
코멘트 목록에서는 누가 "내부 쪽"이고 누가 "파트너 쪽"인지, 그리고 내부라면 어떤 직무인지를 정렬 위치 + 색 뱃지로 한눈에 구분합니다.
7.1 좌우 정렬로 보는 진영
코멘트는 말하는 쪽에 따라 좌우로 갈려 표시됩니다.
| 발화자 | 표시 |
|---|---|
| 내부 팀원 | 왼쪽 정렬 · 회색 말풍선 |
| 파트너 | 오른쪽 정렬 |
이름 옆에 역할 배지가 붙어 누가 어느 쪽 사람인지 바로 구분됩니다.
| 발화 주체 | 정렬 | 말풍선 색 |
|---|---|---|
| 내부(수행팀) | 왼쪽 | 회색 계열 |
| 파트너(고객사) | 오른쪽 | 초록 계열 |
7.2 역할 뱃지 색
이름 옆 뱃지는 그 사람의 역할을 색으로 표현합니다. 한 눈에 발언의 무게(누가 결정권자인지 등)를 가늠할 수 있습니다.
| 역할 | 뱃지 표기 | 색 |
|---|---|---|
| 슈퍼관리자 | 슈퍼관리자 | 빨강 계열 |
| 팀장 | 팀장 | 파랑 계열 |
| 팀원 | 팀원 | 보라 계열 |
| 파트너 | 파트너 | 초록 계열 |
💡 "오른쪽 초록 말풍선 = 고객사(파트너)"라고 기억하면, 긴 대화에서도 우리 쪽과 상대 쪽 발언을 빠르게 가를 수 있습니다.
8. 멘션 알림: 누가 어떤 알림을 받나
코멘트 한 건이 등록되면 두 종류의 알림이 동시에 작동합니다. 상대 진영에 가는 일반 알림과, 지목당한 사람에게만 가는 개인 멘션 알림입니다.
코멘트를 등록하면 알림이 두 갈래로 나갑니다.
| 알림 | 받는 사람 |
|---|---|
| 일반 알림 | 상대 진영 전체 (내가 내부면 파트너 쪽, 내가 파트너면 내부 쪽) |
| 멘션 알림 | @ 로 지목된 사람에게만 개인 알림 |
💡 특정 인물이 꼭 봐야 한다면 일반 코멘트만으로는 부족합니다. @ 로 직접 지목하세요.
| 사건 | 알림 받는 쪽 |
|---|---|
| 코멘트 작성(일반) | 반대 진영(내부↔파트너) |
| @멘션 | 지목된 사람 본인에게 개인 알림 |
8.1 멘션 개인 알림
`@`로 지목된 사람에게는 "○○님이 \"(묶음 이름)\" 번들 댓글에서 회원님을 언급했습니다"라는 개인 알림이 별도로 갑니다. 내부 팀원이든 파트너든 각자에게 정확히 전달됩니다.
8.2 사내 메신저(Slack) 연동 알림
프로젝트에 사내 메신저 채널이 연결되어 있으면, 내부 팀원을 멘션한 경우 해당 채널에도 알림이 전달됩니다. 단, 파트너 멘션은 사내 메신저 채널로는 보내지 않습니다 - 사내 채널은 내부 구성원용이기 때문입니다. 파트너는 포털 안의 개인 알림으로 받습니다.
| 멘션 대상 | 포털 개인 알림 | 사내 메신저 채널 알림 |
|---|---|---|
| 내부 팀원 | 받음 | (채널 연결 시) 받음 |
| 파트너 | 받음 | 보내지 않음 |
💡 멘션을 빠뜨리면 개인 알림이 가지 않아 검토가 늦어질 수 있습니다. 꼭 확인받아야 할 사람은 코멘트에 직접 `@`로 지목하세요.
9. 코멘트 정렬·확대·새로고침
긴 대화나 동시 검토 상황을 위해 다음 보조 기능이 제공됩니다.
9.1 정렬 순서: 최신 코멘트가 맨 위
코멘트 목록은 작성 시각 기준 최신순(내림차순) 으로 고정 정렬됩니다. 즉 가장 최근에 달린 코멘트가 목록 맨 위에 오고, 오래된 코멘트일수록 아래로 내려갑니다. 정렬 방식을 바꾸는 옵션은 없으며, 방금 들어온 의견을 스크롤 없이 바로 확인할 수 있도록 한 구성입니다.
9.2 보조 기능
| 기능 | 동작 | 쓰임새 |
|---|---|---|
| 새로고침(↻) | 최신 코멘트를 다시 불러옴 | 상대가 방금 남긴 의견을 즉시 확인 |
| 확대(⤢) | 코멘트 영역만 크게 펼침 | 여러 차례 오간 긴 대화 열람 |
| 자동 시각 표시 | "○시간 전"으로 표기 | 의견이 언제 나왔는지 빠르게 파악 |
코멘트 영역은 [⤢] 로 확대할 수 있습니다. 기본 상태는 목록 높이가 제한되지만, 확대하면 전체 화면으로 펼쳐져 긴 대화를 한 번에 볼 수 있습니다. [↻] 로 새로고침합니다.
💡 두 사람이 동시에 검토할 때는 새로고침을 눌러 상대의 최신 코멘트를 받아 보세요. 화면은 자동으로도 갱신되지만, 즉시 확인하고 싶을 때 유용합니다.
10. 운영 팁 & 자주 묻는 질문
운영 팁
- 확인이 꼭 필요한 사람은 본문에 풀어 쓰지 말고 `@`로 직접 지목하세요. 멘션해야 개인 알림이 갑니다.
- 의견은 해당 번들의 코멘트에 남기세요. 카카오톡·메일로 흩어지면 검토 이력이 끊깁니다.
- 반려할 때의 핵심 사유는 반려 사유로, 부연 설명·질문은 코멘트로 나눠 적으면 읽기 쉽습니다.
- 새 버전을 올렸다면 코멘트로 "v3 올렸습니다, 확인 부탁드립니다"처럼 상대를 멘션해 검토를 재촉하세요.
자주 묻는 질문
Q. 파트너(고객사)도 멘션할 수 있나요?
네. 멘션 후보에는 프로젝트에 참여 중인 내부 팀원과 파트너가 모두 포함됩니다. 후보 목록에서 파트너는 "파트너" 뱃지로 구분되며, 멘션하면 해당 파트너에게 포털 개인 알림이 갑니다.
Q. 멘션 후보에 특정 사람이 안 보입니다.
그 사람이 이 프로젝트에 참여 중인지, 그리고 계정이 활성 상태인지 확인하세요. 프로젝트에서 빠졌거나 비활성화(퇴사 등)된 사람은 후보에 나타나지 않습니다. 또한 본인은 자기 자신을 멘션할 수 없어 후보에서 제외됩니다.
Q. 같은 이름이거나 비슷한 사람이 섞여 잘못 호출되지 않나요?
아니요. 시스템은 내부 사용자와 파트너를 서로 다른 체계로 구분해 지목하므로, 이름이 비슷하더라도 후보에서 고른 바로 그 사람에게만 알림이 갑니다.
Q. 내부 팀원을 멘션하면 사내 메신저로도 알림이 가나요?
프로젝트에 사내 메신저 채널이 연결되어 있으면, 내부 팀원 멘션은 해당 채널로도 전달됩니다. 파트너 멘션은 사내 채널로 보내지 않고 포털 개인 알림으로만 전달됩니다.
Q. 코멘트는 어느 단위로 쌓이나요?
개별 파일이 아니라 묶음(번들) 단위로 쌓입니다. 한 묶음에 파일이 여러 개여도 코멘트 흐름은 하나입니다. 버전을 올리면 그 버전의 코멘트가 새로 이어지고, 과거 버전의 코멘트는 그대로 보존됩니다.
Q. 코멘트는 어떤 순서로 보이나요?
최신 코멘트가 맨 위에 오는 최신순(작성 시각 내림차순) 으로 고정 표시됩니다. 별도의 정렬 변경 옵션은 없습니다.
Q. 코멘트에 보이는 동그란 이미지는 무엇인가요?
작성자의 프로필 이미지(아바타)입니다. 프로필 이미지가 없는 사용자·파트너는 이름 첫 글자가 동그라미로 대신 표시되며, 내부는 회색·파트너는 초록 바탕으로 구분됩니다.
Q. 상대가 방금 남긴 코멘트가 안 보입니다.
코멘트 영역 상단의 새로고침(↻) 을 눌러 최신 내용을 다시 불러오세요.
함께 보면 좋은 문서: [파일 관리와 승인 워크플로우](업로드·번들·버전·승인/반려) · [알림 센터](멘션·검토 알림을 모아 보기)