# Тун Шу (вибір дати)

**Тун Шу** (通書) це китайський альманах, за яким традиційно обирають день. Два його шари обчислюються точно, і саме вони тут реалізовані: **дванадцять керівників дня** (建除十二神) і **двадцять вісім стоянок** (二十八宿).

## Ендпоінти

| Ендпоінт | Кредити | Що повертає |
|---|---|---|
| `POST /v1/chinese/tong-shu` | 10 | Один день: стовп дня, керівник, стоянка, тварина зіткнення |
| `POST /v1/chinese/tong-shu/select` | 20 | Дні в діапазоні, які реєстр схвалює для однієї дії |

## Дванадцять керівників дня

Правило одне. День, чия земна гілка збігається з гілкою місяця, це **建 Establish**, і далі дванадцять ідуть по колу. Місяць тут визначається точним моментом сонячного терміну, а не першим числом, тому керівник може змінитися посеред календарного місяця.

| # | 中文 | Назва | Про що день |
|---|---|---|---|
| 1 | 建 | Establish | Початок, але не завершення |
| 2 | 除 | Remove | Прибрати, позбутися |
| 3 | 滿 | Full | Повнота, підписання, відкриття |
| 4 | 平 | Balance | Рівне, буденне, безпечне |
| 5 | 定 | Stable | Те, що має тривати |
| 6 | 執 | Control | Взяти в руки |
| 7 | 破 | Destruction | День, що б'ється з місяцем |
| 8 | 危 | Danger | Висота й ризик |
| 9 | 成 | Success | Найсприятливіший із дванадцяти |
| 10 | 收 | Collect | Зібрати, отримати |
| 11 | 開 | Open | Відкрити, впустити |
| 12 | 閉 | Close | Запечатати; ці найнижче |

## Двадцять вісім стоянок

Стоянка змінюється щодня по безперервному колу з 28 днів, і це коло **прив'язане до тижня**: 角 завжди четвер, бо 28 це рівно чотири тижні. Ця властивість не декоративна, вона і є перевіркою: неправильний якір або зсунув би послідовність відносно опублікованого альманаху, або зламав би день тижня.

## Приклад

<Tabs>
  <TabItem label="Один день">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/chinese/tong-shu \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "date": "2026-09-12" }'
    ```
  </TabItem>
  <TabItem label="Вибір дати">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{ "from": "2026-09-01", "to": "2026-12-31",
            "activity": "marriage", "avoidClashWith": "Rat" }'
    ```
  </TabItem>
</Tabs>

Дії: `marriage`, `opening`, `moving`, `travel`, `contract`, `construction`, `demolition`, `medical`, `funeral`, `education`.

<Aside type="note">
**Три вердикти, і `neutral` це не «байдуже».** `suitable` і `unsuitable` це те, що реєстр каже прямо. `neutral` означає, що традиція про цю дію мовчить. Тому мовчазні дні за замовчуванням не потрапляють у вибірку, і їх можна попросити через `includeNeutral`.
</Aside>

<Aside type="caution">
**Діапазон обмежений 366 днями, і довший відхиляється, а не обрізається.** Мовчки скорочена відповідь читалася б як «після березня хороших днів немає», хоча насправді туди ніхто не дивився. У відповіді завжди є `scanned`, `matched` і `dropped` з розбивкою, тож сума сходиться.
</Aside>

## Що перевірено

- **Керівники** звірені з опублікованим розібраним прикладом: грудень 2020 у місяці Щура, де 11 грудня це перший Establish, а 8, 9 і 10 грудня це Collect, Open і Close. Усі чотири збігаються.
- **Стоянки** звірені з денною послідовністю японського альманаху за серпень 2026: двадцять днів поспіль, від 女 першого серпня до 角 двадцятого. Плюс інваріант дня тижня, перевірений на столітті дат.
- **Стовп дня** тепер закріплений трьома опублікованими датами (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Раніше вони були названі лише в коментарі й не перевірялися нічим.

**Вибір іде по керівниках, не по стоянках.** Стоянка повертається для кожного дня, але не фільтрує: її подійний реєстр різниться між альманахами, і ми його не вигадуємо. Так само не реалізовані таблиці 神煞: це десятки серій, що перекриваються, без згоди між джерелами.