علم التنجيم الفيدي عبر API: من باراشارا إلى Lal Kitab في 354 نقطة نهاية

علم التنجيم الفيدي أقدم تقليد فلكي متواصل في العالم. تُستخدم منهجياته الرسمية (BPHS، و Jaimini Sutras، و Lal Kitab، و KP) يوميًا في الهند: في توفيق الزيجات، واختيار المواعيد، والتشخيص الاستباقي لمسار الحياة. لكن الوصول البرمجي إلى حسابات عالية الجودة كان حتى وقت قريب أمرًا مؤلمًا.

يعالج AstroWay v2.19 هذه المشكلة: أكثر من 354 نقطة نهاية فيدية، جرى التحقق منها مقابل PyJHora (التطبيق المرجعي بلغة Python)، مع توثيق الفروقات.

مع أن الدائرتين البروجيتين تُحسبان من مواقع الكواكب نفسها (عبر Swiss Ephemeris)، إلا أنهما مختلفتان مفاهيميًا:

الفيدي ليس “بديلًا” عن الغربي، بل نظام مستقل بإطاره المنطقي الداخلي الخاص. المطورون الذين يبنون تطبيقات متعددة التقاليد (أبراج على الجوال، توفيق زيجات، daily horoscope) يريدون غالبًا الاثنين معًا، وهنا تكون API واحدة بدل اثنتين من مزودين خارجيين توفيرًا حقيقيًا.

معظم المنافسين يقدمون Vimshottari فقط (دورة 120 عامًا، وهي الأكثر شيوعًا). يغطي AstroWay:

1. Vimshottari (120 عامًا): معيار BPHS، الأساسي في كل مكان
2. Yogini (36 عامًا): تنبؤات أسرع، 8 كواكب
3. Ashtottari (108 أعوام): تقليد Ardradi، توصية حسب الـ paksha
4. Kalachakra (الأبراج بصفتها أسياد MD): أعقد نظام، والـ paramayu يختلف من خريطة لأخرى
5. Chara (Jaimini المتحرك): للتنبؤات القائمة على الأبراج
6. Tribhagi (54 = Vimshottari/2 مع إضافات): Vimshottari مُسرّع
7. Shatabdika (100 عام): أعداد متباينة حسب المصادر
8. Shodashottari (116 عامًا): للخرائط ذات الـ paksha المختلطة
9. Sthira (dasha نادرة بفترات ثابتة)
10. Shoola (طريقة عبر الـ rasi)

يدعم كل نظام 5 مستويات: Maha ← Antar ← Pratyantar ← Sookshma ← Prana.

الخرائط التقسيمية نظرات متكررة إلى الخريطة الولادية نفسها بمقاييس مختلفة. D9 (Navamsha) الأهم للزواج. D10 (Dashamsha) للمهنة. D60 (Shashtyamsha) أدق مستوى.

استدعاء واحد إلى /v1/vedic/vargas يُرجع التقسيمات الـ 16 كلها دفعة واحدة، فلا يحتاج المطوّر إلى 16 طلبًا منفصلًا.

5 عناصر أساسية مع عناصر مساعدة:

• Tithi (اليوم القمري، أحد 30 قسمًا من الدورة القمرية)
• Karana (نصف tithi، 11 نوعًا)
• Yoga (يوغا اليوم، 27 نوعًا، تقوم على مجموع خطي طول الشمس والقمر)
• Nakshatra (أحد المنازل القمرية الـ 27)
• Choghadia (النهار والليل مقسومان إلى 8 كتل لكل منهما لتحديد درجة السعد، مدة كل كتلة نحو ساعة ونصف)
• Hora (الساعة الكوكبية)
• Rahu-kaal (نافذة نحس مدتها ساعة ونصف كل يوم)

باستدعاء /v1/vedic/panchang/full تحصل على العناصر الثمانية كلها في JSON واحد لتاريخ وموقع محددين.

الـ yoga في التنجيم الفيدي تركيبة كوكبية خاصة تُكوّن نمطًا واضحًا في الحياة. يصف باراشارا (BPHS) المئات منها، ويطبّق AstroWay أكثرها استشهادًا:

• Raja: تركيبات السلطة والتقدير
• Dhana: الثروة
• Dharma-Karmadhipati: المسار المهني
• Pancha Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 كواكب في بيوت kendra في أبراجها)
• Gajakesari: القمر مع المشتري في kendra
• Adhi: عطارد/الزهرة/المشتري في 6/7/8 من القمر

إضافة إلى الخاصة بـ Jaimini: karaka-yoga (8 chara karakas في بيوت ذات دلالة)، و karakamsa (إسقاط 12 بيتًا انطلاقًا من AK في D9)، و shubha-graha (الكواكب السعيدة وظيفيًا وفق BPHS Adhyaya 34).

الـ dosha إصابة كوكبية تُعقّد مجالًا محددًا من الحياة. يغطي AstroWay ثلاث مدارس:

• باراشارا: Mangal Dosha (المريخ)، و Kaal Sarp (الكواكب بين Rahu و Ketu)، و Pitru (كارما الأسلاف)، و Shrapit، و Grahan، و Guru-Chandal
• Lal Kitab: Manglik (بتفسير خاص بـ Lal Kitab)، إضافة إلى doshas أخرى تنفرد بها هذه المدرسة
• KP (Krishnamurti Paddhati): تشخيص قائم على الـ sub-lord

إذا كانت خدمة التوفيق لديك تخدم عملاء من مناطق مختلفة في الهند (البنجاب تستخدم LK غالبًا، وتاميل نادو KP، والجميع باراشارا)، فأنت تحتاج API واحدة بدل ثلاث.

عملية المطابقة الهندية الكلاسيكية:

1. Ashtakoot (Guna Milan): مقياس من 8 أجزاء، 36 نقطة كحد أقصى. أقل من 18 يعني توافقًا ضعيفًا. الأكثر شيوعًا في شمال الهند ووسطها.
2. Dashakoota: مقياس من 10 أجزاء، النسخة الجنوبية.
3. فحص Manglik: حاسم للخرائط الولادية المصابة بالمريخ.
4. Mangal match: يعوّض حالة المريخ مع المريخ.
5. Bhrigu match: طبقة تنبؤية من Bhrigu Samhita.

كل ذلك عبر /v1/vedic/compatibility/full: استدعاء واحد وتقرير توافق كامل.

الـ “Muhurta” هي اللحظة المباركة لبدء حدث ما. الأحداث الكلاسيكية:

• Marriage muhurta (الزفاف)
• Vehicle purchase (شراء سيارة)
• Business start (افتتاح مشروع)
• Travel (السفر)
• Naming ceremony (Namakaran: تسمية المولود)
• العمليات الجراحية، وبدء الدراسة، والاستثمار، وشراء العقار، و griha-pravesh (دخول المنزل الجديد)، والخطوبة، والقضايا أمام المحاكم

تُرجع /v1/vedic/muhurat/{event} أفضل 3 تواريخ مباركة ضمن النطاق المحدد.

Lahiri هو الافتراضي (Chitra Paksha، المعيار الرسمي للحكومة الهندية). يمكن التبديل عبر المعامل ayanamsa:

• raman: تقليد B.V. Raman (شائع في KP)
• krishnamurti: خاص بـ KP
• yukteshwar: Sri Yukteshwar (المسافة عن Spica)
• fagan-bradley: Fagan/Bradley (النجمي الغربي)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

كل واحد منها إزاحة مختلفة (عادة بين 23.5 و 24.0°). قد تختلف مواقع كواكب العميل نفسه في الأبراج، ومن المهم معرفة ذلك في مرحلة تصميم بنية تطبيقك.

لكل نقطة نهاية:

• حالة (GREEN/YELLOW) في docs/AUDIT-TRAIL.md
• ترويسة AUDIT داخل الشيفرة المصدرية مع المصادر (BPHS Adhyaya N، و Jaimini Sutras X.Y، ودالة PyJHora المرجعية)
• fixture لاختبار snapshot يحمي من التراجعات

الفروقات مع PyJHora (حيث وُجدت، وغالبًا في منهجيات المؤلف الواحد مثل Lal Kitab) موثقة في AUDIT-TRAIL، فيرى المطوّر الفرق الدقيق قبل الدمج.

# Natal Vedic chart
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

يُرجع سيد الـ Maha-dasha الحالي، وتاريخ نهاية الـ MD، وتسلسل الـ dashas التالية. عبر /maha ← /antar ← /pratyantar ← … يمكنك التعمق حتى المستوى الخامس.

التقارير الفيدية (PDF) متاحة بـ 20 لغة منها hi و ko و ja و id و tr و vi، وهي أسواق فيها طلب حقيقي على المحتوى الفيدي. مرّر lang=<code> إلى أي نقطة نهاية /v1/reports/*. التفاصيل في /languages/.

تكلّف نقاط النهاية الفيدية 10 أو 20 أو 50 رصيدًا بحسب ما تحسبه: Lal Kitab و KP بـ 10، والـ vargas وعناصر الـ Panchang بـ 20، و doshas باراشارا والـ dashas والـ shadbala والـ muhurta بـ 50. على الخطة المجانية (10 000 رصيد) يعني ذلك بين 200 و 1000 استدعاء فيدي شهريًا. تقارير PDF لـ Vedic Kundli / Lal Kitab بـ 5000.

• فئات نقاط النهاية الفيدية: تصفح 8 مجموعات
• Vedic API: نظرة شاملة مع أمثلة برمجية بـ 4 لغات
• البدء السريع: أول طلب خلال 5 دقائق
• الأسعار: من المجاني إلى Enterprise