단일 책임 원칙(SRP)

📌 한 줄 통찰 (The Karpathy Summary)

단일 책임 원칙(SRP, Single Responsibility Principle)은 클래스나 모듈이 단 하나의 변경 이유만 가져야 한다는 소프트웨어 설계 원칙입니다 [1, 2]. 하나의 모듈에 영속성, 데이터 처리, 알림 등 여러 책임이 섞이면 코드가 불안정해지고 조그만 수정에도 예기치 않은 문제가 발생할 위험이 커집니다 [2]. 이 원칙을 준수하면 각 모듈이 한 가지 명확한 역할만 수행하게 되어, 한 영역의 코드를 수정할 때 다른 무관한 로직에 영향을 미치지 않고 안전하게 변경할 수 있습니다 [2, 3].

📖 구조화된 지식 (Synthesized Content)

개념의 정의: 모듈이 변경되어야 하는 '이유'는 단 하나여야 하며, 이는 특정 이해관계자, 비즈니스 규칙 또는 외부 시스템의 요구사항을 의미합니다 [2]. 클래스나 인터페이스가 너무 많은 책임을 지게 되면 잦은 변경에 노출되고 취약해집니다 [4].
위반의 징후 (Red Flags): HTTP 핸들러, 비즈니스 로직, 데이터 접근 로직이 한 파일에 뒤섞여 있는 경우, 비대한 "god" 클래스로 인해 코드 병합 충돌(merge conflict)이 빈번한 경우, 그리고 코드 주석에 "~도 수행함(also does...)" 같은 설명이 붙는 메서드 등은 SRP 위반을 시사합니다 [3].
리팩토링 전략: 실용적인 해결책은 "비명을 지를 때까지 추출하라(extract till you scream)"는 것입니다. 가장 두드러지는 부차적인 책임을 독립된 별도의 클래스로 빼내고, 테스트를 작성하는 과정을 반복합니다 [3]. 이렇게 역할을 분리하면, 결제 로직을 건드리지 않고 이메일 제공자를 교체하거나 스키마를 안전하게 변경할 수 있습니다 [3].
실무 적용 사례:
- Toss Front SDK: "리소스를 만든 곳에서 닫는다"는 접근은 단일 책임 원칙을 잘 보여줍니다. 이를 통해 사용자 실수로 인한 리소스 및 리스너 누수를 방지하여 SDK 전반의 안정성을 굳건하게 지켜냅니다 [5].
- Strapi 개발: 커스텀 컨트롤러의 로직을 가볍게 유지해야 합니다. 파일 업로드, 유효성 검사, 분석 등의 작업은 하나의 컨트롤러 파일에 몰아넣지 않고 개별 서비스로 분리하여 호출하도록 설계해야 합니다 [3].
- 아키텍처 패턴의 활용: 단일 책임 원칙은 인터페이스 분리 원칙(ISP)과 궤를 같이합니다. 복잡한 시스템을 퍼사드(Facade) 패턴으로 감싸 책임을 단순화하면, 개발자의 인지 부하를 줄이고 시스템 간 결합도를 낮추는 강력한 수비 전략이 됩니다 [4].

⚠️ 모순 및 업데이트 (Contradictions & RL Update)

과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
정책 변화: Programming & Language 분야의 자동 자산화 수행.

🔗 지식 연결 (Graph)

Related Topics: SOLID 원칙, 인터페이스 분리 원칙(ISP), 퍼사드(Facade) 패턴
Projects/Contexts: Toss Front SDK 기반 외부 연동사 플러그인 개발 생태계 구축, Strapi
Contradictions/Notes: 소스 내에서 단일 책임 원칙에 대한 모순점은 없으며, 제공된 모든 소스에서 모듈의 결합도를 낮추고 예측 가능성을 높이는 핵심 아키텍처 원칙으로 일관되게 강조하고 있습니다.

Last updated: 2026-04-18

Raw Source: 00_Raw/2026-04-20/단일 책임 원칙(SRP).md

4.0 KiB Raw Permalink Blame History

단일 책임 원칙(SRP)

📌 한 줄 통찰 (The Karpathy Summary)

📖 구조화된 지식 (Synthesized Content)

⚠️ 모순 및 업데이트 (Contradictions & RL Update)

🔗 지식 연결 (Graph)

4.0 KiB

Raw Permalink Blame History