Linear

No LaunchCal, um lançamento pode acompanhar o projeto do Linear em que ele é construído. O status dele muda quando o do projeto muda, ele mostra o progresso do projeto, e as atualizações de status do projeto aparecem no lançamento, então os responsáveis e revisores veem como o trabalho está indo sem precisar perguntar.

O Taktoria só lê do Linear: nunca cria, altera nem comenta nada lá. O Linear é conectado como um app, e não como uma pessoa, então continua funcionando seja quem for que o conectou.

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

1. Abra Configurações → Integrações.
2. Em Sistemas de tickets, selecione Conectar o Linear.
3. No Linear, escolha o espaço de trabalho do Linear a conectar e aprove.

O cartão então mostra a qual espaço de trabalho do Linear ele está conectado. Cada espaço de trabalho do Taktoria conecta um.

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 da página do projeto no Linear.
3. Selecione Vincular projeto.

O projeto precisa estar no espaço de trabalho do Linear conectado, e sincroniza na hora. Um link colado antes de o Linear ser conectado fica guardado como link simples, e começa a sincronizar assim que ele for conectado.

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.

• Status: quando o status do projeto muda, o do lançamento acompanha: backlog ou planejado vira Escopo, iniciado vira Em desenvolvimento (um lançamento que já está em Design ou Testes continua lá), e pausado ou cancelado vira Em espera. Um status que você escolhe no LaunchCal vale até o do projeto mudar de novo.
• Progresso: o do próprio projeto.
• Atualizações de status: cada uma vira uma atualização do lançamento na aba Atividade, marcada Do Linear com um link para ela, e a saúde do lançamento segue a mais recente. Edite uma no Linear e a próxima sincronização traz a mudança; o lançamento guarda o histórico delas.
• Concluído: quando o projeto é concluído, o lançamento avisa que está pronto e os responsáveis são notificados.

O que uma sincronização altera aparece como feito pelo Linear, no histórico do lançamento, no que é enviado aos responsáveis e no log de auditoria.

• Nunca lança nada. Um projeto 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 Linear.
• Nunca desfaz um status que você escolheu no LaunchCal, a menos que o status do projeto mude de novo.

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 Linear e retira o acesso do Taktoria lá. Os lançamentos mantêm o que vinculam e tudo o que foi sincronizado até então, e voltam a sincronizar assim que o Linear é conectado de novo.

• O projeto não foi encontrado: ele foi excluído, ou movido para um espaço de trabalho do Linear diferente do conectado. Vincule o endereço atual dele.
• O Linear recusou a conexão: um proprietário ou administrador do espaço de trabalho conecta o Linear de novo em Configurações → Integrações.
• O Linear não respondeu na última sincronização: a próxima tenta de novo, ou selecione Sincronizar agora mais tarde.
• O projeto ficou guardado como link simples: o Linear ainda não está conectado, ou o endereço não é de um projeto. Cole o endereço da página do próprio projeto.
• O status do lançamento não mudou: uma sincronização só o muda quando o status do projeto muda, e nunca depois que o lançamento foi lançado.