포스트

God Enum: 한 enum에 섞인 네 가지 책임과 분리 방법

enum 하나에 응답 포맷, 도메인 분류 로직, i18n 메타데이터, 카탈로그 정의를 함께 넣기 시작하면 왜 나중에 구조 부채가 커지는지 실제 사례를 바탕으로 정리한 글이다.

상황

  • 처음에는 분류 enum 하나였다.
  • 시간이 지나면서 그 enum이 응답 문자열, 등급 계산, i18n 키, 색상, fallback을 모두 맡게 됐다.
  • enum 이름 하나를 바꾸면 API 응답이 바뀌고, descKey가 깨지고, 분류 함수 결과까지 영향을 받았다.
  • of(name) 매핑 함수에서는 선언 순서 때문에 특정 값이 절대 선택되지 않는 dead branch가 생겼다.

enum을 쓴 것이 문제가 아니라, 서로 다른 레이어의 책임을 한 타입에 합친 것이 문제다.

enum이 떠안게 되는 네 가지 책임

enum은 도메인 안의 상태나 분류 목록을 표현하는 데 적합하다. 문제는 다음 책임이 함께 붙을 때 생긴다.

책임내용
Wire Format외부 API나 응답 JSON에 나가는 문자열
Domain Classification입력을 어떤 카테고리로 분류할지 정하는 규칙
Presentation Metadata화면에 표시할 이름, 색상, 아이콘
Catalog Definition도메인 안에 존재하는 값들의 목록

카탈로그 정의와 wire format은 한동안 같은 enum에 있어도 큰 문제가 없다. 분류 규칙과 표시 메타데이터가 붙으면서부터 enum이 레이어 경계를 무너뜨린다.

부채가 쌓이는 과정

처음 형태:

1
2
3
4
5
enum class StormStatus {
    NORMAL,
    WARNING,
    DANGER,
}

요구사항이 붙은 뒤:

1
2
3
4
5
6
7
8
9
10
11
12
13
enum class StormStatus(
    val descKey: String,
    val color: String,
) {
    NORMAL("storm.normal", "blue"),
    WARNING("storm.warning", "yellow"),
    DANGER("storm.danger", "red"),
    ;

    companion object {
        fun calculateGrade(speed: Float, locale: Locale): StormStatus { ... }
    }
}

한 타입 안에 섞인 관심사:

  • descKey, color: presentation 메타데이터
  • calculateGrade(...): domain classification
  • Locale: cross-cutting context
  • enum value 자체: catalog definition

“StormStatus 관련 정보가 다 여기 있다”는 점에서 응집도가 높아 보이지만, 실제로는 서로 다른 이유로 바뀌는 것들이 결합된 상태다.

변경 영향 범위

enum 이름 하나를 바꾸면:

  • API 응답 문자열이 바뀐다
  • 도메인 분류 결과가 바뀔 수 있다
  • i18n 키가 깨질 수 있다
  • 화면 색상 매핑이 바뀐다
  • 클라이언트와 서버를 동시에 배포해야 할 수 있다

멀티모듈 구조에서는 의존 방향도 거꾸로 된다.

  • 응답 DTO용 enum이 app-api에 있다
  • domain/service 코드가 그 enum의 정적 함수나 필드를 호출한다

도메인이 표현 계층에 의존하는 상태다. 다른 모듈에서 같은 분류 정보가 필요해지면 이 잘못된 의존이 함께 복제된다.

fallback과 dead branch

외부 문자열을 enum으로 매핑하는 of(name) 함수가 있으면 조용한 오분류가 생긴다.

1
2
3
4
5
6
7
8
9
10
11
enum class FooStatus(val apiName: String) {
    FOO("Foo"),
    BAR("Bar"),
    BAZ("Foo"),
    ;

    companion object {
        fun of(name: String) =
            entries.find { it.apiName == name } ?: FOO
    }
}

BAZ에는 도달할 수 없다. entries.find가 선언 순서상 앞에 있는 FOO("Foo")를 먼저 찾기 때문이다.

  • 빌드는 통과한다
  • 기본 fallback이 있다
  • 런타임 에러가 나지 않는다
  • 대신 잘못 분류된 값이 응답에 섞인다

wire format과 fallback 정책까지 같은 enum에 있으면, 분류 규칙 문제인지 응답 매핑 문제인지 enum 선언 중복인지 구분하기 어렵다.

구조 위반 신호

1. 레이어 역전

도메인 코드가 presentation 패키지의 enum을 import한다. 분류 규칙이 응답 타입에 종속된다.

2. Cross-cutting context 누수

분류 함수 시그니처에 Locale, User, TenantId 같은 값이 들어온다. 표현 관련 정보가 domain classification까지 들어온 상태다.

3. 요청/응답 타입과 도메인 타입의 경계 소실

클라이언트와 주고받는 값, 내부 분류 결과, fallback 정책이 한 타입에 묶인다. 입력 검증과 출력 표현이 분리되지 않는다.

4. 재사용 불가

다른 도메인이나 모듈에서 분류 정보가 필요하면 표현 계층의 enum을 그대로 가져와야 한다. 잘못된 의존이 퍼진다.

분리 방법

같이 바뀌지 않는 것들을 분리한다.

1. Domain Catalog는 순수하게 둔다

1
2
3
4
5
enum class StormStatus {
    NORMAL,
    WARNING,
    DANGER,
}

메타 필드와 정적 계산 함수를 넣지 않는다.

2. 분류 규칙은 Policy로 분리한다

1
2
3
interface StormClassificationPolicy {
    fun classify(speed: Float): StormStatus
}

입력이나 분류 규칙이 바뀌어도 enum은 바뀌지 않는다.

3. Presentation 메타데이터는 Resolver로 분리한다

1
2
3
4
interface StormPresentationResolver {
    fun descKey(status: StormStatus): String
    fun color(status: StormStatus): String
}

i18n 키나 색상 정책을 바꿔도 도메인 타입은 그대로다.

4. Wire Format은 DTO로 분리한다

응답 문자열이 domain enum과 같은 모양이어도 타입은 분리한다. 그래야 enum 이름 변경이 외부 breaking change로 바로 이어지지 않는다.

단계별 리팩터 순서

한 번에 바꾸지 않고 단계적으로 진행한다.

  1. Cross-cutting context 격리: 분류 함수 시그니처에서 Locale, User 같은 표현·세션 정보를 뺀다. 위험이 가장 낮다.
  2. Domain enum과 Wire DTO 분리: enum을 domain 쪽으로 옮기고 응답용 타입을 따로 만든다. 의존 방향이 바로잡힌다.
  3. Policy와 Metadata Resolver 분리: 네 가지 책임이 대부분 분리된다. 범위가 커질 수 있으므로 같은 패턴을 가진 다른 enum과 묶어 ADR로 결정한다.

완벽한 구조보다 변경 영향 범위를 줄이는 순서를 우선한다.

코드 리뷰 체크리스트

  • companion object 안에 분류 로직이 있는가
  • enum 필드에 descKey, color, icon 같은 메타가 붙어 있는가
  • 서비스 코드가 응답 패키지 enum을 import하는가
  • UNKNOWN, OTHER 같은 fallback 값이 분류 정책까지 맡고 있는가
  • of(name) 매핑 함수가 있는데 조회 키 고유성 테스트가 없는가
  • enum value 이름 변경이 클라이언트 breaking change로 이어지는가

이 중 2~3개가 겹치면 God Enum일 가능성이 높다.

정리

God Enum이 되면 다음이 생긴다.

  • 의존 방향이 흐려진다
  • 변경 영향 범위가 커진다
  • fallback과 오분류가 드러나지 않고 쌓인다
  • 다른 모듈로 같은 문제가 퍼진다

enum을 볼 때 확인할 것:

  • catalog만 표현하고 있는가
  • 분류 규칙, 표현 메타, wire format까지 함께 가지고 있는가
  • 이름 하나를 바꿨을 때 API, UI, 도메인 로직이 함께 바뀌는가
이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.