코드 배포 없는 메일 문구 관리 및 Mustache 기반 동적 렌더링 설계

Context

메일 템플릿을 하드코딩된 문자열로 관리함에 따른 잦은 코드 수정 및 배포 필요성 발생. 마케팅 팀의 문구 수정 요청 시마다 개발 공수가 투입되며 다수 발송 지점 간 문구 불일치 문제 상존.

Technical Solution

• 하드코딩된 텍스트를 분리하여 이름과 변수를 가진 독립적 리소스로 관리하는 Hosted Template 구조 도입
• Mustache 엔진을 활용한 {{variable}} 치환 방식으로 데이터와 프레젠테이션 레이어의 완전한 분리 구현
• Application-level 및 Grant-level Scope 구분을 통한 템플릿 공유 범위 및 접근 제어 최적화
• 런타임 시 Template ID와 Variable Map을 전달하여 API 서버 내부에서 최종 렌더링 후 발송하는 서버 사이드 렌더링 방식 채택
• 데이터 누락으로 인한 불완전한 메일 발송을 방지하기 위해 Strict 모드를 기본값으로 설정한 Fail-fast 메커니즘 적용
• 특정 메시지만의 변주를 위해 템플릿 복제 대신 Send 요청 시 Subject 및 Body를 직접 Override 하는 유연한 설계 적용