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 尚未连接，或者该地址不是组织的项目或里程碑。