Tong Shu (výběr data)

Tong Shu (通書) je čínský almanach, podle kterého se tradičně vybírá den. Dvě jeho vrstvy se dají spočítat přesně a právě ty jsou zde implementovány: dvanáct správců dne (建除十二神) a dvacet osm lunárních domů (二十八宿).

Endpointy

Endpoint	Kredity	Co vrací
POST /v1/chinese/tong-shu	10	Jeden den: pilíř dne, správce, lunární dům, zvíře střetu
POST /v1/chinese/tong-shu/select	20	Dny v rozmezí, které rejstřík doporučuje pro jednu činnost

Dvanáct správců dne

Pravidlo je jedno. Den, jehož pozemská větev se shoduje s větví měsíce, je 建 Establish, a dál jde všech dvanáct dokola. Měsíc je zde určen přesným okamžikem solárního termínu, ne prvním dnem kalendářního měsíce, takže se správce může změnit uprostřed kalendářního měsíce.

#	中文	Název	O čem ten den je
1	建	Establish	Začátek, ale ne dokončení
2	除	Remove	Uklidit, zbavit se
3	滿	Full	Plnost, podpis, otevření
4	平	Balance	Vyrovnaný, všední, bezpečný
5	定	Stable	To, co má vydržet
6	執	Control	Vzít do rukou
7	破	Destruction	Den, který se střetává s měsícem
8	危	Danger	Výška a riziko
9	成	Success	Nejpříznivější ze dvanácti
10	收	Collect	Sklidit, přijmout
11	開	Open	Otevřít, vpustit
12	閉	Close	Zapečetit; tyto jsou nejníže

Dvacet osm lunárních domů

Lunární dům se mění každý den v nepřetržitém cyklu 28 dní a tento cyklus je svázán s týdnem: 角 je vždy čtvrtek, protože 28 jsou přesně čtyři týdny. Tato vlastnost není dekorativní, je to přímo kontrola: špatná kotva by buď posunula sekvenci vůči publikovanému almanachu, nebo rozbila den v týdnu.

Příklad

Jeden den

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

Výběr data

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

Činnosti: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Poznámka

Tři verdikty a neutral neznamená “je to jedno”. suitable a unsuitable jsou to, co rejstřík říká výslovně. neutral znamená, že tradice o této činnosti mlčí. Proto se mlčící dny ve výchozím stavu do výběru nedostanou a lze si o ně říct přes includeNeutral.

Upozornění

Rozmezí je omezeno na 366 dní a delší se odmítne, ne ořízne. Potichu zkrácená odpověď by se četla jako “po březnu žádné dobré dny nejsou”, i když se tam ve skutečnosti nikdo nedíval. Odpověď vždy obsahuje scanned, matched a dropped s rozpisem, takže součet sedí.

Co je ověřeno

• Správci jsou porovnáni s publikovaným rozebraným příkladem: prosinec 2020 v měsíci Krysy, kde 11. prosinec je první Establish a 8., 9. a 10. prosinec jsou Collect, Open a Close. Všechny čtyři sedí.
• Lunární domy jsou porovnány s denní sekvencí japonského almanachu za srpen 2026: dvacet dní po sobě, od 女 prvního srpna po 角 dvacátého. K tomu invariant dne v týdnu, ověřený na století dat.
• Pilíř dne je nyní ukotven třemi publikovanými daty (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Dříve byla zmíněna jen v komentáři a nic je neověřovalo.

Výběr se řídí správci, ne lunárními domy. Lunární dům se vrací pro každý den, ale nefiltruje: jeho rejstřík událostí se mezi almanachy liší a nevymýšlíme si ho. Stejně tak nejsou implementovány tabulky 神煞: jsou to desítky překrývajících se řad bez shody mezi zdroji.