서비스 개요

saju-me란?

saju-me는 한국 전통 사주(四柱) 이론을 기반으로 오늘의 기운 분석, 궁합, 장소·음식 추천, 커뮤니티 매칭을 제공하는 서비스입니다.

사주 원국 계산은 외부 사주 엔진(Ablecity)에 위임하고, 계산된 오행(五行) 데이터를 OpenAI GPT와 결합해 사용자에게 읽기 쉬운 형태의 일별 운세·추천 콘텐츠를 생성합니다.

핵심 사용자 시나리오

1. 카카오 로그인
        ↓
2. 생년월일시 + 성별 + 출생 도시 입력
        ↓
3. 사주 8자(四柱八字) 자동 계산
   └─ 천간(天干)·지지(地支) × 연·월·일·시
   └─ 오행 비율, 용신(用神), 격국(格局), 신강/신약 도출
        ↓
4. 오늘의 기운 생성 (매일 자동 갱신)
   └─ 종합 점수 · 좋은 시간대 · 기분 · 추천 행동
   └─ 오행 기반 추천 장소 유형 (Kakao Maps 연동)
   └─ 오늘 보충해야 할 오행 기반 음식 추천
        ↓
5. 상대방 사주 등록 → 궁합 점수 조회
        ↓
6. 커뮤니티 기수 참가 → 카카오 오픈채팅 입장

서비스 구성

기능	설명
사주 분석	생년월일시 입력으로 오행 비율·용신·격국 등 원국 데이터 계산
오늘의 기운	매일 갱신되는 종합 기운 점수, 좋은 시간·행동·피할 행동
연운(年運)	연간 운세 흐름 조회 (비동기 웹훅 방식)
정통사주	GPT가 사주 원국 전체를 해석한 심층 분석 리포트
궁합	상대방 사주 등록 후 오행 기반 궁합 점수 및 해설
장소 추천	오늘의 용신에 맞는 장소 유형 + Kakao Maps 키워드
음식 추천	부족한 오행을 보완하는 음식 5가지 순위
커뮤니티	기수(Cohort) 기반 모임 참가, 카카오 알림톡 + 오픈채팅 연결

비즈니스 흐름

사주-me의 핵심 가치는 "전통 이론 × AI 해석" 의 결합입니다.

순수 사주 계산은 정확도가 검증된 외부 사주 엔진(Ablecity)에 위임합니다.
계산된 원국 데이터(용신·격국·오행·대운)는 GPT 프롬프트에 직접 주입되어, 사주 도메인 지식을 LLM이 활용할 수 있도록 설계합니다.
결과물(오늘의 기운·추천 콘텐츠)은 DB에 캐시되어 같은 날 반복 조회 시 LLM 호출 없이 즉시 반환합니다.

전통 사주 이론
      +
Ablecity 사주 엔진  →  원국 데이터 (오행·용신·격국·대운)
                              ↓
                    OpenAI GPT (도메인 프롬프트)
                              ↓
              오늘의 기운 해설 · 장소 키워드 · 음식 추천

인증 방식

카카오 OAuth2를 통해 로그인하며, 서버는 JWT Access Token / Refresh Token을 발급합니다. Refresh Token Rotation 방식으로 토큰을 갱신하고, 로그아웃 시 Refresh Token을 즉시 폐기합니다.

주요 기술적 제약

제약	대응
Ablecity API 비동기 콜백	웹훅 브리지로 클라이언트에 동기 응답
외부 API 장애	Circuit Breaker + Retry(지수 백오프) 이중 적용
GPT 호출 비용	Caffeine 캐시로 장소 추천 1일 1회 제한
커뮤니티 정원 초과	비관적 락으로 동시 참가 경쟁 조건 방지

saju-me란?​

핵심 사용자 시나리오​

서비스 구성​

비즈니스 흐름​

인증 방식​

주요 기술적 제약​