시스템 구성도 설명, 상자와 연결선의 의미부터 맞추기

2026년 10월 26일

기준일 2026-10-24 · AZET 운영팀 작성

이 글은 AZET 운영팀이 작성한 실무 참고 자료입니다. 설명용 가상 상황을 포함하며, 각 조직에서 확인한 자료와 업무 목적에 맞춰 적용합니다.

구성도에서 서비스와 외부 도구가 선 하나로 이어져 있습니다. 독자는 그 선을 보고 자료가 자동으로 오간다고 이해하지만, 작성자는 수동 전달까지 포함한 관계를 표시했을 수 있습니다. 같은 선에 여러 의미를 넣으면 그림이 실제 범위보다 큰 약속을 하게 됩니다.

상자와 선의 단위를 먼저 정합니다

가상의 업무 시스템 설명에서는 상자 하나가 서비스인지, 기능인지, 조직인지부터 정합니다. 서로 다른 단위를 함께 넣어야 한다면 모양이나 제목으로 종류를 구별합니다. 사용자 역할을 뜻하는 상자를 저장 공간처럼 읽지 않도록 범례를 둡니다.

선에는 전달하는 정보나 요청의 이름을 붙입니다. 방향도 확인합니다. 한쪽에서 요청을 보내고 반대쪽에서 결과를 받는다면 필요한 설명 범위에 맞춰 각각 표시합니다. 관계가 있다는 이유만으로 양방향 화살표를 붙이지 않습니다.

제품 바깥에 있는 연동 서비스를 점선 상자로 묶었다면 그 경계가 외부 운영 범위인지, 단순한 도식 구분인지 적습니다. 연결되어 있다는 사실만으로 지원 책임이나 장애 대응 범위를 추론하게 두지 않습니다. 그런 조건은 확인된 설명 문서와 연결합니다.

현재 구성과 제안 구성을 같은 장에 겹치면 검토 중인 연결이 이미 동작하는 것으로 읽힐 수 있습니다. 두 그림을 나누거나 상태를 직접 표시합니다. 아직 확인하지 못한 연결은 가설이라고 쓰고, 실제 연결을 뜻하는 선과 구분합니다.

설명을 단순하게 만들기 위해 중간 요소를 생략할 수는 있습니다. 다만 생략 때문에 데이터가 직접 전달되는 것처럼 보이면 ‘중간 처리 생략’ 같은 주석을 붙입니다. 개념도라는 표기와 실제 배치도라는 표기도 구별해 독자가 그림의 정밀도를 판단하도록 합니다.

검수할 때는 ‘사용자가 자료를 제출하면 결과가 어디에 남는가’처럼 구체적인 질문을 고릅니다. 출발점부터 선을 따라가며 이름이 없는 연결과 도착지가 없는 요청을 찾습니다. 그림만으로 설명할 수 없는 부분은 말로 때우지 말고 해당 표시를 고칩니다.

고객용 구성도에 불필요한 내부 주소나 접근 정보를 넣지 않습니다. 검토 목적에 필요한 역할과 연결 관계만 남긴 뒤, 실제 정보를 확인한 담당자에게 표현 범위를 대조받습니다. 이 과정은 보안 수준이나 운영 성능을 판정하는 절차와는 별개입니다.

Q1. 기술 용어를 모두 풀어 써야 하나요? 독자가 판단할 때 필요한 역할을 먼저 씁니다. 정확한 이름이 필요하면 짧은 역할 설명과 함께 표시합니다.

Q2. 선이 너무 많으면 어떻게 하나요? 설명하려는 질문별로 그림을 나눕니다. 전체 그림에는 경계와 주요 연결을 남기고 상세 흐름을 별도로 보여 줍니다.

Q3. 구성도만 보고 연동 가능 여부를 알 수 있나요? 그림의 상태와 근거를 확인해야 합니다. 검토안의 선은 실제 동작을 확인했다는 증거가 아닙니다.

AZET에 관한 정보는 AZET 안내에서 확인할 수 있습니다.

시스템구성도고객설명연동범위범례AZET