페이지·기능·API 연동 레이어 주 담당
새 요금제를 추가하면 유료 기능이 전부 열리는 구조였다
유료 기능 게이팅이 '상품 코드가 특정 값이 아니면 허용'이라는 부정 조건으로 짜여 있었다. 새 저가 플랜을 추가하는 순간 그 플랜 사용자에게 전 기능이 열린다. 등급값과 기능별 최소 등급표를 신설해 판정을 훅 하나로 모으고, UI와 API가 같은 플랜을 다른 이름으로 부르던 이중 표기를 없앴다.
무엇을 만들었나
생성형 AI 플랫폼이 브랜드를 얼마나·어떻게 언급하는지 측정·분석하는 B2B SaaS 대시보드에서 페이지·기능·API 연동 레이어를 맡았다. 결제와 구독 도메인도 그 범위에 있었다.
그 도메인에서 구조적 결함 하나를 발견하고 다시 모델링했다.
무엇이 문제였나
유료 기능 게이팅이 “상품 코드가 기본 플랜이 아니면 허용”이라는 부정 조건으로 짜여 있었다.
말을 바꾸면 이렇다. 코드가 알고 있는 것은 “이 하나는 막는다” 뿐이고, 그 외의 모든 값은 통과다. 아직 존재하지 않는 값도 통과다.
새 저가 플랜을 하나 추가하는 순간 그 플랜 사용자에게 유료 기능이 전부 열린다. 코드를 한 줄도 건드리지 않았는데 페이월이 뚫린다. 기획이 플랜을 추가하기로 결정하는 시점과 개발자가 그 사실을 아는 시점 사이에 구멍이 열린다.
왜 눈에 띄지 않았나
존재하는 플랜에 대해서는 전부 올바르게 동작하기 때문이다.
부정 조건은 그 시점의 플랜 목록에 의존한다. 목록이 그대로인 동안은 조건이 참이고, 목록이 늘어나는 순간 조용히 거짓이 된다. 결함이 드러나려면 아직 없는 플랜을 넣어봐야 하는데, 없는 것에 대한 검증을 미리 하기는 어렵다.
코드 리뷰로도 잡기 어렵다. if (plan !== BASIC) 은 읽었을 때 이상해 보이지 않는다. 이상한 것은 코드가 아니라 그 코드가 기대고 있는 전제이고, 전제는 코드에 적혀 있지 않다.
여기에 이중 표기 문제가 겹쳐 있었다
같은 플랜을 UI 와 API 가 서로 다른 이름으로 부르고 있었다.
두 이름이 코드 여기저기에서 변환 없이 섞여 쓰였다. 그래서 신규 플랜 결제 요청이 기본 플랜 코드로 나가는 경로가 있었다. 사용자는 상위 플랜을 결제했다고 생각하는데 서버에는 다른 값이 도착한다.
문자열 두 개가 같은 개념을 가리키는 순간, 어딘가에서 반드시 하나를 빠뜨린다.
어떻게 다시 모델링했나
“무엇이 아닌가”를 묻는 구조를 “몇 등급인가”를 묻는 구조로 바꿨다.
세 가지를 신설했다.
- 등급값(tier) — 플랜 상품과 분리된, 순서가 있는 폐쇄 집합. 상품은 서버가 소유하고 마케팅 사정으로 계속 늘어나지만, 등급은 코드가 소유하고 제품이 정의한 만큼만 존재한다.
- 기능별 최소 등급표 — “이 기능은 어느 등급 이상인가”를 한 곳에 선언한다. 기능이 늘어나면 표에 줄이 하나 늘 뿐이다.
- 판정 훅 하나 — 화면 곳곳에 흩어져 있던 비교를 전부 이 훅으로 모았다.
플랜 상품과 플랜 등급을 다른 개념으로 분리한 것이 핵심이다. 둘을 같은 것으로 다루면 상품이 추가될 때마다 게이팅 로직이 흔들린다. 분리하면 상품이 몇 개가 되든 등급으로 매핑되는 지점 한 곳만 늘어난다.
이중 표기는 표기 하나를 폐기하고 경계에서만 변환하도록 정리했다.
티어 분기에 default 를 두지 않았다
같은 시기에 요금제 도메인 전체를 정리하면서 정한 규칙이 하나 있다. 등급별로 분기하는 switch 에 의도적으로 default 를 두지 않는다.
default 가 있으면 새 등급이 추가됐을 때 코드가 조용히 그 분기로 흘러간다. 화면은 멀쩡히 그려지고 아무 에러도 나지 않는데 잘못된 값이 표시된다. 없으면 TypeScript 가 컴파일 단계에서 처리되지 않은 등급을 지적한다.
조용한 오동작을 컴파일 에러로 바꾸는 거래다. 등급이 추가될 때 반드시 개발자가 개입하게 만드는 장치이기도 하다.
같은 원칙을 백엔드 enum 매핑에도 적용했다. 미지값이 들어왔을 때 임의의 기본값으로 폴백하면 잘못된 정보가 조용히 화면에 표시된다. 매퍼 자체는 엄격하게 유지하되, 호출부에서 감싸 실패한 항목만 격리하고 로그로 노출하는 정책을 세워 문서로 남겼다.
결과
| 항목 | 내용 |
|---|---|
| 제거한 것 | 플랜 추가 시 페이월이 자동으로 열리던 구조 |
| 제거한 것 | 신규 플랜 결제가 다른 플랜 코드로 나가던 경로 |
| 신설한 것 | 등급값 · 기능별 최소 등급표 · 판정 훅 단일화 |
| 남긴 규칙 | 등급 분기에 default 금지 (조용한 오동작 → 컴파일 에러) |
| 통합 | 4개 feature 에 흩어져 중복 정의되던 요금제 개념을 한 곳으로 |
결제 도메인 자체도 이 시기에 구현했다. 빌링키 발급, 결제 완료, 구독 변경·취소, 카드 변경 실패, 쿠폰 사용 경로를 다뤘다.
되돌아보면
이 결함은 코드의 버그가 아니라 모델링의 문제였다. 그래서 코드를 읽어서는 찾기 어려웠고, “플랜이 하나 더 생기면 어떻게 되지?”라고 물었을 때 보였다.
부정 조건으로 권한을 판정하지 않는다. !== A 는 “A 가 아닌 모든 것”에 권한을 주는 문장이고, 그 집합은 미래에 커진다. 반대로 >= 2등급 은 집합이 늘어나도 의미가 변하지 않는다.