Vedic FAQ

베다 엔드포인트를 통합할 때 자주 나오는 질문을 모았습니다. 답을 찾지 못하셨다면 hello@astroway.info로 알려 주세요. 추가하겠습니다.

어떤 아야남샤를 지원하나요? 무엇을 골라야 하나요?

API는 9가지 아야남샤를 지원합니다:

코드	이름	선택 기준
`lahiri` (default)	Chitra-Paksha	인도 정부 표준이며 가장 큰 대중 시장. 대부분의 베다 앱에는 이것을 쓰면 됩니다.
`raman`	B.V. Raman	남인도 시장(Karnataka, Tamil Nadu)용 모바일 앱을 통합하는 경우.
`krishnamurti` (별칭 `kp`)	KP	`/v1/vedic/kp/*`를 호출하는 경우 - KP에는 자체 아야남샤가 있습니다.
`yukteshwar`	Sri Yukteshwar	Spica로부터의 거리; 신지학적 / 서양 성향의 사용자층.
`fagan-bradley`	Fagan/Bradley	서양 sidereal(베다 아님). sidereal-Western 전통에서 옮겨 오는 점성가용.
`de-luce`	De Luce	예전에 점성가들이 쓰던 선택지, 드묾.
`jn-bhasin`	JN Bhasin	특정 학파, 드묾.
`true-citra`	True Chitra Paksha	Spica를 천칭자리 0°에 엄격하게 고정. Lahiri와 0.01° 차이이므로, 정확히 별 기준 고정이 필요할 때만 사용하세요.
`djwhal-khul`	Djwhal Khul	신지학 학파, 드묾. 표에서 편차가 가장 큽니다.

주요 학파 간 차이는 작습니다: Lahiri, True Chitra, KP는 0.1° 이내, Fagan/Bradley, JN Bhasin, Yukteshwar, Raman은 최대 1.45°. De Luce(Lahiri와 3.96°)와 Djwhal Khul(3.82°)은 동떨어져 있어서, 별자리 경계 근처의 위치는 옆 별자리로 넘어가 버립니다. 2026-08-18에 한 차트의 달을 기준으로 측정했습니다. 도(degree) 기반 기법(Nakshatra position, Argala)에서는 0.1° 이내의 차이도 눈에 보입니다.

Sidereal인가요 tropical인가요? API는 무엇을 반환하나요?

베다 엔드포인트는 기본적으로 항성(sidereal) 위치를 반환합니다 (아야남샤를 적용해 별에 고정된 조디악). 서양 엔드포인트(/v1/chart, /v1/synastry)는 트로피컬 위치를 반환합니다(춘분점에 고정된 조디악).

트로피컬 베다(Sanjay Rath와 Ernst Wilhelm이 제안하는 드문 edge-case)는 API가 제공하지 않습니다: 모든 베다 엔드포인트는 sidereal로 계산하며 요청 본문의 zodiacType을 무시합니다. 트로피컬 위치는 서양 계열(/v1/chart, /v1/synastry)이 제공하고, zodiacType: "sidereal"을 주면 같은 아야남샤로 항성 조디악으로 전환됩니다.

어떤 학파를 언제 쓰나요?

학파	지역 / 사용자층	강점
Parashara (BPHS)	베다 세계 전체 - universal baseline	가장 방대한 기법 체계; 항상 여기서 시작
Jaimini	Tamil Nadu + 숙련된 실무자	카라카 기반 예측; AK 중심의 삶의 주제
Lal Kitab	Punjab + 북인도	독특한 처방(우파야), Manglik 특화
KP (Krishnamurti)	Tamil Nadu + Andhra Pradesh	Sub-lord theory, 사건 시기 판단의 정밀도

Pratyangira, AstroSage 등 대형 API는 대부분 Parashara만 제공합니다. AstroWay는 별도의 엔드포인트 그룹으로 네 학파 모두를 다룹니다.

Ashtakoot와 Dashakoota: 어느 시장용인가요?

	Ashtakoot	Dashakoota
지역	북인도/중인도, 파키스탄, 네팔	남인도 (Tamil Nadu, Karnataka, Kerala)
척도	최대 36점	10 쿠타 (factors)
구성 요소	Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi	Dina + Gana + Mahendra + Stree-Deergha + Yoni + Rashi + Rashi-adhipati + Vashya + Rajju + Vedha
API	`/v1/vedic/compatibility/ashtakoot`	`/v1/vedic/compatibility/dashakoota`

중매 서비스가 인도 전역을 대상으로 한다면 /v1/vedic/compatibility/full을 호출하세요 - 둘 다 + Manglik + Bhrigu를 받습니다.

Mangal Dosha: 왜 중요한가요?

Mangal Dosha = 라그나, 달 또는 금성으로부터 1/2/4/7/8/12 하우스에 있는 화성(학파마다 해석이 다름). 인도에서는 **결혼의 결정적 장애 요인(deal-breaker)**입니다: 두 파트너 모두 상쇄 없이 Mangal 흉작용이 있다면, 전통적인 점성가는 upayas(처방)나 상쇄 요인 없이는 승낙하지 않습니다.

API 엔드포인트: /v1/vedic/compatibility/manglik-check - { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }를 반환합니다.

D9 (Navamsha) - 왜 가장 중요한 바르가인가요?

D9 = 각 별자리를 9등분 = 세밀한 “soul-level” 차트. 베다에서는 다음에 쓰입니다:

결혼 예측: D9의 금성 + 7하우스 로드가 결혼 생활의 진짜 성격을 보여 줍니다
행성의 힘: D1에서는 강하지만 D9에서 약한 행성 = “shows but doesn’t deliver”
Vargottama: D1과 D9에서 같은 별자리에 있는 행성 = 특별한 힘

API: /v1/vedic/vargas는 16개 분할을 한 번의 호출로 모두 반환합니다. 결혼/관계 관련 기능에는 D9에 집중하세요.

왜 출생 시각이 결정적인가요? 모른다면 어떻게 하나요?

베다는 매우 time-sensitive합니다:

Lagna(Ascendant)는 약 2시간마다 바뀝니다: 차트 전체가 이동한다는 뜻입니다
달의 Nakshatra는 6–8시간마다 바뀝니다
Dasha-balance(초기 주기)는 달의 nakshatra 위치에 따라 달라집니다

정확한 시각을 모른다면:

Sunrise chart: 출생지의 일출 시각을 근사값으로 사용하세요. 이때 태양이 어센던트에 놓이므로 Lagna는 대체로 태양 별자리와 일치합니다. 일부 베다 점성가는 sunrise chart가 general-tendency 예측에 유효하다고 봅니다
Rectification: 알려진 생애 사건 2~3개(결혼, 출산, 이직)와 함께 /v1/rectification을 호출하세요 - API가 가능성 높은 출생 시각 범위를 반환합니다
사용자 고지: 시각을 모르는 경우의 결과는 근사값이며 정확한 차트가 아니라고 알려 주세요

어떤 하우스 시스템을 사용하나요?

베다는 전통적으로 Whole Sign 하우스(별자리 전체 = 하우스 하나)를 씁니다. 서양은 Placidus / Koch / Equal 등.

AstroWay의 베다 기본값 = Whole Sign. KP 엔드포인트는 Placidus(KP 관례). 다른 것이 필요하면 houseSystem 파라미터를 전달하세요: whole-sign, placidus, koch, equal, porphyry.

한 앱에서 베다와 서양을 섞어도 되나요?

네 - 여러 전통을 다루는 사용자층에는 오히려 권장합니다. 아키텍처:

출생 차트는 한 번만 계산됩니다: 서양과 베다 엔드포인트는 같은 입력(date/time/lat/lon)을 공유합니다
UI에 “Western view” / “Vedic view” 토글을 두세요
베다의 달 별자리(라시)는 서양의 태양 별자리와 자주 혼동됩니다: 사용자에게 차이를 알려 주세요
궁합: 서양 synastry와 베다 Ashtakoot를 동시에 둘 다 보여 줄 수 있습니다

API 엔드포인트 /v1/compat/astro-vedic는 이를 자동으로 해 줍니다 - Western synastry × Vedic Ashtakoot bridge.

어떤 천문력(ephemeris)을 쓰나요? 얼마나 정확한가요?

Swiss Ephemeris (LGPL) - Solar Fire, Kepler, Astro Gold, Janus, AstroSeek와 같은 것입니다. 정확도:

행성 위치: NASA JPL ephemeris 대비 ±1 각초
하우스 커스프: ±1 각분
아야남샤: Lahiri 표를 인도 정부 공식 표와 교차 검증

베다 특화 계산(Nakshatra 위치, Vimshottari balance, Vargas)은 PyJHora(사실상 표준인 Python 레퍼런스)와 교차 검증했으며, 차이가 있는 곳도 < 0.01°입니다. 차이 보고서는 리포지토리의 docs/AUDIT-TRAIL.md에 있습니다.

결과를 캐시해도 되나요? 어떻게요?

네 - 대부분의 베다 엔드포인트는 같은 chart-input에 대해 결정론적입니다. 안정적인 캐시 키: hash(date + time + lat + lon + ayanamsa + endpoint).

API는 X-Idempotency-Key 헤더도 제공합니다 - api-calc 쪽 5분 캐시입니다. 캐시 적중 시 크레딧은 차감되지 않습니다.

응답 텍스트는 어떻게 현지화되나요?

해석(yoga descriptions, dosha meanings, muhurat reasons)을 반환하는 베다 엔드포인트는 lang 파라미터를 받습니다. 지원: 20개 언어 (T0 - uk/en/de/ru 수작업; T1 - pl/es/pt/hi/fr/ko AI Beta; T2/T3 - 계획 중). 자세한 내용: /languages/.

엔드포인트가 수치 데이터(도, 날짜, 별자리 인덱스)를 반환한다면 언어 중립적입니다. 텍스트 필드(note, meaning, manifestation)는 현지화됩니다.

YELLOW 상태는 어떻게 받아들여야 하나요?

YELLOW = 엔드포인트는 동작하지만 세 가지 특성 중 하나가 있습니다:

Single-author school (Lal Kitab, KP): 다른 학파가 존재하지 않으므로 교차 검증할 수 없음
Scoring/heuristic-based (compatibility 0-100, breakup-timing): 수치 평가가 본질적으로 주관적
Intrinsic precision limit (rectification, Bhrigu match): 알고리즘에 내재된 정밀도 한계가 있음

해당 엔드포인트의 docs/AUDIT-TRAIL.md를 보세요 - 왜 YELLOW인지, GREEN으로 가는 길이 있는지 적혀 있습니다. 대부분은 없습니다(내재적 한계). 이는 통합 개발자를 위한 솔직한 고지입니다.