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 尚未連結，或者該網址不是組織的專案或里程碑。