Horoskop Motorumuzu Tanıtıyoruz¶

Horoskop motorumuz, gerçek üretim ürünler için tasarlanmış, deterministik bir astrolog çalışma zamanıdır ve sadece eğlenceli metin üretimi için değildir. Swiss Ephemeris hesaplaması, katı faktör aktivasyonu ve düzenleyici renderlama ile uygulamanızın kararlı, açıklanabilir ve üst düzey rapor çıktısı almasını sağlar.

Üzerinde Çalıştığınız Şeyler¶

Çalışma zamanında, motor gerçek göksel durumu hesaplar ve etkinleştirilmiş astrologik faktörlerden anlam oluşturur. Eşit yüklemeler için çıktılar bit-bit olarak kararlıdır. Kişiselleştirme girdileri sağlandığında, ev seviyesindeki ve doğum bağlam vektörleri etkinleşerek kullanıcıya özgü farklılıklar üretir.

Bu, ekibinize şunları sağlar:

• Tahmin edilebilir çıktılar test, kalite kontrol ve önbellekleme için: aynı istekler her zaman aynı JSON'ı döndürür.
• Her bölümdeki factor_details izleri aracılığıyla açıklanabilir rapor oluşturma.
• Hafif imza raporlarından yüksek kaliteli kişiselleştirilmiş raporlara kadar olan temiz bir yol.
• Zaman dilimine uygun derinlik: günlük (5-6 faktör), haftalık (10), aylık (11) ve yıllık (13) faktör kümeleri, açık ağırlıklarla.

Genel Mimari¶

Tam Horoskop Motoru Mimarisi¶

İstek-Cevap Mimarisi¶

Deterministik Boru Hattı¶

1. Giriş Noktası, kimlik doğrulama, kotaları ve istek politikasını doğrular.
2. İstek sözleşmesi doğrulaması, kabul edilen şemayı ve seçenekleri zorunlu kılar.
3. Motor, işaret kaynağını, zaman aralığını ve ephemeris yapılandırmasını çözümler.
4. Swiss Ephemeris, konumları, açıları ve evleri (uygun olduğunda) hesaplar.
5. Toplama katmanı, zaman aralığını örnekler, olayları (açılar, girişler, istasyonlar, ay tutulmaları, güneş tutulmaları), sürücüleri çıkarır ve sıralar.
6. Yorumlama motoru, sabit bir sırada, açık ağırlıklarla ve kararlı hash seçimiyle faktör özelliklerini düzen içeriğine eşler.
7. Düzenleme motoru, zaman aralığına özgü arc kompozisyonu (açılış → değişim → sonuç) ile V2 içerik paketlerinden bölge anlatımlarını oluşturur.
8. Giriş Noktası, motor yükünü ve entegrasyon meta verileri için şirket wrapper'larını (_enterprise, _api_metadata_) döndürür.

Belirginlik Garantisi¶

Belirginlik bir tesadüf değil — her katmanda zorunlu kılınır:

Bu, aynı gövdeye sahip iki bağımsız isteği hashleyebilmenizi ve aynı çıktı elde etmenizi sağlar, bu da güvenilir önbellekleme, QA regresyon testi ve tekrarlanabilir hata ayıklama olanağı sunar.

Kamuya Açık vs Kişiselleştirilmiş Raporlar¶

Her ikisi de üretim için geçerlidir. Fark, kalitede değil, etkinlik derinliğindedir.

Kamuya Açık Mod (İmza Tabanlı)¶

Sadece bir burç ve tarih sağlayın. Motor, aynı burcun o dönemdeki tüm kullanıcılar için kararlı, ortak bir yorum üretir.

• Geniş kitlelere yönelik beslemeler ve maliyet açısından verimli önbellekleme için harika (12 burç × 4 dönem × 365 gün = ~17.520 benzersiz günlük önbellek)
• Ev hesaplamaları yok — rising_sign, house_cusps ve vücut house atamaları null'ye göre yapılır
• Hızlı dağıtım, dergi tarzı horoskoplar ve freemium katmanları için güçlü bir uyum

Kişiselleştirilmiş Mod (Doğum Bilgilerine Dayalı)¶

Doğum bağlamını (birth_time, koordinatlar, zaman dilimi) sağlayarak daha derin vektörleri etkinleştirin. Aynı burcun iki kullanıcının farklı editörler alabilmesi, ev yerleşimi ve yükselen burç nedeniyle faktör puanlarını değiştirdiğinden mümkündür.

• Gerekli alanlar: birth_time (HH:MM) + birth_latitude + birth_longitude
• Kilistirilmiş özellikler: yükselen burç, 12 ev köşesi, gezegen-ev atamaları ve ev odaklı faktörler (daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus)
• En iyi premium abonelikler ve yüksek tutma oranları için
• Daha zengin uygulama modülleri ve kişiselleştirme akışlarını destekler

Faktör Odaklı Editöryal Model¶

Motor, açık faktör yığınları tarafından yönlendirilir — göksel anlara ve periyot toplama işlemlerinden hesaplanan deterministik yorumlama sürücüleri. Her periyodun tanımlanmış bir faktör sırası ve açık ağırlıkları vardır.

Periyotlara Göre Faktör Yığınları¶

Ek rapor aileleri, özel faktör yığınlarını oluşturur: - Geçiş: planet_core_archetypes, planet_condition_archetypes, planet_house_focus, planet_sign_archetypes - Doğum Günü: solar_return_tone, birthday_year_reset, natal_sun_house_year_theme - Görünüm: Hesaplamalı veya geçersiz kılınmış baskın görünüm ile görüme tabanlı yığınlar - Geçiş: Hesaplamalı veya geçersiz kılınmış baskın geçiş arketipi ile geçiş tabanlı yığınlar

Her faktöre açık bir ağırlık (örneğin, moon_in_sign: 1.15 günlük, yearly_theme_archetypes: 1.30 yıllık) dahildir ve bu da bölüm puanlamasını ve yoğunluk türetilmesini etkiler.

Bu model, rastgele metin akışını önler ve hesaplanmış sürücüleri korurken, düzenleme tonunu tamamen izlenebilir hale getirir (factor_details).

Günlük Kişiselleştirilmiş Uygulama İstatistikleri (Ana Horoskop)¶

Günlük kişiselleştirilmiş mod için, motor data.daily_personalized_stats'da uygulama uyumlu istatistik bloklarını döndürür. Bunlar, pano kartları ve özet widget'ler için idealdir.

Etkinleştirme tetikleyicisi: period=daily ve kişiselleştirilmiş doğum isteği, hem birth_time hem de coordinates içerir. Temel bloklar:

• overall_pulse — günlük canlılık puanı (karma)
• archetype_scores — sekiz boyutlu ayrım (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)
• harmony_discord — en uyumlu ve en uyumsuz 4 burç kombinasyonu
• elemental_balance — ateş/toprak/hava/su dağılımı
• momentum_channels — gezegenlerin hareket sinyalleri

Kontrol edilen yük yoğunluğu:

• daily_stats_detail: "full", blok başına güven seviyeleriyle birlikte tüm grafik verileri için
• daily_stats_detail: "compact" daha hafif istemci yükleri için (mobil widget'ler için ideal)

İstek Tasarımı Önemli Noktaları¶

Açık ve tiplendirilmiş kontrollerle, gökbilimsel yapılandırma ve görselleştirme davranışını destekler. Yaygın seçenekler şunlardır:

Geçişte Yanıt Şekli Garantileri¶

Geçiş rapor yanıtları, motor verilerini geçirir ve şablonlar ekler:

• _enterprise — plan seviyesi, kota ve hız sınırlı bilgileri
• _api_metadata_ — uç nokta bilgisi, desteklenen diller ve istek bağlamı

Motor tarafından desteklenen rapor uç noktaları için, _api_metadata_.supported_languages yalnızca İngilizce'dir:

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

Dil ve Çeviri Politikası¶

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.

İçerik Akışı: V2 İçerik Paketleri¶

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:

1. Exact match (factor_type + factor_value + intensity)
2. Any value for factor_type (factor_type + intensity)
3. Any factor in section (section + intensity)
4. Section fallback template

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

Güven Modeli: Kapalı Çekirdek + Açık Kaynak Hafif¶

Our main production engine is closed-source and optimized for enterprise reliability, depth, and managed operations. Aşağıdaki içerikleri içermektedir:

• Tüm dönemler için kapsamlı, kişiselleştirilmiş raporlar (tam uyum)
• Güneş dönüşü faktörleri içeren doğum döngüsü raporları
• Gezegen, aspekt, transit, ev ve gezegen-ev raporları
• Ayarlanabilir SVG çember ile doğum haritası
• Redis önbellekleme, metrikler, sağlık kontrolleri ve yatay ölçeklendirme

Bağımsız astrologların ve geliştirici değerlendirmesini desteklemek için ayrıca açık kaynaklı lite motorunu da sunuyoruz:

• OpAstro sitesi
• OpAstro GitHub
• OpAstro PyPI

OpAstro'yu motor kalitesini değerlendirmek, faktör hesaplama mantığını keşfetmek ve Swiss Ephemeris entegrasyonunu doğrulamak için kullanın. Daha zengin rapor katmanları, daha geniş uç nokta kapsamı ve yönetilen üretim operasyonları için NumerologyAPI kurumsal rotalarına ölçeklendirin.

Entegrasyon Yolu¶

1. Herkese açık, işaret seviyesindeki raporlarla başlayın – günlük/haftalık/aylık/yıllık olarak yalnızca sign kullanılarak. Doğum verileri gerektirmez. Verimli bir şekilde önbelleğe alın.
2. Kişiselleştirilmiş doğum alanlarını ekleyin – birth_time + koordinatları sağlayarak, evleri dikkate alan faktörlerle farklılaştırılmış editörler elde edin.
3. Uzmanlaşmış rapor ailelerini katmanlayın – gezegenler, açısal ilişkiler, geçişler ve ev uç noktaları ile daha derin ürün yüzeyleri için.
4. Natal uç noktalarını ekleyin – tam doğum haritası JSON + görselleştirme ve gelişmiş astrologi iş akışları için SVG tekerleği.
5. Bölümlerle optimize edin – yalnızca arayüzünüzün ihtiyaç duyduğu sections'u (örneğin, ["general", "career"]) isteyerek veri yük boyutunu azaltın.
6. tenant_id'yi kullanarak önbelleği izole edin – ücretsiz/premium katmanları veya A/B test varyasyonlarını önbellek kirliliği olmadan ayrı tutun.

Önbellekleme Stratejisi¶

Devam Etmek İçin¶

• Horoskop Raporları API'si Genel Bakış
• Bugünün Horoskopu
• Haftalık Horoskop
• Aylık Horoskop
• Yıllık Horoskop
• Doğum Günü Horoskopu
• Natal Doğum Haritası