Boolean Blindness 제거를 통한 State Machine 기반 상태 무결성 확보

Context

다수의 Boolean 플래그 사용으로 인해 발생한 2^n개의 잠재적 상태 조합 및 논리적 모순 해결 필요. 복잡한 if/elif/else 조건문으로 인한 코드 유지보수성 저하와 상태 전이의 불확실성이 병목 지점으로 작용.

Technical Solution

• Finite State Machine(FSM) 도입을 통한 단일 상태 유지 및 상호 배타적 상태 정의
• State Design Pattern 적용으로 상태별 행동을 개별 클래스로 캡슐화하여 Polymorphism 기반의 동작 제어
• Order 클래스가 현재 상태 객체에 행위를 위임하는 Delegation 구조 설계를 통한 비즈니스 로직 분리
• Open-Closed Principle 준수를 위해 새로운 상태 추가 시 기존 코드 수정 없이 클래스 확장만으로 기능 구현
• 실무적 효율성을 위해 선언적(Declarative) 전이 정의 방식을 채택하여 상태-트리거-목적지 간의 매핑 자동화
• Guard Clause 도입으로 상태 전이 전 특정 조건(예: word_count > 500)을 검증하는 정밀한 제어 로직 추가