GitHub

LaunchCal에서는 출시가 GitHub의 작업, 즉 조직의 프로젝트나 저장소의 마일스톤을 따르게 할 수 있습니다. 프로젝트나 마일스톤의 상태가 바뀌면 출시의 상태도 바뀌고, 그 진행률이 표시되며, 프로젝트의 상태 업데이트가 출시에 나타납니다.

Taktoria는 GitHub에서 읽기만 하며, 그곳에서 무엇도 만들거나 바꾸거나 댓글을 달지 않습니다. 사람이 아니라 조직에 설치된 앱으로 연결되므로 조직이 고른 저장소만 볼 수 있고, 누가 연결했든 계속 작동합니다.

GitHub는 워크스페이스 소유자나 관리자만 연결할 수 있습니다.

1. 설정 → 통합을 엽니다.
2. 티켓 시스템 아래에서 GitHub 연결을 선택합니다.
3. GitHub에서 조직에 Taktoria 앱을 설치하고, 앱이 읽을 수 있는 저장소를 고른 뒤 승인합니다.

앱은 조직의 프로젝트와, 저장소의 이슈, 풀 리퀘스트, 메타데이터를 읽을 권한을 요청합니다. 조직 소유자가 먼저 승인해야 하면 Taktoria가 알려 줍니다. 승인된 뒤 GitHub 연결을 다시 선택하세요. 그러면 카드에 연결된 조직이 표시됩니다. Taktoria 워크스페이스마다 하나를 연결합니다.

출시를 수정할 수 있는 사람은 누구나 연동, 동기화, 연동 해제를 할 수 있습니다.

1. 출시의 세부 정보 탭을 엽니다.
2. 티켓 프로젝트에서 조직의 프로젝트나 저장소의 마일스톤 주소를 프로젝트 링크에 붙여 넣습니다.
3. 프로젝트 연동을 선택합니다.

프로젝트는 연결된 조직의 것이어야 하고, 마일스톤은 앱이 읽을 수 있는 저장소에 있어야 합니다. 바로 동기화됩니다. 저장소나 GitHub의 다른 것은 일반 링크로 보관되며, GitHub가 연결되기 전에 붙여 넣은 링크도 연결될 때까지 일반 링크로 보관됩니다.

LaunchCal에 연결된 AI 어시스턴트와 REST API도 같은 규칙에 따라 출시를 연동, 동기화, 연동 해제할 수 있습니다.

연동된 출시는 출시될 때까지 하루에 한 번, 그리고 누군가 지금 동기화를 선택할 때마다 동기화됩니다.

프로젝트의 경우:

• 상태: 프로젝트의 가장 최근 상태 업데이트가 정합니다. On track, At risk, Off track은 개발 중(이미 디자인이나 테스트에 있는 출시는 그대로), Inactive는 일시 중지, Complete는 완료입니다. 아직 상태 업데이트가 없으면 프로젝트의 항목 중 하나가 완료될 때까지 범위 설정에 머뭅니다. 닫힌 프로젝트는 Inactive가 아니었다면 완료입니다.
• 진행률: 닫혔거나, 병합되었거나, 완료 열에 있는 항목의 비율입니다.
• 상태 업데이트: 각각 출시의 활동 탭에 업데이트로 추가되고, GitHub에서 가져옴 표시와 원본 링크가 붙습니다. 출시의 건강도는 가장 최근 업데이트를 따릅니다.

마일스톤의 경우: 열려 있고 닫힌 이슈가 없으면 범위 설정, 열려 있고 일부가 닫혔으면 개발 중, 닫혔으면 완료입니다. 진행률은 닫힌 이슈의 비율입니다. 마일스톤에는 업데이트가 없습니다.

프로젝트나 마일스톤이 완료되면 출시에 준비되었다고 표시되고 담당자에게 알립니다. LaunchCal에서 고른 상태는 GitHub의 상태가 다시 바뀔 때까지 유지됩니다. 동기화로 바뀐 내용은 출시 기록, 담당자에게 보내는 알림, 감사 로그에서 GitHub가 바꾼 것으로 표시됩니다.

• 무엇도 출시하지 않습니다. 완료된 프로젝트나 마일스톤은 출시를 준비 완료로 만들 뿐이며, 필수 검토가 결정되면 누군가 **눌러서 출시하기!**를 선택해야 합니다.
• 이미 출시된 출시는 바꾸지 않습니다.
• GitHub에 쓰지 않습니다.
• 조직이 허용하지 않은 저장소는 읽지 않습니다.

출시의 세부 정보 탭에서 연동 해제를 하면 그 출시의 동기화가 멈추며, 이미 가져온 내용은 그대로 남습니다.

설정 → 통합에서 연결 해제를 하면 GitHub에서 오는 모든 출시의 동기화가 멈추고, Taktoria의 접근도 즉시 끝납니다. 출시는 연동된 대상과 그때까지 동기화된 내용을 모두 유지하며, GitHub를 다시 연결하면 동기화를 이어 갑니다. 앱은 조직 소유자가 GitHub의 조직 설정에서 제거할 때까지 조직에 설치된 채로 남습니다.

• 프로젝트를 찾을 수 없음: 삭제되었거나, 조직이 앱에 허용하지 않은 저장소처럼 앱이 볼 수 없는 곳에 있습니다. 조직 소유자가 GitHub의 앱 설정에서 그 저장소를 앱의 접근 범위에 추가하거나, 현재 주소로 연동하세요.
• GitHub가 연결을 거부함: 앱이 제거되었거나 일시 중지되었습니다. 워크스페이스 소유자나 관리자가 설정 → 통합에서 GitHub를 다시 연결합니다.
• 앱이 승인을 기다리는 중: 조직 소유자가 GitHub에서 앱을 승인한 뒤 GitHub 연결을 다시 선택하세요.
• 지난 동기화에 GitHub가 응답하지 않음: 다음 동기화 때 다시 시도하며, 나중에 지금 동기화를 선택해도 됩니다.
• 일반 링크로 보관됨: GitHub가 아직 연결되지 않았거나, 주소가 조직의 프로젝트나 마일스톤의 주소가 아닙니다.