# Летючі зірки (玄空飛星)

**Сюань Кун Фей Сін** (玄空飛星) це школа фен-шуй, яка будує карту не для людини, а для **будівлі**. Двох речей достатньо, і обидві обов'язкові: період, у який будівлю зайняли, і напрямок, у який вона дивиться. З них виводяться три числа на кожен із дев'яти секторів.

## Три зірки в кожному палаці

| Зірка | 中文 | Що читають |
|---|---|---|
| Гірська | 山星 | Люди, здоров'я, стосунки |
| Зірка періоду | 運星 | Епоха, до якої належить будівля |
| Лицьова | 向星 | Гроші, можливості, рух |

Число зірки та її політ це точна арифметика. Що означає **пара** чисел у конкретній кімнаті, це вже інтерпретаційна традиція, у якої більш ніж одна школа. У відповіді ці дві половини розділені, і в `notes` сказано, де закінчується розрахунок.

## Ендпоінти

| Ендпоінт | Кредити | Що повертає |
|---|---|---|
| `POST /v1/chinese/feng-shui/flying-star` | 10 | Натальна карта будівлі: дев'ять палаців, тип карти, особливі візерунки |
| `POST /v1/chinese/feng-shui/annual-stars` | 10 | Річні зірки та ураження року, за бажанням місячний шар |

<Aside type="caution">
**Період не має значення за замовчуванням.** Без `period` або `occupiedDate` запит повертає 400. Будівля, зайнята 1998 року, належить до періоду 7, і впевнена карта періоду 9 для неї була б просто неправильною відповіддю з правильним виглядом.
</Aside>

## Приклад

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "period": 8, "facing": 180, "year": 2026 }'
    ```
  </TabItem>
  <TabItem label="Node">
    ```js
    const res = await fetch('https://api.astroway.info/v1/chinese/feng-shui/flying-star', {
      method: 'POST',
      headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ occupiedDate: '2011-06-01', facingMountain: 'S2' }),
    });
    const { data } = await res.json();
    console.log(data.chartType.id, data.palaces.find((p) => p.palace === 'S').pair);
    ```
  </TabItem>
</Tabs>

Напрямок можна задати або градусами за годинниковою стрілкою від істинної півночі (`facing: 180`), або назвою однієї з 24 гір: кодом (`S2`), піньїнем (`Wu`) чи ієрогліфом (`午`). Період так само: числом (`period: 8`) або датою заселення (`occupiedDate`), і тоді рік рахується від точного моменту Лічунь, а не від фіксованого 4 лютого.

## Тип карти

Чотири канонічні розташування, і відповідь називає те, яке вийшло:

| id | 中文 | Читання |
|---|---|---|
| `wang-shan-wang-shui` | 旺山旺水 | Найсприятливіше: люди позаду, гроші попереду |
| `shang-shan-xia-shui` | 上山下水 | Обернене; саме тут практик питає про ландшафт назовні |
| `double-facing` | 雙星到向 | Обидві зірки попереду: добре для грошей, потрібна опора позаду |
| `double-sitting` | 雙星到坐 | Обидві позаду: добре для людей, потрібна вода попереду |

## Що ми перевірили, і чим

Правило польоту зірки формулюють неправильно частіше, ніж правильно. Зірку відправляє вперед чи назад **не** полярність гори, у яку дивиться будівля, а полярність гори на тій самій порядковій позиції в секторі **власної триграми зірки**.

Наївне прочитання відтворює **6 з 24** опублікованих карт періоду 8 і провалює 18. Одна-дві перевірки його б пропустили, тому в тестах лежить увесь опублікований набір: 24 карти, 9 палаців, 3 зірки, **648 чисел, і всі збігаються**.

Зірка 5 не має власної триграми й позичає полярність зірки періоду. Друга поширена версія («полярність палацу, з якого 5 прийшла») це **та сама** версія: 5 завжди опиняється в палаці з числом Ло Шу `10 − період`, а воно завжди має парність періоду. Це доведено для всіх дев'яти періодів, а не залишено як застереження.

<Aside type="note">
**替卦 (заміщувальні зірки) свідомо не реалізовані.** Частина шкіл застосовує їх, коли вимір потрапляє близько до межі гори. Це змінює карту, а школи не згодні щодо умов. Замість тихого вибору відповідь попереджає: якщо ваш вимір ближче ніж 1.5° до межі, у `warnings` буде відстань і сусідня гора.
</Aside>

## Річні зірки та ураження

`POST /v1/chinese/feng-shui/annual-stars` дає дев'ять річних зірок і чотири-п'ять уражень року. Різниця між ними важлива для того, хто збирається діяти:

- **Тай Суй (太歲)** і **Суй По (歲破)** це по одній горі, 15° кожна.
- **Сан Ша (三煞)** це цілий сектор, 45°.
- **П'ять жовтих (五黃)** і **дві чорні (二黑)** це сектори річної карти.

Для 2026 року відповідь ставить п'ять жовтих на південь, Тай Суй на S2 (午), Суй По на N2 і Сан Ша на північ, що збігається з опублікованими альманахами; ці чотири значення зафіксовані тестом.

Рік тут сонячний і починається на Лічунь. Дата в січні належить до попереднього року, і саме тому нічого не підставляється за замовчуванням: без `year` або `date` буде 400.

## Що поруч

Решта фен-шуй-поверхні вже жила в API й лишається на місці: `POST /v1/chinese/feng-shui/kua` (число Гуа), `/lucky-directions` (вісім особистих напрямків) і `/bagua` (карта дев'яти сфер життя).