팀 아키텍처 다이제스트

팀 다이제스트는 아키텍처 활동을 요약한 이메일을 팀 메일링 리스트로 정기적으로 보내 줍니다. 각 팀은 자체 일정, 시간대, 수신 주소, 관심 있는 섹션을 직접 설정합니다 — 그래서 로그인하지 않아도 적절한 사람이 적절한 정보를 적절한 때에 받아 볼 수 있습니다.

다이제스트에는 해당 팀이 소유한 프로젝트만 포함되므로, 각 팀의 이메일은 자기 팀의 담당 범위로 한정됩니다.

다이제스트에 포함되는 내용

다이제스트에는 최대 7개의 섹션을 넣을 수 있으며, 각 섹션은 팀별로 켜고 끌 수 있습니다.

아키텍처 건강 상태 — 이전 기간 대비 변화량을 포함한 드리프트 점수, 준수 통과율, 배포 횟수, 리드 타임, MTTR(DORA 스냅샷).
아키텍처 변경 사항 — 추가, 수정 또는 삭제된 C4 요소(상위 항목).
결정 사항 (ADR) — 해당 기간에 생성되거나 병합된 ADR.
풀 리퀘스트 — 상태별 Architecture Change Request.
준수 — 새로운 위반 사항과 통과율.
토론 — 아키텍처 요소(컨테이너, 컴포넌트, ADR 등)에서 새로 시작된 댓글 스레드.
인사이트 — 해당 기간에 생성된 아키텍처 인사이트.

해당 기간에 새로운 활동이 없는 섹션은 자동으로 생략됩니다 — 팀에 반쯤 빈 이메일이 가는 일은 없습니다.

팀 관리자가 팀 설정에서 다이제스트를 설정합니다.

off가 아닌 빈도로 저장하기 전까지 다이제스트는 비활성 상태(빈도 사용 안 함)로 유지됩니다.

정기 일정을 켜기 전에 모양과 내용을 확인하세요.

미리보기 — 최신 데이터로 렌더링한 이메일 미리보기를 화면에서 바로 엽니다. 이메일은 발송되지 않습니다.
테스트 전송 — 팀에 설정된 다이제스트 주소로 이메일 한 통을 즉시 보냅니다. 전달 여부와 실제 메일 클라이언트에서 이메일이 어떻게 보이는지 확인할 때 유용합니다.

미리보기에는 수신자가 보게 될 것과 동일한 HTML이 표시되며, 수신자의 메일 클라이언트가 prefers-color-scheme을 지원하는 경우 다크/라이트 모드 대응도 포함됩니다.

스케줄러는 매시간 실행됩니다. 사용 안 함 상태가 아닌 각 팀에 대해:

현재 시각을 팀의 시간대로 변환합니다.
현지 시각이 발송 시각과 일치하면 요일/날짜 규칙을 확인합니다.
- 매주는 설정된 요일과 일치할 때 발송합니다.
- 격주는 짝수 ISO 주차의 해당 요일과 일치할 때 발송합니다.
- 매월은 설정된 날짜와 일치할 때 발송하며, 해당 월의 마지막 날을 넘지 않습니다(따라서 31일로 설정하면 2월에는 28일에 발송됩니다).
안전 기간(매주 6일, 격주 13일, 매월 27일) 안에 이미 다이제스트가 발송되었다면 해당 실행은 건너뜁니다 — cron이 재시도할 때 중복 발송을 막기 위해서입니다.

일정은 언제든 변경할 수 있습니다. 다음 실행 시점부터 새 설정이 적용됩니다.

각 팀은 하나의 digest_email 주소만 가집니다. 모든 팀원이 다이제스트를 받게 하려면 공용 메일링 리스트를 사용하세요 — 다이제스트 자체는 개인화되지 않으므로, 수신자 하나에 팀 전체로 전달하는 방식이 가장 간단합니다.

빈도를 사용 안 함에서 다른 값으로 바꿀 때 주소가 비어 있으면 저장이 거부됩니다.

팀 설정에서 빈도를 사용 안 함으로 설정하세요 — 다음 실행 시점부터 다이제스트가 중지됩니다. 설정은 그대로 보존되므로, 나중에 모든 항목을 다시 입력하지 않고도 다시 활성화할 수 있습니다.