# 사주보기 설정 가이드

## 카카오 앱 키 설정

카카오톡 공유 기능을 사용하려면 카카오 개발자 앱 키가 필요합니다.

### 1. 카카오 개발자 계정 생성

1. [카카오 개발자 센터](https://developers.kakao.com/) 접속
2. 카카오 계정으로 로그인
3. 개발자 등록 (처음 사용 시)

### 2. 애플리케이션 생성

1. **내 애플리케이션** 메뉴 클릭
2. **애플리케이션 추가하기** 클릭
3. 앱 정보 입력:
   - 앱 이름: `사주보기` (또는 원하는 이름)
   - 사업자명: `개인` 또는 사업자명
4. **저장** 클릭

### 3. JavaScript 키 발급

1. 생성한 앱 선택
2. **앱 키** 메뉴에서 **JavaScript 키** 복사
   - 예: `a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6`

### 4. 플랫폼 설정

1. **플랫폼** 메뉴 선택
2. **Web 플랫폼 추가** 클릭
3. 사이트 도메인 등록:
   - 개발 환경: `http://localhost:3003`
   - 배포 환경: `https://your-domain.com`
4. **저장** 클릭

### 5. 환경 변수 설정

1. 프로젝트 루트의 `.env.local` 파일 열기
2. `NEXT_PUBLIC_KAKAO_APP_KEY=` 뒤에 복사한 JavaScript 키 붙여넣기

```bash
NEXT_PUBLIC_KAKAO_APP_KEY=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
```

3. 개발 서버 재시작

```bash
npm run dev
```

### 6. 동작 확인

1. 사주 결과 페이지에서 **공유하기** 버튼 클릭
2. 카카오톡 아이콘 클릭
3. 카카오톡 로그인 후 친구 선택하여 공유 테스트

---

## 절기 기준 사주 계산

이 프로젝트는 정확한 사주 계산을 위해 **24절기**를 기준으로 월주를 계산합니다.

### 절기란?

- 1년을 24개로 나눈 계절의 구분점
- 사주에서 월주는 양력 월이 아닌 절기를 기준으로 계산
- 예: 입춘(立春) 이후가 인월(寅月)

### 주요 절기

| 절기 | 시기 | 월주 |
|------|------|------|
| 입춘 | 2월 4일경 | 인월 (寅月) |
| 경칩 | 3월 5일경 | 묘월 (卯月) |
| 청명 | 4월 4일경 | 진월 (辰月) |
| 입하 | 5월 5일경 | 사월 (巳月) |
| 망종 | 6월 6일경 | 오월 (午月) |
| 소서 | 7월 7일경 | 미월 (未月) |
| 입추 | 8월 7일경 | 신월 (申月) |
| 백로 | 9월 8일경 | 유월 (酉月) |
| 한로 | 10월 8일경 | 술월 (戌月) |
| 입동 | 11월 7일경 | 해월 (亥月) |
| 대설 | 12월 7일경 | 자월 (子月) |
| 소한 | 1월 5일경 | 축월 (丑月) |

---

## 대운 계산

### 대운이란?

- 10년 단위로 변화하는 큰 운의 흐름
- 각 사람마다 대운이 시작되는 나이가 다름

### 대운 시작 나이 계산

1. **양남음녀** (양년생 남자, 음년생 여자)
   - 순행: 생일부터 **다음 절기**까지의 일수 계산

2. **음남양녀** (음년생 남자, 양년생 여자)
   - 역행: **이전 절기**부터 생일까지의 일수 계산

3. **대운수 공식**
   - 일수 ÷ 3 = 대운 시작 나이
   - 예: 24일 → 8세부터 대운 시작

### 양년/음년 구분

- 년간(天干)이 **양**(甲, 丙, 戊, 庚, 壬): 양년
- 년간(天干)이 **음**(乙, 丁, 己, 辛, 癸): 음년

---

## 음력 변환

### 음력 생일 입력

1. 생년월일 입력 시 **음력** 버튼 선택
2. 윤달인 경우 **윤달** 체크박스 선택
3. 자동으로 양력 날짜로 변환되어 사주 계산

### 지원 범위

- 1900년 ~ 2100년
- 윤달 지원

### 주의사항

- 음력 1월 1일 = 양력 1월 말 ~ 2월 초
- 매년 음력과 양력의 대응 날짜가 다름
- 정확한 변환을 위해 `lunar-calendar` 라이브러리 사용

---

## 개발 환경

### 필수 요구사항

- Node.js 18+
- npm 또는 yarn

### 설치

```bash
npm install
```

### 개발 서버 실행

```bash
npm run dev
```

http://localhost:3003 에서 확인

### 빌드

```bash
npm run build
npm start
```

---

## 기술 스택

- **Next.js 14** - React 프레임워크
- **TypeScript** - 타입 안정성
- **Tailwind CSS** - 스타일링
- **jsPDF + html2canvas** - PDF 생성
- **lunar-calendar** - 음력 변환
- **Kakao SDK** - 카카오톡 공유

---

## 라이선스

© 2025 쟁승메이드. All rights reserved.