نقدم محرك التوقعات الفلكية الخاص بنا¶

محرك التوقعات الفلكية الخاص بنا هو بيئة تشغيل فلكية محددة التصميم، مصممة لتطبيقات حقيقية وليست مجرد توليد نص. إنه يجمع بين حساب Swiss Ephemeris، وتفعيل صارم للعوامل، وعرض تحريري، لضمان حصول تطبيقك على مخرجات تقارير مستقرة وواضحة وعالية الجودة.

ما الذي تقوم ببنائه؟¶

في وقت التشغيل، يحسب المحرك الحالة الفلكية الحقيقية ويجمع المعنى من العوامل الفلكية النشطة. بالنسبة للبيانات المرسلة نفسها، تظل المخرجات مستقرة تمامًا. عند توفير مدخلات مخصصة، يتم تنشيط المتجهات على مستوى المنزل والسياق الولادي لإنتاج اختلافات خاصة بالمستخدم.

وهذا يمنح فريقك:

• مخرجات متوقعة للاختبار وضمان الجودة والتخزين المؤقت - الطلبات المتطابقة تُرجع دائمًا نفس JSON.
• تكوين تقرير قابل للتفسير من خلال تتبع factor_details في كل قسم.
• مسار واضح من تقارير الإشارة الخفيفة الوزن إلى التقارير المخصصة الفاخرة.
• عمق مدرك للفترة الزمنية - مجموعات يومية (5-6 عوامل)، أسبوعية (10)، شهرية (11)، وسنوية (13) مع أوزان محددة.

نظرة عامة على البنية¶

بنية المحرك الكامل¶

بنية الطلب إلى الاستجابة¶

خط أنابيب ثابت¶

1. بوابة تتحقق من المصادقة، والحدود، وسياسة الطلبات.
2. التحقق من اتفاقية الطلب يفرض مخططًا وميزات مقبولة.
3. محرك يحدد مصدر الإشارة، ونطاق الفترة، وتكوين الأبراج الفلكية.
4. الأبراج الفلكية السويسرية تحسب المواقع، والزوايا، والمنازل (عندما تكون مؤهلة).
5. طبقة التجميع تجمع البيانات خلال الفترة، وتستخرج الأحداث (الزوايا، الدخول، الثبات، مراحل القمر، الكسوف)، وترتب العوامل.
6. محرك التحليل يربط مواصفات العوامل بالمحتوى الإجرائي باستخدام ترتيب ثابت، وأوزان محددة، واختيار متغير تجزئة مستقر.
7. محرك المحتوى الإجرائي يعرض سرد الأقسام من حزم المحتوى V2 مع تكوين الأقواس الخاصة بالفترة (بداية → تحول → نتيجة).
8. البوابة ترجع محتوى المحرك بالإضافة إلى التغليف المؤسسي (_enterprise، _api_metadata_) لبيانات التكامل.

ضمانات الاتساق¶

الاتساق ليس صدفة - بل يتم تطبيقه في كل طبقة:

وهذا يعني أنه يمكنك تجزئة طلبين مستقلين بنفس الجسم والحصول على نفس النتيجة، مما يتيح التخزين المؤقت الموثوق به واختبار الانحدار وضبط الأخطاء بشكل قابل للتكرار.

تقارير عامة مقابل شخصية¶

كلاهما في وضع الإنتاج. الفرق ليس في الجودة؛ بل هو عمق التفعيل.

الوضع العام (القائم على العلام)¶

قدم فقط علامة زوديا وتاريخ. ينتج المحرك قراءة ثابتة ومشتركة لجميع المستخدمين الذين لديهم نفس العلامة في تلك الفترة.

• مثالي للمجموعات الواسعة وفعالية التكلفة في التخزين المؤقت (12 علامة × 4 فترات × 365 يومًا = ~17,520 ذاكرة تخزين مؤقت فريدة يوميًا)
• لا توجد حسابات المنازل — يتم تعيين rising_sign، و house_cusps، وجسم house بواسطة null
• مناسب بشكل كبير للإطلاق السريع، والتقارير الفلكية على نمط المجلة، ومستويات Freemium

وضع مخصص (مع مراعاة تاريخ الميلاد)¶

توفير سياق الميلاد (birth_time، الإحداثيات، المنطقة الزمنية) لتفعيل المتجهات الأكثر عمقًا. يمكن للمستخدمين الذين لديهم نفس العلامة أن يتلقوا تحليلات مختلفة بسبب اختلاف مواقع الأبراج وتأثيرها على تحديد العوامل.

• الحقول المطلوبة: birth_time (الساعات:الدقائق) + birth_latitude + birth_longitude
• يفتح الوصول إلى: برج الميلاد، نقاط التقاطع الـ 12 للأبراج، تخصيص الكواكب للمنازل، وعوامل التركيز على المنازل (daily_house_focus، weekly_house_focus، monthly_house_focus، yearly_house_focus)
• مثالي للاشتراكات المميزة وتجارب الاحتفاظ العالية
• يدعم الوحدات التطبيقية الأكثر ثراءً وقنوات التخصيص

نموذج تحليلات يعتمد على العوامل¶

يعمل المحرك بناءً على مجموعات العوامل المحددة - محركات تفسيرية ثابتة يتم حسابها من صور فلكية وتجميع الفترات. لكل فترة ترتيب محدد للعوامل وأوزان واضحة.

مجموعات العوامل حسب الفترة¶

تُضاف طبقات إضافية من العوامل المخصصة للتقارير: - الكوكب: planet_core_archetypes، planet_condition_archetypes، planet_house_focus، planet_sign_archetypes - تاريخ الميلاد: solar_return_tone، birthday_year_reset، natal_sun_house_year_theme - الجانب: مجموعات قائمة على الجانب مع جوانب مهيمنة محسوبة أو مُعدلة - التأثير: مجموعات قائمة على التأثير مع أركيتيب التأثير المهيمن المحسوب أو المُعدل

يحمل كل عامل وزنًا محددًا (مثل: moon_in_sign: 1.15 يوميًا، yearly_theme_archetypes: 1.30 سنويًا) والذي يؤثر على تقييم القسم واستنتاج شدته.

يتجنب هذا النموذج الانحراف العشوائي في النص ويحافظ على النبرة التحريرية المرتبطة بالمحركات المحسوبة مع تتبع كامل في factor_details.

إحصائيات التطبيق الشخصية اليومية (التقويم الرئيسي)¶

في وضع التشغيل الشخصي اليومي، يُرجع المحرك كتل إحصائية جاهزة للتطبيق في data.daily_personalized_stats. وهذه مثالية لبطاقات لوحة المعلومات ومؤشرات الملخص.

سبب التفعيل: period=daily و طلب الميلاد الشخصي يتضمن كل من birth_time و coordinates.

Key blocks:

• overall_pulse — درجة النشاط اليومية المجمعة
• archetype_scores — تحليل ثماني الأبعاد (wisdom، creativity، confidence، intuition، allure، romance، career، emotions)
• harmony_discord — الأربعة علامات الأكثر توافقًا والأربعة علامات الأكثر اختلافًا
• elemental_balance — توزيع / نار / أرض / هواء / ماء
• momentum_channels - إشارات زخم الكواكب

التحكم في كثافة البيانات المرسلة:

• daily_stats_detail: "full" للبيانات الكاملة للرسم البياني مع مستويات الثقة لكل كتلة
• daily_stats_detail: "compact" لحمولة العميل الأخف (مثالي للأدوات المحمولة)

أبرز ميزات التصميم للطلب¶

The engine supports clear, typed controls for astrological configuration and rendering behavior. خيارات شائعة تشمل:

ضمانات شكل الاستجابة في البوابة¶

تمر استجابات تقارير البوابة عبر بيانات المحرك وتضيف غلافًا:

• _enterprise — معلومات مستوى الخطة، والحد الأقصى، وقيود المعدل
• _api_metadata_ — معلومات نقطة النهاية، واللغات المدعومة، والسياق المطلوب

بالنسبة لنقاط نهاية التقارير المدعومة بالمحرك، فإن _api_metadata_.supported_languages هي باللغة الإنجليزية فقط:

{
  "_api_metadata_": {
    "supported_languages": ["en"]
  }
}

سياسة اللغة والترجمة¶

Live engine-backed report endpoints currently support lang=en only. This is intentional to preserve deterministic editorial nuance in production while translation reliability is curated separately. The gateway translation helper layer (lang=en|es|de|fr|pt) provides translated output at the API boundary for all non-horoscope report endpoints.

مسار المحتوى: حزم محتوى V2¶

محتوى التحرير يتم الحصول عليه من حزم المحتوى المنظمة V2 في مستودع المحتوى للمحرك.

At runtime, the content repository selects variants deterministically via stable hash selection with a four-level fallback chain:

1. تطابق تام (نوع العامل + قيمة العامل + شدة)
2. أي قيمة لـ factor_type (factor_type + intensity)
3. أي عامل في القسم (القسم + الشدة)
4. قالب النسخ الاحتياطي للقسم

This structure ensures editorial variety across intensities while preserving reproducibility for the same seed.

نموذج الثقة: نواة مغلقة + مصدر مفتوح خفيف¶

Our main production engine is closed-source and optimized for enterprise reliability, depth, and managed operations. يشمل:

• تقارير مخصصة بالكامل تأخذ في الاعتبار جميع الفترات (جميع الفترات)
• تقارير دورة الميلاد مع عوامل العودة الشمسية
• مجموعات من التقارير التي تتضمن الكواكب، الجوانب، التحركات، البيوت، وتقرير الكوكب والبيت
• مخطط ميلاد الولادة مع عرض SVG قابل للتكوين
• ذاكرة التخزين المؤقت Redis، المقاييس، فحوصات الصحة، والتوسع الأفقي

للدعم المستقل للممارسين الفلكيين وتقييم المطورين، نقدم أيضًا محرك المصدر المفتوح الخفيف:

• موقع OpAstro
• GitHub الخاص بـ OpAstro
• PyPI الخاص بـ OpAstro

استخدم OpAstro لتقييم جودة المحرك، واستكشاف منطق حساب العوامل، والتحقق من تكامل Swiss Ephemeris. وسع نطاق عملك باستخدام مسارات NumerologyAPI المؤسسية للحصول على طبقات تقارير أكثر ثراءً، وتغطية أوسع لنقاط النهاية، وعمليات إنتاج مُدارة.

مسار التكامل¶

1. ابدأ بتقارير على مستوى الجمهور - يوميًا/أسبوعيًا/شهريًا/سنويًا باستخدام sign فقط. لا يلزم بيانات الميلاد. قم بتخزين البيانات بكفاءة.
2. أضف حقول الميلاد الشخصية - زود birth_time + الإحداثيات لفتح تحليلات مخصصة مع مراعاة مواقع الأبراج.
3. ضع طبقات من عائلات التقارير المتخصصة - كواكب، جوانب، تحركات، ونقاط نهاية البيوت للحصول على أسطح منتجات أعمق.
4. أضف نقاط نهاية الميلاد - JSON كامل لخرائط الميلاد + عجلة SVG للرسم التوضيحي وعمليات علم الفلك المتقدمة.
5. حسن باستخدام الأقسام - اطلب فقط sections التي تحتاجها واجهة المستخدم الخاصة بك (مثل ["general", "career"]) لتقليل حجم البيانات المرسلة.
6. استخدم tenant_id لعزل التخزين المؤقت - قم بفصل المستويات المجانية/المدفوعة أو متغيرات اختبار A/B دون تلوث التخزين المؤقت.

استراتيجية التخزين المؤقت¶

قراءة إضافية¶

• نظرة عامة على واجهة برمجة تطبيقات تنبؤات الأبراج
• الأبراج اليومية
• الأبراج الأسبوعية
• الأبراج الشهرية
• الأبراج السنوية
• الأبراج الخاصة بالميلاد
• خريطة الميلاد