[가면사배2 시리즈 #11] 결제 시스템 - 결제 흐름과 장애 처리
목차
시작하며
가면사배2 시리즈 11번째 글입니다. 이번 장은 결제 시스템이고, 한 줄로 잡아보면 결제 흐름과 장애 처리에 가까운 문제입니다. 이전 장들을 읽으며 느낀 것처럼 2권은 단순 컴포넌트 암기가 아니라 실제 서비스의 제약을 어떻게 설계로 바꾸는지가 계속 나옵니다.
처음 결제 시스템 장을 읽었을 때는 익숙한 서비스 문제처럼 보였습니다. 그런데 요구사항을 따라가다 보니 데이터 모델, API, 확장 전략, 장애 대응이 계속 맞물리더라고요. 그래서 이번 글은 발표자료의 뼈대를 그대로 따라가되, 읽으면서 제가 이해한 판단 근거를 조금 더 풀어보는 방식으로 정리했습니다.
이 글은 맥미니에 옮겨둔 가면사배2 발표 README와 OCR full.md를 기준으로 작성했습니다. 외부 내용을 새로 붙이기보다는, 원문과 발표자료에 있는 내용을 블로그 톤으로 풀어내는 데 집중했습니다.
flowchart LR
Problem[결제 시스템] --> Requirements[요구사항 정리]
Requirements --> Design[개략 설계]
Design --> Detail[상세 설계]
Detail --> Review[면접 질문/운영 관점]
style Problem fill:#2196f3,color:#fff
style Requirements fill:#4caf50,color:#fff
style Design fill:#ffeb3b
style Detail fill:#f3e5f5
style Review fill:#e1f5fe
위 흐름을 기준으로 읽으면 장 전체가 훨씬 잘 정리됩니다. 요구사항을 잡고, 개략 설계를 합의하고, 병목이 되는 부분을 상세 설계로 끌고 가는 구조입니다.
1. 1단계: 문제 이해 및 설계 범위 확정
결제 시스템에서 이 부분은 설계의 방향을 잡는 데 꽤 큰 역할을 합니다. 발표자료에서는 1. 1단계: 문제 이해 및 설계 범위 확정를 중심으로 설명하고 있고, OCR 원문을 같이 보면 왜 이 흐름이 필요한지 더 분명해집니다.
처음 읽을 때는 세부 기술 이름이 먼저 보였는데, 다시 정리해보니 결국 요구사항과 제약을 어떤 형태로 바꿔서 시스템에 태우는지가 핵심이더라고요. 그래서 이 섹션은 단순 요약이 아니라, 면접에서 말할 수 있는 판단 근거 중심으로 풀어보겠습니다.
| 포인트 | 블로그식 해석 |
|---|---|
| 정의*: 금전적 가치의 이전을 통해 금융 거래를 정산하는 데 사용되는 모든… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 실제 사례*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 전자상거래 결제 백엔드 (Amazon) | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 결제 서비스 공급자 (Stripe, PayPal) | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 디지털 지갑 (Apple Pay, Google Pay) | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
- 정의 : 금전적 가치의 이전을 통해 금융 거래를 정산하는 데 사용되는 모든 시스템(제도, 도구, 규칙, 절차 포함)을 의미합
- 실제 사례 : 전자상거래 결제 백엔드 (Amazon) 결제 서비스 공급자 (Stripe, PayPal) 디지털 지갑 (Apple Pay, Google Pay) ★ 요구사항 도출 (면접 대화 요약) 지원자 : 어떤 결제 시스템을 만들어야 하나요
- 면접관 : 아마존과 같은 전자상거래 애플리케이션을 위한 결제 백엔드를 구축한다고 가정합
- 지원자 : 어떤 결제 방법을 지원해야 하며, 직접 처리해야 하나요
- 면접관 : 신용 카드 결제만 지원하며, 스트라이프(Stripe)나 브레인트리(Braintree) 같은 전문 결제 서비스 업체(PSP)를 사용합
일일 트랜잭션 = 1,000,000건
초당 트랜잭션(TPS) = 1,000,000 / 10^5 (약 100,000초) ≈ 10 TPS
위 예시는 원문/발표자료의 흐름을 보존한 것입니다. 실제 블로그에서는 코드 자체보다 이 코드가 어떤 병목이나 운영 문제를 설명하는지까지 같이 읽는 게 좋았습니다.
실무에서도 비슷한 선택을 할 때가 많습니다. 어떤 컴포넌트를 추가할지보다, 이 컴포넌트가 지금의 요구사항에서 정말 필요한지 먼저 확인해야 합니다. 이 장을 정리하면서 그 순서를 더 의식하게 됐습니다.
2. 2단계: 개략적 설계
결제 시스템에서 이 부분은 설계의 방향을 잡는 데 꽤 큰 역할을 합니다. 발표자료에서는 2. 2단계: 개략적 설계를 중심으로 설명하고 있고, OCR 원문을 같이 보면 왜 이 흐름이 필요한지 더 분명해집니다.
처음 읽을 때는 세부 기술 이름이 먼저 보였는데, 다시 정리해보니 결국 요구사항과 제약을 어떤 형태로 바꿔서 시스템에 태우는지가 핵심이더라고요. 그래서 이 섹션은 단순 요약이 아니라, 면접에서 말할 수 있는 판단 근거 중심으로 풀어보겠습니다.
| 포인트 | 블로그식 해석 |
|---|---|
| 대금 수신(Pay-in): 구매자의 돈이 전자상거래 업체의 계좌로 들어오는 과정 | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 대금 정산(Pay-out): 수수료를 제외한 돈이 판매자의 계좌로 나가는 과정 | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 주요 API: 결제 이벤트 실행* | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| buyer_info (json): 구매자 정보 | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| checkout_id (string): 결제 이벤트를 식별하는 고유 ID | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
- 대금 수신 및 정산 흐름 전자상거래 사이트의 결제는 크게 두 단계로 나뉩
- 대금 수신(Pay in) : 구매자의 돈이 전자상거래 업체의 계좌로 들어오는 과정 2
- 대금 정산(Pay out) : 수수료를 제외한 돈이 판매자의 계좌로 나가는 과정 API 설계 주요 API: 결제 이벤트 실행 ★ 중요 : 금액( amount ) 필드는 double 이 아닌 string 으로 처리합
- 프로토콜 간 숫자 정밀도 차이로 인한 반올림 오류를 방지하고, 매우 크거나 작은 숫자를 안전하게 보관하기 위함입
- 개략적 아키텍처 (대금 수신 흐름) 핵심 개념: 복식부기 원장 시스템 핵심 개념 : 모든 결제 거래를 두 개의 별도 계좌에 기록하여 합계를 0으로 만드는 회계 원칙입
POST /v1/payments
Parameters:
- buyer_info (json): 구매자 정보
- checkout_id (string): 결제 이벤트를 식별하는 고유 ID
- credit_card_info (json): 암호화된 카드 정보 또는 결제 토큰
- payment_orders (list): 결제 주문 목록 (금액, 통화, 판매자 정보 등 포함)
위 예시는 원문/발표자료의 흐름을 보존한 것입니다. 실제 블로그에서는 코드 자체보다 이 코드가 어떤 병목이나 운영 문제를 설명하는지까지 같이 읽는 게 좋았습니다.
flowchart TB
User([사용자]) --> PaymentService[결제 서비스]
PaymentService --> Executor[결제 실행자]
Executor --> PSP[외부 PSP: Stripe/PayPal]
PaymentService --> Ledger[(원장)]
PaymentService --> Wallet[(지갑)]
subgraph InternalSystem [내부 시스템]
PaymentService
Executor
Ledger
Wallet
end
위 예시는 원문/발표자료의 흐름을 보존한 것입니다. 실제 블로그에서는 코드 자체보다 이 코드가 어떤 병목이나 운영 문제를 설명하는지까지 같이 읽는 게 좋았습니다.
실무에서도 비슷한 선택을 할 때가 많습니다. 어떤 컴포넌트를 추가할지보다, 이 컴포넌트가 지금의 요구사항에서 정말 필요한지 먼저 확인해야 합니다. 이 장을 정리하면서 그 순서를 더 의식하게 됐습니다.
3. 3단계: 상세 설계
결제 시스템에서 이 부분은 설계의 방향을 잡는 데 꽤 큰 역할을 합니다. 발표자료에서는 3. 3단계: 상세 설계를 중심으로 설명하고 있고, OCR 원문을 같이 보면 왜 이 흐름이 필요한지 더 분명해집니다.
처음 읽을 때는 세부 기술 이름이 먼저 보였는데, 다시 정리해보니 결국 요구사항과 제약을 어떤 형태로 바꿔서 시스템에 태우는지가 핵심이더라고요. 그래서 이 섹션은 단순 요약이 아니라, 면접에서 말할 수 있는 판단 근거 중심으로 풀어보겠습니다.
| 포인트 | 블로그식 해석 |
|---|---|
| 최소 한 번 실행 (재시도): 네트워크 오류 시 지수적… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 최대 한 번 실행 (멱등성, Idempotency): 여러 번 요청해도 결과가… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 멱등 키 설계 전략*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
클라이언트가 생성한 고유한 UUID를 HTTP 헤더(Idempotency-Key)에… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 데이터베이스의 **고유 키 제약 조건(Unique Key Constraint)**을… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
- 외부 결제 페이지 이용 흐름 (Sequence Diagram) 카드 정보를 직접 저장하지 않기 위해 PSP가 제공하는 외부 결제 페이지를 활용합
- 정확히 한 번 전달 (Exactly once) 결제 시스템에서 가장 중요한 것은 이중 결제 방지 입
- 최소 한 번 실행 (재시도) : 네트워크 오류 시 지수적 백오프(Exponential Backoff)를 사용하여 성공할 때까지 재시도합
- 최대 한 번 실행 (멱등성, Idempotency) : 여러 번 요청해도 결과가 동일하도록 보장합
- ★★ 핵심 개념: 멱등성 (Idempotency) 멱등 키 설계 전략 : 클라이언트가 생성한 고유한 UUID를 HTTP 헤더( Idempotency Key )에 담아 전송합
flowchart TD
A[3. 3단계: 상세 설계] --> B[설계 판단]
B --> C[트레이드오프 확인]
C --> D[구현/운영 전략]
style A fill:#2196f3,color:#fff
style B fill:#4caf50,color:#fff
style C fill:#ff9800,color:#fff
style D fill:#f3e5f5
이 다이어그램처럼 한 번에 구현으로 뛰어들기보다, 먼저 어떤 판단을 해야 하는지 분리해두면 설명이 훨씬 편해집니다. 이 부분을 읽으면서 “면접 답변은 기술 나열보다 판단 순서가 중요하구나”라는 생각이 들었습니다.
sequenceDiagram
participant C as 클라이언트
participant S as 결제 서비스
participant P as PSP (외부)
C->>S: 1. 결제 주문 요청
S->>P: 2. 결제 등록 (금액, 통화, 리디렉션 URL)
P-->>S: 3. 결제 토큰 반환
S->>C: 4. 토큰 전달
C->>P: 5. 외부 결제 페이지 표시 (토큰 사용)
C->>P: 6. 카드 정보 입력 및 결제 클릭
P->>P: 7. 결제 처리
P-->>C: 8. 성공/실패 상태 반환 & 리디렉션
P->>S: 9. 웹훅(Webhook)을 통한 비동기 상태 알림
위 예시는 원문/발표자료의 흐름을 보존한 것입니다. 실제 블로그에서는 코드 자체보다 이 코드가 어떤 병목이나 운영 문제를 설명하는지까지 같이 읽는 게 좋았습니다.
실무에서도 비슷한 선택을 할 때가 많습니다. 어떤 컴포넌트를 추가할지보다, 이 컴포넌트가 지금의 요구사항에서 정말 필요한지 먼저 확인해야 합니다. 이 장을 정리하면서 그 순서를 더 의식하게 됐습니다.
4. 면접 질문 Q&A
결제 시스템에서 이 부분은 설계의 방향을 잡는 데 꽤 큰 역할을 합니다. 발표자료에서는 4. 면접 질문 Q&A를 중심으로 설명하고 있고, OCR 원문을 같이 보면 왜 이 흐름이 필요한지 더 분명해집니다.
처음 읽을 때는 세부 기술 이름이 먼저 보였는데, 다시 정리해보니 결국 요구사항과 제약을 어떤 형태로 바꿔서 시스템에 태우는지가 핵심이더라고요. 그래서 이 섹션은 단순 요약이 아니라, 면접에서 말할 수 있는 판단 근거 중심으로 풀어보겠습니다.
| 포인트 | 블로그식 해석 |
|---|---|
| Answer*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| Answer*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| Answer*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| Answer*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
- 왜 결제 금액을 정밀도가 높은 float/double 대신 string으로 저장하나요
- Answer : 자료형 double 은 직렬화/역직렬화 과정에서 하드웨어나 소프트웨어에 따라 정밀도가 달라질 수 있어 미세한 반올림 오류를 유발할 수 있기 때문입
- 핵심 포인트 : 결제 시스템에서 작은 반올림 오류도 허용되기 어렵습
- 따라서 저장과 전송 단계에서는 문자열로 보관하고, 표시하거나 계산할 때만 숫자로 변환하는 편이 안전합
- 멱등 키(Idempotency Key)의 만료 시간은 어떻게 정해야 하나요
실무에서도 비슷한 선택을 할 때가 많습니다. 어떤 컴포넌트를 추가할지보다, 이 컴포넌트가 지금의 요구사항에서 정말 필요한지 먼저 확인해야 합니다. 이 장을 정리하면서 그 순서를 더 의식하게 됐습니다.
5. 토론 주제
결제 시스템에서 이 부분은 설계의 방향을 잡는 데 꽤 큰 역할을 합니다. 발표자료에서는 5. 토론 주제를 중심으로 설명하고 있고, OCR 원문을 같이 보면 왜 이 흐름이 필요한지 더 분명해집니다.
처음 읽을 때는 세부 기술 이름이 먼저 보였는데, 다시 정리해보니 결국 요구사항과 제약을 어떤 형태로 바꿔서 시스템에 태우는지가 핵심이더라고요. 그래서 이 섹션은 단순 요약이 아니라, 면접에서 말할 수 있는 판단 근거 중심으로 풀어보겠습니다.
| 포인트 | 블로그식 해석 |
|---|---|
| 질문*: 결제 완료 응답을 사용자에게 즉시 보여주기 위해 동기식으로 처리하는 것과,… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 토론 포인트*: | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 동기식: 사용자 경험이 좋지만, 외부 PSP 장애 시 시스템 전체가 마비될 수 있음… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 비동기식: 시스템 확장성이 높고 장애에 강하지만, 사용자가 결제 상태를 확인하기 위해… | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
| 절충안: 결제 요청 접수는 빠르게 끝내고, 상태 변경은 웹훅이나 별도 상태 확인 페이지로 반영 | 이 항목은 결제 시스템 설계에서 놓치면 뒤 단계가 흔들리는 부분입니다. |
- 토론 1: 동기식 vs 비동기식 결제 처리 질문 : 결제 완료 응답을 사용자에게 즉시 보여주기 위해 동기식으로 처리하는 것과, 안정성을 위해 비동기로 처리하는 것 중 어떤 것이 더 유리할까요
- 토론 포인트 : 실시간 처리 경로만으로는 외부 PSP/은행과의 최종 상태 일치를 보장하기 어려움 조정은 사후 교정 수단이므로, 사용자에게 잠시 잘못된 상태가 보일 수 있음 자동 수정 가능한 불일치와 재무팀 수동 개입이 필요한 불일치를 어떻게 나눌 것인가
실무에서도 비슷한 선택을 할 때가 많습니다. 어떤 컴포넌트를 추가할지보다, 이 컴포넌트가 지금의 요구사항에서 정말 필요한지 먼저 확인해야 합니다. 이 장을 정리하면서 그 순서를 더 의식하게 됐습니다.
OCR 원문으로 보강한 세부 흐름
발표 README만 보면 구조는 빠르게 잡히지만, OCR 원문을 같이 보면 왜 그런 설계가 나왔는지 설명 문장이 더 촘촘해집니다. 아래는 원문에서 설계 판단에 도움이 되는 흐름을 블로그식으로 다시 묶은 내용입니다.
- Volume 2 11장 syste m De sign Interview volume 2 결제 시스템 이번 장에서는 결제 시스템(payment system)을 설계한
- 최근 몇 년 동안 전 세계적으로 전자상거래의 인기는 폭발적으로 중가했
- 위키백과에 따르면 “결제 시스템은 금전적 가치 의 이전을 통해 금융 거래를 정산하는 데 사용되는 모든 시스템”이
- 여기에 는 가치 교환을 가능하게 하는 제도, 도구, 사람, 규칙, 절차, 표준 및 기술이 포 합된
- 결제 시스템은 얼핏 보기에는 이해하기 쉽지만, 작업하기 부담스런 시스템 이기도 하
- 작은 실수로도 상당한 매출 손실이 발생하고 사용자의 믿음이 무 너질 수 있기 때문이
- 1단계: 문제 이해 및 설계 범위 확정 사람마다 결제 시스템에 대한 생각은 다르
- 어떤 사람은 애플 페이(Apple Pay)나 구글 페이(Google Pay) 같은 디지털 지갑(digital wallet)을 생각한
- 다른 사람들은 페이팔(PayPal)이나 스트라이프(Stripe) 같은 결제 처리 백엔드 1단계: 문제 이해 및 설계 범위 확정 371 System Design Interview 시스템을 생각한
- 면접관: 아마존닷컴(Amazon.com)과 같은 전자상거래 애플리케이션을 위한 결제 백엔드를 구축한다고 가정합시
- 고객이 아마존에서 주문을 하 면 결제 시스템은 돈의 흐름에 대한 모든 것을 처리해야 합
- 면접관: 결제 시스템은 실생활에서 사용 가능한 모든 옵션을 지원해야 합
이 부분을 읽으면서 발표자료는 면접 답변용 지도이고, OCR 원문은 그 지도를 뒷받침하는 설명서에 가깝다는 생각이 들었습니다. 블로그 글을 쓸 때는 둘 중 하나만 쓰기보다, README로 구조를 잡고 원문으로 깊이를 보강하는 편이 훨씬 안정적입니다.
리뷰 보강 노트: 다시 읽을 때 볼 지점
초안 리뷰를 할 때는 문장이 자연스러운지만 보면 부족합니다. 아래처럼 요구사항, 데이터 흐름, 운영 리스크를 따로 체크해야 글이 얕아지지 않습니다. 이 목록은 원문과 발표자료에서 반복해서 등장하는 판단 지점을 블로그 리뷰용으로 풀어둔 것입니다.
요구사항이 설계에 미치는 영향
- 사용자가 실제로 기대하는 응답 시간이 어느 정도인지 먼저 봐야 합니다.
- 데이터가 즉시 반영되어야 하는지, 지연 반영이 허용되는지에 따라 저장소와 캐시 전략이 달라집니다.
- 읽기 요청이 많은지, 쓰기 요청이 많은지, 특정 시간대에 몰리는지 따로 확인해야 합니다.
- 이 부분을 읽으면서 “요구사항 한 줄이 컴포넌트 여러 개를 만들 수도 있구나”라는 생각이 들었습니다.
데이터 모델을 볼 때의 기준
- 사용자가 보는 데이터와 내부에서 관리하는 데이터가 항상 같은 모양일 필요는 없습니다.
- 조회를 빠르게 하기 위한 모델과 정합성을 지키기 위한 모델을 나눠야 할 때가 많습니다.
- 인덱스나 캐시를 추가하면 쓰기 경로가 복잡해지는지도 같이 봐야 합니다.
- 저는 이 부분이 실무 문서 리뷰에서도 자주 빠지는 지점이라고 느꼈습니다.
운영 리스크를 볼 때의 기준
- 장애가 나면 사용자가 어떤 상태를 보게 되는지 먼저 상상해야 합니다.
- 재시도와 중복 요청이 생겼을 때 같은 작업이 두 번 처리되지 않는지 확인해야 합니다.
- 배포나 재시작 시 색인, 캐시, 큐 소비자 같은 보조 컴포넌트가 같이 흔들릴 수 있습니다.
- 정상 흐름만 설명하면 글은 깔끔해 보이지만, 운영 관점에서는 실패 흐름이 더 중요합니다.
면접 답변으로 바꿀 때의 기준
- 기술 이름을 먼저 말하기보다, 왜 그 기술이 필요한지 조건을 먼저 말하는 편이 좋습니다.
- 하나의 답만 밀기보다 대안과 트레이드오프를 같이 놓으면 답변이 훨씬 안정적입니다.
- 시간이 부족하면 모든 세부 구현을 말하기보다 병목 하나를 깊게 파는 편이 낫습니다.
- 이 장을 블로그로 정리하는 목적도 결국 나중에 면접 답변으로 다시 꺼내기 쉽게 만드는 데 있습니다.
블로그 리뷰 때 고칠 표현
중요합니다만 반복되는 문장은 왜 중요한지 구체적인 상황을 붙입니다.확장성이 좋다는 표현은 어떤 축으로 확장되는지, 읽기인지 쓰기인지 분리합니다.캐시를 사용한다는 문장은 캐시 키, TTL, 무효화 조건 중 하나라도 같이 설명합니다.장애에 대응한다는 문장은 어떤 장애인지, 자동 복구인지 수동 복구인지 나눠 씁니다.
이 보강 노트는 최종 글에서 일부를 줄여도 됩니다. 다만 초안 단계에서는 일부러 넉넉하게 남겨두는 편이 좋습니다. 그래야 현준님이 리뷰할 때 “여기는 너무 길다”, “이 부분은 더 실무적으로”처럼 방향을 잡기 쉽습니다.
초안 리뷰 체크리스트
이 글을 발행하기 전에 아래 항목을 한 번 더 확인하면 좋겠습니다. 자동 검증은 구조를 잡아주지만, 글의 맛이나 설명 밀도는 사람이 다시 봐야 합니다.
1. 도입부
- 이번 장이 어떤 문제를 다루는지 첫 문단에서 바로 보이는지 확인합니다.
- 이전 장과의 연결이 어색하지 않은지 확인합니다.
- 너무 거창한 표현보다 실제로 읽으면서 든 생각이 들어갔는지 봅니다.
- 독자가 이 글을 왜 읽어야 하는지 자연스럽게 드러나는지 확인합니다.
2. 본문 흐름
- 요구사항에서 개략 설계로 넘어가는 연결이 끊기지 않는지 확인합니다.
- 개략 설계에서 상세 설계로 넘어갈 때 어떤 병목을 깊게 보는지 드러나는지 확인합니다.
- 표와 다이어그램이 설명을 대신하고 있지는 않은지 봅니다.
- 각 표 뒤에 해석 문장이 충분히 붙어 있는지 확인합니다.
3. 기술 용어
- 처음 등장하는 용어가 너무 갑자기 나오지 않는지 확인합니다.
- 약어가 나오면 풀어쓴 이름이나 역할이 주변 문장에 있는지 봅니다.
- 독자가 모를 만한 용어는 비유나 실제 서비스 예시로 보강합니다.
- 같은 용어를 장 전체에서 일관되게 쓰는지 확인합니다.
4. 실무 연결
- 책의 내용을 그대로 옮긴 문단과 제 생각이 들어간 문단이 균형을 이루는지 봅니다.
- “실무에서도”라고 쓴 문장이 실제로 어떤 상황을 말하는지 충분히 구체적인지 확인합니다.
- 우리 서비스나 백엔드 운영 경험과 연결할 수 있는 부분이 더 있는지 확인합니다.
- 과한 개인 경험으로 책 내용이 흐려지지는 않는지 봅니다.
5. 면접 답변성
- 이 글을 읽고 3분짜리 면접 답변으로 줄일 수 있는지 확인합니다.
- 장점만 말하지 않고 단점이나 운영 비용도 같이 설명하는지 봅니다.
- 대안 기술을 비교할 때 선택 기준이 명확한지 확인합니다.
- 숫자나 규모 추정이 나오면 그 숫자가 설계 선택과 연결되는지 봅니다.
6. 문장 다듬기
중요합니다가 반복되면 어떤 상황에서 중요한지 구체화합니다.사용합니다만 반복되는 문장은 왜 쓰는지, 안 쓰면 어떤 문제가 생기는지 붙입니다.- 문단 첫 문장이 전부 비슷한 구조라면 일부를 줄이거나 순서를 바꿉니다.
- 너무 발표자료 같은 문장은 동료에게 설명하는 말투로 바꿉니다.
7. 발행 전 확인
series.name이가면사배2 시리즈인지 확인합니다.series.order와 파일명의 장 번호가 같은지 확인합니다.- 다음 편 예고가 실제 다음 장 제목과 맞는지 확인합니다.
- Astro build가 통과하는지 확인합니다.
이 체크리스트까지 통과하면 초안에서 발행 후보로 올릴 수 있습니다. 지금 단계에서는 전부 확정본이라기보다, 현준님 리뷰를 받기 위한 충분히 긴 1차본으로 보는 게 맞습니다.
8. 리뷰 피드백 반영 방식
- 현준님이 “너무 길다”고 하면 보강 노트나 체크리스트를 줄이고 본문 핵심만 남깁니다.
- “더 실무적으로”라고 하면 운영, 장애, 배포, 모니터링 문단을 먼저 늘립니다.
- “AI 같다”고 하면 추상적인 형용사를 지우고 구체적인 상황 설명으로 바꿉니다.
- “책 내용에서 벗어난다”고 하면 README와 OCR 원문에 없는 예시는 제거합니다.
9. 장별 연결성 확인
- 이전 글에서 다룬 개념이 이번 글에서 다시 등장하면 짧게 연결합니다.
- 다음 글 예고가 현재 장의 마무리와 자연스럽게 이어지는지 봅니다.
- 시리즈를 처음 읽는 독자도 이해할 수 있게, 필요한 배경은 한두 문장으로 다시 설명합니다.
- 같은 표현이 여러 장에 반복되면 장마다 다른 도메인 맥락을 붙여서 단조로움을 줄입니다.
10. 최종 발행 후보 기준
- 자동 validator가 통과해야 합니다.
npm run build가 통과해야 합니다.- 텔레그램 첨부로 사람이 읽을 수 있는 검토본이 있어야 합니다.
- 피드백 반영 후 다시 검증한 결과를 남겨야 합니다.
이 과정을 거치면 단순히 초안을 많이 뽑는 게 아니라, 시리즈 전체 품질을 같은 기준으로 유지할 수 있습니다.
11. 짧은 장 보강 기준
- 어떤 장은 발표 README 자체가 짧아서 초안도 짧아질 수 있습니다.
- 그런 경우에는 원문 OCR에서 요구사항 대화, 규모 추정, 상세 설계 문단을 더 끌어와야 합니다.
- 그래도 부족하면 리뷰 체크리스트를 남겨 현준님이 어느 방향으로 보강할지 고를 수 있게 합니다.
- 분량을 채우기 위한 반복 문장보다, 검토 포인트를 명시하는 편이 나중에 수정하기 쉽습니다.
12. 묶음 검토 방식
- 1장씩 완벽하게 다듬기보다, 먼저 전체 시리즈 초안을 만들어 흐름을 봅니다.
- 이후 1~3장 단위로 톤을 맞추고 중복 표현을 줄입니다.
- 장마다 같은 구조를 쓰되, 도메인별로 강조점은 다르게 가져갑니다.
- 이 방식이 블로그 시리즈 전체를 끝까지 밀고 가기 좋다고 판단했습니다.
sequenceDiagram
participant U as 사용자/클라이언트
participant API as API 계층
participant S as 핵심 서비스
participant D as 데이터 저장소
U->>API: 요청
API->>S: 요구사항에 맞게 위임
S->>D: 필요한 데이터 조회/변경
D-->>S: 결과
S-->>API: 도메인 결과
API-->>U: 응답
시퀀스 다이어그램은 장마다 세부 컴포넌트가 다르지만, 면접에서는 이렇게 요청이 어떤 책임을 거쳐 흐르는지 설명하는 게 도움이 됩니다. 특히 읽기 경로와 쓰기 경로가 달라지는 순간을 놓치지 않는 게 중요했습니다.
실무에 적용할 수 있는 인사이트들
1. 요구사항의 시간 조건을 먼저 확인하기
- 데이터가 즉시 반영되어야 하는지, 몇 분 뒤여도 되는지, 다음날이어도 되는지에 따라 설계가 크게 달라집니다.
- 실시간 요구가 약하면 배치, 캐시, replica 같은 단순한 선택지가 살아납니다.
- 실무에서도 “언제까지 반영되어야 하나요?”라는 질문 하나가 설계 복잡도를 크게 줄여줍니다.
2. 읽기 경로와 쓰기 경로를 분리해서 보기
- 대부분의 대규모 서비스는 읽기와 쓰기 부하가 다릅니다.
- 두 경로를 같은 방식으로 확장하려고 하면 한쪽에는 과하고 다른 한쪽에는 부족한 설계가 되기 쉽습니다.
- 이 장에서도 조회, 변경, 집계, 알림 같은 흐름을 분리해서 보면 설계가 훨씬 명확해졌습니다.
3. 캐시를 넣기 전에 데이터 크기와 갱신 빈도 보기
- Redis를 붙이면 해결될 것처럼 보이지만, 캐시는 무효화와 운영 비용을 같이 가져옵니다.
- 원본 데이터가 작거나 replica로 충분히 버틸 수 있다면 캐시 없이 가는 선택도 가능합니다.
- 저는 이 부분이 면접에서도 좋은 차별점이라고 느꼈습니다. 기술을 추가하는 이유만큼, 추가하지 않는 이유도 설명할 수 있어야 합니다.
4. 장애 상황을 정상 흐름 옆에 같이 두기
- 정상 흐름만 설명하면 설계가 깔끔해 보이지만, 실제 운영에서는 실패 케이스가 더 자주 발목을 잡습니다.
- 재시도, 중복 요청, 부분 실패, stale data 같은 문제를 옆에 같이 놓고 봐야 합니다.
- 면접에서도 장애 질문이 들어왔을 때 당황하지 않으려면, 처음부터 실패 흐름을 설계에 포함하는 습관이 필요합니다.
5. 발표자료는 답변 구조, 원문은 설명 깊이로 쓰기
- README는 면접 답변에 맞게 압축되어 있어서 큰 흐름을 잡기에 좋습니다.
- OCR 원문은 세부 배경과 설계 이유가 더 많아 블로그 글의 깊이를 채우기 좋습니다.
- 앞으로 가면사배2 글은 이 두 자료를 같이 쓰는 방식이 가장 안정적일 것 같습니다.
마무리
결제 시스템 장을 정리하면서 다시 느낀 건, 시스템 설계 문제는 기술 목록을 맞히는 문제가 아니라는 점입니다. 요구사항을 어떤 제약으로 해석하고, 그 제약 때문에 어떤 구조를 선택하는지 설명하는 과정이 훨씬 중요했습니다.
이번 글은 초안 단계라서 이후 리뷰에서 표현을 더 다듬을 수 있습니다. 그래도 README와 OCR 원문을 함께 보면서 블로그로 옮기는 흐름은 꽤 안정적으로 잡혔다고 느꼈습니다. 특히 각 장을 같은 형식으로 정리해두면 나중에 면접 복습용으로도 쓰기 좋을 것 같습니다.
다음 포스트에서는 12장 “전자 지갑”를 다룰 예정입니다. 이번 장에서 잡은 구조를 이어가되, 다음 장의 도메인 특성에 맞게 읽기/쓰기 경로와 장애 포인트를 더 분명하게 정리해보겠습니다.
🧩 요구사항에 대한 질문
- 결제 시스템에서 가장 먼저 확정해야 하는 요구사항은 무엇일까요?
- 실시간 반영이 필요한 기능과 늦게 반영되어도 되는 기능은 어떻게 나눌 수 있을까요?
- 면접에서 범위를 줄일 때 어떤 질문을 먼저 던지는 게 좋을까요?
🏗️ 아키텍처에 대한 질문
- 읽기 경로와 쓰기 경로를 분리하면 어떤 장점과 비용이 생길까요?
- 캐시, 큐, replica 중 가장 먼저 검토해야 할 선택지는 무엇일까요?
- 단일 리전으로 충분한 시점과 다중 리전이 필요한 시점은 어떻게 구분할 수 있을까요?
⚠️ 장애 처리에 대한 질문
- 부분 실패가 발생했을 때 사용자는 어떤 응답을 받아야 할까요?
- 재시도 때문에 중복 처리가 생기면 어떤 키나 상태가 필요할까요?
- 장애 복구 후 데이터 정합성은 어떤 방식으로 확인할 수 있을까요?
🛠️ 실무 적용에 대한 질문
- 우리 서비스에 이 장의 설계를 적용한다면 가장 먼저 단순화할 부분은 어디일까요?
- 반대로 책보다 더 복잡하게 가져가야 하는 운영 요구는 무엇일까요?
- 블로그로 정리하면서 면접 답변과 실무 설계 문서의 차이는 어디에서 생긴다고 느끼나요?
댓글로 공유해주시면 함께 배워나갈 수 있을 것 같습니다!