GitHub

No LaunchCal, um lançamento pode acompanhar o trabalho dele no GitHub: um projeto de uma organização ou um marco de um repositório. O status dele muda quando o do projeto ou do marco muda, ele mostra o progresso deles, e as atualizações de status de um projeto aparecem no lançamento.

O Taktoria só lê do GitHub: nunca cria, altera nem comenta nada lá. Ele é conectado como um app instalado na sua organização, e não como uma pessoa, então só vê os repositórios que a organização escolheu e continua funcionando seja quem for que o conectou.

Só um proprietário ou administrador do espaço de trabalho pode conectar o GitHub.

1. Abra Configurações → Integrações.
2. Em Sistemas de tickets, selecione Conectar o GitHub.
3. No GitHub, instale o app do Taktoria na organização, escolha quais repositórios ele pode ler e aprove.

O app pede para ler os projetos da organização e as issues, os pull requests e os metadados dos repositórios dela. Se um proprietário da organização precisar aprovar o app antes, o Taktoria avisa: selecione Conectar o GitHub de novo depois que ele aprovar. O cartão então mostra a qual organização ele está conectado. Cada espaço de trabalho do Taktoria conecta uma.

Qualquer pessoa que possa editar um lançamento pode vinculá-lo, sincronizá-lo ou desvinculá-lo.

1. Abra a aba Detalhes do lançamento.
2. Em Projeto de tickets, cole em Link do projeto o endereço do projeto da organização ou do marco do repositório.
3. Selecione Vincular projeto.

Um projeto precisa ser da organização conectada, e um marco precisa estar em um repositório que o app pode ler. Ele sincroniza na hora. Um repositório, ou qualquer outra coisa do GitHub, fica guardado como link simples, assim como um link colado antes de o GitHub ser conectado, até que ele seja.

Um assistente de IA conectado ao LaunchCal, e a API REST, também podem vincular, sincronizar e desvincular um lançamento, com as mesmas regras.

Um lançamento vinculado é sincronizado uma vez por dia até ser lançado, e sempre que alguém seleciona Sincronizar agora.

Para um projeto:

• Status: quem diz é a atualização de status mais recente do projeto. No caminho certo, em risco ou fora do caminho vira Em desenvolvimento (um lançamento que já está em Design ou Testes continua lá), inativo vira Em espera, e concluído deixa o trabalho pronto. Sem nenhuma atualização de status ainda, o lançamento fica em Escopo até que um dos itens do projeto seja concluído. Um projeto fechado está concluído, a menos que estivesse inativo.
• Progresso: a parcela dos itens fechados, mesclados ou em uma coluna de concluídos.
• Atualizações de status: cada uma vira uma atualização do lançamento na aba Atividade, marcada Do GitHub com um link para ela, e a saúde do lançamento segue a mais recente.

Para um marco: aberto sem nenhuma issue fechada vira Escopo, aberto com algumas fechadas vira Em desenvolvimento, e fechado está concluído. O progresso dele é a parcela das issues fechadas. Um marco não tem atualizações.

Quando o projeto ou o marco é concluído, o lançamento avisa que está pronto e os responsáveis são notificados. Um status que você escolhe no LaunchCal vale até o do GitHub mudar de novo. O que uma sincronização altera aparece como feito pelo GitHub, no histórico do lançamento, no que é enviado aos responsáveis e no log de auditoria.

• Nunca lança nada. Um projeto ou marco concluído deixa o lançamento pronto; alguém ainda precisa selecionar Aperte para lançar! quando as revisões obrigatórias forem decididas.
• Nunca altera um lançamento que já foi lançado.
• Nunca escreve no GitHub.
• Nunca lê um repositório que a organização não deu a ele.

Desvincular, na aba Detalhes do lançamento, interrompe a sincronização desse lançamento; o que já foi trazido continua.

Desconectar, em Configurações → Integrações, interrompe a sincronização de todos os lançamentos com o GitHub e encerra o acesso do Taktoria na hora. Os lançamentos mantêm o que vinculam e tudo o que foi sincronizado até então, e voltam a sincronizar assim que o GitHub é conectado de novo. O app continua instalado na organização até que um dos proprietários dela o desinstale nas configurações da organização no GitHub.

• O projeto não foi encontrado: ele foi excluído, ou está em um lugar que o app não vê, como um repositório que a organização não deu a ele. Um proprietário da organização pode adicionar o repositório ao acesso do app nas configurações dele no GitHub; ou vincule o endereço atual.
• O GitHub recusou a conexão: o app foi desinstalado ou suspenso. Um proprietário ou administrador do espaço de trabalho conecta o GitHub de novo em Configurações → Integrações.
• O app está aguardando aprovação: um proprietário da organização o aprova no GitHub; depois, selecione Conectar o GitHub de novo.
• O GitHub não respondeu na última sincronização: a próxima tenta de novo, ou selecione Sincronizar agora mais tarde.
• Ficou guardado como link simples: o GitHub ainda não está conectado, ou o endereço não é de um projeto de uma organização nem de um marco.