State-Driven 엔진 기반의 동적 반응형 REST API 설계

Context

정적인 응답을 반환하는 일반적인 REST API 구조에서 탈피하여 사용자의 요청에 따라 서버의 상태가 변화하는 시스템 설계 필요성 대두. 단순 랜덤 응답이 아닌 내부 상태 값에 따라 결과가 결정되는 결정론적 무작위성 구현을 목표로 함.

Technical Solution

• Node.js 및 Express.js 기반의 State-Driven 아키텍처 설계로 요청마다 서버의 상태를 갱신하는 구조 채택
• mood, caffeine level, burnout, cleanliness 등 4가지 핵심 지표를 통해 API의 행동 양식을 정의하는 상태 엔진 구축
• Brewing-Burnout 증가, Refill-Energy 회복, Cleaning-Mood 개선 등 액션별 상태 전이 로직을 통한 유기적 상태 변화 구현
• HTTP status code(200, 503, 409, 418)를 활용하여 상태에 따른 API의 거부 및 수락 여부를 표준 프로토콜로 전달
• nanoid를 통한 고유 식별자 관리 및 일관된 JSON 응답 포맷 유지를 통한 기술적 정합성 확보