notes · thoughts ·
같은 API를 두고 다른 것을 보고 있었다
화면에 필요한 데이터가 먼저 보이던 관점에서, 상태를 바꾸는 규칙까지 함께 보게 됐다. 조회와 행동에 필요한 모델은 같지 않을 수 있다.
프론트엔드에서 일하면서 화면에 필요한 데이터부터 생각하는 일이 자연스러워졌다. 목록에 이름, 이메일, 주문 수, 구매 금액이 필요하면 그 필드가 있는 응답 형태부터 떠올린다. 그다음에 이 데이터를 어떤 API로 받을지 생각한다.
그래서 필요한 DTO가 빠져 있으면 답답했다. 화면에서 필요한 것이 이미 보이는데 왜 응답에는 없을까. 왜 화면을 기준으로 설계하지 않을까.
《The Little Schemer》를 읽으며 데이터의 모양을 따라 프로그램의 구조를 생각하다가, 이 익숙한 출발점을 다시 보게 됐다. 내가 먼저 보고 있던 것은 화면을 채울 데이터였다. 반면 도메인 모델을 중심으로 설계하는 쪽에서는 주문이 언제 취소될 수 있는지, 환불에 어떤 조건이 필요한지를 먼저 보고 있을 수 있었다.
읽는 것과 바꾸는 것
주문 상세를 표시할 때는 사용자 이름과 상품명, 결제 금액을 한 번에 받으면 편하다. 하지만 취소 버튼을 누르는 순간에는 다른 질문이 필요하다. 지금 취소할 수 있는 상태인가. 이미 배송을 시작했는가. 취소하면 어떤 기록이 함께 바뀌어야 하는가.
상세 화면에 필요한 필드를 모두 모았다고 해서 이런 규칙까지 설명되는 것은 아니다. 반대로 상태 변경의 규칙을 잘 담은 모델이 목록 화면에 필요한 응답으로 바로 쓰기 편한 것도 아니다.
이 차이를 생각하니, 같은 모델 하나로 조회와 변경을 모두 설명하려고 할 때 생기는 불편함이 조금 이해됐다. 그렇다고 모든 서비스에서 모델을 분리해야 한다는 결론은 아니다. 우선 내가 지금 해결하려는 문제가 데이터를 읽는 일인지, 상태를 바꾸는 일인지 구분할 수 있어야 한다.
화면에서 필요한 데이터가 빠졌다는 문제는 여전히 해결해야 한다. 다만 이제는 왜 내 관점대로 설계하지 않았는지 묻기 전에, 서로 어떤 요구를 먼저 보고 있는지 확인하고 싶다. 응답의 편리함과 비즈니스 규칙을 함께 이야기해야 같은 API를 두고도 대화가 엇갈리는 일을 줄일 수 있을 것 같다.