사주니
AI Assistant를 사용하여 신랑과 신부의 궁합을 알려주는 사주 서비스
프로젝트 개요
신랑과 신부의 생년월일로 AI 궁합 결과를 보여주는 서비스입니다. 포탈에서 JSP 화면과 Spring 백엔드로 처음 만들었고, 이후 Next.js 웹앱으로 옮기면서 Route Handler로 서버 쪽을 다시 구현했습니다. 두 버전 모두 화면부터 OpenAI Assistants API 호출까지 혼자 맡았고, 결과 이미지 캡처와 공유가 앱과 웹에서 모두 동작하도록 처리했습니다.
주요 화면
주요 기능
신랑과 신부 정보 입력
생년월일과 시간을 입력해 AI 궁합 결과를 요청하는 전용 입력 화면을 제공합니다.
AI 궁합 결과 화면
AI Assistant API 응답을 바탕으로 신랑과 신부의 궁합 결과를 보여주는 완료 화면을 구성했습니다.
결과 캡처와 공유
결과 화면을 이미지로 캡처하고, 앱 안팎에서 공유하거나 저장할 수 있는 흐름을 제공합니다.
앱 웹뷰와 외부 브라우저 대응
웨딩북 앱 내부 웹뷰와 외부 브라우저 환경을 구분해 캡처와 공유 기능이 동작하도록 처리했습니다.
기술 스택
Next.js · App Router · Route Handler · React · TypeScript · OpenAI Assistants API · JSP · Spring · SCSS Modules
담당 범위와 결과
JSP·Spring으로 만들고 Next.js로 다시 구현
- 처음에는 포탈의 JSP 화면과 Spring 컨트롤러·서비스로 OpenAI Assistants API를 호출해 스레드를 만들고, 실행 상태를 확인한 뒤 답변을 가져왔습니다.
- Next.js 웹앱으로 옮기면서 같은 흐름을 Route Handler와 서비스 모듈로 다시 구현하고, 실패 시 에러 응답을 JSON으로 정리했습니다.
lab/saju 도메인 단위로 기능 범위 분리
- 입력 페이지, 결과 페이지, 전용 컴포넌트, API Route를 lab/saju 도메인 안에 모아 변경 범위를 좁혔습니다.
- 화면과 서버 호출이 함께 바뀌는 기능이라 관련 파일을 가까이 두어 유지보수와 제거 비용을 줄였습니다.
캡처와 공유 품질을 위해 렌더링 완료 조건을 제어
- image.decode()로 paint가 끝날 때까지 기다려서 캡처에 빈 영역이 안 잡히게 했습니다.
- document.fonts.ready와 requestAnimationFrame을 같이 써서 폰트 로딩과 다음 프레임을 같이 기다렸습니다.
- base64를 Blob으로 바꿔서 공유와 다운로드 양쪽을 처리했습니다.
앱 안 웹뷰 호환성
- weddingbell user agent를 감지해서 앱 내부와 외부 브라우저를 구분했습니다.
- iPad의 모던 케이스(MacIntel + maxTouchPoints)도 따로 식별했습니다.
- Clipboard API가 안 되는 환경(비-HTTPS 등)에는 execCommand fallback을 두고, iOS에서 textarea가 화면에 보이지 않도록 처리했습니다.