# Сумісність (Guna Milan) — ведична сумісність

Guna Milan — традиційна ведична методика звірки сумісності двох натальних карт перед шлюбом. Найпоширеніша в Індії форма (Ашта-кута, 8 розділів × 36 балів) і кілька регіональних варіантів. AstroWay підтримує **6 ендпоінтів сумісності**.

<Aside type="note">
Ці ендпоінти повертають числові показники і структуровану діагностику — _не_ "вирок про шлюб". Інтерпретація балів культурно специфічна (зазвичай в Індії 18+/36 = прохідний). Будуйте UI з контекстом і повагою.
</Aside>

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

- **Ашта-кута** (8-fold Guna Milan) — найпоширеніша Північно-Індійська методика, 36 балів за 8 куртами (Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi).
- **Даша-кута** (10-fold) — Південно-Індійська (Тамілська/Малаялам) методика, 10 куртів, інша вага категорій.
- **Manglik-перевірка** — обидва партнери на наявність Манґлік-доші + cancellation-правила (Манґлік + Манґлік нейтралізують одне одного).
- **Mangal-match** — детальний матч сили Марса між картами (а не просто наявність доші).
- **Bhrigu-match** — Bhrigu-Bindu метод (тонша сумісність крізь призму середньої точки між Місяцем і Раху).
- **Full** — комбінований звіт: Ашта-кута + Manglik + Bhrigu + score breakdown.

## Ендпоінти

| Ендпоінт | Кредити | Опис |
|---|---|---|
| `/v1/vedic/compatibility/ashtakoot` | 50 | 8-fold Guna Milan з повним breakdown |
| `/v1/vedic/compatibility/dashakoota` | 50 | 10-fold (Південна Індія) |
| `/v1/vedic/compatibility/manglik-check` | 20 | Manglik-діагностика обох партнерів + cancellation |
| `/v1/vedic/compatibility/mangal-match` | 20 | Сила Марса між картами |
| `/v1/vedic/compatibility/bhrigu-match` | 30 | Bhrigu-Bindu сумісність |
| `/v1/vedic/compatibility/full` | 100 | Усі методи + загальний score |

## Приклад

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/compatibility/ashtakoot \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "person1": {
          "date": "1990-07-14",
          "time": "14:30:00",
          "timezoneOffset": 3,
          "latitude": 50.4501,
          "longitude": 30.5234
        },
        "person2": {
          "date": "1992-03-22",
          "time": "08:15:00",
          "timezoneOffset": 3,
          "latitude": 49.8397,
          "longitude": 24.0297
        },
        "ayanamsa": "lahiri"
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/compatibility/full', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        person1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234 },
        person2: { date: '1992-03-22', time: '08:15:00', timezoneOffset: 3, latitude: 49.8397, longitude: 24.0297 },
        ayanamsa: 'lahiri',
      }),
    });
    const { data } = await r.json();
    console.log(`Ashtakoot: ${data.ashtakoot.total}/36`);
    console.log(`Manglik p1: ${data.manglik.person1.present}, p2: ${data.manglik.person2.present}`);
    console.log(`Cancellation: ${data.manglik.cancelled}`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/vedic/compatibility/full',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        json={
            'person1': {'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.4501, 'longitude': 30.5234},
            'person2': {'date': '1992-03-22', 'time': '08:15:00', 'timezoneOffset': 3, 'latitude': 49.8397, 'longitude': 24.0297},
            'ayanamsa': 'lahiri',
        },
    )
    data = r.json()['data']
    print(f"Ashtakoot: {data['ashtakoot']['total']}/36")
    print(f"Bhrigu match: {data['bhrigu']['score']}")
    ```
  </TabItem>
</Tabs>

Приклад відповіді (Ашта-кута, скорочено):

```json
{
  "data": {
    "ashtakoot": {
      "total": 24,
      "max": 36,
      "passing_threshold": 18,
      "verdict": "passing",
      "breakdown": [
        { "kuta": "Varna",       "score": 1, "max": 1 },
        { "kuta": "Vashya",      "score": 2, "max": 2 },
        { "kuta": "Tara",        "score": 3, "max": 3 },
        { "kuta": "Yoni",        "score": 2, "max": 4 },
        { "kuta": "Graha Maitri","score": 4, "max": 5 },
        { "kuta": "Gana",        "score": 6, "max": 6 },
        { "kuta": "Bhakoot",     "score": 0, "max": 7, "doshic": true },
        { "kuta": "Nadi",        "score": 8, "max": 8 }
      ],
      "warnings": ["Bhakoot dosha — 6/8 axis"]
    },
    "ayanamsa": "lahiri"
  }
}
```

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

- **Ашта-кута** — алгоритм за класичною формулою (Northern Indian standard), референс — *Muhurta Chintamani* (Ramadayalu Bhattacharya, 16 ст.) і сучасні compendium-и (B.V. Raman, *Hindu Predictive Astrology*).
- **Даша-кута** — South Indian варіант, 10 куртів (додає Rasi-kuta, Stree-Deergha-kuta тощо). Референс — *Jataka Tattva* (Mahadeva).
- **Bhrigu-Bindu** — техніка Bhrigu Pratyantar (середня точка Moon-Rahu), популяризована K.N. Rao і його школою.
- **Manglik cancellation** — використовуємо 12 класичних правил (наприклад, Марс у Скорпіоні в 4-му домі скасовує дошу; Марс у Раку в 1-му скасовує). Список правил у docs.
- **Sidereal zodiac**: Lahiri за замовчуванням. Підтримуються Raman, Krishnamurti, Fagan-Bradley, Yukteshwar.
- **Статус**: Ашта-кута GREEN (cross-verified проти JagannathaHora-3 і реалізації Maitreya). Bhrigu-Bindu — YELLOW (school-specific, обмежений public reference). Повний breakdown — `docs/AUDIT-TRAIL.md`.

## Пов'язане

<CardGrid>
  <LinkCard title="Доші" href="/vedic/doshas/" description="19 ендпоінтів афлікцій (включно з Manglik)" />
  <LinkCard title="Йоги" href="/vedic/yogas/" description="Раджа, Дхана, Махапуруша — комбінації" />
  <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>
