title: Introducing Our Horoscope Engine | Deterministic Swiss Ephemeris Reports description: Temui mesin horoskop NumerologyAPI: astrologi Swiss Ephemeris yang deterministik, mode laporan publik dan pribadi, keluarga endpoint berbasis periode, arsitektur, dan panduan integrasi produksi.

Memperkenalkan Mesin Horoskop Kami¶

Mesin horoskop kami adalah runtime astrologi deterministik yang dirancang untuk produk produksi nyata, bukan pembuatan teks hiburan. Ini menggabungkan perhitungan Swiss Ephemeris, aktivasi faktor yang ketat, dan rendering editorial sehingga aplikasi Anda menerima output laporan yang stabil, dapat dijelaskan, dan berkualitas tinggi.

Apa yang Anda Bangun¶

Pada saat runtime, mesin menghitung kondisi langit yang sebenarnya dan menyusun makna dari faktor astrologi yang diaktifkan. Untuk payload yang identik, output tetap stabil byte demi byte. Ketika input personalisasi diberikan, vektor tingkat rumah dan konteks kelahiran diaktifkan untuk menghasilkan perbedaan khusus pengguna.

Ini memberi tim Anda:

• Hasil yang dapat diprediksi untuk pengujian, QA, dan caching — permintaan yang sama selalu menghasilkan JSON yang identik.
• Komposisi laporan yang mudah dijelaskan melalui jejak factor_details di setiap bagian.
• Jalur yang bersih dari laporan tanda tangan ringan hingga laporan personalisasi premium.
• Kedalaman yang sadar akan periode — tumpukan faktor harian (5-6 faktor), mingguan (10), bulanan (11), dan tahunan (13) dengan bobot eksplisit.

Gambaran Umum Arsitektur¶

Arsitektur Mesin Lengkap¶

Arsitektur Permintaan-ke-Respons¶

Pipeline Deterministik¶

1. Gerbang memvalidasi autentikasi, batasan penggunaan, dan kebijakan permintaan.
2. Validasi kontrak permintaan menegakkan skema dan opsi yang diterima.
3. Mesin menyelesaikan sumber tanda, jendela periode, dan konfigurasi ephemeris.
4. Swiss Ephemeris menghitung posisi, aspek, dan rumah (ketika memenuhi syarat).
5. Lapisan agregasi mengambil sampel periode, mengekstrak peristiwa (aspek, ingress, stasiun, lunasi, gerhana), dan memberi peringkat driver.
6. Mesin interpretasi memetakan spesifikasi faktor ke konten editorial menggunakan urutan tetap, bobot eksplisit, dan pemilihan varian hash yang stabil.
7. Mesin editorial menghasilkan narasi bagian dari paket konten V2 dengan komposisi arc khusus periode (membuka → pergeseran → hasil).
8. Gerbang mengembalikan payload mesin ditambah pembungkus perusahaan (_enterprise, _api_metadata_) untuk metadata integrasi.

Jaminan Determinisme¶

Determinisme bukanlah kebetulan — ia ditegakkan di setiap lapisan:

Ini berarti Anda dapat membuat hash dua permintaan independen dengan badan yang sama dan mendapatkan hasil yang sama, memungkinkan caching yang andal, pengujian regresi QA, dan debugging yang dapat direproduksi.

Laporan Publik vs Personalisasi¶

Kedua mode ini valid untuk produksi. Perbedaannya bukan kualitas; melainkan tingkat aktivasi.

Mode Publik (Berdasarkan Zodiak)¶

Hanya berikan zodiak dan tanggal. Mesin menghasilkan pembacaan yang stabil dan bersama untuk semua pengguna dengan zodiak tersebut pada periode tersebut.

• Sangat baik untuk umpan audiens luas dan caching yang hemat biaya (12 zodiak × 4 periode × 365 hari = ~17.520 cache unik harian)
• Tidak ada perhitungan rumah — penugasan rising_sign, house_cusps, dan tubuh house adalah null
• Cocok untuk peluncuran cepat, horoskop bergaya majalah, dan tingkatan freemium

Mode Personalisasi (Berdasarkan Tanggal Lahir)¶

Berikan konteks kelahiran (birth_time, koordinat, zona waktu) untuk mengaktifkan vektor yang lebih mendalam. Dua pengguna dengan zodi yang sama dapat menerima editorial yang berbeda karena posisi rumah dan tanda zodi mengubah bobot faktor.

• Bidang wajib: birth_time (HH:MM) + birth_latitude + birth_longitude
• Membuka: tanda zodi, titik cusp rumah ke-12, penugasan planet ke rumah, dan faktor fokus rumah (daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus)
• Terbaik untuk langganan premium dan pengalaman retensi yang tinggi
• Mendukung modul aplikasi yang lebih kaya dan saluran personalisasi

Model Editorial Berbasis Faktor¶

Mesin didorong oleh tumpukan faktor eksplisit — pendorong interpretasi deterministik yang dihitung dari snapshot langit dan agregasi periode. Setiap periode memiliki urutan faktor dan bobot yang ditentukan.

Tumpukan Faktor per Periode¶

Lapisan faktor tambahan: - Planet: planet_core_archetypes, planet_condition_archetypes, planet_house_focus, planet_sign_archetypes - Tanggal Lahir: solar_return_tone, birthday_year_reset, natal_sun_house_year_theme - Aspek: Stack yang dipimpin oleh aspek dengan aspek dominan yang dihitung atau ditimpa - Transit: Stack yang dipimpin oleh transit dengan arketipe transit dominan yang dihitung atau ditimpa

Setiap faktor memiliki bobot eksplisit (misalnya, moon_in_sign: 1.15 harian, yearly_theme_archetypes: 1.30 tahunan) yang memengaruhi penilaian bagian dan derivasi intensitas.

Model ini menghindari pergeseran prosa acak dan menjaga nada editorial terkait dengan faktor-faktor yang dihitung dengan jejak lengkap dalam factor_details.

Statistik Aplikasi Pribadi Harian (Horoskop Utama)¶

Untuk mode pribadi harian, mesin mengembalikan blok statistik aplikasi yang kaya pada data.daily_personalized_stats. Ini ideal untuk kartu dasbor dan widget ringkasan.

Pemicu aktivasi: period=daily dan permintaan kelahiran yang dipersonalisasi mencakup kedua birth_time dan coordinates.

Blok-blok penting:

• overall_pulse — skor vitalitas harian gabungan
• archetype_scores — analisis delapan dimensi (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)
• harmony_discord — 4 tanda yang paling harmonis dan 4 tanda yang paling tidak harmonis sebagai penggerak utama
• elemental_balance — distribusi api/bumi/udara/air
• momentum_channels — sinyal momentum planet

Kontrol kepadatan payload:

• daily_stats_detail: "full" untuk data grafik lengkap dengan tingkatan kepercayaan per blok
• daily_stats_detail: "compact" untuk payload klien yang lebih ringan (ideal untuk widget seluler)

Sorotan Desain Permintaan¶

The engine supports clear, typed controls for astrological configuration and rendering behavior. Opsi umum meliputi:

Jaminan Bentuk Respons di Gateway¶

Respons laporan gateway melewati data mesin dan menambahkan wrapper:

• _enterprise — metadata tingkat rencana, kuota, dan batas tarif
• _api_metadata_ — informasi endpoint, bahasa yang didukung, dan konteks permintaan

Untuk endpoint laporan berbasis mesin, _api_metadata_.supported_languages hanya dalam Bahasa Inggris:

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

Kebijakan Bahasa dan Penerjemahan¶

Fitur endpoint laporan yang didukung oleh mesin saat ini hanya mendukung lang=en. 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.

Alur Konten: Paket Konten V2¶

Konten editorial diambil dari paket konten terstruktur V2 di repositori konten mesin. At waktu eksekusi, repositori konten memilih varian secara deterministik melalui pemilihan hash yang stabil dengan rantai fallback empat tingkat:

1. Pencocokan persis (tipe faktor + nilai faktor + intensitas)
2. Setiap nilai untuk factor_type (ditambah dengan intensity)
3. Setiap faktor dalam bagian (bagian + intensitas)
4. Templat cadangan bagian

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

Model Kepercayaan: Inti Tertutup + Sumber Terbuka Ringan¶

Our main production engine is closed-source and optimized for enterprise reliability, depth, and managed operations. It includes:

• Laporan personalisasi lengkap yang mempertimbangkan semua periode
• Laporan siklus kelahiran dengan faktor solar return
• Kumpulan laporan planet, aspek, transit, rumah, dan hubungan planet-rumah
• Bagan kelahiran dengan rendering roda SVG yang dapat dikonfigurasi
• Penyimpanan Redis, metrik, pemeriksaan kesehatan, dan penskalaan horizontal

Untuk mendukung astrolog independen dan evaluasi pengembang, kami juga menyediakan mesin sumber terbuka ringan:

• Situs OpAstro
• GitHub OpAstro
• PyPI OpAstro

Gunakan OpAstro untuk mengevaluasi kualitas mesin, menjelajahi logika perhitungan faktor, dan memverifikasi integrasi Swiss Ephemeris. Skalakan ke rute NumerologyAPI untuk lapisan laporan yang lebih kaya, cakupan titik akhir yang lebih luas, dan operasi produksi yang dikelola.

Jalur Integrasi¶

1. Mulai dengan laporan tingkat publik — harian/mingguan/bulanan/tahunan menggunakan hanya sign. Data kelahiran tidak diperlukan. Optimalkan cache.
2. Tambahkan bidang kelahiran yang dipersonalisasi — sediakan birth_time + koordinat untuk membuka editorial yang berbeda dengan mempertimbangkan faktor rumah.
3. Lapisan keluarga laporan khusus — titik akhir planet, aspek, transit, dan rumah untuk permukaan produk yang lebih dalam.
4. Tambahkan titik akhir kelahiran — JSON bagan kelahiran lengkap + roda SVG untuk visualisasi dan alur kerja astrologi tingkat lanjut.
5. Optimalkan dengan bagian — minta hanya sections yang dibutuhkan UI Anda (misalnya, ["general", "career"]) untuk mengurangi ukuran payload.
6. Gunakan tenant_id untuk isolasi cache — pisahkan tingkatan gratis/premium atau varian A/B tanpa polusi cache.

Strategi Penyimpanan Cache¶

Membaca Selanjutnya¶

• Ikhtisar API Laporan Horoskop
• Horoskop Hari Ini
• Horoskop Mingguan
• Horoskop Bulanan
• Horoskop Tahunan
• Horoskop Ulang Tahun
• Grafik Kelahiran Natal