Resumo de arquitetura da equipe

O resumo da equipe envia um balanço recorrente por e-mail da atividade de arquitetura para a lista de e-mail de uma equipe. Cada equipe configura sua própria programação, fuso horário, endereço de destino e as seções que lhe interessam — assim as pessoas certas recebem as informações certas na hora certa, sem precisar fazer login.

Apenas os projetos pertencentes à equipe são incluídos no resumo, então o e-mail de cada equipe fica restrito ao seu próprio perímetro.

O que um resumo contém

Um resumo pode incluir até sete seções, cada uma ativável por equipe:

  • Saúde da arquitetura — drift score com a variação em relação ao período anterior, taxa de conformidade, número de deploys, lead time e MTTR (snapshot DORA).
  • Mudanças na arquitetura — elementos C4 adicionados, atualizados ou removidos (principais itens).
  • Decisões (ADRs) — ADRs abertos ou mesclados no período.
  • Pull requests — Architecture Change Requests por status.
  • Conformidade — novas violações e taxa de conformidade.
  • Discussões — novas threads de comentários abertas em elementos de arquitetura (containers, componentes, ADRs, …).
  • Insights — insights de arquitetura gerados para o período.

As seções sem nova atividade no período são omitidas automaticamente — sua equipe não vai receber um e-mail pela metade.

Ativar o resumo

Um administrador da equipe configura o resumo nas configurações da equipe:

  1. Abra o seletor de equipes e clique nas configurações da equipe.
  2. Vá para a aba Resumo.
  3. Informe o e-mail da equipe (normalmente uma lista de e-mail compartilhada como team-frontend@company.com).
  4. Escolha uma frequência: semanal, a cada duas semanas ou mensal.
  5. Escolha o dia (segunda-feira por padrão para semanal/a cada duas semanas, dia 1 para mensal) e a hora de envio.
  6. Escolha o fuso horário da equipe para que o resumo chegue no horário local correto.
  7. Marque as seções que deseja incluir.
  8. Clique em Salvar.

O resumo fica desativado (frequência Desativado) até você salvar com uma frequência diferente de off.

Pré-visualizar e testar

Antes de ativar a programação recorrente, valide a aparência e o conteúdo:

  • Pré-visualizar — abre uma pré-visualização inline do e-mail renderizado com os dados mais recentes. Nenhum e-mail é enviado.
  • Enviar teste — envia imediatamente um único e-mail para o endereço de resumo configurado na equipe. Útil para verificar a entregabilidade e como o e-mail aparece no seu cliente de e-mail real.

A pré-visualização mostra o mesmo HTML que os destinatários verão, incluindo a adaptação ao modo claro/escuro quando o cliente de e-mail deles suporta prefers-color-scheme.

Como a programação funciona

Um agendador é executado a cada hora. Para cada equipe que não está Desativado:

  • A hora atual é convertida para o fuso horário da equipe.
  • Se a hora local corresponder a Enviar às, a regra do dia é verificada:
    • Semanal corresponde ao dia da semana configurado.
    • A cada duas semanas corresponde ao dia da semana nas semanas ISO pares.
    • Mensal corresponde ao dia do mês configurado, limitado ao último dia do mês (então o dia 31 envia em 28 de fevereiro).
  • Se um resumo já foi enviado dentro da janela de segurança (6 dias para semanal, 13 para a cada duas semanas, 27 para mensal), a execução é ignorada — uma proteção contra envios duplicados caso o cron tente de novo.

Você pode alterar a programação a qualquer momento. O próximo tick elegível aplica a nova configuração.

Destinatário

Cada equipe tem um único endereço digest_email. Use uma lista de e-mail compartilhada se quiser que todos os membros da equipe recebam o resumo — o resumo não é personalizado, então um único destinatário com encaminhamento para toda a equipe é o modelo mais simples.

Se o endereço estiver vazio quando você mudar a frequência de Desativado para outra opção, o salvamento é rejeitado.

Permissões

  • Membros da equipe podem ler a configuração do resumo.
  • Administradores da equipe podem atualizar a configuração, gerar uma pré-visualização, enviar um e-mail de teste e ativar/desativar o resumo.
  • Administradores da organização são tratados como administradores de todas as equipes da organização.

Interromper ou pausar o resumo

Defina a frequência como Desativado nas configurações da equipe — o resumo para no próximo tick. A configuração é preservada, então você pode reativá-lo depois sem precisar preencher tudo de novo.

Relacionados