تونغ شو (اختيار التاريخ)

تونغ شو (通書) هو التقويم الصيني الذي يُختار به اليوم تقليديًا. تُحسب طبقتان منه بدقة، وهما المنفّذتان هنا: حكّام الأيام الاثنا عشر (建除十二神) والمنازل القمرية الثماني والعشرون (二十八宿).

نقاط النهاية

نقطة النهاية	الأرصدة	ما تعيده
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.

ملاحظة

ثلاثة أحكام، وneutral لا تعني “لا يهم”. suitable وunsuitable هما ما يقوله السجل صراحةً. أما neutral فتعني أن التقليد صامت بشأن هذا العمل. لذلك لا تدخل الأيام الصامتة في النتيجة افتراضيًا، ويمكن طلبها عبر includeNeutral.

تنبيه

النطاق محدود بـ 366 يومًا، والنطاق الأطول يُرفض ولا يُقتطع. فالاستجابة المختصرة بصمت ستُقرأ كأنه “لا أيام جيدة بعد مارس”، مع أن أحدًا لم ينظر هناك أصلًا. تحتوي الاستجابة دائمًا على scanned وmatched وdropped مع التفصيل، فيتطابق المجموع.

ما الذي تم التحقق منه

• الحكّام مطابَقون مع مثال محلول منشور: ديسمبر 2020 في شهر الفأر، حيث 11 ديسمبر هو أول Establish، و8 و9 و10 ديسمبر هي Collect وOpen وClose. الأربعة متطابقة.
• المنازل مطابَقة مع التسلسل اليومي لتقويم ياباني لشهر أغسطس 2026: عشرون يومًا متتاليًا، من 女 في الأول من أغسطس إلى 角 في العشرين منه. إضافةً إلى ثابت يوم الأسبوع الذي تم التحقق منه على قرن كامل من التواريخ.
• عمود اليوم أصبح الآن مثبّتًا بثلاثة تواريخ منشورة (1949-10-01 甲子، 2000-01-01 戊午، 2024-02-10 甲辰). في السابق كانت مذكورة في تعليق فقط ولم يتحقق منها شيء.

الاختيار يتم حسب الحكّام، لا حسب المنازل. تُعاد المنزلة لكل يوم لكنها لا ترشّح: فسجل أحداثها يختلف بين التقاويم، ولا نختلقه. وبالمثل لم تُنفَّذ جداول 神煞: فهي عشرات السلاسل المتداخلة دون اتفاق بين المصادر.