Jira·GitHub 연동

브랜치·PR에 연결된 Jira 티켓으로 AI 코딩 비용을 롤업하려면, 조직에 Jira(그리고 선택적으로 GitHub App)를 한 번 연결합니다. 연결 후에는 자동으로 동기화됩니다.

이 설정은 조직 관리자(org_admin) 만 할 수 있습니다. 대시보드 헤더의 관리 → 연동 에서 진행합니다.

준비물

• 조직 관리자 권한
• Jira Cloud 계정 (your-org.atlassian.net)
• Jira API 토큰 — id.atlassian.com/manage-profile/security/api-tokens 에서 발급

1. Jira 연결

관리 → 연동 → Jira 연동 에 아래를 입력하고 저장합니다.

저장하면 taco가 각 티켓의 개발 정보(dev-status) — 연결된 브랜치·PR — 를 읽어 이벤트를 티켓에 귀속합니다.

2. (선택) 동기화 프로젝트

기본은 전체 프로젝트 동기화입니다. 특정 프로젝트를 빼고 싶으면 동기화 프로젝트 목록에서 해당 프로젝트를 끄면 됩니다.

3. (선택) GitHub App 설치

브랜치명이나 PR에 티켓 키가 없어도, 커밋 메시지([DO-3809] ...)로 티켓을 매칭하려면 GitHub App이 필요합니다.

관리 → 연동 → GitHub App 연동 → 설치 를 눌러 조직 GitHub에 설치하세요. 설치 후 백엔드가 브랜치의 커밋 메시지에서 티켓 키를 해석합니다.

GitHub App 없이도 브랜치명·PR에 키가 있으면(feature/DO-3809) 매칭됩니다. GitHub App은 키가 안 박힌 브랜치까지 잡아주는 보강 수단입니다.

동기화: 지금 vs 전체 다시

연결하면 taco가 주기적으로 자동 동기화합니다. 필요할 때 수동으로도 돌릴 수 있어요.

• 지금 동기화 — 최근 기간의 티켓만 빠르게 갱신합니다. 방금 만든 브랜치를 즉시 반영하고 싶을 때.
• 전체 다시 동기화 — 기간 제한 없이 모든 티켓을 다시 조회하고 전 기간 비용을 티켓에 다시 귀속합니다. 처음 연동했거나 과거 데이터가 비어 보일 때 한 번 (수 분 소요).

결과 보기

• 대시보드 조직 그룹의 티켓 탭 — 티켓·프로젝트·에픽별 비용 롤업
• 개인 홈의 티켓별 사용 카드 — 내 작업을 티켓 단위로

티켓이 어떻게 매칭되는지(브랜치명·커밋 메시지, 화이트리스트 프로젝트)는 티켓별 비용을 참고하세요.

잘 안 될 때

• 티켓에 비용이 안 붙어요 — 브랜치명에도 커밋 메시지에도 티켓 키가 없으면 매칭할 신호가 없습니다. 브랜치명에 키를 넣거나(feature/DO-1234), 커밋 메시지에 [DO-1234]를 쓰거나, GitHub App을 설치하세요.
• 과거 데이터가 비어 보여요 — 전체 다시 동기화를 한 번 돌려 전 기간을 재귀속하세요.
• 키가 티켓으로 안 잡혀요 — 화이트리스트에 없는 프로젝트일 수 있습니다 → 티켓별 비용 · 화이트리스트.

다음

• 티켓별 비용
• 대시보드 둘러보기