콘텐츠로 이동

Presentation – UI와 UX가 자리하는 곳

뷰 계약을 경계로 프레젠테이션 계층이 시작됩니다.

예를 들어 뷰는 자신의 Facade에서 다음 값과 동작을 제공받습니다.

customer
canOrder
canDelete
loading
deleteCustomer()
placeOrder()

프레젠테이션 계층은 이 정보를 어떻게 보여 주고 사용자가 어떻게 조작하게 할지 결정합니다. 정보의 배치, 로딩 상태의 표시 방식, 비활성화할 버튼, 다이얼로그를 열 시점, 폼의 동작, 키보드나 터치 입력에 대한 반응이 모두 여기에 해당합니다.

이 값들의 도메인 의미는 앞선 계층에서 이미 정해졌습니다. 여기까지 아키텍처는 사용자에게 보이지 않았습니다. 프레젠테이션 계층에서 비로소 화면으로 드러납니다.

프레젠테이션 계층은 복잡해도 됩니다

섹션 제목: “프레젠테이션 계층은 복잡해도 됩니다”

“프레젠테이션은 단순해야 한다”는 지침을 모든 경우에 적용하기는 어렵습니다. 좋은 UI를 구현하는 데에도 까다로운 기술적 작업이 필요할 수 있습니다.

폼, 단계별 입력 화면, 모달 다이얼로그, 표, 드래그 앤 드롭, 포커스 관리, 키보드 탐색, 접근성, 터치 상호작용, 반응형 레이아웃, 애니메이션, UI 구성까지 모두 프레젠테이션 계층이 맡을 수 있습니다. 까다로운 폼 하나를 구현하는 데 비즈니스 로직 없이도 UI 코드가 수백 줄 필요할 수 있습니다.

자동 완성 필드를 예로 들어 보겠습니다. 입력을 처리하고 추천 항목을 표시하며, 방향키와 Escape에 반응하고, 입력란과 목록 사이에서 포커스를 관리해야 합니다. 화면 읽기 프로그램을 사용하는 사람도 필드를 이해하고 조작할 수 있어야 합니다. 이 가운데 선택한 고객의 주문 가능 여부를 판단하는 일은 하나도 없습니다. 그래도 이 컴포넌트의 구현은 결코 단순하지 않습니다.

경계의 기준은 복잡성의 종류입니다. 코드 줄 수로는 판단할 수 없습니다. UI의 복잡성은 프레젠테이션 계층이 맡을 수 있습니다. 도메인의 복잡성은 이 계층의 책임 범위 밖에 있습니다.

이미 내려진 판단을 화면에 표현하기

섹션 제목: “이미 내려진 판단을 화면에 표현하기”

+State는 이미 다음 값을 만들었습니다. Application 계층은 뷰의 Facade를 통해 이 값들을 제공합니다.

canOrder;
canDelete;
selectedCustomer;
visibleCustomers;

프레젠테이션 계층에서는 이 값을 화면에 표현할 수 있습니다.

canOrder = false
↓
주문 버튼을 비활성 상태로 표시

이미 내려진 판단을 아래처럼 다시 계산하는 일은 피해야 합니다.

<button
[disabled]="
facade.customer().status !== 'ACTIVE' ||
facade.customer().creditHold !== 'NONE'
"
>
Order
</button>

템플릿이 어떤 상태나 플래그에서 작업을 허용할지 직접 검사하는 순간, 같은 비즈니스 규칙이 두 군데에 생깁니다. 두 번째 규칙은 마크업에 들어 있어서 +State에 있는 규칙보다 찾기 어렵습니다.

프레젠테이션 계층은 도메인 판단을 화면에 표현할 수 있습니다. 그 판단을 다시 계산하는 일은 피해야 합니다.

이미 도출된 canOrder, canDelete, selectedCustomer가 뷰의 Facade를 거쳐 비활성화된 주문 버튼, 삭제 작업, 고객 상세 정보로 표시되는 흐름

도메인 판단의 렌더링 그림 원본 크기로 열기

뷰 하나가 사용하는 Facade는 정확히 하나입니다

섹션 제목: “뷰 하나가 사용하는 Facade는 정확히 하나입니다”

Application 글에서 정한 경계가 여기서도 이어집니다. 뷰 하나는 자신에게 맞춰 정의된 계약을 정확히 하나 사용합니다.

CustomerListFacade
↓
CustomerListView

뷰가 도메인 내부의 여러 영역에 직접 접근하는 구조는 피합니다.

CustomerListView
├── CustomerState
├── PermissionState
├── OrderState
└── SelectionState

일반적으로 여러 Facade를 한 뷰에서 동시에 사용하는 구조도 피합니다.

CustomerListView
├── CustomerFacade
├── PermissionFacade
├── OrderFacade
└── SelectionFacade

그렇게 하면 프레젠테이션 계층에서 다시 도메인 내부 구조를 조율하게 됩니다. 스토어를 직접 조율하던 일이 Facade를 사용하는 한 단계 위로 옮겨 갈 뿐입니다.

뷰는 Facade를 정확히 하나 사용합니다. 그 Facade는 내부에서 도메인의 여러 영역에 접근할 수 있습니다. 뷰는 그 구조를 알 필요가 없습니다.

폼은 프레젠테이션 계층에 속합니다

섹션 제목: “폼은 프레젠테이션 계층에 속합니다”

폼은 프레젠테이션 계층이 맡습니다. FormControl, FormGroup, dirty, touched, focused, submitted 같은 폼의 상태와 동작, 필드의 표시 여부, 입력 형식 지정과 마스킹, 폼에서 바로 보여 주는 검증 피드백까지 포함합니다.

프레임워크가 Reactive Forms, Template Forms, Hooks, 자체 폼 라이브러리 가운데 무엇을 사용하든 같은 원칙이 적용됩니다.

폼 안에서도 한 가지를 더 구분할 필요가 있습니다.

예를 들어 다음은 프레젠테이션 계층에서 확인할 수 있습니다.

  • 필수 입력란이 비어 있습니다.
  • 입력값이 요구한 형식과 맞지 않습니다.
  • 이메일 주소의 구문이 올바르지 않습니다.
  • 폼에 입력한 두 비밀번호 값이 일치하지 않습니다.

다음과 같은 규칙은 폼의 책임 범위 밖에 있습니다.

이 고객은 현재 계약 상태에서 이메일 주소를 변경할 수 없습니다.

이 판단은 이미 도메인에서 내려져 있어야 합니다. 예를 들어 뷰 계약의 canEditEmail로 제공할 수 있습니다.

기술적인 유효성 검사 함수가 반드시 컴포넌트 파일 안에 있어야 하는 것도 아닙니다. 어느 계층에 속하는지는 각 보조 함수가 맡은 책임으로 판단합니다. 파일의 물리적 위치는 그 기준이 아닙니다.

폼은 프레젠테이션 계층에 속합니다. 그 폼을 통해 바꾸는 도메인 사실은 도메인이 소유합니다.

모달 다이얼로그와 상호작용 흐름

섹션 제목: “모달 다이얼로그와 상호작용 흐름”

다이얼로그도 프레젠테이션 계층에 속합니다.

사용자가 삭제 버튼을 누름
↓
확인 다이얼로그를 엶
↓
사용자가 삭제를 확인함
↓
facade.deleteCustomer()

삭제할 수 있는지는 +State에서 이미 결정했고, 그 결과는 canDelete로 확인할 수 있습니다.

다이얼로그를 사용할지, 어떤 모양과 버튼을 갖출지, 어디에 포커스를 둘지, Escape 입력이나 취소 이후에 어떻게 동작할지는 프레젠테이션 계층이 결정합니다. 도메인에서 삭제를 허용하는지는 여기서 다시 판단하지 않습니다.

삭제가 진행 중일 때도 같은 원칙이 적용됩니다. 예를 들어 뷰 계약이 loading을 제공할 수 있습니다. 프레젠테이션 계층은 그 값을 보고 다이얼로그를 열어 둘지, 스피너를 보여 줄지, 버튼을 비활성화할지, 성공한 뒤 다이얼로그를 닫을지 결정합니다.

상태는 전달됩니다. 사용자가 그 상태를 어떻게 경험할지는 UI가 결정합니다.

폼 외에도 순수 UI 상태는 프레젠테이션 계층이 맡는 큰 영역입니다.

isDialogOpen;
activeAccordion;
hoveredRow;
focusedField;
selectedTab;
menuExpanded;
tooltipVisible;

이 값들이 현재 화면의 표시 방식이나 동작만 설명한다면 프레젠테이션 계층에 속합니다.

+State 글에서 던진 질문은 여기서도 유용합니다.

이 상태는 현재 화면에 어떻게 표시되는지와 무관하게 도메인에서 의미가 있나요?

그렇지 않다면 프레젠테이션 계층이 이 상태를 맡는 것이 자연스러울 가능성이 큽니다.

예외도 있습니다. selectedTab이 실제로 도메인의 선택을 나타낸다면 도메인에서 의미 있는 상태가 될 수 있습니다. 변수 이름만으로는 어느 계층에 속하는지 판단하기 어렵습니다. 값이 무엇을 의미하는지가 중요합니다.

UI 컴포넌트의 역할을 화면 표현에 집중시키자는 생각은 오늘날의 Signal이나 스토어 기반 아키텍처보다 오래되었습니다.

John Papa는 Angular Style Guide의 Defer Logic to Services에서 컴포넌트를 “slim, trim, and focused”하게 유지하는 등의 이유로 로직을 컴포넌트 밖에 위임하라고 권했습니다. Keep Components Focused에서는 컴포넌트가 자신의 뷰에 집중하도록 권합니다.

현재의 공식 Angular Style Guide에도 “Keep components and directives focused on presentation”이라는 같은 취지의 지침이 있습니다. 컴포넌트와 디렉티브의 코드는 원칙적으로 그 UI와 관련되어야 합니다. 해당 UI와 분리해도 의미가 있는 코드는 별도의 함수나 클래스로 옮기는 편이 좋습니다.

이 시리즈의 계층 구분은 별도의 설계 모델입니다. 예를 들어 컴포넌트 밖으로 옮긴 유효성 검사 함수도 여전히 프레젠테이션 계층의 책임에 속할 수 있습니다.

이 출처들이 보여 주는 것은 UI 컴포넌트의 역할을 명확히 한정하자는 생각이 오래전부터 자리 잡았다는 점입니다.

React, Vue, Svelte 컴포넌트에도 같은 문제가 생깁니다. UI 컴포넌트 하나가 데이터 조회, 비즈니스 규칙, 도메인 데이터 집계, 상태 관리, UI 상호작용을 한꺼번에 맡으면, 화면을 렌더링하는 프레임워크가 무엇이든 컴포넌트의 초점이 흐려집니다. 컴포넌트는 유스케이스가 아닙니다(독일어)에서 이 패턴을 더 자세히 설명합니다.

하나의 도메인, 여러 UI 프레임워크

섹션 제목: “하나의 도메인, 여러 UI 프레임워크”

계층의 경계가 분명하면 같은 도메인 기반 위에 서로 다른 프레젠테이션 기술을 사용할 수 있습니다.

공통 도메인
↓
Application
↓
뷰 계약
/ \
/ \
Material 뷰 Ionic 뷰

어느 프레젠테이션을 사용할지는 기능 외부의 앱 조합 단계(Composition Level)에서 정할 수 있습니다.

앱 조합
│
├── 데스크톱 → Material 프레젠테이션
│
└── 모바일 → Ionic 프레젠테이션

도메인은 특정 프레젠테이션이 지금 활성화된 이유를 알 필요가 없습니다.

한 장기 프로젝트에서는 같은 도메인 기반 위에서 Angular Material과 Ionic을 여러 해 동안 함께 운영했습니다. 두 프레젠테이션 구현이 같은 도메인 판단을 사용하고, 비즈니스 규칙을 각자 다시 구현하지 않았으며, UI 고유의 차이를 각 구현 안에서 처리했기에 가능했습니다.

예를 들어 Material과 Ionic은 내비게이션, 레이아웃, 컨트롤, 다이얼로그, 터치 동작, 반응형 디자인에서 서로 달라도 됩니다. 같은 도메인 작업을 허용하는지에 대해서는 두 화면의 답이 일치해야 합니다.

canOrder = false
Material
버튼 비활성화
Ionic
동작을 회색으로 표시하거나 사용할 수 없게 함

사용자 경험은 다릅니다. 두 화면이 보여 주는 도메인 사실은 같습니다.

Angular Material과 Ionic은 실제 프로젝트에서 가져온 예입니다. 아키텍처 원칙은 프레임워크에 관계없이 적용됩니다.

공통 도메인과 뷰 계약을 바탕으로 Angular Material과 Ionic이 동일한 도메인 판단을 각자의 방식으로 표시하는 구조

두 UI 프레임워크의 표현 방식 비교 그림 원본 크기로 열기

두 기술이 같은 논리적 뷰와 같은 뷰 계약을 구현하는 대안이라면 Application 글의 1:1 규칙에도 부합합니다.

CustomerDetailFacade
/ \
Material Ionic
뷰 뷰

데스크톱과 모바일에서 Application 계약에 요구하는 내용이 서로 달라지면 각 뷰의 책임도 달라진 것입니다. 이때는 뷰마다 별도의 Facade를 둡니다.

경계는 그대로입니다. 프레젠테이션 구현 하나는 명확하게 정의된 뷰 계약을 정확히 하나 사용합니다.

프레젠테이션 계층의 책임 범위

섹션 제목: “프레젠테이션 계층의 책임 범위”

프레젠테이션 계층은 다음 일을 맡을 수 있고, 맡는 것이 적절합니다.

  • 뷰 계약, 즉 Facade를 정확히 하나 사용하기
  • 값과 파생 상태를 렌더링하기
  • 사용자 입력을 처리하기
  • 사용자가 요청한 작업을 Facade에 위임하기
  • 폼을 관리하기
  • 모달 다이얼로그를 열기
  • 로컬 UI 상태를 소유하기
  • 포커스와 키보드 및 터치 상호작용을 관리하기
  • 접근성을 구현하기
  • 애니메이션과 반응형 화면 표시를 제어하기
  • UI 컴포넌트를 조합하기
  • UI에 고유한 오류 메시지를 표시하기
  • 도메인 판단을 시각적으로 표현하기

프레젠테이션 계층은 다음 일을 맡지 않는 편이 좋습니다.

  • 비즈니스 규칙을 구현하기
  • 도메인 판단을 다시 계산하기
  • DTO를 해석하기
  • HTTP 요청을 실행하기
  • 외부 SDK를 통해 도메인에 직접 접근하기
  • +State를 직접 사용하기
  • 여러 도메인 스토어를 조율하기
  • 도메인 처리를 위해 여러 Facade를 조율하기
  • 도메인 스트림을 결합하기
  • 도메인에서 의미 있는 파생 상태를 만들기
  • 기술적인 API 오류 코드를 해석하기
  • 도메인 상태를 수동으로 동기화하기

프레젠테이션 계층의 파일을 열면 UI와 상호작용 코드가 보입니다. 이벤트 핸들러, 폼 상태, CSS 클래스 사이에서 비즈니스 규칙을 찾을 필요가 없습니다. 그 규칙은 +State에 있습니다.

UI와 UX는 도메인과 독립적으로 발전할 수 있습니다. 다이얼로그를 드로어로, 표를 카드로 바꿀 수 있고 데스크톱과 모바일은 서로 다른 상호작용 패턴을 사용할 수 있습니다. 이런 변경을 위해 도메인을 수정할 필요는 없습니다.

한편 canOrder, canDelete, visibleCustomers 값은 여러 프레젠테이션 구현에서 일관되게 유지됩니다. 각 화면은 같은 도메인 판단을 받아, 어떻게 보여 주고 조작할 수 있게 할지만 결정합니다.

새로운 접근성 요구사항이나 레이아웃 및 상호작용 방식의 변화가 곧바로 도메인 상태의 변경으로 이어지지는 않습니다.

UI 작업은 UI 안에 머뭅니다.

컴포넌트를 억지로 “멍청하게” 만들 필요는 없습니다

섹션 제목: “컴포넌트를 억지로 “멍청하게” 만들 필요는 없습니다”

좋은 프레젠테이션 컴포넌트가 꼭 다섯 줄이어야 할 이유는 없습니다.

복잡한 폼 처리, 드래그 앤 드롭, 접근성, 키보드 탐색을 구현하다 보면 프레젠테이션 코드가 수백 줄에 이르는 것도 충분히 타당합니다.

어떤 책임을 맡고 있는지가 중요합니다.

복잡한 UI 상호작용 → Presentation
복잡한 도메인 판단 → +State

따라서 컴포넌트가 크다는 사실만으로 아키텍처에 문제가 생기지는 않습니다. 여러 종류의 책임이 한데 뒤엉켜 커졌을 때 문제가 됩니다.

기술적 외부 세계에서 사용자까지

섹션 제목: “기술적 외부 세계에서 사용자까지”
기술적 외부 세계
↓
Infrastructure
↓
+State
↓
Application
↓
Presentation
↓
사용자

Infrastructure는 기술적 외부 세계로부터 내부를 보호하고 외부 계약을 내부에서 쓸 수 있는 형태로 변환합니다. +State는 상태에 도메인 의미를 부여하고 비즈니스 규칙을 소유합니다. Application은 그중 특정 뷰에 필요한 것을 골라 계약을 만듭니다. 프레젠테이션 계층은 이 계약을 화면에 드러내고 사용자가 조작할 수 있게 합니다.

각 계층은 자신이 맡은 책임에서 비롯된 복잡성을 감당할 수 있습니다.

계층화의 가치는 이 명확함에 있습니다. 판단마다 자연스럽게 속하는 곳이 있고, 이웃 계층은 같은 판단을 되풀이할 필요가 없습니다.