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

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

Ендпоінти

Ендпоінт	Кредити	Що повертає
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 це рівно чотири тижні. Ця властивість не декоративна, вона і є перевіркою: неправильний якір або зсунув би послідовність відносно опублікованого альманаху, або зламав би день тижня.

Приклад

Один день

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" }'

Вибір дати

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" }'

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

Ghi chú

Три вердикти, і neutral це не «байдуже». suitable і unsuitable це те, що реєстр каже прямо. neutral означає, що традиція про цю дію мовчить. Тому мовчазні дні за замовчуванням не потрапляють у вибірку, і їх можна попросити через includeNeutral.

Chú ý

Діапазон обмежений 366 днями, і довший відхиляється, а не обрізається. Мовчки скорочена відповідь читалася б як «після березня хороших днів немає», хоча насправді туди ніхто не дивився. У відповіді завжди є scanned, matched і dropped з розбивкою, тож сума сходиться.

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

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

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