결합도 낮은 Smart Client SDK로 구축하는 엔터프라이즈 프론트엔드 구조

Context

전역 상태의 무분별한 사용과 분산된 fetch 호출로 인한 책임 소재 불분명. useEffect 내의 산재한 API 요청이 시스템 복잡도를 증가시키는 구조. 유지보수가 어려운 취약한 추상화 계층의 한계.

Technical Solution

• API 요청을 단일 진입점으로 관리하는 Fetch Adapter 기반의 Menu 패턴 도입
• 인증 토큰 주입, 401 재시도, 전역 에러 핸들링을 통합 처리하는 LibrarianFetch 인터페이스 설계
• 컴포넌트와 API 계층을 완전히 분리하여 프레임워크 변경에 유연하게 대응하는 디커플링 전략
• 낙관적 업데이트 대신 백엔드 확정 데이터를 기반으로 로컬 캐시를 갱신하는 Ledger 방식의 상태 동기화
• 상태 관리 로직을 LibrarianStore 클래스로 캡슐화하여 데이터 일관성 보장

Key Takeaway

상태 동기화와 데이터 페칭 로직을 UI 프레임워크로부터 완전히 분리하여 비즈니스 로직의 생명주기를 독립적으로 관리하는 설계 원칙.