프로젝트(대시보드) 관리
분석 결과가 저장되는 프로젝트(대시보드)의 생성·열람·인사이트·AI 필터·차트 상세·편집·삭제 방법을 안내합니다.
분석을 실행하면 결과가 프로젝트(대시보드) 로 저장됩니다. 프로젝트는 다음을 담는 단위입니다.
- 분석 범위(연결된 GitLab 그룹/프로젝트)
- 날짜 범위
- 저장된 차트들
- 생성된 보고서
프로젝트 생성
- 자동 생성: 분석 요청 → 범위 선택 → 분석 완료 시 자동으로 만들어집니다.
- 빈 프로젝트로 시작: 사이드바 프로젝트 옆 ＋(새 프로젝트) 버튼으로 범위부터 선택해 시작할 수 있습니다.
프로젝트 열람
사이드바 프로젝트 목록에서 항목을 클릭하면 해당 대시보드로 이동합니다.
제목 옆 🔖 아이콘은 북마크 토글이고, 제목 아래에는 대시보드 설명과 최근 편집자·생성자·데이터 업데이트 시각이 표시됩니다. 우측 상단에는 다음 버튼이 순서대로 있습니다.
| 버튼 | 설명 |
|---|---|
| 보고서 생성 | 이 대시보드로 보고서 만들기 (보고서 참고) |
AI 필터 (전체 ▾) | 사람·AI 기여를 나눠서 보기 (아래 AI 필터 참고) |
날짜 범위 (지난 90일 ▾) | 분석 기간 변경 |
| 알림 🔔 | 이 대시보드의 지표 알림 설정 (알림 참고) |
| 새로고침 ↻ | 최신 GitLab 데이터로 갱신 |
| 공유 / 공유중 | 개인↔공유 전환(가시성) (데이터 공유 참고) |
| Edit | 편집 모드 진입 |
Mantis Insight
대시보드 상단의 Mantis Insight 패널(위 화면 참고)은 AI가 이 대시보드에서 발견한 신호를 카드로 정리해 보여 줍니다. 카드는 성격에 따라 위험 · 주의 · 긍정 · 중립 네 가지로 나뉩니다.
- 패널 헤더에 신규 N · 연속 N · 해소 N 으로 이번 갱신에서 새로 잡힌 신호, 계속 이어지는 신호, 사라진 신호의 개수를 요약합니다.
- 각 카드에는 신규 또는 N회 연속 배지와 함께 핵심 지표(예: 활성 사용률 1.8% ▼ -85%)가 붙습니다.
- 이번에 사라진 신호는 해소됨 취소선으로 표시됩니다(예: "리뷰 대기 MR 12건 적체 — 직전 생성에서 감지, 이번엔 재현되지 않음").
- 긍정·중립 카드는 기본적으로 접혀 있고 긍정·중립 등 N건 더 보기로 펼칠 수 있습니다.
인사이트 카드 펼치기
카드를 누르면 네 부분으로 나뉜 상세가 펼쳐집니다.
| 부분 | 내용 |
|---|---|
| 현황 | 무슨 일이 있었는지 데이터로 설명 |
| 시사점 | 이 신호가 왜 중요한지, 무엇을 뜻하는지 |
| 액션 | 지금 할 일과 다음 할 일을 지금 / 다음 칩으로 구분해 제시 |
| 추이 · 근거 쿼리 | 지표 추이를 보거나, 이 인사이트가 참고한 쿼리를 확인 |
💡 분석 범위(멤버 필터·AI 필터)를 바꾸면 인사이트는 "인사이트 범위가 변경되었습니다 — 재생성하기" 안내와 함께 무효화됩니다. 재생성하기를 누르면 바뀐 범위 기준으로 인사이트를 다시 만듭니다.
AI 필터
AI 필터는 사람과 AI(봇·에이전트)의 기여를 나눠서 볼 수 있게 해 줍니다. 헤더의 AI 필터 버튼을 누르면 세 가지 중에서 고릅니다.
| 항목 | 보이는 데이터 |
|---|---|
| 전체 (AI + 사람) | 사람과 AI 기여를 모두 합산 (기본값) |
| AI 활동만 | 봇·에이전트가 만든 활동만 |
| 사람 활동만 | 사람 개발자의 활동만 |
필터를 바꾸면 대시보드의 차트와 인사이트가 선택한 기준으로 다시 계산됩니다. Copilot·Duo 같은 AI 도구 도입 효과를 볼 때 유용합니다.
차트 상세 보기
차트를 클릭하면 상세 모달이 열립니다. 큰 차트와 함께 그 차트에 연결된 Mantis Insight 목록, 그리고 이 분석의 근거를 확인할 수 있습니다.
모달을 아래로 내리면 이 분석의 근거 섹션이 있습니다.
- 계산 근거: 이 차트의 수치를 어떻게 계산했는지 설명합니다.
- 근거 쿼리: 실제 실행된 PostgreSQL 쿼리를 접기/펼치기로 확인하고 복사할 수 있습니다.
- 차트에 따라 원본 데이터 테이블도 함께 제공됩니다.
- 모달 하단에는 데이터 출처인 연결된 GitLab 데이터베이스 표시가 있습니다.
💡 근거 쿼리는 "이 숫자가 어디서 나왔는지"를 그대로 보여 주므로, 결과를 검증하거나 다른 도구로 재현할 때 활용할 수 있습니다.
날짜 범위 선택
날짜 범위 버튼을 누르면 빠른 선택과 사용자 지정 달력이 열립니다.
빠른 선택(오늘, 지난 7일·30일·90일·365일) 또는 직접 기간을 지정할 수 있습니다. 범위를 바꾸면 대시보드의 모든 차트가 그 기간 기준으로 다시 계산됩니다.
데이터 새로고침
새로고침 ↻ 버튼은 연결된 GitLab의 최신 데이터로 대시보드를 갱신합니다. (조직 설정의 자동 동기화와 별개로 즉시 갱신할 때 사용)
편집 모드
Edit 버튼을 누르면 대시보드를 자유롭게 재구성할 수 있습니다.
- 카드 좌상단 드래그 핸들로 위치 변경, 우하단 핸들로 크기 조절
- 카드 우상단 ✕ 로 차트 삭제, 좌하단 📌 로 위치 고정
- 제목 옆 ✎ 로 제목·연결 범위 수정
- 화면 하단 중앙 채팅 입력창("어떻게 AI 대시보드를 수정할까요?")에 AI에게 수정을 요청할 수 있습니다. AI의 제안은 확인 후 대시보드에 반영됩니다.
- 완료 후 우측 상단 Save(저장) 또는 Cancel(취소)
프로젝트 삭제
- 편집 모드로 진입합니다.
- 우측 상단 휴지통 아이콘을 클릭합니다.
- 확인 메시지에서 삭제를 한 번 더 확인합니다.
⚠️ 프로젝트를 삭제하면 저장된 모든 차트가 함께 삭제됩니다. 되돌릴 수 없습니다.