이찬양Backend Engineer

언어

Design Method

요구를 검증 가능한 설계로 연결합니다

모든 프로젝트를 같은 순서로 진행했다는 뜻이 아니라, 먼저 확인해야 할 경계를 찾기 위한 공통 질문입니다. B2B 샘플은 요구·역할 경계를, 실서비스 사례는 상태·권한·재처리 경계를 보여줍니다.

Domain Analysis Process

요구에서 설계·구현·운영 근거로 이어지는 흐름

요구사항을 목적, 행위자, 상태 변화, 정책·운영 제약으로 분류한 뒤 도메인 언어, 아키텍처 경계, 유스케이스·API 계약, 품질 속성, 운영 복구 기준으로 연결합니다.

01

행위자 기획서 · B2B 샘플

요구사항을 목적·행위·제약으로 분류합니다

바로 API를 만들기 전에 왜 필요한 기능인지, 누가 어떤 상태를 바꾸는지, 언어·통화 같은 글로벌 제약과 정책·예외·운영 조건을 어떻게 지켜야 하는지 나눕니다.

요구사항 분류 근거 보기 →
  • 행위자
  • 상태 변화
  • 유스케이스
  • 정책 · 글로벌 제약
02

도메인 회고·모델 감사

도메인 언어·경계·상태 모델을 잡습니다

결제, 청구, 수강권, 구독, 환불, 포인트, 표시 언어·통화처럼 생명주기가 다른 사실을 모델과 상태 전이로 분리합니다.

도메인 모델링 근거 보기 →
  • 생명주기
  • 소유권
  • 언어 경계
  • 상태 전이
03

ADR·회고·코드 경계

아키텍처 경계와 불변 조건을 결정합니다

같이 확정해야 하는 상태, 비동기로 넘길 처리, 외부 시스템 실패와 권역 확장 전략을 흡수할 경계를 불변 조건과 트레이드오프로 고정합니다.

아키텍처 판단 근거 보기 →
  • 트랜잭션
  • 정본 상태
  • 재시도
  • 리전 전략
04

API 계약·커밋·테스트

유스케이스·계약·코드 검증으로 연결합니다

미리보기, 주문, 결제 시작, 승인 확인, 콜백, 상태 조회처럼 사용자에게 가치가 있는 흐름을 API 계약, 재검증 조건, 테스트 기준으로 고정합니다.

구현·검증 근거 보기 →
  • 유스케이스
  • API 계약
  • 테스트
  • 감사 결과
05

인프라·런북·배포 문서

품질 속성에 맞는 인프라 옵션을 선택합니다

실행 시간, 실패 비용, 재시도 가능성, 관측성, 비용 조건을 보고 API 서버, Worker, 객체 저장소, Redis, 로그·배포 경계를 선택합니다.

인프라 판단 근거 보기 →
  • 배포 안전성
  • 관측성
  • 비용
  • 실행 경계
06

복구 회고·런북·코드

운영·복구 기준으로 실패 이후를 검증합니다

멱등키, 행 잠금, Outbox, 언어별 대체 문구, 배치 커서, 실패 상태, 운영 문서를 남겨 중복 실행·부분 실패·재처리를 설명 가능하게 만듭니다.

운영·복구 근거 보기 →
  • 실패 상태
  • 재처리
  • 언어별 대체 문구
  • 운영 문서

Decision Criteria

요구를 시스템 설계로 연결하는 판단 기준

요구사항을 바로 API로 옮기기 전에 서버가 보장할 값, 남겨야 할 상태, 복구 가능한 경계를 먼저 정합니다.

판단 근거

요구를 책임 경계로 나눕니다

요구사항을 책임 경계와 도메인 언어로 나눈 근거

문제 정의

화면 언어를 서버, 프론트, PG, 운영자의 책임으로 나눴습니다.

설계 판단

구매·청구·결제시도·수강권·구독권한을 별도 모델로 분리했습니다.

검증 근거

결제·구독·환불 플로우와 payment/entitlement 문서에서 추출했습니다.