# Vedic FAQ Зібрані питання, які часто виникають при інтеграції ведичних ендпоінтів. Якщо не знайшли відповідь — пишіть на [hello@astroway.info](mailto:hello@astroway.info), додамо. ## Які айянамші підтримуються? Яку обрати? API підтримує **7 айянамш**: | Код | Назва | Коли обирати | |---|---|---| | `lahiri` *(default)* | Чітра-Пакша | Стандарт уряду Індії; найбільший масовий ринок. Для більшості Vedic-застосунків — це. | | `raman` | B.V. Raman | Якщо інтегруєте мобільний застосунок для південноіндійського ринку (Karnataka, Tamil Nadu). | | `krishnamurti` | KP | Якщо викликаєте `/v1/vedic/kp/*` — KP має власну айянамшу. | | `yukteshwar` | Sri Yukteshwar | Distance from Spica; theosophical / Western-leaning audiences. | | `fagan-bradley` | Fagan/Bradley | Western sidereal (не Vedic). Для астрологів які мігрують з sidereal-Western traditions. | | `de-luce` | De Luce | Старіша astrologists' choice, рідка. | | `jn-bhasin` | JN Bhasin | Специфічна школа, рідка. | Різниця між айянамшами зазвичай 0.5–1.5° — у більшості натальних карт **не змінює знаки**, але впливає на degree-based техніки (Nakshatra position, Argala, etc). ## Sidereal чи tropical? Що повертає API? **За замовчуванням Vedic-ендпоінти повертають сайдеричні позиції** (зодіак прив'язаний до зірок, з застосованою айянамшею). Західні ендпоінти (`/v1/chart`, `/v1/synastry`) повертають **тропічні** (зодіак прив'язаний до точки рівнодення). Для tropical-Vedic (рідкісний edge-case — Sanjay Rath і Ernst Wilhelm пропонують) — передавайте `zodiac=tropical` у Vedic-ендпоінт, який це підтримує. ## Яка школа коли використовується? | Школа | Регіон / Аудиторія | Сильна сторона | |---|---|---| | **Parashara (BPHS)** | Весь Vedic-світ — universal baseline | Найповніший корпус техник; завжди start here | | **Jaimini** | Tamil Nadu + advanced practitioners | Karaka-based predictions; AK-driven life themes | | **Lal Kitab** | Punjab + North India | Уніcal remedies (упайя), Manglik-spec | | **KP (Krishnamurti)** | Tamil Nadu + Andhra Pradesh | Sub-lord theory, precision in event-timing | Pratyangira, AstroSage та інші великі апи дають здебільшого Parashara. AstroWay покриває **всі чотири** через окремі ендпоінт-групи. ## Ashtakoot чи Dashakoota — для якого ринку? | | Ashtakoot | Dashakoota | |---|---|---| | **Регіон** | North/Central Індія, Pakistan, Nepal | South Індія (Tamil Nadu, Karnataka, Kerala) | | **Шкала** | 36 балів max | 10 кут (factors) | | **Складові** | Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi | Дина + Гана + Махендра + Стрі-Дірга + Йоні + Раши + Раши-аадхипатхи + Вашіа + Раджу + Ведха | | **API** | `/v1/vedic/compatibility/ashtakoot` | `/v1/vedic/compatibility/dashakoota` | Якщо метчмейкер обслуговує всю Індію — викликайте `/v1/vedic/compatibility/full` — отримуєте обидва + Manglik + Bhrigu. ## Mangal Dosha — чому це важливо? Mangal Dosha = Mars у 1/2/4/7/8/12 будинку від Lagna, Місяця, або Венери (різні школи трактують по-різному). У Індії — це **диск-брейкер для шлюбу**: якщо в обох партнерів Mangal-афлікція без компенсації — традиційний astrologer не дасть зеленого світла без upayas (remedies) або компенсуючих факторів. API ендпоінт: `/v1/vedic/compatibility/manglik-check` — повертає `{ chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }`. ## D9 (Navamsha) — чому це найважливіша варга? D9 = 9-кратний поділ кожного знаку = детальний "soul-level" чарт. У Vedic — використовується для: 1. **Marriage predictions** — Venus + 7th lord у D9 показують справжню природу подружнього життя 2. **Strength of planets** — планета сильна в D1 але слабка в D9 = "shows but doesn't deliver" 3. **Vargottama** — планета в одному і тому ж знаку в D1 та D9 = особлива сила API: `/v1/vedic/vargas` повертає всі 16 поділів за один виклик; зосередьтесь на D9 для marriage/relationship-related фічей. ## Чому час народження критичний? Що робити якщо невідомий? Vedic дуже **time-sensitive**: - Lagna (Ascendant) змінюється кожні ~2 години — це ВСЯ карта зміщується - Nakshatra Місяця змінюється кожні 6–8 годин - Dasha-balance (initial period) залежить від nakshatra-position Місяця Якщо точний час невідомий: 1. **Sunrise chart** — використовуйте 06:00 локального часу як approximation. Lagna буде Овен/Тілець для Sun у Лева/Cap; деякі Vedic-астрологи вважають sunrise charts валідними для general-tendency прогнозу 2. **Rectification** — викликайте `/v1/rectification` з 2-3 відомими life-events (шлюб, дитина, перенос роботи) — API повертає probable birth-time window 3. **Disclaimer користувачу** — повідомте що результати з невідомим часом — approximation, не точна карта ## Які house-системи використовуються? Vedic традиційно використовує **Whole Sign** houses (увесь знак = один будинок). Western — Placidus / Koch / Equal etc. AstroWay default for Vedic = **Whole Sign**. Для KP-ендпоінтів — Placidus (KP-конвенція). Передавайте `houseSystem` параметр якщо потрібно інше: `whole-sign`, `placidus`, `koch`, `equal`, `porphyry`. ## Чи можна змішувати Vedic + Western у одному застосунку? Так — і це навіть **рекомендоване** для multi-tradition aud audiences. Architecture: 1. Натальна карта обчислюється один раз — Western та Vedic ендпоінти ділять той самий вхід (date/time/lat/lon) 2. Виведіть toggle "Western view" / "Vedic view" у вашому UI 3. Vedic Moon sign (раши) часто плутають з Western Sun sign — попередьте користувача про різницю 4. Compatibility — можете показати ОБИДВА: Western synastry + Vedic Ashtakoot одночасно API ендпоінт `/v1/compat/astro-vedic` робить це автоматично — Western synastry × Vedic Ashtakoot bridge. ## Який ephemeris використовується? Наскільки точно? **Swiss Ephemeris** (LGPL) — той самий, що в Solar Fire, Kepler, Astro Gold, Janus, AstroSeek. Точність: - Планетарні позиції: ±1 кутова секунда vs NASA JPL ephemeris - Куспіди будинків: ±1 кутова мінута - Айянамша: Lahiri-table cross-validated проти official Indian government tables Для Vedic-специфічних обрахунків (Nakshatra-position, Vimshottari balance, Vargas) — крос-перевірено проти **PyJHora** (de-facto Python reference); розбіжності < 0.01° де є. Звіт по розбіжностях — `docs/AUDIT-TRAIL.md` репо. ## Чи можу я кешувати результати? Як? Так — більшість Vedic-ендпоінтів **детерміністичні** для одного і того ж вхідного chart-input. Stable cache key: hash(date + time + lat + lon + ayanamsa + endpoint). API також пропонує `X-Idempotency-Key` header — 5-хвилинний кеш на стороні api-calc. На cache hit — кредити **не списуються**. ## Як локалізовано тексти у відповідях? Vedic-ендпоінти, що повертають **інтерпретації** (yoga descriptions, dosha meanings, muhurat reasons), приймають `lang` параметр. Підтримка: 20 мов (T0 — uk/en/de/ru ручно; T1 — pl/es/pt/hi/fr/ko AI Beta; T2/T3 — planned). Деталі: [`/languages/`](/languages/). Якщо ендпоінт повертає **числові** дані (degrees, dates, sign indices) — вони мовно-нейтральні. Текст-fields (`note`, `meaning`, `manifestation`) — локалізовані. ## Що робити з YELLOW-статусом? YELLOW = ендпоінт працює, але має **одну зі трьох характеристик**: 1. **Single-author school** (Lal Kitab, KP) — немає cross-verification з іншими школами, бо їх не існує 2. **Scoring/heuristic-based** (compatibility 0-100, breakup-timing) — числова оцінка subjective за природою 3. **Intrinsic precision limit** (rectification, Bhrigu match) — алгоритм має inherent precision floor Дивіться `docs/AUDIT-TRAIL.md` для конкретного ендпоінту — там написано **чому YELLOW** і **чи є шлях до GREEN**. Для більшості — ні (intrinsic), і це чесний disclaimer для інтегратора. ## Корисні посилання