GitHub

En LaunchCal, un lanzamiento puede seguir su trabajo en GitHub: un proyecto de una organización o un hito de un repositorio. Su estado cambia cuando cambia el del proyecto o el del hito, muestra su avance, y las actualizaciones de estado de un proyecto aparecen en el lanzamiento.

Taktoria solo lee de GitHub: nunca crea, cambia ni comenta nada allí. Se conecta como una app instalada en tu organización y no como una persona, así que solo ve los repositorios que eligió la organización, y sigue funcionando sea quien sea quien lo conectó.

Solo una persona propietaria o administradora del espacio de trabajo puede conectar GitHub.

1. Abre Configuración → Integraciones.
2. En Sistemas de tickets, selecciona Conectar GitHub.
3. En GitHub, instala la app de Taktoria en la organización, elige qué repositorios puede leer y apruébalo.

La app pide leer los proyectos de la organización, y las incidencias, las pull requests y los metadatos de sus repositorios. Si una persona propietaria de la organización tiene que aprobarla primero, Taktoria lo indica: selecciona de nuevo Conectar GitHub cuando lo haya hecho. Después, la tarjeta indica a qué organización está conectado. Cada espacio de trabajo de Taktoria conecta una.

Cualquiera que pueda editar un lanzamiento puede vincularlo, sincronizarlo o desvincularlo.

1. Abre la pestaña Detalles del lanzamiento.
2. En Proyecto de tickets, pega en Enlace del proyecto la dirección del proyecto de la organización o del hito del repositorio.
3. Selecciona Vincular proyecto.

Un proyecto tiene que ser de la organización conectada, y un hito, de un repositorio que la app pueda leer. Se sincroniza al momento. Un repositorio, o cualquier otra cosa de GitHub, se guarda como un simple enlace, igual que un enlace pegado antes de conectar GitHub, hasta que se conecta.

Un asistente de IA conectado a LaunchCal, y la API REST, también pueden vincular, sincronizar y desvincular un lanzamiento, con las mismas reglas.

Un lanzamiento vinculado se sincroniza una vez al día hasta que se lanza, y cada vez que alguien selecciona Sincronizar ahora.

Para un proyecto:

• Estado: lo dice la actualización de estado más reciente del proyecto. En buen camino, en riesgo o desviado es En desarrollo (un lanzamiento que ya está en Diseño o Pruebas se queda ahí), inactivo es En pausa, y completado significa hecho. Sin ninguna actualización de estado todavía, el lanzamiento se queda en Definición hasta que se hace alguno de los elementos del proyecto. Un proyecto cerrado está hecho, salvo que estuviera inactivo.
• Avance: la proporción de sus elementos cerrados, fusionados o en una columna de terminados.
• Actualizaciones de estado: cada una se convierte en una actualización del lanzamiento en su pestaña Actividad, marcada Desde GitHub con un enlace a ella, y la salud del lanzamiento sigue a la más reciente.

Para un hito: abierto sin ninguna incidencia cerrada es Definición, abierto con alguna cerrada es En desarrollo, y cerrado significa hecho. Su avance es la proporción de sus incidencias cerradas. Un hito no tiene actualizaciones.

Cuando el proyecto o el hito está hecho, el lanzamiento indica que está listo y se avisa a sus responsables. Un estado que elijas en LaunchCal se mantiene hasta que el de GitHub vuelva a cambiar. Lo que cambia una sincronización aparece como obra de GitHub, en el historial del lanzamiento, en lo que se envía a sus responsables y en el registro de auditoría.

• Nunca lanza nada. Un proyecto o un hito hecho deja el lanzamiento listo; alguien tiene que seleccionar ¡Pulsa para lanzar! cuando se hayan decidido sus revisiones obligatorias.
• Nunca cambia un lanzamiento que ya se ha lanzado.
• Nunca escribe en GitHub.
• Nunca lee un repositorio que la organización no le haya dado.

Desvincular, en la pestaña Detalles del lanzamiento, detiene la sincronización de ese lanzamiento; lo que se trajo se queda.

Desconectar, en Configuración → Integraciones, detiene la sincronización de todos los lanzamientos desde GitHub y retira al momento el acceso de Taktoria. Los lanzamientos conservan lo que tienen vinculado y todo lo sincronizado hasta entonces, y retoman la sincronización en cuanto GitHub vuelve a conectarse. La app sigue instalada en la organización hasta que una de sus personas propietarias la desinstala en la configuración de la organización en GitHub.

• No se encontró el proyecto: se eliminó, o está en un lugar que la app no ve, como un repositorio que la organización no le dio. Una persona propietaria de la organización puede añadir el repositorio al acceso de la app en su configuración en GitHub; o vincula la dirección actual.
• GitHub rechazó la conexión: la app se desinstaló o se suspendió. Una persona propietaria o administradora del espacio de trabajo vuelve a conectar GitHub en Configuración → Integraciones.
• La app está pendiente de aprobación: una persona propietaria de la organización la aprueba en GitHub; después, selecciona de nuevo Conectar GitHub.
• GitHub no respondió en la última sincronización: la próxima lo vuelve a intentar, o selecciona Sincronizar ahora más tarde.
• Se guarda como un simple enlace: GitHub aún no está conectado, o la dirección no es la de un proyecto de una organización ni la de un hito.