시스템 아키텍처 발표

템플릿 소개

어떤 자리에 내놓는 자료인가

구성 방식과 그렇게 정한 이유를 짧게 설명하는 8장 자료입니다. 기술 검토 회의보다는 승인권자나 타 부서를 상대로 결론을 전달하는 자리에 맞습니다. 컴포넌트별 인터페이스 명세나 데이터 흐름 전체를 다루려면 장수가 부족하고, 그런 내용은 별도 설계서로 남겨야 합니다.

구성도 도형은 파일에 없습니다

이 8장에는 박스와 화살표로 된 구성도가 들어 있지 않습니다. 본문 슬라이드는 제목, 한 줄 요약, 불릿 3개 구조입니다. 그림이 필요하면 본문 슬라이드를 복제한 뒤 불릿 도형을 지우고 그 자리에 구성도를 직접 그려 넣는 방식이 가장 빠릅니다. 그림 한 장은 계층을 3단까지만 두고, 그 이상은 다음 장으로 나눕니다. 4장에 이미 “관문·서비스·저장소 3계층 구분”이라고 적혀 있으니 그림의 층도 이 세 단계에 맞추면 말과 그림이 같아집니다.

채우는 순서

1. 표지 라벨과 제목을 시스템 이름과 문서 버전으로 바꾸고, 아래 “2026. 발표자 이름 / 소속” 줄과 템플릿 안내 문장도 함께 고칩니다.
2. 2장 목차는 경계와 구성, 단일 구조와 분리 구조, 핵심 지표, 추이 분석 네 항목입니다. 네 줄 모두 뒤에 슬라이드가 있어서, 첫 줄은 3장 간지와 4장 본문 한 쌍이, 나머지 셋은 5장 좌우 비교와 6장 지표 카드, 7장 막대가 한 장씩 받습니다.
3. 따라서 설명 순서를 바꾸려면 항목을 채우는 것이 아니라 자리를 늘려야 합니다. 요구 조건 · 데이터 흐름 · 장애 대응 · 보안 · 남은 결정 사항처럼 한 장씩 필요한 주제가 있으면 3장과 4장을 한 쌍으로 복제하고 2장 차례에 같은 이름의 줄을 더하십시오. 간지 번호가 01 하나뿐이므로 02 이하는 손으로 이어 붙여야 합니다.
4. 5장 단일 구조와 분리 구조의 좌우 세 줄을 우리 시스템 기준으로 고칩니다. 왼쪽 기존 단일 구조에는 웹·API·배치가 한 서버에 · 배포할 때 전체가 중단 · 장애가 전 기능으로 번짐, 오른쪽 개선 분리 구조에는 역할별 3개 서비스로 분리 · 무중단 순차 배포 · 장애 영향 범위를 격리가 들어 있어 구성 방식·배포 방식·장애 전파 범위 순으로 한 줄씩 마주 봅니다. 여기에 as-is와 to-be 그림을 좌우로 넣어도 도형 위치가 맞습니다.

예시

• 4장 본문 불릿 — 기본값은 관문·서비스·저장소 3계층 구분 / 외부 연동 지점 6곳 표시 / 사내망과 공개망 경계 명시입니다. 예: 서비스 3개와 공용 인증 서버 1개 / 트래픽은 게이트웨이 한 곳으로만 유입 / 배치 작업은 별도 큐로 분리
• 장애 대응 불릿을 새로 만든다면 — 예: 두 개 가용 영역에 동일 구성 / 데이터베이스는 자동 승격, 감지에서 승격까지 90초 / 승격 시 읽기 전용 30초 발생
• 6장 핵심 지표 카드 — 초당 처리 3,200건, 응답 지연 86ms, 구성 단계 3계층, 가용 영역 2곳이 예시값으로 들어 있습니다. 네 항목 모두 구성 설명에 바로 쓰는 값이니 라벨은 두고 숫자만 측정 근거가 있는 값으로 바꾸고, 측정 기간과 측정 구간을 카드 아래 한 줄로 적어야 질문이 줄어듭니다. 구성 단계 3계층과 가용 영역 2곳은 4장·5장 문구에서 다시 나오는 값이라 함께 고쳐야 합니다.
• 7장 추이 분석 막대 — 평시 86, 2배 부하 104, 5배 부하 138, 10배 부하 190으로 부하 구간별 응답 지연을 그린 모양입니다. 평시 86은 6장 카드의 응답 지연 86ms와 같은 값입니다. 시간축이 아니므로 제목을 부하별 응답으로 바꾸고, 측정에 쓴 도구와 시나리오를 캡션에 적으십시오.

흔한 실수

• 구성 요소를 다 그려 넣기 — 8장 분량에서 박스가 열 개를 넘으면 아무도 따라오지 못합니다.
• 선택한 방식만 적고 검토했다 버린 대안을 빼기 — 승인 회의에서 같은 질문이 반복됩니다.
• 지표 카드의 응답 시간을 조건 없이 적기 — 어떤 요청, 어느 구간의 값인지 없으면 근거로 쓰이지 못합니다.
• 5장 오른쪽 열을 개선안 이름만으로 채우기 — 왼쪽 세 줄이 지금 겪는 문제여야 오른쪽 세 줄이 답으로 읽힙니다.

남은 결정 사항을 마지막 장에 적습니다

아키텍처 발표는 확정된 것보다 아직 안 정한 것에서 논쟁이 생깁니다. 8장 마무리 앞에 본문 한 장을 복제해 미결 항목 3개와 각 항목의 결정 기한, 결정권자를 적어 두면 회의가 그 장에서 끝납니다. 예: 메시지 큐 제품 선택 4월 10일 플랫폼팀, 로그 보관 기간 4월 17일 보안팀.

배포 전 확인

구성도에 서버 이름이나 내부 주소가 그대로 들어가면 대외 배포용으로 쓸 수 없습니다. 외부에 나가는 판본에서는 이름을 역할 표기로 바꾸고, 문서 버전과 작성일을 표지에 남겨 두십시오. 8장 아래에도 “2026. 발표자 이름 / 소속” 자리가 한 번 더 있으니 표지와 같이 채웁니다.