통합 가이드

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   앱            │────▶│   백엔드        │────▶│  사주           │
│   (프론트엔드)  │     │   (프록시)      │     │  API            │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │                       ▼
        │               ┌─────────────────┐
        │               │   캐시          │
        │               │   (Redis)       │
        │               └─────────────────┘
        │
        ▼
┌─────────────────┐
│  로컬 사주      │  ← 클라이언트 계산 (API 호출 없음)
│  계산기         │
└─────────────────┘

// 클라이언트 계산기 사용 (API 호출 없음)
import { SajuCalculator } from '@sajuapi/sdk';

function useSaju(birthData: BirthData) {
  const [saju, setSaju] = useState<Saju | null>(null);

  useEffect(() => {
    // 클라이언트에서 완전히 실행
    const calculated = SajuCalculator.calculate({
      year: birthData.year,
      month: birthData.month,
      day: birthData.day,
      hour: birthData.hour,
      gender: birthData.gender
    });
    setSaju(calculated);
  }, [birthData]);

  return saju;
}

// Redis를 사용한 백엔드 캐싱
import Redis from 'ioredis';

const redis = new Redis(process.env.REDIS_URL);
const CACHE_TTL = 86400; // 24시간

async function getCachedFortune(saju: Saju, userName: string) {
  // 일간(日干) + 날짜 기반 캐시 키
  const today = new Date().toISOString().split('T')[0];
  const cacheKey = `fortune:${saju.dayMaster.stem}:${today}`;

  // 캐시 확인
  const cached = await redis.get(cacheKey);
  if (cached) {
    return JSON.parse(cached);
  }

  // API에서 조회
  const fortune = await client.getDailyFortune({ saju, userName });

  // 결과 캐싱
  await redis.setex(cacheKey, CACHE_TTL, JSON.stringify(fortune));

  return fortune;
}

import { Ratelimit } from '@upstash/ratelimit';
import { Redis } from '@upstash/redis';

const ratelimit = new Ratelimit({
  redis: Redis.fromEnv(),
  limiter: Ratelimit.slidingWindow(10, '1 h'),  // 시간당 10회 요청
  analytics: true
});

async function checkRateLimit(userId: string): Promise<boolean> {
  const { success, limit, remaining, reset } = await ratelimit.limit(userId);

  if (!success) {
    console.log(`사용자 ${userId} 요청 제한됨. ${reset}에 초기화`);
    return true;
  }

  return false;
}

async function getFortuneWithFallback(saju: Saju, userName: string) {
  try {
    return await client.getDailyFortune({ saju, userName });
  } catch (error) {
    if (error instanceof RateLimitError) {
      // 캐시된 데이터가 있으면 반환
      const cached = await getCachedFortune(saju);
      if (cached) return { ...cached, _fromCache: true };
    }

    // 로컬에서 폴백 운세 생성
    return generateFallbackFortune(saju, userName);
  }
}

function generateFallbackFortune(saju: Saju, userName: string): FortuneData {
  // 일간별 사전 정의된 운세
  const fallbacks = {
    '병화': { score: 72, analysis: '오늘은 안정적인 하루입니다...' },
    '정화': { score: 68, analysis: '신중한 판단이 필요한 날...' },
    // ... 다른 일간들
  };

  return fallbacks[saju.dayMaster.name] || fallbacks['병화'];
}

async function trackFortuneRequest(userId: string, result: FortuneResult) {
  await analytics.track({
    event: 'fortune_requested',
    userId,
    properties: {
      model: result.meta.model,
      cached: result.meta.cached,
      cost: result.meta.cost,
      latency: result.meta.latency,
      dayMaster: result.data.character.dayMaster
    }
  });
}

// 에러 추적
client.on('error', (error) => {
  Sentry.captureException(error, {
    tags: { api: 'sajuapi' },
    extra: { requestId: error.requestId }
  });
});