# Доші (Doshas) — планетарні афлікції

Доші — це планетарні афлікції в натальній карті, які традиційно вказують на ризики, обмеження або кармічні борги. AstroWay підтримує **19 ендпоінтів дош** у чотирьох школах — Парашара (класична), Лал Кітаб (північноіндійська усна традиція), KP (Krishnamurti Paddhati) і Джайміні.

<Aside type="caution">
**Інтерпретація дош — культурно-чутлива тема.** Ми надаємо обчислювальний результат (так/ні + сила), але не виносимо суджень про долю людини. Як саме показувати це в UI — рішення інтегратора. Рекомендуємо балансувати "наявність доші" з контекстом про можливі remedies і той факт, що класичні тексти описують ~80% карт як такі, що мають хоча б одну дошу.
</Aside>

## Що ми розраховуємо

- **Манґлік-доша** (Mars affliction) — Марс у 1/2/4/7/8/12 домах від асценденту, Місяця або Венери. Найважливіша доша для шлюбу в індійській традиції.
- **Кала-Сарп-доша** — всі 7 планет між Раху і Кету ("в горлі змії"). Кілька варіантів (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) залежно від домів осі Rahu-Ketu.
- **Пітру-доша** — Сонце або Раху афліктовані; традиційно — невирішений кармічний борг предкам.
- **Шрапіт-доша** — Сатурн і Раху в одному домі; "прокляття" з минулого життя.
- **Грахан-доша** — Сонце/Місяць у поєднанні з Раху або Кету.
- **Гуру-Чандал-доша** — Юпітер з Раху (chandal = "беззаконний" Раху псує Гуру).
- **Лал Кітаб доші** — `manglik`, `kaal-sarp`, `pitru-rin` (борг предкам як одне з 7 рін), `kaal-purush` варіанти за специфікою Лал Кітаб.
- **KP-доші** — діагностика через sub-lord теорію Krishnamurti.
- **Джайміні-доші** — `arudha`-афлікції та badhaka-pattern.

## Ендпоінти

| Ендпоінт | Школа | Кредити | Опис |
|---|---|---|---|
| `/v1/vedic/doshas/parashara/mangal` | Парашара | 20 | Манґлік-доша |
| `/v1/vedic/doshas/parashara/kaal-sarp` | Парашара | 20 | Кала-Сарп + варіант |
| `/v1/vedic/doshas/parashara/pitru` | Парашара | 20 | Пітру-доша |
| `/v1/vedic/doshas/parashara/shrapit` | Парашара | 20 | Шрапіт-доша |
| `/v1/vedic/doshas/parashara/grahan` | Парашара | 20 | Грахан-доша |
| `/v1/vedic/doshas/parashara/guru-chandal` | Парашара | 20 | Гуру-Чандал-доша |
| `/v1/vedic/doshas/parashara/full` | Парашара | 50 | Усі доші Парашара |
| `/v1/vedic/doshas/lal-kitab/manglik` | Лал Кітаб | 20 | Манґлік за Лал Кітаб |
| `/v1/vedic/doshas/lal-kitab/kaal-sarp` | Лал Кітаб | 20 | Кала-Сарп за Лал Кітаб |
| `/v1/vedic/doshas/lal-kitab/pitru-rin` | Лал Кітаб | 20 | Борг предкам |
| `/v1/vedic/doshas/lal-kitab/kaal-purush` | Лал Кітаб | 20 | Кала-Пуруш доша |
| `/v1/vedic/doshas/lal-kitab/full` | Лал Кітаб | 50 | Усі Лал Кітаб доші |
| `/v1/vedic/doshas/kp/mangal` | KP | 20 | Манґлік за KP sub-lord |
| `/v1/vedic/doshas/kp/kaal-sarp` | KP | 20 | Кала-Сарп за KP |
| `/v1/vedic/doshas/kp/full` | KP | 50 | Усі KP доші |
| `/v1/vedic/doshas/jaimini/arudha-affliction` | Джайміні | 20 | Афлікція аруда-пади |
| `/v1/vedic/doshas/jaimini/badhaka` | Джайміні | 20 | Badhaka-pattern |
| `/v1/vedic/doshas/jaimini/full` | Джайміні | 50 | Усі Джайміні доші |
| `/v1/vedic/doshas/all` | Усі | 100 | Згруповано усі 4 школи |

## Приклад

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/doshas/parashara/full \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234,
        "ayanamsa": "lahiri"
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/doshas/parashara/full', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
        ayanamsa: 'lahiri',
      }),
    });
    const { data } = await r.json();
    for (const d of data.doshas) {
      console.log(`${d.name}: ${d.present ? 'YES' : 'no'} (${d.strength ?? '-'})`);
    }
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/vedic/doshas/parashara/full',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
            'ayanamsa': 'lahiri',
        },
    )
    for d in r.json()['data']['doshas']:
        verdict = 'YES' if d['present'] else 'no'
        print(f"{d['name']}: {verdict} ({d.get('strength', '-')})")
    ```
  </TabItem>
</Tabs>

Приклад відповіді (скорочено):

```json
{
  "data": {
    "doshas": [
      {
        "name": "Mangal Dosha",
        "key": "mangal",
        "present": true,
        "strength": "moderate",
        "reason": "Mars in 7th house from Ascendant",
        "cancellations": ["Mars in own sign"],
        "net_effect": "partial"
      },
      {
        "name": "Kaal Sarp Dosha",
        "key": "kaal-sarp",
        "present": false
      }
    ],
    "ayanamsa": "lahiri"
  }
}
```

## Точність і джерела

- **Парашара-доші** — *Brihat Parashara Hora Shastra*, плюс перевірка проти *Phaladeepika* та *Saravali*. Манґлік — найкласичніша формула (Марс у 1/2/4/7/8/12 з cancellation-правилами).
- **Лал Кітаб** — *Lal Kitab* (Пандіт Руп Чанд Джоші, 1939-1952, 5 томів). Доші у цій школі мають іншу логіку (planet-house тематика, "tina rin" — три борги, varshphal-cycle), не накладаються на класичну Парашара.
- **KP** — *Krishnamurti Paddhati* readers (K.S. Krishnamurti, 6 volumes). Sub-lord-теорія, відмінна від Парашара cusp-роботи.
- **Джайміні** — *Jaimini Sutras*; arudha-pada афлікції.
- **Статус** — Парашара GREEN; Лал Кітаб і Джайміні — переважно YELLOW (single-author лінії, мінімум cross-verification у комерційних API). Чесний disclaimer у `docs/AUDIT-TRAIL.md`.

## Пов'язане

<CardGrid>
  <LinkCard title="Йоги" href="/vedic/yogas/" description="Раджа, Дхана, Махапуруша — 12 ендпоінтів комбінацій" />
  <LinkCard title="Сумісність" href="/vedic/compatibility/" description="Manglik-match, ашта-кута, даша-кута" />
  <LinkCard title="Мухурта" href="/vedic/muhurat/" description="Електорна астрологія для подій" />
  <LinkCard title="Вартість" href="/credits/" description="Кредити для кожного ендпоінта" />
  <LinkCard title="Точність" href="/accuracy/" description="Як ми верифікуємо обчислення" />
  <LinkCard title="Автентифікація" href="/authentication/" description="X-Api-Key, тестові ключі" />
</CardGrid>