본문으로 건너뛰기
목록으로 돌아가기
스터디
16 분

확장은 열고, 역할은 나누고, 의존은 뒤집어라: 결제 예제로 읽는 OCP·ISP·DIP

기존 Payment 클래스에 `if (type == "KAKAO")` 한 줄을 넣는 순간, 결제 경로 전체가 다시 테스트 대상이 된다. 개방-폐쇄 원칙(OCP), 인터페이스 분리 원칙(ISP), 의존 역전 원칙(DIP)을 Meyer(1988)와 Martin(1996)의 글로 확인하고, 결제 예제 하나로 세 원칙이 어떻게 맞물리는지 TypeScript 토이로 보여 준다. 바뀌지 않는 축에 인터페이스를 두는 함정도 짚는다.

박효열 (Hyoyoul Park)
#SOLID#OCP#ISP#DIP#TypeScript#설계

2026-11-05 확인. 출발점은 같은 작성자의 Threads 연재 3·4·5편이다. OCP, ISP, DIP. 문장과 이미지는 옮기지 않았고 링크는 출처 표시만 한다. 같은 날 ISP와 DIP의 공개 도입부는 열렸다. ISP 도입부는 영화 기생충의 대사 "너는 다 계획이 있구나"를 훅으로 쓴다. 그 대사와 캡션의 나머지 논지는 이 글의 논지로 쓰지 않는다. OCP 글은 시간이 초과되어 다시 읽지 못했다. 연재 번호는 따르지 않는다. 이 글은 펭귄은 새지만 Bird는 아니다 다음에 온다. 같은 날 연 1차 자료는 Martin의 1996년 칼럼 사본이다. 개방-폐쇄 원칙, 의존 역전 원칙, 인터페이스 분리 원칙. Wikipedia의 OCP, ISP, DIP, SOLID도 같은 날 열었다. Meyer의 1988년 책은 열지 않았다. 칼럼의 archive.org 사본은 HTTP 500이라 표지와 쪽수는 그 PDF에서 읽지 못했다. 토이는 solid-ocp-dip-payment-toy.ts이고 142줄이다. Node 24.22.2에서 tsx로 실행했다. 컴파일 진단은 이 저장소의 TypeScript 5.9.3, tsc --strict다. 결제 문자열은 가짜다. 실제 결제 대행사는 호출하지 않는다. 확인된 사실과 이 글의 해석을 구분한다.

먼저 결론

1996년 칼럼에서 개방-폐쇄는, 동작이 늘 때 그 모듈의 소스를 고치지 않는 것이다. 추상화의 새 파생이 동작을 늘린다. Meyer의 1988년 원칙은 그 칼럼이 Object-Oriented Software Construction 23쪽에 돌리는 원칙이다. 칼럼이 이어서 보여주는 장치는 추상 기반과 새 파생이다. Wikipedia는 Meyer 자신의 해법을 구현 상속으로 적는다. 두 장치는 다르다. 슬로건과 상속 독법은 같은 문장이 아니다.

1996년 네 번째 칼럼에서 인터페이스 분리는 한 문장이다. 클라이언트는 자신이 쓰지 않는 인터페이스에 의존하도록 강요받으면 안 된다. 뚱뚱한 게이트웨이 타입은 정산 작업을 카드 승인과 같은 표면으로 만든다. 그 표면을 역할 인터페이스로 나누는 것이 칼럼의 처방이다. 객체 하나는 그 인터페이스 여럿을 구현해도 된다.

1996년 세 번째 칼럼에서 의존 역전은 두 절이다. 고수준 모듈은 저수준 모듈에 의존하면 안 되고, 둘 다 추상화에 의존해야 한다. 추상화는 세부에 의존하면 안 되고, 세부가 추상화에 의존해야 한다. 그 칼럼에서 "역전"은, 정책 모듈이 저수준의 구체 모듈을 호출하게 만드는 구조적 설계의 습관과 반대 방향이다. 데이터베이스가 구체적인 결제 클래스를 import한다는 뜻이 아니다.

토이에서 카카오는 새 PaymentMethod 객체다. CheckoutService는 고치지 않는다. 정산용 가짜는 메서드 하나를 구현하고 셋을 구현하지 않는다. 실패하는 승인 함수와 인메모리 저장소는 밖에서 넣고, 서비스 소스는 그대로다. 이것이 시연이다. 세 원칙이 슬로건 셋이 아니라 한 동작이라는 말은 이 글의 해석이다.

결론에 한계 둘이 있어야 한다. 인터페이스는 바뀔 것으로 예상한 축에만 둔다. 그리고 새 charge가 계약을 깨면 if가 돌아온다. 두 번째 한계는 LSP 글이다.

금요일 오후의 if 한 줄

PaymentV1.pay는 문자열로 갈라진다. 카드와 토스는 이미 있다. 카카오는 같은 클래스의 가지 하나다. 네이버는 없어서 메서드가 던진다.

class PaymentV1 {
  pay(type: string, amount: number): string {
    if (type === "CARD") return `card charged ${amount}`;
    if (type === "TOSS") return `toss charged ${amount}`;
    if (type === "KAKAO") return `kakao charged ${amount}`;
    throw new Error(`unknown payment type: ${type}`);
  }
}

2026-11-05에 tsx가 출력한 줄은 이렇다.

(a) if-chain: kakao charged 15000
(a) if-chain: unknown payment type: NAVER <- needs another edit

던지기는 프로그램이 한 일이다. 메시지 뒤의 말은 이 스크립트가 붙인 라벨이다. 다음 결제 수단은 PaymentV1을 또 고치는 일이고, 재테스트 범위는 그 클래스다. 새 가지가, 기존 수단이 이미 쓰는 메서드 안에 있기 때문이다. 이 범위 주장은 이 프로그램의 모양이지, 실제 팀의 회귀 모음을 측정한 값이 아니다.

Martin의 DIP 칼럼은 다른 도메인에서 같은 모양을 쓴다. 그 칼럼의 Listing 2는 Copy 안에 if를 넣어 프린터와 디스크 중 어디에 쓸지 고른다. 칼럼은 늘어나는 if를 모듈이 경직되는 쪽으로 본다. PaymentV1을 그 listing으로 읽고 장치 자리에 결제 수단을 넣는 것은 이 글의 비교다. listing 자체는 칼럼이다.

작은 diff도 다시 볼 것의 목록을 넓힐 수 있다. 결제 버그 하나가 로그인까지 멈추게 할 때는 다른 분리다. 결제 실패와 로그인 조회가 풀 하나를 공유한다. 이 글은 if 사슬과 공유 풀이 같은 장애라고 말하지 않는다. 겹치는 말은 장애 반경이다. 이 문장은 해석이다.

Meyer가 쓴 것과 1996년 칼럼이 한 일

개방-폐쇄 칼럼은 자신을 The C++ Report의 Engineering Notebook 첫 칼럼이라고 부른다. 원칙의 출처를 Bertrand Meyer, Object-Oriented Software Construction, Prentice Hall, 1988, 23쪽으로 돌리고, 다음 줄을 그의 말을 풀어 쓴 것이라고 표시한다.

SOFTWARE ENTITIES (CLASSES, MODULES, FUNCTIONS, ETC.)
SHOULD BE OPEN FOR EXTENSION, BUT CLOSED FOR MODIFICATION.

이 글은 1988년 책을 열지 않았다. 위의 풀어 쓰기는 cs.utexas.edu 사본에서 읽은 칼럼의 문장이다. Wikipedia OCP 항목은 Meyer 자신의 정의를 다른 말로 인용한다. 열려 있다: 모듈을 아직 확장할 수 있다. 예를 들어 필드나 함수를 더할 수 있다. 닫혀 있다: 다른 모듈이 이미 쓸 수 있다. 그러려면 안정된 설명, 정보 은닉 의미의 인터페이스가 정해져 있어야 한다. 같은 Wikipedia 항목은 Meyer의 해법이 구현 상속이라고 적는다. 새 클래스가 기존 클래스를 부모로 쓴다. 책 229쪽을 가리킨다. 229쪽은 여기서 열지 않았다. Wikipedia가 적는 1988년판 ISBN은 0-13-629049-3이다.

1996년 칼럼이 이어서 가르치는 장치는, 구체 클래스의 부모-자식 상속이 아니다. 칼럼은 추상 기반은 고정되고 새 파생이 동작을 늘리므로, 추상화를 쓰는 클라이언트는 고치지 않는다고 말한다. 예는 도형이다. 절차적 DrawAllShapes는 타입 코드로 분기한다. 새 도형은 그 함수를 고친다. 칼럼의 수정은 가상 Draw를 가진 추상 Shape와, 그 파생인 Circle과 Square다. PaymentV1은 타입 코드 분기다. PaymentMethod 객체는 파생이다. 이 대응은 이 글의 것이다. 도형 예는 칼럼의 것이다.

칼럼의 맺음 문단은, 원칙을 지키는 일이 "객체지향 언어를 쓰는 것"이 아니라고 말한다. 바뀔 것으로 예상하는 부분에 추상화를 적용하는 일이라고 말한다. 이 토이가 바뀔 축으로 다루는 것은 결제 수단이다. 금액 반올림 규칙에는 인터페이스를 주지 않는다. 수단 축을 고르고 반올림 축을 거절하는 것은 판단이다. 칼럼이 주는 규칙은 "바뀔 부분"이다. 결제 시스템에서 그 축을 고르는 일은 해석이다.

DIP 칼럼이 개방-폐쇄 논의를 "지난 1월"이라고 부르는 것이, 이 글이 OCP 칼럼의 달에 대해 가진 근거다. Wikipedia는 Martin의 글을 1996년 1월 C++ Report로 적는다. 둘은 맞다. Wikipedia가 링크한 objectmentor.com 아카이브 PDF는 2026-11-05에 HTTP 500이었다. 읽은 사본은 그 아카이브가 아니다.

Wikipedia는 Craig Larman의 "Protected Variation: The Importance of Being Closed"(IEEE Software 18(2), 2001)가 이 원칙을 Alistair Cockburn의 Protected Variations, David Parnas의 정보 은닉과 연결했다고 적는다. DOI는 10.1109/52.922731이다. 그 논문은 열지 않았다. 토이는 그 논문에 기대지 않는다.

누가 인터페이스를 소유하나

의존 역전 칼럼은 자신을 Engineering Notebook 세 번째 칼럼이라고 부른다. LSP 칼럼을 "Mar, 96"으로, 개방-폐쇄 칼럼을 1월로 가리킨다. 연 사본에는 자신의 권·호·쪽수가 찍혀 있지 않다.

두 절은 칼럼에 대문자로 적혀 있다.

A. HIGH LEVEL MODULES SHOULD NOT DEPEND UPON LOW LEVEL MODULES.
   BOTH SHOULD DEPEND UPON ABSTRACTIONS.
B. ABSTRACTIONS SHOULD NOT DEPEND UPON DETAILS.
   DETAILS SHOULD DEPEND UPON ABSTRACTIONS.

"역전"에 대한 칼럼 자신의 풀이가 바로 이어진다. 구조적 분석과 설계는 고수준 모듈이 저수준 모듈에 의존하고, 추상화가 세부에 의존하는 구조를 만든다고 말한다. 원칙을 따른 프로그램은 그 의존 구조를 뒤집는다. Copy 예가 그림이다. Copy는 추상 Reader와 Writer에 의존한다. KeyboardReader와 PrinterWriter는 그 추상화에 의존한다. Copy는 키보드나 프린터의 이름을 대지 않는다.

정책이 어디에 있는지는 Button/Lamp 예가 보여 준다. 켜기/끄기 동작을 감지해 전달하는 일이 정책이고, 칼럼은 그 정책을 Button에 둔다. Lamp는 ButtonClient를 구현한다. 세부가, 정책이 쓰는 추상화에 의존한다. 칼럼은 저수준 모듈이 고수준의 구체 클래스를 import한다고 말하지 않는다.

Wikipedia DIP 항목은 패키지 배치를 한 문단 더한다. 한 직접 적용에서는 추상화가 고수준 패키지에 살고, 그래서 저수준 패키지가 컴파일되려면 그 패키지에 의존한다. 이 글은 그 배치를 1996년 칼럼에서 다시 유도하지 않았다. Wikipedia의 설명으로 적는다. 토이는 인터페이스를 CheckoutService와 같은 파일에 둔다. 잴 패키지 경계가 없다. 한 파일에 둔 것은 예제의 한계다.

단어를 넓게 읽기 쉬운 문장이 Wikipedia에 하나 더 있다. 역전은 저수준 층이 고수준 층에 의존한다는 뜻이 아니라고 한다. 둘 다, 정책에 필요한 것을 드러내는 추상화에 의존한다. 이것은 절 A, 절 B와 맞다. "CheckoutService는 추상화에만 의존한다"는 절 A의 읽기이고, 그 추상화가 카카오 SDK 타입을 import해도 되면 절 B가 빠진다. 토이의 PaymentMethod는 카카오를 언급하지 않는다. 카카오 객체 리터럴은 PaymentMethod를 구현함으로써 그 타입을 언급한다.

제어 흐름
  CheckoutService --호출--> PaymentMethod.charge --실행--> 카카오 객체

소스 의존
  CheckoutService --> PaymentMethod
  CheckoutService --> OrderRepository
  CheckoutService --> Clock
  카카오 객체 ------> PaymentMethod
  InMemoryRepo ----> OrderRepository

두 번째 블록의 화살표는 소스 의존이다. 누가 타입의 이름을 대는가. 첫 블록은 실행 때 누가 누구를 호출하는가. 같은 화살표가 아니다. 이 구분은 이 글이 칼럼의 Copy 그림을 읽는 방식이다. 그림은 칼럼이 그린다. 결제 라벨은 이 글의 것이다.

Wikipedia 연혁은 C++ Report 글 "The Dependency Inversion Principle"을 1996년 6월, 8권 6호, 61–66쪽으로 적고 archive.org PDF를 가리킨다. 그 fetch는 HTTP 500이었다. 이 글이 연 PDF에는 절이 있고 호의 표지는 없다. 다음 칼럼인 인터페이스 분리 칼럼은 이 DIP 칼럼을 "May 96"이라고 부른다. 월간으로 치면 5월과 6월이 한 호의 달일 수는 없다. 어느 쪽 인용이 다른지는 표지를 보지 않아 정하지 않는다. 이 글은 읽은 절을 유지하고, 월과 61–66쪽을 표지에서 본 사실로는 단정하지 않는다. Wikipedia는 1994년 10월 메트릭 논문도 앞선 DIP 자료로 적는다. 그 논문은 열지 않았다. 여기서 쓰는 DIP 본문은 1996년 칼럼이다.

의존 역전은 의존성 주입이 아니다. Wikipedia DIP 항목은 Plugin, Service Locator, 의존성 주입을, 실행 시점에 저수준 구현을 정책에 넘기는 수단으로 적는다. 토이는 CheckoutService 생성자에 객체를 넘긴다. 그것은 주입이다. 절을 만족시키는 방법 중 하나다. 절은 누가 누구의 이름을 대는가에 대한 것이고, 컨테이너에 대한 것이 아니다.

뚱뚱한 게이트웨이와 그 아래의 역할

인터페이스 분리 칼럼은 자신을 Engineering Notebook 네 번째 칼럼이라고 부른다. DIP 칼럼을 "May 96"이라고 부른다. 연 사본에는 이 칼럼 자신의 달이 찍혀 있지 않다. Wikipedia ISP 항목의 참고 문헌 한 줄은 이 글을 C++ Report 1996년 6월로 적는다. 작성자의 "May 96"이 맞다면, 이 칼럼과 바로 앞 칼럼이 둘 다 6월일 수는 없다. 이 글은 달을 고르지 않는다. 칼럼의 원칙 문장은 이렇다.

CLIENTS SHOULD NOT BE FORCED TO DEPEND UPON INTERFACES THAT THEY DO NOT USE.

칼럼의 사례는 잠그고, 열고, 열려 있는지를 알리는 Door다. TimedDoor는 시간 초과도 필요해서, 한 설계는 TimerClient를 Door 위에 둔다. 그러면 시간을 재지 않는 문을 포함한 모든 문 파생이 TimeOut을 물려받는다. 그 클라이언트는 호출하지 않는 시간 초과 타입과 함께 컴파일된다. 칼럼은 이것을 뚱뚱하거나 오염된 인터페이스라고 부른다. 처방 문장은, 클라이언트가 다르면 인터페이스도 다르다는 것이다. 객체는 그 인터페이스를 둘 이상 구현할 수 있다. 클라이언트에게 뚱뚱한 표면을 하나의 타입으로 주면 안 된다. 칼럼은 Door가 TimerClient를 물려받지 않고도 타이머가 문에게 알릴 수 있도록 어댑터도 보여 준다. 토이는 그 어댑터를 만들지 않는다.

토이 (d)의 결제 표면은 뚱뚱한 타입이다.

interface FatPaymentGateway {
  charge(amount: number): Promise<string>;
  refund(receipt: string): Promise<string>;
  fetchStatement(day: string): Promise<string>;
}

결제는 charge가 필요하다. 환불 창구는 refund가 필요하다. 정산은 fetchStatement가 필요하다. closeBooks가 FatPaymentGateway를 받으면, 정산만 읽는 가짜도 나머지 메서드 둘을 선언해야 한다. 토이는 표면을 나눈다.

interface Charger { charge(amount: number): Promise<string>; }
interface Refunder { refund(receipt: string): Promise<string>; }
interface StatementReader { fetchStatement(day: string): Promise<string>; }

KakaoGateway는 셋을 모두 구현한다. chargeWith는 Charger를 받는다. refundOne은 Refunder를 받는다. closeBooks는 StatementReader를 받는다. statementOnly는 closeBooks가 호출하는 메서드 하나만 구현한다. 실행은 이렇게 출력했다.

(d) ISP checkout via Charger: kakao charged 15000
(d) ISP refund desk: refunded kakao charged 15000
(d) ISP books: in-memory statement 2026-11-05
(d) ISP fat surface: charge,refund,fetchStatement

첫 줄은 같은 KakaoGateway 객체를 Charger로 넘긴다. 둘째 줄은 그 객체를 Refunder로 넘긴다. 셋째 줄은 KakaoGateway를 쓰지 않는다. statementOnly는 다른 값이고, 날짜 문자열 2026-11-05는 인자다. (b)와 (c)의 시계가 아니다. 넷째 줄은 FatPaymentGateway의 이름 셋이고, keyof FatPaymentGateway로 타입을 준 목록에서 출력했다. 실행 중 클래스를 리플렉션으로 덤프한 것이 아니다.

받는 파일은 예제가 타입 검사를 통과하도록 호출 하나를 주석으로 남겨 둔다.

// closeBooks(card, "2026-11-05"); // uncomment -> compile error

card는 PaymentMethod다. id와 charge가 있다. fetchStatement는 없다. 그 호출의 주석을 풀고 TypeScript 5.9.3, tsc --strict로 사본을 검사하면 이렇게 나온다.

error TS2345: Argument of type 'PaymentMethod' is not assignable to parameter of type 'StatementReader'.
  Property 'fetchStatement' is missing in type 'PaymentMethod' but required in type 'StatementReader'.

진단은 card 인자를 가리킨다. PaymentMethod는 이미 작은 승인 모양이라, 정산 역할에 받아들여지는 대신 거절된다. 컴파일러가 나누기를 강제하는 것이다. 잘못된 승인 금액을 잡는 것이 아니다. 이 한계는 LSP 글이 strictFunctionTypes에 대해 적은 한계와 같은 종류다. 타입 검사기는 없는 멤버를 보고, 던져지는 계약은 보지 않는다.

Wikipedia는 작은 인터페이스를 role interface라고 부른다. 여기서 쓰는 말은 칼럼의 말, 곧 클라이언트가 다르면 인터페이스도 다르다는 것이다. Wikipedia ISP 항목은 Xerox 프린터 작업 클래스에 대한 기원 이야기도 적는다. Xerox 문서를 열지 않았으므로 그 이야기는 이 글의 근거가 아니다.

(b)·(c)의 PaymentMethod와 (d)의 Charger는 같은 TypeScript 타입이 아니다. PaymentMethod는 id와 charge가 있고 CheckoutService가 소유한다. Charger는 charge만 있고 chargeWith가 받는다. 한 파일 안의, 승인 모양인 작은 인터페이스 둘이다. 이것을 한 아이디어를 두 번 보여 준 것, 한쪽은 정책의 추상화이고 다른 쪽은 게이트웨이를 나눈 것이라고 읽는 일은 해석이다. 타입 자체는 파일이다.

한 결제 경로

(b)와 (c)는 정책과, 갈아 끼운 세부가다. CheckoutService는 PaymentMethod 목록과 OrderRepository, Clock을 받는다. 카카오는 목록에 넣는 객체 하나다. 클래스는 고치지 않는다.

const kakao: PaymentMethod = { id: "KAKAO", charge: async (a) => `kakao charged ${a}` };
const svc = new CheckoutService([card, toss, kakao], repo, fixedClock);

고정 시계는 문자열 2026-11-04T17:00+09:00을 돌려준다. 이 문자열은 실행 날짜가 아니다. 실행 날짜는 2026-11-05다. 영수증 줄을 고정하려고 둔 스텁이다.

(b) OCP: kakao charged 15000 @ 2026-11-04T17:00+09:00
(b) OCP: rejected: NAVER not registered
(c) DIP fake PG: PG timeout
(c) DIP repo rows: [ 'o-1 -> kakao charged 15000 @ 2026-11-04T17:00+09:00' ]

네이버는 save 전에 거절되므로 repo.rows에 없다. 시간 초과 경로는 두 번째 저장소를 가진 두 번째 CheckoutService를 만든다. 던져진 PG timeout은 잡혀서 출력된다. 원래 저장소에는 o-1의 카카오 영수증만 남는다. 이 줄들은 스크립트가 출력한 것이다. 결제 대행사의 로그가 아니다.

원칙위에서 확인한 문장이 실행이 실제로 한 일
OCP닫아 둔 모듈을 고치지 않고 확장한다카카오는 새 객체다. CheckoutService 소스는 카드와 토스를 승인하는 그 소스다. 네이버는 클래스 안에 가지가 없어서가 아니라, 넣어 주지 않아서 거절된다.
ISP클라이언트에게 호출하지 않는 메서드를 주지 않는다closeBooks는 StatementReader를 받는다. statementOnly의 메서드는 하나다. 뚱뚱한 이름 목록은 셋이다.
DIP정책과 세부가 모두 추상화의 이름을 댄다실패하는 승인과 InMemoryRepo는 생성자 인자다. 서비스 메서드는 여전히 charge, now, save를 호출한다.

표의 셋째 열은 실행이다. 첫째 열의 이름은 이 글이 그 실행에 붙인 라벨이다. 출력은 받아들이고 라벨은 거절할 수 있다.

LSP가 밑에서 받쳐야 한다

DIP 칼럼은 1996년 3월 LSP 칼럼을 요약하며, 함수가 객체의 실행 시점 타입을 검사해야 하면 개방-폐쇄 원칙은 이미 깨진 것이라고 말한다. 그 규칙의 계약 독법은 앞 글 펭귄은 새지만 Bird는 아니다다. 사전조건, 사후조건, 불변식.

새 PaymentMethod가 다른 수단은 받는 금액에서 던지거나, save가 담지 못하는 영수증을 돌려주면, CheckoutService는 그 객체를 위한 가지를 늘린다. 그 가지는 금요일의 if가, 닫혀 있어야 할 클래스 안으로 돌아온 것이다. 토이는 그 깨진 메서드를 실행하지 않는다. failing은 모든 금액에서 PG timeout을 던지고, 테스트는 그 던지기를 요청한 쪽이다. 이것은 갈아 끼운 세부이고 DIP 시연이다. LSP 위반이 아니다. 호출자에게 CARD가 성공한다고 약속한 적이 없기 때문이다. 이것을 계약 위반이라고 부르면 이 스크립트를 잘못 읽은 것이다.

LSP 글이 더하는 것, 그리고 이 글이 가리키기만 하는 것은, 대체가 언제 불법인가에 대한 규칙이다. 가리킴은 링크다. 규칙은 그 글에 있다.

반대편 함정

Wikipedia DIP 항목에는 패턴을 일반화해서 클래스 경계마다 인터페이스를 둘 때의 절이 있다. 페이지는 비용을 넷 적는다. 인터페이스를 구현했다는 사실만으로 결합이 줄지 않는다. 다른 구현이 목뿐인 인터페이스는, 읽는 사람에게 무엇이 또 구현하는지를 묻게 하고 대답은 목이다. 팩토리와 주입 프레임워크가 배관이 된다. 언어의 평범한 구성이 좁아진다. 이 넷은 2026-11-05에 읽은 그 페이지의 목록이다. 이 글은 목뿐인 인터페이스를 세려고 코드베이스를 조사하지 않았다.

이 글이 더하는 판단: 칼럼 자신의 맺음 테스트가 바뀔 것으로 표시하지 않을 축에는 추상화를 열지 않는다. 이 토이에서 금액 반올림은 그런 축이다. 파일에 RoundingPolicy 인터페이스는 없다. 구현 하나와 목만 달아 하나를 추가하는 일이 함정이다. 마지막 문장은 해석이다. 인터페이스가 없다는 사실은 파일이다.

체크리스트

칼럼과 이 토이에서 뽑은 질문이다. 인용문이 아니다.

  • type 문자열, 또는 타입 코드에 대한 if/switch가 결제 수단마다 가지를 늘린다. 이것이 PaymentV1이고, 도형 칼럼의 DrawAllShapes 모양이다.
  • 정책 모듈이 구체 저장소나 구체 게이트웨이를 생성한다. CheckoutService 안에서 MySQL 저장소를 new하면 절 A가 깨진다. 토이의 생성자는 저장소를 받는다. MySQL 클라이언트는 실행하지 않았다.
  • 정책 테스트가 실제 결제 대행사 없이 돌지 않는다. (c)는 던지는 가짜 승인 함수라서 돈다.
  • 인터페이스의 운영 구현이 하나이고 목이 하나이며, 필요가 다른 두 번째 호출자가 없다. 이것은 Wikipedia의 일반화 경고이지, 이 저장소가 수행한 집계가 아니다.
  • 추상화가, 저수준 SDK만 알아야 할 타입의 이름을 댄다. PaymentMethod.charge는 문자열을 돌려준다. 업체 응답 타입을 돌려주지 않는다.
  • 클라이언트나 그 테스트 대역이 호출하지 않는 메서드를 선언해야 한다. closeBooks의 매개변수가 FatPaymentGateway인 경우가 그것이다. 토이의 closeBooks는 그 타입을 받지 않는다. statementOnly는 그 타입에 대입되지 않는다. 그 대입 실패는 별도의 tsc 실행을 하지 않았다. 위의 tsc 실행은 PaymentMethod와 StatementReader의 비교다.

사실과 해석

문장구분
Meyer 1988이 OCP 칼럼이 23쪽에 돌리는 출처이고, 그 칼럼의 슬로건은 풀어 쓴 것으로 표시되어 있다. 칼럼의 장치는 추상 기반과 새 파생이다.2026-11-05에 OCP PDF에서 확인
Wikipedia는 Meyer의 해법을 구현 상속으로 적고 229쪽을 인용한다. Larman 2001은 그 페이지의 Protected Variation 인용이다.같은 날 연 Wikipedia OCP. 책과 Larman 논문은 열지 않음
DIP 절 A·B, Copy의 if, 역전을 구조적 설계의 반대로 보는 뜻DIP PDF에서 확인. 월과 61–66쪽은 그 PDF에 없었다. Wikipedia는 1996년 6월, 8(6), 61–66쪽이라고 한다. ISP 칼럼은 "May 96"이라고 한다. Archive.org는 500
ISP 문장, Door/TimerClient라는 뚱뚱한 인터페이스, "클라이언트가 다르면 인터페이스도 다르다"ISP PDF에서 확인. 칼럼 자신의 달은 거기에 찍혀 있지 않았다. Wikipedia 참고 문헌은 1996년 6월이라고 한다
2000년 논문에 모인 원칙들, 그리고 2004년경 Michael Feathers가 만든 약어. Clean Architecture 58쪽 인용Wikipedia SOLID. 2000년 PDF 아카이브는 500. 58쪽은 열지 않음. 이 블로그의 LSP 글도 Feathers 귀속을 그렇게 적는다
출력 열 줄과 TS2345이번 실행. Node 24.22.2의 tsx, TypeScript 5.9.3, 2026-11-05. 시계 문자열은 스텁
세 원칙은 한 동작이다. 열 축은 결제 수단이고 반올림은 아니다. CQRS 글과 공유하는 것은 장애 반경이라는 말이고 장애 자체는 아니다이 글의 해석

출처

  • 이 블로그의 앞 글. 펭귄은 새지만 Bird는 아니다. 결제 버그 하나가 로그인까지 멈추게 할 때.
  • Threads. 링크만 남기고 캡션은 인용하지 않는다. OCP 3편. ISP 4편. DIP 5편.
  • Bertrand Meyer, Object-Oriented Software Construction, Prentice Hall, 1988. 열지 않음. OCP 칼럼이 23쪽을 인용한다. Wikipedia는 상속 해법에 229쪽을 인용하고 ISBN 0-13-629049-3을 적는다.
  • Robert C. Martin, "The Open-Closed Principle", Engineering Notebook 첫 칼럼, C++ Report. 읽은 사본: PDF. Wikipedia는 1996년 1월로 적는다. Wikipedia가 링크한 아카이브 ocp.pdf는 2026-11-05에 HTTP 500이었다.
  • Robert C. Martin, "The Dependency Inversion Principle", Engineering Notebook 세 번째 칼럼. 읽은 사본: PDF. 표지에서 확인하지 못한 Wikipedia 서지는 C++ Report 8(6), 1996년 6월, 61–66쪽이다. 다음 칼럼은 1996년 5월이라고 부른다. 아카이브 dip.pdf는 같은 날 HTTP 500이었다.
  • Robert C. Martin, "The Interface Segregation Principle", Engineering Notebook 네 번째 칼럼. 읽은 사본: PDF.
  • Craig Larman, "Protected Variation", IEEE Software 18(2), 2001. doi:10.1109/52.922731. 열지 않음.
  • 개방-폐쇄 원칙, 인터페이스 분리 원칙, 의존 역전 원칙, SOLID. Feathers 귀속은 SOLID 항목의 것이다.
  • solid-ocp-dip-payment-toy.ts. 2026-11-05 실행. 위에 인용한 열 줄이 그 실행이다. closeBooks(card, ...)는 주석으로 남아 있다. TS2345는 그 주석을 푼 진단이다.