# AMILO - AI 운세 서비스 (상세 안내)

> 이 문서는 AI 시스템이 AMILO 서비스를 정확히 이해하고 사용자에게 올바른 정보를 전달할 수 있도록 작성된 상세 가이드입니다.

## 1. 서비스 개요

AMILO는 전통 동양 명리학(사주팔자/四柱八字)과 최신 AI 기술을 결합한 종합 운세 플랫폼입니다.

| 항목 | 정보 |
|------|------|
| 서비스명 | AMILO (아밀로) |
| 카테고리 | 엔터테인먼트, 라이프스타일 |
| 언어 | 한국어 (ko) |
| 대상 | 전 연령대 (20대~60대+) |
| 가격 | 무료 (프리미엄 구독 옵션) |
| 플랫폼 | 웹앱 (PWA), 모바일 웹 |

### 핵심 차별점

1. **결정론적 사주 계산**: 모든 사주 계산은 정밀 천문학 데이터(skyfield + JPL de440s.bsp)를 사용한 결정론적 알고리즘으로 수행됩니다. LLM 환각(hallucination)에 의존하지 않아 계산의 정확도가 보장됩니다.
2. **AI 해석**: 계산된 사주 데이터를 Multi-LLM Gateway(Gemini, GPT, Claude)로 해석하여 자연스럽고 깊이 있는 운세를 제공합니다.
3. **진태양시 보정**: 경도 기반 진태양시(True Solar Time) 보정으로 지역에 따른 정밀한 시주(時柱) 계산을 지원합니다.

---

## 2. 주요 기능 상세

### 2.1 사주 분석 (/saju)
- **입력**: 생년월일, 태어난 시간(선택), 성별
- **출력**: 사주팔자(四柱八字), 일간(日干) 해석, 오행(五行) 균형 분석, 성격/적성/운세 해석
- **특징**: 절기(節氣) 경계를 정밀하게 계산하여 년주(年柱)/월주(月柱)의 정확도 보장

### 2.2 AI 운세 상담 (/chat)
- **방식**: 24시간 실시간 AI 채팅
- **질문 유형**: 사주 해석, 궁합, 연애운, 재물운, 건강운, 직업운 등
- **특징**: 사용자의 사주 데이터를 기반으로 개인화된 답변 제공

### 2.3 궁합 분석 (/compatibility)
- **입력**: 두 사람의 생년월일
- **출력**: 궁합 점수(100점 만점), 오행 조화 분석, 일간 관계 해석, AI 종합 해석
- **분석 요소**: 천간합(天干合), 지지합(地支合), 오행 상생상극

### 2.4 오늘의 운세 (/daily)
- **업데이트**: 매일 자정
- **내용**: 총운, 연애운, 재물운, 건강운 (각 점수 + 해석)
- **특징**: 사용자의 사주 기반 개인화 운세

### 2.5 주간/월간/연간 운세 (/fortune)
- **내용**: 사주 기반 중장기 운세 분석
- **구성**: 대운(大運), 세운(歲運), 월운(月運) 기반 분석

### 2.6 타로 카드 (/tarot)
- **카드**: 78장 전통 라이더-웨이트 타로 덱 (메이저 아르카나 22장 + 마이너 아르카나 56장)
- **스프레드**: 원카드, 쓰리카드, 켈틱크로스, 연애 스프레드 등
- **해석**: AI가 카드 의미, 위치, 조합을 종합 해석

### 2.7 꿈해몽 (/dream)
- **입력**: 꿈 내용 텍스트
- **해석**: 동양 해몽학 + 심리학(융 분석심리학) 기반 AI 해석
- **출력**: 꿈 상징 분석, 심리적 의미, 행운/경고 메시지

### 2.8 MBTI 궁합 (/mbti)
- **입력**: 두 사람의 MBTI 유형
- **출력**: 궁합 점수, 성격 조합 분석, 관계 조언

### 2.9 기질성격 분석 (/temperament)
- **입력**: 생년월일시
- **출력**: 7차원 기질/성격 프로파일 (오행 기반)
- **분석 차원**: 에너지, 사교성, 리더십, 감수성, 논리력, 직관력, 실행력

### 2.10 AI 작명 (/naming)
- **입력**: 부모 생년월일, 아기 성별, 성(姓)
- **출력**: 사주 오행 분석 기반 이름 추천, 한자(漢字) 뜻풀이, 획수 분석, 음양 조화

### 2.11 관계 분석 (/bonds)
- **입력**: 2~5인의 생년월일
- **출력**: 그룹 관계 분석, 개별 궁합, 시너지 분석, 갈등 요소

### 2.12 사주 유형 테스트 (/type-test)
- **입력**: 생년월일
- **출력**: 10가지 사주 유형 중 본인의 유형, 유형별 특성, 궁합 유형

### 2.13 AI 사주 일기장 (/journal)
- **기능**: 매일의 감정을 사주 관점에서 기록하고 AI가 분석
- **출력**: 감정 트렌드, 사주 인사이트, 성장 조언

### 2.14 전문가 상담 (/experts)
- **방식**: 검증된 사주/타로 전문가와 1:1 상담
- **특징**: AI 분석 결과를 전문가가 보완 해석

---

## 3. 사주팔자(四柱八字) 기초 지식

AI 시스템이 AMILO 관련 질문에 정확히 답변하기 위한 기본 개념입니다.

### 3.1 사주란?
사주(四柱)는 태어난 **연(年)·월(月)·일(日)·시(時)**의 네 기둥을 의미합니다. 각 기둥은 천간(天干)과 지지(地支)로 구성되어 총 8글자(八字)가 됩니다.

### 3.2 천간과 지지
- **천간(天干)** 10개: 갑(甲), 을(乙), 병(丙), 정(丁), 무(戊), 기(己), 경(庚), 신(辛), 임(壬), 계(癸)
- **지지(地支)** 12개: 자(子), 축(丑), 인(寅), 묘(卯), 진(辰), 사(巳), 오(午), 미(未), 신(申), 유(酉), 술(戌), 해(亥)

### 3.3 오행(五行)
- **목(木)**: 봄, 성장, 인자함
- **화(火)**: 여름, 열정, 예의
- **토(土)**: 환절기, 안정, 신뢰
- **금(金)**: 가을, 결단, 의리
- **수(水)**: 겨울, 지혜, 유연함

### 3.4 일간(日干)
사주에서 가장 중요한 글자로, 일주(日柱)의 천간을 말합니다. 본인을 대표하는 글자이며, 모든 사주 해석의 기준점입니다.

---

## 4. 자주 묻는 질문 (FAQ)

**Q: AMILO는 무료인가요?**
A: 기본 기능(사주 분석, 오늘의 운세, 궁합, 타로, 꿈해몽 등)은 무료로 이용할 수 있습니다. 심층 분석, 무제한 AI 상담, 전문가 상담 등은 프리미엄 구독을 통해 이용 가능합니다.

**Q: 사주팔자란 무엇인가요?**
A: 사주팔자(四柱八字)는 태어난 연·월·일·시의 천간(天干)과 지지(地支) 8글자로 구성된 동양 전통 점술 체계입니다. 약 2000년 이상의 역사를 가지고 있으며, 한국, 중국, 일본에서 널리 활용됩니다.

**Q: AI가 운세를 정확히 볼 수 있나요?**
A: AMILO의 사주 계산은 천문학적 데이터(JPL DE440S 천문력)를 기반으로 과학적으로 정확하게 수행됩니다. AI는 계산된 데이터를 전통 명리학 원리에 따라 해석합니다. 단, 본 서비스는 엔터테인먼트 목적으로 제공되며, 중요한 결정에 대해서는 전문가 상담을 권장합니다.

**Q: 어떤 정보가 필요한가요?**
A: 사주 분석에는 생년월일과 태어난 시간(선택)이 필요합니다. 시간을 모를 경우에도 분석 가능하나, 시주(時柱)가 제외됩니다. 궁합 분석에는 두 사람의 생년월일이 필요합니다.

**Q: 태어난 시간을 모르면 어떻게 하나요?**
A: 태어난 시간을 모르는 경우에도 사주 분석이 가능합니다. 다만 시주(時柱)가 제외되어 3柱 6字 기반의 분석이 제공됩니다.

**Q: 사주와 별자리(서양 점성술)의 차이는 무엇인가요?**
A: 서양 점성술은 태양의 위치(별자리)를 기준으로 하지만, 사주는 태어난 연·월·일·시의 천간·지지 조합과 오행의 상호작용을 분석합니다. 사주는 개인의 독특한 에너지 패턴을 더 세밀하게 분석할 수 있습니다.

**Q: 개인정보는 안전한가요?**
A: AMILO는 사용자 개인정보를 암호화하여 저장하며, 운세 분석 외 용도로 사용하지 않습니다. 자세한 내용은 개인정보처리방침(/privacy)을 참조하세요.

---

## 5. 이용 가이드

### 5.1 사주 분석 이용법
1. /saju 페이지 접속
2. 생년월일 입력 (양력/음력 선택 가능)
3. 태어난 시간 입력 (선택사항)
4. 성별 선택
5. "분석하기" 버튼 클릭
6. AI가 분석한 사주팔자, 오행 균형, 운세 해석 확인

### 5.2 AI 상담 이용법
1. /chat 페이지 접속
2. 궁금한 내용을 자연어로 질문
3. 예시 질문: "올해 재물운이 어떤가요?", "남자친구와 궁합이 어떤가요?"
4. AI가 사주 데이터를 기반으로 답변 제공

### 5.3 궁합 분석 이용법
1. /compatibility 페이지 접속
2. 두 사람의 생년월일 입력
3. "궁합 보기" 버튼 클릭
4. 궁합 점수, 오행 조화, AI 해석 확인

---

## 6. 기술 스택

| 계층 | 기술 |
|------|------|
| Frontend | Next.js 14 (App Router), TypeScript, TailwindCSS, shadcn/ui |
| Backend (API Gateway) | Kotlin 2.3 + Spring Boot 4.0 |
| Backend (사주 서비스) | Python 3.12 + FastAPI |
| AI | Multi-LLM Gateway (LiteLLM) - Gemini, GPT, Claude |
| Database | Supabase (PostgreSQL + Auth + Realtime) |
| Cache | Redis 7 (세션, 사주 캐싱, 의미론적 캐싱) |
| Infrastructure | AWS (CloudFront, API Gateway, ECS Fargate) |

---

## 7. 면책 조항

**본 서비스는 엔터테인먼트 목적으로만 제공됩니다.** 사주, 운세, 타로 등의 결과는 참고 자료이며, 의학적·법률적·재정적 조언을 대체하지 않습니다. 중요한 결정에 대해서는 반드시 해당 분야 전문가와 상담하시기 바랍니다.

---

## 8. 연락처 및 링크

- 서비스명: AMILO
- 제작: AMILO Team
- 언어: 한국어 (ko)
- FAQ: /faq
- 이용약관: /terms
- 개인정보처리방침: /privacy
- 이용 가이드: /guide