हमारे ज्योतिष इंजन का परिचय¶

हमारा ज्योतिष इंजन एक निश्चित ज्योतिष रनटाइम है, जो वास्तविक उत्पादन उत्पादों के लिए डिज़ाइन किया गया है, न कि केवल मनोरंजन के लिए। यह स्विस एपhemerिस गणना, सख्त कारक सक्रियण और संपादन रेंडरिंग को जोड़ता है ताकि आपका ऐप स्थिर, स्पष्ट और उच्च गुणवत्ता वाली रिपोर्ट आउटपुट प्राप्त करे।

आप किस पर काम कर रहे हैं¶

रनटाइम पर, इंजन वास्तविक खगोलीय स्थिति की गणना करता है और सक्रिय ज्योतिषीय कारकों से अर्थ को जोड़ता है। समान पेलोड के लिए, आउटपुट बाइट-दर-बाइट स्थिर रहते हैं। जब व्यक्तिगत इनपुट प्रदान किए जाते हैं, तो हाउस-स्तर और जन्म-संदर्भ वेक्टर सक्रिय होते हैं ताकि उपयोगकर्ता-विशिष्ट अंतर उत्पन्न हों।

इससे आपकी टीम को निम्नलिखित लाभ मिलते हैं:

पूर्वानुमेय परिणाम: परीक्षण, गुणवत्ता आश्वासन और कैशिंग के लिए - समान अनुरोध हमेशा समान JSON लौटाते हैं।
प्रत्येक अनुभाग पर factor_details ट्रेस के माध्यम से व्याख्यात्मक रिपोर्ट संरचना।
हल्के साइन रिपोर्ट से लेकर प्रीमियम व्यक्तिगत रिपोर्ट तक का स्पष्ट मार्ग।
समय-आधारित गहराई: दैनिक (5-6 कारक), साप्ताहिक (10), मासिक (11) और वार्षिक (13) कारकों के साथ स्पष्ट भार।

एक नज़र में वास्तुकला¶

पूर्ण इंजन वास्तुकला¶

पूर्ण ज्योतिष इंजन वास्तुकला

अनुरोध-से-प्रतिक्रिया वास्तुकला¶

ज्योतिष अनुरोध-से-प्रतिक्रिया वास्तुकला

निश्चित पाइपलाइन¶

गेटेवे प्रमाणीकरण, कोटा और अनुरोध नीति को मान्य करता है।
अनुरोध अनुबंध सत्यापन स्वीकृत स्कीमा और विकल्पों को लागू करता है।
इंजन साइन स्रोत, अवधि विंडो और एपhemerिस कॉन्फ़िगरेशन को हल करता है।
स्विस एपhemerिस स्थितियों, पहलुओं और घरों की गणना करता है (जब योग्य हो)।
एग्रीगेशन लेयर अवधि का नमूना लेता है, घटनाओं (पहलू, इनग्रेश, स्टेशन, लुनेशन, ग्रहण) निकालता है और ड्राइवरों को रैंक करता है।
इंटरप्रिटेशन इंजन निश्चित क्रम, स्पष्ट भार और स्थिर हैश वेरिएंट चयन का उपयोग करके फैक्टर विनिर्देशों को संपादकीय सामग्री में मैप करता है।
संपादकीय इंजन अवधि-विशिष्ट आर्क रचना (ओपनिंग → शिफ्ट → परिणाम) के साथ V2 सामग्री पैक्स से अनुभाग कथाओं को प्रस्तुत करता है।
गेटेवे इंजन पेलोड और एंटरप्राइज रैपर्स (_enterprise, _api_metadata_) के साथ एकीकरण मेटाडेटा के लिए वापस आता है।

निश्चितता की गारंटी¶

निश्चितता कोई दुर्घटना नहीं है - यह हर स्तर पर लागू किया जाता है:

गारंटी	प्रवर्तन तंत्र
समान पेलोड → समान कारक	अवधि के अनुसार स्पष्ट कारक क्रम + निश्चित भार
समान कारक → समान सामग्री विविधताएँ	SHA-256 स्थिर हैश इंडेक्स चयन
समान विविधताएँ → समान वाक्यांश	V2 सामग्री पैक्स से नियतात्मक वाक्यांश चक्रण
समान वाक्यांश → समान JSON	संपादन में स्थिरता + आसन्न अनुभागों का सांस-लाइन डुप्लिकेट हटाना

इसका मतलब है कि आप एक ही बॉडी के साथ दो स्वतंत्र अनुरोधों को हैश कर सकते हैं और समान आउटपुट प्राप्त कर सकते हैं, जिससे विश्वसनीय कैशिंग, QA रिग्रेशन परीक्षण और पुनरुत्पादनीय डिबगिंग संभव हो सके।

सार्वजनिक बनाम व्यक्तिगत रिपोर्ट¶

दोनों उत्पादन-मान्य मोड हैं। अंतर गुणवत्ता में नहीं, बल्कि सक्रियता की गहराई में है।

सार्वजनिक मोड (सिग्नल-आधारित)¶

केवल एक ज्योतिषीय चिह्न और तिथि प्रदान करें। इंजन उस चिह्न के लिए उस अवधि में सभी उपयोगकर्ताओं के लिए एक स्थिर, साझा रीडिंग उत्पन्न करता है।

व्यापक दर्शकों के फीड और लागत प्रभावी कैशिंग के लिए बढ़िया (12 चिह्न × 4 अवधि × 365 दिन = ~17,520 अद्वितीय दैनिक कैश)
कोई घर की गणना नहीं — rising_sign, house_cusps और शरीर house के असाइनमेंट null हैं
तेजी से रोलआउट, पत्रिका-शैली की ज्योतिषीय भविष्यवाणियां और फ्रीमियम स्तरों के लिए मजबूत फिट

व्यक्तिगत मोड (जन्म के अनुसार)¶

गहरे विश्लेषण के लिए जन्म की जानकारी प्रदान करें: birth_time (स्थान, निर्देशांक, समय क्षेत्र)। समान राशि वाले दो उपयोगकर्ताओं को अलग-अलग संपादकीय प्राप्त हो सकते हैं क्योंकि घर का स्थान और उदय राशि स्कोरिंग कारकों को बदल देती है।

आवश्यक फ़ील्ड: birth_time (HH:MM) + birth_latitude + birth_longitude
सक्षम करता है: उदय राशि, 12 घर के कोने, ग्रह-से-घर असाइनमेंट और घर-केंद्रित कारक daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus
प्रीमियम सब्सक्रिप्शन और उच्च प्रतिधारण अनुभव के लिए सबसे उपयुक्त
समृद्ध ऐप मॉड्यूल और व्यक्तिगतकरण फ़नल का समर्थन करता है

कारक-आधारित संपादकीय मॉडल¶

यह इंजन स्पष्ट कारक ढेर पर आधारित है - जो खगोलीय स्नैपशॉट और अवधि के एकत्रीकरण से गणना किए गए निश्चित व्याख्या चालकों द्वारा संचालित होता है। प्रत्येक अवधि में एक परिभाषित कारक क्रम और स्पष्ट भार होते हैं।

अवधि के अनुसार कारक ढेर¶

अवधि	कारक गणना	मुख्य चालक
दैनिक	5-6	`sun_in_sign`, `moon_in_sign`, `transits_archetypes`, `aspects`, `daily_house_focus`
साप्ताहिक	10	`weekly_moon_phase`, `planetary_focus`, `retrograde_archetypes`, `weekly_theme_archetypes`, `weekly_house_focus`
मासिक	11	`monthly_lunation_archetypes`, `eclipse_archetypes`, `outer_planet_focus`, `monthly_theme_archetypes`, `monthly_house_focus`
वार्षिक	13	`jupiter_in_sign`, `saturn_in_sign`, `nodal_axis`, `yearly_house_focus`, `yearly_theme_archetypes`

अतिरिक्त रिपोर्ट परिवारों की परतें समर्पित कारक ढेर: - ग्रह: 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 — composite daily vitality score
archetype_scores — आठ आयामों का विश्लेषण (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)
harmony_discord — शीर्ष 4 सामंजस्यपूर्ण और शीर्ष 4 असंगतिपूर्ण साइन ड्राइवर
elemental_balance — आग/पृथ्वी/हवा/पानी का वितरण
momentum_channels — ग्रहों की गति के संकेत

Payload density control:

daily_stats_detail: "full" for complete chart data with confidence tiers per block
daily_stats_detail: "compact" हल्के क्लाइंट पेरोल के लिए (मोबाइल विजेट के लिए आदर्श)

अनुरोध डिजाइन के मुख्य बिंदु¶

The engine supports clear, typed controls for astrological configuration and rendering behavior. Common options include:

Field	Type	Purpose
`period`	string	`daily`, `weekly`, `monthly`, `yearly`
`sections`	array	Life areas to include (e.g., `general`, `career`, `love_singles`)
`sign` / `birth`	string / object	Sign source (public vs personalized)
`target_date`	string	Explicit date anchor (`YYYY-MM-DD`) for reproducibility
`zodiac_system`	string	`tropical` or `sidereal`
`ayanamsa`	string	Sidereal offset system (`lahiri`, `fagan_bradley`, etc.)
`house_system`	string	`placidus`, `whole_sign`, `equal`, `koch`
`node_type`	string	`true` (actual) or `mean` (average) lunar node
`tenant_id`	string	Cache namespace isolation for multi-tenant or A/B scenarios

Response Shape Guarantees in the Gateway¶

Gateway report responses pass through engine data and append wrappers:

_enterprise — plan tier, quota, and rate-limit metadata
_api_metadata_ — endpoint info, supported languages, and request context

For engine-backed report endpoints, _api_metadata_.supported_languages is English-only:

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

Language and Translation Policy¶

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.

Content Pipeline: V2 Content Packs¶

Editorial content is sourced from structured V2 content packs in the engine's content repository.

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

सटीक मिलान (कारक प्रकार + कारक मान + तीव्रता)
किसी भी मान के लिए factor_type (factor_type + तीव्रता)
किसी भी कारक (खंड + तीव्रता)
सेक्शन फॉलबैक टेम्पलेट

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

Trust Model: Closed Core + Open Source Lite¶

मुख्य उत्पादन इंजन बंद-स्रोत और उद्यम की विश्वसनीयता, गहराई और प्रबंधित संचालन के लिए अनुकूलित है।

It includes:

पूर्ण रूप से अनुकूलित रिपोर्ट (सभी अवधि)
जन्मदिन चक्र रिपोर्ट जिसमें सौर वापसी कारक शामिल हैं
ग्रह, पहलू, ट्रांजिट, घर और ग्रह-घर रिपोर्ट सूट
कॉन्फ़िगर करने योग्य SVG व्हील के साथ जन्म चार्ट
Redis कैशिंग, मेट्रिक्स, स्वास्थ्य जांच और क्षैतिज स्केलिंग

स्वतंत्र ज्योतिषी और डेवलपर मूल्यांकन का समर्थन करने के लिए, हम ओपन-सोर्स लाइट इंजन भी प्रदान करते हैं:

इंजन की गुणवत्ता का मूल्यांकन करने, कारक गणना तर्क का पता लगाने और स्विस एपhemerिस एकीकरण को सत्यापित करने के लिए OpAstro का उपयोग करें।

अधिक समृद्ध रिपोर्ट परतों, व्यापक एंडपॉइंट कवरेज और प्रबंधित उत्पादन संचालन के लिए NumerologyAPI एंटरप्राइज मार्गों में स्केल करें।

एकीकरण मार्ग¶

सार्वजनिक स्तर पर रिपोर्टिंग से शुरुआत करें - दैनिक/साप्ताहिक/मासिक/वार्षिक, केवल sign का उपयोग करके। जन्म डेटा की आवश्यकता नहीं है। कुशलतापूर्वक कैश बनाएं।
व्यक्तिगत जन्म फ़ील्ड जोड़ें - birth_time + निर्देशांक प्रदान करें ताकि घर के कारकों के साथ अलग-अलग संपादकीय सामग्री अनलॉक हो सके।
विशेष रिपोर्ट परिवारों को परत करें - ग्रहों, पहलुओं, ट्रांजिट और घर के एंडपॉइंट्स का उपयोग करके गहन उत्पाद सतहों के लिए।
जन्म एंडपॉइंट जोड़ें - पूर्ण जन्म चार्ट JSON + विज़ुअलाइज़ेशन और उन्नत ज्योतिष वर्कफ़्लो के लिए SVG व्हील।
विभाजन के साथ अनुकूलित करें - केवल उस sections का अनुरोध करें जिसकी आपको UI की आवश्यकता है (उदाहरण के लिए, ["general", "career"]) ताकि पेलोड आकार कम हो सके।
कैश अलगाव के लिए tenant_id का उपयोग करें - बिना कैश प्रदूषण के स्वतंत्र/प्रीमियम स्तरों या A/B परीक्षण वेरिएंट को अलग करें।

कैशिंग रणनीति¶

मोड	कैश दक्षता	रणनीति
सार्वजनिक (सिग्नल-ओनली)	उच्च — लगभग 17,520 अद्वितीय दैनिक कैश	अगले दिन के लिए प्री-वार्मिंग; TTL 1-4 घंटे
व्यक्तिगत (जन्म-जागरूक)	कम — प्रति उपयोगकर्ता	प्रति-उपयोगकर्ता कैश की; TTL 24 घंटे; Redis अनुशंसित