
소프트웨어 설계를 처음 배우는 사람은 종종 UML부터 외우려 한다. 클래스 다이어그램, 시퀀스 다이어그램, 유스케이스 다이어그램 같은 이름이 먼저 쏟아지기 때문이다. 물론 UML은 중요한 표준이다. OMG는 UML을 소프트웨어와 시스템을 시각화하고 명세하고 문서화하는 표준 언어로 설명한다.
하지만 입문 단계에서 더 먼저 필요한 것은 도형 이름이 아니다. 이 시스템이 어떤 경계를 갖고 있고, 어떤 책임이 어디에 있으며, 무엇이 자주 바뀌는지 설명하는 습관이 먼저다.
UML은 언어이지 설계 그 자체는 아니다
UML을 배우면 구조를 표현하는 데 도움이 된다. 특히 클래스 관계나 상호작용 흐름을 빠르게 보여줄 수 있다는 장점이 있다. 다만 UML을 배운다고 설계가 저절로 좋아지는 것은 아니다.
흔한 실수는 이렇다.
- 다이어그램을 그리는 데 너무 오래 쓴다.
- 실제 코드보다 문서가 더 복잡해진다.
- 무엇을 전달하려는지보다 표기법 맞추기에 집중한다.
그래서 UML은 필요한 내용을 더 빨리 설명하기 위한 도구로 쓰는 편이 낫다. 목적은 그림이 아니라 설명이다.
입문자에게는 C4 모델처럼 단계가 분명한 시각화도 유용하다
Simon Brown의 C4 모델은 소프트웨어 구조를 시스템, 컨테이너, 컴포넌트, 코드의 네 단계로 보여 주는 접근이다. 복잡한 표기법보다 “지금 어느 해상도에서 설명하고 있는가”를 분명히 해 준다는 점에서 초보자에게 특히 유용하다.
예를 들어 이런 순서가 자연스럽다.
- 이 시스템이 바깥과 어떻게 연결되는가
- 내부에 어떤 큰 실행 단위가 있는가
- 각 단위 안에 어떤 책임이 모여 있는가
- 마지막에 필요하면 클래스나 코드 구조를 본다
이 흐름을 익히면 설계 설명이 훨씬 덜 막막해진다.
패턴 공부는 “해법 암기”보다 “문제 분류” 쪽이 더 중요하다
설계를 공부하다 보면 곧 디자인 패턴으로 넘어가게 된다. 이때도 중요한 것은 패턴 카탈로그를 외우는 것이 아니라, 반복되는 문제를 어떻게 분류하느냐다.
예를 들어 이런 질문이 먼저다.
- 생성 책임을 분리해야 하는가
- 변경 가능성이 큰 부분을 감싸야 하는가
- 한 객체의 변화가 여러 곳에 전달되어야 하는가
이 질문을 분명히 할 수 있어야 패턴이 유용해진다. 질문 없이 패턴 이름부터 떠올리면 설계는 금방 과해진다.
설계 학습 순서는 “표현 도구”보다 “변화의 경계”가 먼저다
소프트웨어 공학자 데이비드 파나스(D. L. Parnas)는 1972년 발표 논문에서 모듈 분해의 기준으로 정보 은닉을 강조했다. 자주 바뀔 가능성이 있는 설계 결정을 모듈 뒤에 숨기라는 이야기다. 이 원칙은 지금 읽어도 여전히 강하다.
결국 설계 공부의 핵심은 다음 순서에 가깝다.
- 무엇이 자주 바뀌는지 본다.
- 그 변화를 어디에 가둘지 정한다.
- 책임 경계를 설명한다.
- 필요하면 UML이나 C4 같은 도구로 시각화한다.
즉 표기법보다 구조 감각이 먼저다.
그림 하나에 답할 질문 하나를 먼저 정하기
소프트웨어 구조 설명 방식인 C4 모델의 공식 안내는 네 단계의 그림을 전부 그릴 필요가 없으며 가치가 있는 수준만 사용하라고 설명한다. UML과 C4를 같은 표기법으로 취급할 필요도 없다. 어떤 질문에 답하려는지에 따라 그림의 범위를 고를 수 있다.
다음은 가상의 게임 저장 기능을 설명하는 자체 점검표다. 실제 시스템의 구조를 뜻하지 않는다.
| 설명할 질문 | 담을 내용 | 검토할 지점 |
|---|---|---|
| 저장은 어디에서 일어나는가 | 플레이어, 게임 실행 환경, 저장 위치 | 시스템 안팎의 경계가 명확한가 |
| 누가 저장을 요청하고 결과를 받는가 | 화면, 저장 담당 기능, 파일 접근 사이의 흐름 | 실패가 어느 쪽으로 전달되는가 |
| 어떤 데이터가 이어지는가 | 슬롯 식별자, 데이터 버전, 복원할 상태 | 그림과 실제 인터페이스가 맞는가 |
UML로 표현한다면 구조나 상호작용을 다루는 표준 표기를 목적에 맞게 선택할 수 있다. 간단한 스케치라면 정식 UML인 것처럼 부르기보다 화살표와 선의 의미를 범례로 적어 두자. 파일·데이터의 이름과 검토한 시점을 남기면 구현이 바뀌었을 때 그림도 다시 확인하기 쉽다.
핵심 정리
소프트웨어 설계를 배우려면 UML이나 패턴 이름부터 외우기보다, 시스템의 경계와 책임, 그리고 자주 바뀌는 결정이 어디에 있는지를 설명하는 습관부터 익히는 편이 낫다. UML은 유용한 표준이지만 언어일 뿐이고, C4 모델은 해상도를 나눠 구조를 설명하는 데 도움이 되는 도구다.
설계 학습의 출발점은 결국 하나다. “이 구조는 왜 이렇게 나뉘었는가”를 스스로 설명할 수 있는가. 그 답이 생기면 도구는 그다음에 붙는다.