Zi Wei Dou Shu: توزيع النجوم

紫微斗數 لا يبني الخريطة من الكواكب، بل من اثني عشر قصرًا وأكثر من مئة نجم مرتّبة وفق قواعد تعتمد على التاريخ القمري وساعة الميلاد. POST /v1/ziwei/chart يحسب كل ذلك بالكامل.

نقاط النهاية

نقطة النهاية	الرصيد	ما تُرجعه
POST /v1/ziwei/chart	20	الخريطة الكاملة: القصور، النجوم، المراحل، الحدود، 四化. تتطلب time وgender
POST /v1/ziwei/four-transformations	10	四化 حسب ساق السنة، أربع مدارس
POST /v1/ziwei/twelve-palaces	5	مرجع القصور الاثني عشر
POST /v1/ziwei/main-stars	5	مرجع النجوم الرئيسية الأربعة عشر
POST /v1/ziwei/palace-*	5	مرجع قصر واحد، تسعة مسارات

المسارات المرجعية تحمل الحقل computed: false وتكلّف نصف التعرفة. تُرجع الجدول نفسه لأي تاريخ ميلاد، ولا بأس في ذلك ما دام مذكورًا صراحة.

`/ziwei/full-chart` مهمل (deprecated)

إنه يُرجع قاموس القصور نفسه لأي شخص، بينما يَعِد اسمه بخريطة. يستجيب دون تغيير حتى 2027-11-26، ويحمل ترويسات Deprecation وSunset وLink إلى الخلف. انتقل إلى /v1/ziwei/chart: فهو يتطلب gender إضافةً إلى التاريخ والساعة.

مثال

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

المصفوفة palaces تحمل الاثني عشر جميعها بالشكل نفسه، من 寅 إلى 丑.

ما الذي يُحسب بالضبط

الخطوة	القاعدة
命宮 و身宮	من قصر الشهر رجوعًا عبر الساعات لقصر الحياة، وتقدّمًا لقصر الجسد
سيقان القصور	五虎遁 من ساق السنة
五行局	من عمود قصر الحياة؛ يتطابق مع 納音 في الأزواج الستين كلها
紫微	قسمة اليوم على رقم 局 مع استعارة: الاستعارة الزوجية للأمام، والفردية للخلف
紫微系 (6)	إزاحات −1، −3، −4، −5، −8 من 紫微
天府系 (8)	天府 هو مرآة 紫微 حول محور 寅-申، ثم +1..+6 و**+10** لـ 破軍
六吉 و六煞	من الشهر والساعة وساق السنة، ولكل منها صيغتها الخاصة
واحد وثلاثون نجمًا صغيرًا	من فرع السنة وساق السنة والشهر واليوم والساعة
長生十二神	من 五行局، للأمام لـ 陽男陰女 وللخلف في غير ذلك
博士十二神	من 祿存، بالاتجاه نفسه
將前 و歲前 十二神	من ثلاثية فرع السنة ومن الفرع نفسه، وكلاهما دائمًا للأمام
大限	من 命宮، البداية في عمر رقم 局، بخطوة عشر سنوات
小限	يقرأ الجنس ولا يقرأ الين-يانغ، بخلاف الحدود العشرية
四化	حسب ساق السنة، موسومة مباشرة على النجوم

مفاتيح التبديل الأربعة للمدارس

هي في جسم الطلب وليست في كودنا، لأن كل واحد منها يزيح الخريطة كلها للمواليد الذين يمسّهم.

المعامل	الافتراضي	القيمة الثانية
yearDivide	lunar: تبدأ السنة في اليوم الأول من الشهر القمري الأول	lichun: الحد من BaZi
fixLeap	true: يُقسم الشهر الكبيس في اليوم الخامس عشر	false: يُحسب الشهر الكبيس كله تابعًا للسابق
dayDivide	forward: الساعة 23:00 تتبع اليوم التالي	current: يبقى التاريخ، وتُوسم الساعة بـ 晚子時
tianmaSchool	year: 天馬 من فرع السنة (中州派)	month: 天馬 من الشهر القمري
school	zhongzhou: 四化 وفق منظومة 王亭之	quanji، quanshu، beipai

ساعة الميلاد إلزامية

قصر الحياة يُحدَّد من الساعة، وعليه يتوقف 五行局 وكل نجم. الخريطة بلا ساعة لن تكون إجابة جزئية، بل اثني عشر قصرًا من الهراء الواثق، لذلك يُرفض الطلب بلا time برمز 400. هذا يختلف عن BaZi، حيث يغيب عمود الساعة فحسب دون ساعة.

السنة هنا لا تبدأ من Lichun

هذا ليس خيار مدرسة. 斗數 نظام قمري بحت ولا ينتقل إلى المصطلحات الشمسية، بخلاف 子平. المعامل yearDivide=lichun موجود فقط للمطابقة مع حاسبة جرّت الحد من BaZi.

كيف تم التحقق من ذلك

تم التثبيت على ثلاث خرائط منشورة، لا على مكتبة واحدة، وهذا مقصود. فالمنظومة المفتوحة لـ Zi Wei بأكملها تقريبًا تنحدر من مشروع واحد: منفذان (port) إضافةً إلى مشروع واحد على الأقل يدّعي سلالة أخرى، بينما يستدعيه في الداخل ويحلل مخرجاته. لذلك فالتطابق مع عدة مشاريع هو تطابق مع مشروع واحد.

• خريطتان مُعاد إنتاجهما بالكامل: النجوم الرئيسية الأربعة عشر كلها، 五行局، وقصرا الحياة والجسد.
• المراحل الاثنتا عشرة تم التحقق منها على متجه اختبار ثالث من المصدر نفسه، حيث نُشرت الاثنتا عشرة المتوقعة، لا على هاتين الخريطتين. بدايات العقود طُوبقت مع رقم 五行局، أي مع القاعدة التي تُشتق منها، لا مع منشور خارجي.
• الخريطة الثالثة مأخوذة من نص تعليمي صيني لا صلة له بتلك المنظومة، وتُثبّت إزاحات النجوم وترتيب القصور بشكل مستقل.
• المُذكِّرة 安紫微星 「六五四三二／酉午亥辰丑」 والمسار المنشور لـ 火六局 عبر الأيام 1-15 يُتحقق منهما مباشرة: فهما ثوابت التقليد، لا تطبيق أحد ما.

ماذا تفعل عندما تعطي حاسبتك نتيجة مختلفة

افحص ليس الحساب، بل مفاتيح التبديل الأربعة: حد السنة، الشهر الكبيس، حد اليوم عند 23:00، وجدول 四化. الاختلاف يكون هناك دائمًا تقريبًا.

رواية شائعة واحدة خاطئة

火星 و鈴星 يُرتَّبان للأمام من ثلاثية فرع السنة ولا يقرآن الجنس في أي نقل تم التحقق منه. القاعدة 陽男陰女順 / 陰男陽女逆 التي تُنسب إليهما أحيانًا تخص المراحل الاثنتي عشرة 長生十二神 والحدود العشرية. كلا الموضوعين يقفان في الصفحة نفسها في المصدر الأكثر نسخًا، ويبدو أن الالتباس نشأ من هناك.

اللغات

أسماء القصور والمراحل الاثنتي عشرة مترجمة إلى 21 لغة: أضف ?lang=، وسيظهر في كل قصر palaceLocalised، وفي المرحلة الحقل localised. أسماء النجوم تبقى بالأحرف الصينية مع ترجمة إنجليزية بجانبها: فلا أسماء مستقرة لها.