Resumen de arquitectura del equipo

El resumen del equipo envía periódicamente por correo un resumen de la actividad de arquitectura a la lista de correo de un equipo. Cada equipo configura su propia periodicidad, zona horaria, dirección de destino y las secciones que le interesan — para que las personas adecuadas vean la información adecuada en el momento adecuado, sin tener que iniciar sesión.

Solo se incluyen en el resumen los proyectos que pertenecen al equipo, de modo que el correo de cada equipo se limita a su propio perímetro.

Qué incluye un resumen

Un resumen puede incluir hasta siete secciones, cada una activable por equipo:

  • Salud de la arquitectura — puntuación de deriva con la variación respecto al periodo anterior, tasa de conformidad, número de despliegues, lead time y MTTR (instantánea DORA).
  • Cambios de arquitectura — elementos C4 añadidos, actualizados o eliminados (los principales).
  • Decisiones (ADR) — ADR abiertos o fusionados en el periodo.
  • Pull requests — Architecture Change Requests por estado.
  • Conformidad — nuevas violaciones y tasa de conformidad.
  • Discusiones — nuevos hilos de comentarios abiertos sobre elementos de arquitectura (contenedores, componentes, ADR, …).
  • Insights — insights de arquitectura generados para el periodo.

Las secciones sin actividad nueva en el periodo se omiten automáticamente — tu equipo no recibirá un correo medio vacío.

Activar el resumen

Un administrador del equipo configura el resumen desde los ajustes del equipo:

  1. Abre el selector de equipos y haz clic en los ajustes del equipo.
  2. Ve a la pestaña Resumen.
  3. Introduce el correo del equipo (normalmente una lista de correo compartida como team-frontend@company.com).
  4. Elige una frecuencia: semanal, cada dos semanas o mensual.
  5. Elige el día (lunes por defecto para semanal/cada dos semanas, día 1 para mensual) y la hora de envío.
  6. Elige la zona horaria del equipo para que el resumen llegue a la hora local correcta.
  7. Marca las secciones que quieres incluir.
  8. Haz clic en Guardar.

El resumen permanece desactivado (frecuencia Desactivado) hasta que guardes con una frecuencia distinta de off.

Vista previa y prueba

Antes de activar el envío periódico, valida el aspecto y el contenido:

  • Vista previa — abre una vista previa integrada del correo renderizado con los datos más recientes. No se envía ningún correo.
  • Enviar prueba — envía de inmediato un único correo a la dirección de resumen configurada para el equipo. Útil para comprobar la entregabilidad y cómo se ve el correo en tu cliente real.

La vista previa muestra el mismo HTML que verán los destinatarios, incluida la adaptación al modo oscuro/claro cuando su cliente de correo admite prefers-color-scheme.

Cómo funciona la programación

Un programador se ejecuta cada hora. Para cada equipo que no esté en Desactivado:

  • La hora actual se convierte a la zona horaria del equipo.
  • Si la hora local coincide con Enviar a las, se comprueba la regla del día:
    • Semanal coincide con el día de la semana configurado.
    • Cada dos semanas coincide con el día de la semana en las semanas ISO pares.
    • Mensual coincide con el día del mes configurado, limitado al último día del mes (así, el día 31 se envía el 28 de febrero).
  • Si ya se envió un resumen dentro de la ventana de seguridad (6 días para semanal, 13 para cada dos semanas, 27 para mensual), la ejecución se omite — lo que evita envíos duplicados si el cron reintenta.

Puedes cambiar la programación en cualquier momento. El siguiente tick elegible aplicará la nueva configuración.

Destinatario

Cada equipo tiene una única dirección digest_email. Usa una lista de correo compartida si quieres que todos los miembros del equipo reciban el resumen — el resumen en sí no está personalizado, así que un único destinatario con reenvío a todo el equipo es el modelo más sencillo.

Si la dirección está vacía cuando cambias la frecuencia desde Desactivado, el guardado se rechaza.

Permisos

  • Los miembros del equipo pueden leer la configuración del resumen.
  • Los administradores del equipo pueden actualizar la configuración, generar una vista previa, enviar un correo de prueba y activar o desactivar el resumen.
  • Los administradores de la organización se tratan como administradores de todos los equipos de su organización.

Detener o pausar el resumen

Pon la frecuencia en Desactivado en los ajustes del equipo — el resumen se detiene en el siguiente tick. La configuración se conserva, así que puedes reactivarlo más adelante sin volver a introducirlo todo.

Relacionado