Einführung in unsere Horoskop-Engine¶

Unsere Horoskop-Engine ist ein deterministischer Astrologie-Runtime, der für echte Produktionsanwendungen entwickelt wurde, nicht für die Generierung von spielerischem Text. Er kombiniert Swiss-Ephemeris-Berechnungen, strenge Faktor-Aktivierung und editoriales Rendering, sodass Ihre App stabile, nachvollziehbare und hochwertige Berichtsausgaben erhält.

Worauf Sie aufbauen¶

Zur Laufzeit berechnet die Engine reale Himmelszustände und setzt Bedeutung aus aktivierten astrologischen Faktoren zusammen. Bei identischen Payloads bleiben die Ausgaben Byte für Byte stabil. Wenn Personalisierungs-Eingaben bereitgestellt werden, aktivieren Haus- und Geburtskontext-Vektoren benutzerspezifische Unterschiede.

Dies bietet Ihrem Team:

• Vorhersagbare Ausgaben für Tests, QS und Caching – identische Anfragen geben immer identische JSON-Antworten zurück.
• Nachvollziehbare Berichtszusammensetzung durch factor_details-Nachverfolgung in jedem Abschnitt.
• Ein klarer Pfad von einfachen Sternzeichen-Berichten hin zu personalisierten Premium-Berichten.
• Periodenbewusste Tiefe – tägliche (5-6 Faktoren), wöchentliche (10), monatliche (11) und jährliche (13) Faktor-Stacks mit expliziten Gewichtungen.

Architektur auf einen Blick¶

Vollständige Engine-Architektur¶

Anfrage-zu-Antwort-Architektur¶

Deterministische Pipeline¶

1. Gateway validiert Authentifizierung, Quotas und Anfrage-Richtlinie.
2. Validierung des Anfrage-Vertrags erzwingt das akzeptierte Schema und die Optionen.
3. Engine löst Sternzeichen-Quelle, Periodenfenster und Ephemeris-Konfiguration auf.
4. Swiss Ephemeris berechnet Positionen, Aspekte und Häuser (wenn zulässig).
5. Aggregationsschicht tastet die Periode ab, extrahiert Ereignisse (Aspekte, Ingresse, Stationen, Lunationen, Finsternisse) und stuft Treiber ein.
6. Interpretations-Engine ordnet Faktor-Spezifikationen editorialem Inhalt zu, unter Verwendung fester Reihenfolge, expliziter Gewichtungen und stabiler Hash-Variantenauswahl.
7. Editorial-Engine rendert Abschnitts-Narrative aus V2-Inhaltspaketen mit periodenspezifischer Bogenkomposition (Eröffnung → Wendepunkt → Ergebnis).
8. Gateway gibt Engine-Payload sowie Enterprise-Wrapper (_enterprise, _api_metadata_) für Integrationsmetadaten zurück.

Determinismus-Garantien¶

Determinismus ist kein Zufall – er wird auf jeder Ebene durchgesetzt:

Das bedeutet, Sie können zwei unabhängige Anfragen mit demselben Inhalt hashen und erhalten dieselbe Ausgabe, was zuverlässiges Caching, QS-Regressionstests und reproduzierbares Debugging ermöglicht.

Öffentliche vs. personalisierte Berichte¶

Beide Modi sind produktionsgeeignet. Der Unterschied liegt nicht in der Qualität, sondern in der Aktivierungstiefe.

Öffentlicher Modus (sternzeichenbasiert)¶

Geben Sie nur ein Sternzeichen und ein Datum an. Die Engine erzeugt eine stabile, gemeinsame Lesung für alle Nutzer mit diesem Sternzeichen in dieser Periode.

• Ideal für breite Zielgruppen-Feeds und kosteneffizientes Caching (12 Sternzeichen × 4 Perioden × 365 Tage = ~17.520 eindeutige tägliche Caches)
• Keine Hausberechnungen – rising_sign, house_cusps und Körper-house-Zuweisungen sind null
• Gut geeignet für schnellen Rollout, Magazin-artige Horoskope und Freemium-Stufen

Personalisierter Modus (geburtsbewusst)¶

Geben Sie Geburtskontext (birth_time, Koordinaten, Zeitzone) an, um tiefere Vektoren zu aktivieren. Zwei Nutzer mit demselben Sternzeichen können unterschiedliche editoriale Berichte erhalten, da Hausplatzierung und Aszendentenzeichen die Faktor-Bewertung verändern.

• Erforderliche Felder: birth_time (HH:MM) + birth_latitude + birth_longitude
• Schaltet frei: Aszendent, 12 Haus-Spitzen, Planet-zu-Haus-Zuweisungen und Haus-Fokus-Faktoren (daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus)
• Ideal für Premium-Abonnements und Anwendungen mit hoher Nutzerbindung
• Unterstützt umfassendere App-Module und Personalisierungs-Trichter

Faktor-gesteuertes Editorial-Modell¶

Die Engine wird von expliziten Faktor-Stacks angetrieben – deterministischen Interpretations-Treibern, die aus Himmels-Momentaufnahmen und Perioden-Aggregation berechnet werden. Jede Periode hat eine definierte Faktorreihenfolge und explizite Gewichtungen.

Faktor-Stacks nach Periode¶

Zusätzliche Berichtsfamilien.layerieren dedizierte Faktor-Stacks: - Planet: planet_core_archetypes, planet_condition_archetypes, planet_house_focus, planet_sign_archetypes - Geburtstag: solar_return_tone, birthday_year_reset, natal_sun_house_year_theme - Aspekt: Aspekt-geführte Stacks mit berechnetem oder überschriebenem dominanten Aspekt - Transit: Transit-geführte Stacks mit berechnetem oder überschriebenem dominanten Transit-Archetyp

Jeder Faktor trägt eine explizite Gewichtung (z. B. moon_in_sign: 1.15 täglich, yearly_theme_archetypes: 1.30 jährlich), die die Abschnitts-Bewertung und Intensitätsableitung beeinflusst.

Dieses Modell vermeidet zufällige Text-Abweichungen und hält den editorialen Ton an berechnete Treiber gebunden, mit vollständiger Nachverfolgbarkeit in factor_details.

Tägliche personalisierte App-Statistiken (Haupthoroskop)¶

Für den täglichen personalisierten Modus liefert die Engine umfangreiche, app-fertige Statistik-Blöcke unter data.daily_personalized_stats. Diese eignen sich ideal für Dashboard-Karten und Zusammenfassungs-Widgets.

Aktivierungsauslöser: period=daily und personalisierte Geburtsanfrage enthält sowohl birth_time als auch coordinates.

Wichtige Blöcke:

• overall_pulse – zusammengesetzter täglicher Vitalwert
• archetype_scores – Aufschlüsselung in acht Dimensionen (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)
• harmony_discord – die 4 harmonischsten und 4 disharmonischsten Sternzeichen-Treiber
• elemental_balance – Feuer/Erde/Luft/Wasser-Verteilung
• momentum_channels – planetare Impuls-Signale

Payload-Dichtesteuerung:

• daily_stats_detail: "full" für vollständige Diagrammdaten mit Vertrauensstufen pro Block
• daily_stats_detail: "compact" für leichtere Client-Payloads (ideal für mobile Widgets)

Hinweise zum Anfrage-Design¶

Die Engine unterstützt klare, typisierte Steuerungen für astrologische Konfiguration und Rendering-Verhalten. Häufige Optionen sind:

Antwortstruktur-Garantien im Gateway¶

Gateway-Berichtantworten durchlaufen Engine-Daten und fügen Wrapper hinzu:

• _enterprise – Plan-Stufe, Quota- und Ratenbegrenzungs-Metadaten
• _api_metadata_ – Endpunkt-Informationen, unterstützte Sprachen und Anfragekontext

Für engine-gestützte Bericht-Endpunkte ist _api_metadata_.supported_languages nur auf Englisch verfügbar:

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

Sprach¶

• und Übersetzungsrichtlinie

Live engine-gestützte Bericht-Endpunkte unterstützen derzeit nur lang=en. Dies ist beabsichtigt, um die deterministische editoriale Nuance in der Produktion zu bewahren, während die Übersetzungszuverlässigkeit separat kuratiert wird. Die Gateway-Übersetzungsschicht (lang=en|es|de|fr|pt) liefert übersetzte Ausgaben an der API-Grenze für alle Nicht-Horoskop-Berichtsendpunkte.

Inhalts-Pipeline: V2-Inhaltspakete¶

Editorialer Inhalt wird aus strukturierten V2-Inhaltspaketen im Inhalts-Repository der Engine bezogen.

Zur Laufzeit wählt das Inhalts-Repository Varianten deterministisch über stabile Hash-Auswahl mit einer vierstufigen Fallback-Kette:

1. Exakte Übereinstimmung (factor_type + factor_value + intensity)
2. Beliebiger Wert für factor_type (factor_type + intensity)
3. Beliebiger Faktor im Abschnitt (section + intensity)
4. Abschnitts-Fallback-Vorlage

Diese Struktur gewährleistet editoriale Vielfalt über Intensitäten hinweg, bewahrt aber die Reproduzierbarkeit für denselben Seed.

Vertrauensmodell: Geschlossener Kern + Open-Source-Lite¶

Unsere Haupt-Produktions-Engine ist Closed-Source und optimiert für Enterprise-Zuverlässigkeit, Tiefe und verwalteten Betrieb. Sie umfasst:

• Vollständige hausbewusste personalisierte Berichte (alle Perioden)
• Geburtstagszyklus-Berichte mit Solar-Return-Faktoren
• Planet-, Aspekt-, Transit-, Haus- und Planet-Haus-Berichtssuiten
• Geburtshoroskop mit konfigurierbarem SVG-Rad-Rendering
• Redis-Caching, Metriken, Health-Checks und horizontale Skalierung

Zur Unterstützung unabhängiger Astrologen und zur Entwickler-Evaluierung stellen wir auch die Open-Source-Lite-Engine bereit:

• OpAstro-Website
• OpAstro GitHub
• OpAstro PyPI

Verwenden Sie OpAstro, um die Engine-Qualität zu evaluieren, die Faktor-Berechnungslogik zu erkunden und die Swiss-Ephemeris-Integration zu überprüfen. Skalieren Sie auf NumerologyAPI-Enterprise-Routen für umfangreichere Berichtsschichten, breitere Endpunktabdeckung und verwalteten Produktionsbetrieb.

Integrationspfad¶

1. Beginnen Sie mit öffentlichen Berichten auf Sternzeichen-Ebene – täglich/wöchentlich/monatlich/jährlich nur mit sign. Keine Geburtsdaten erforderlich. Effizient cachen.
2. Fügen Sie personalisierte Geburtsfelder hinzu – geben Sie birth_time + Koordinaten an, um differenzierte editoriale Berichte mit hausbezogenen Faktoren freizuschalten.
3. Erweitern Sie mit spezialisierten Berichtsfamilien – Planeten-, Aspekt-, Transit- und Haus-Endpunkte für tiefere Produktoberflächen.
4. Fügen Sie Natal-Endpunkte hinzu – vollständiges Geburtshoroskop-JSON + SVG-Rad für Visualisierung und fortgeschrittene Astrologie-Workflows.
5. Optimieren Sie mit Abschnitten – fordern Sie nur die sections an, die Ihre UI benötigt (z. B. ["general", "career"]), um die Payload-Größe zu reduzieren.
6. Verwenden Sie tenant_id für Cache-Isolation – trennen Sie kostenlose/Premium-Stufen oder A/B-Test-Varianten ohne Cache-Verschmutzung.

Caching-Strategie¶

Weiterführende Links¶

• Horoskop-Berichte API-Übersicht
• Tageshoroskop
• Wochenhoskop
• Monatshoroskop
• Jahreshoroskop
• Geburtstagshoroskop
• Geburtshoroskop