Documentación

La fábrica

Lo que produjo la fábrica, cuánto costó, lo que requiere tu atención y cómo se desarrolló cada tarea.

La fábrica es el lugar al que accedes tras iniciar sesión. Muestra lo que ha entregado tu fábrica y cuánto ha costado, así como lo que requiere tu atención; cada tarea y plan se presentan como la historia de cómo se desarrollaron. Desde ella puedes acceder a tareas, carriles, planes, automatizaciones e informes, para tener un único lugar donde responder a las preguntas: «¿Qué hemos obtenido y qué necesita mi atención?».

Para qué sirve

La fábrica responde a las preguntas: «¿Qué se ha entregado, cuánto ha costado y qué necesita mi atención?». Mission Control, a un clic de distancia, responde a «¿Qué se está ejecutando en este momento?».

Esta diferencia es importante cuando tienes más de un par de tareas en curso. La fábrica es donde tomas decisiones; Mission Control es donde observas el proceso.

Resumen

Selecciona esta semana o este mes, y todos los proyectos o uno solo, bajo el título correspondiente.

  • Tres cifras: solicitudes de incorporación fusionadas, trabajo finalizado y dinero gastado, cada una comparada con el período anterior («4 más que la semana pasada»). La cuenta de solicitudes fusionadas incluye todas las de pull request fusionadas en tus repositorios conectados, independientemente de quién las haya abierto, y indica cuántas realizó Coroid («11 por parte de Coroid»). Elige una cifra para verla en las últimas ocho semanas o meses; el coste por pull request fusionado por Coroid aparece debajo del gráfico. Estas cifras provienen de registros reales, nunca de un modelo.
  • Requiere tu atención Muestra únicamente las decisiones que alguien debe tomar: un plan por aprobar, trabajo pendiente de revisar o fusionar, un problema de prueba sin tarea asignada, una solicitud para aceptar y trabajo que falló o está bloqueado. Su encabezado cuenta cuántos hay; los cinco primeros se muestran, y Mostrar más Añade el resto. Abre una fila para ver su acción específica, o ponla aparte con «Ahora no».
  • Proyectos Muestra una fila por proyecto con trabajo en el período, ordenadas principalmente por las más fusionadas. Abre una fila para ver las cifras propias del proyecto, su trabajo en curso, si lo entregado funciona correctamente en producción y cómo se desarrolló el trabajo: con qué frecuencia el control de calidad lo aprobó a la primera y cuánto tiempo tardó el trabajo desde la solicitud hasta la entrega. Los proyectos sin actividad en el período se agrupan en una sola fila («4 proyectos están inactivos»).
  • Finalizado esta semana Muestra los resultados, del más reciente al anterior; las automatizaciones rutinarias se agrupan en una sola línea.
  • Todo el trabajo Abre la lista completa de tareas, carriles, planes, automatizaciones e informes, ordenados por estado.

Cuando el trabajo se fusiona, utiliza Lanzamientos para seguir el commit seleccionado a través de su preparación, intentos de despliegue y estado del entorno. Una tarea completada o un carril promocionado no constituyen un resultado de despliegue.

Fábrica
Esta semanacoroid-expoMis solicitudesResumen de la Fábrica
Fusionados
9
6 more than last week
7 por Coroid
Finalizados
7
5 more than last week
Consumido
17,41 US$
376 % more than last week
14 septEsta semana
Requiere tu atención10
Seleccionar
  • Upgrade uuid (breaking change) is blockedcoroid-expo · hace 2 días
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · hace 4 días
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · hace 4 días
Proyectos
  • coroid-expo9 fusionados · 7 finalizados · 17,41 US$ · 10 esperando tu aprobación

Resumen de la Fábrica: los datos de la semana en tres cifras y un gráfico, lo que necesita tu atención y una fila por proyecto. Datos ilustrativos.

Resolver muchas decisiones a la vez

Cuando el trabajo antiguo se acumule en «Requiere tu atención», selecciona varias filas a la vez: pasa el cursor sobre una fila y su punto se convertirá en una casilla de verificación, o utiliza Seleccionar junto al encabezado (en móvil). Seleccionar todo selecciona todas las filas. Luego:

  • Ahora no Pone las filas aparte para ti hasta que su trabajo cambie. Los demás todavía las verán.
  • Cerrar para todos (propietarios y administradores) archiva los planes, cancela las tareas pendientes de revisión y descarta el resto (trabajo fallido, problemas de prueba, solicitudes) para toda la organización hasta que su trabajo cambie. Coroid pregunta primero y nada se elimina.

Decidir una fusión

Un plan listo para fusionar se abre en su pantalla de decisión: cuánto tiempo ha esperado, qué implica la fusión («Fusionar lo coloca en la rama principal de coroid-expo.»), una serie de datos (sus tareas, sus comprobaciones, el pull request), y secciones cerradas con los cambios realizados, cualquier detalle relevante, las pruebas y cómo llegó a ese punto. Aprobar y fusionar Pregunta una vez más antes de fusionar; Otras opciones incluye Solicitar cambios, Preguntar sobre esto, el pull request y el nombre de la rama.

Cómo se desarrolló una tarea

Abre una tarea y verás su hilo: una frase que describe lo ocurrido (o lo que está ocurriendo ahora), una línea con datos (criterios cumplidos, tiempo, coste, rondas de control de calidad), un seguimiento de los estados Pedido, Planificado, Desarrollado, Comprobado y Entregado, y los mensajes que llevaron a ese punto: la solicitud, cada orden de trabajo, los informes del desarrollador y del equipo de control de calidad, las respuestas de tu equipo y cómo finalizó. Cuando el control de calidad devolvió el trabajo, esas rondas se agrupan en una línea que puedes abrir.

Selecciona un mensaje para ver su registro: la orden de trabajo, las comprobaciones y la ejecución con su modelo, tokens y tiempo, además de un acceso al historial completo. «Sobre este trabajo» contiene la especificación, quién la solicitó, el plan, la calidad y el coste.

Un plan se lee de la misma manera: sus fases forman el mapa, cada tarea muestra cómo se desarrolló y cuántas tareas aprobó el control de calidad a la primera.

El trabajo interrumpido se indica en rojo, con información sobre lo que es seguro («Seguro: la rama principal no ha cambiado.»), por qué se detuvo (sus últimos mensajes y el fallo registrado) y Reintentar ahora.

Al final de un hilo puedes:

  • Responder, y mencionar personas con @; recibirán una notificación con un enlace.
  • Preguntar al asistente sobre el trabajo. Leerá el hilo para responder («¿Por qué fue devuelto?») y enlazará a lo que encontró.
  • Compartir compártelo con los miembros de tu organización; recibirán una notificación con su enlace. Nadie fuera de tu organización podrá abrirlo.
  • Copiar como resumen breve: un breve resumen con el resultado, los datos relevantes y el enlace, para pegarlo en cualquier lugar.

Seguir el progreso de una tarea

Abre una tarea en ejecución para seguirla en tiempo real: los pasos realizados, las herramientas utilizadas, los archivos modificados y los resultados de las pruebas a medida que se generan.

Vale la pena hacerlo unas cuantas veces al principio. Seguir el desarrollo completo de dos o tres tareas te enseñará más sobre cómo redactar una buena especificación que cualquier documentación: verás exactamente en qué momento el agente tuvo que hacer suposiciones.

Después de eso, deja de seguir el proceso. Las notificaciones te avisarán cuando algo requiera tu intervención.

Intervenir

Puedes pausar, cancelar o devolver una tarea en ejecución con comentarios. Consulta Cuando una tarea se bloquea o falla para saber cuándo aplicar cada opción.

Automatización

El trabajo no siempre comienza con alguien escribiendo una descripción:

  • Automatizaciones inician el trabajo según un horario o cuando ocurre algún evento, como la apertura de un pull request. Se listan bajo la sección Automatizaciones.
  • Programaciones ejecutan trabajos de forma recurrente.
  • Hooks reaccionan a eventos de la plataforma.
  • Informes resumen lo ocurrido, según un horario establecido.

En esta sección