Presentación de nuestro motor de horóscopo¶

Nuestro motor de horóscopo es un entorno de ejecución astrológico determinista, diseñado para productos reales, no para la generación de texto novedoso. Combina la computación de Swiss Ephemeris, activación estricta de factores y renderizado editorial, para que tu aplicación reciba resultados estables, explicables y de alta calidad.

En qué estás trabajando¶

En tiempo de ejecución, el motor calcula el estado celeste real y ensambla significado a partir de los factores astrológicos activados. Para cargas idénticas, los resultados permanecen estables, byte por byte. Cuando se proporcionan entradas de personalización, los vectores a nivel de casa y contexto de nacimiento se activan para producir diferencias específicas del usuario.

Esto proporciona a tu equipo: - Salidas predecibles para pruebas, control de calidad y almacenamiento en caché: las solicitudes idénticas siempre devuelven JSON idéntico. - Composición de informes explicable a través de las trazas factor_details en cada sección. - Una ruta limpia desde informes de firma ligeros hasta informes personalizados premium. - Profundidad consciente del período: pilas de factores diarias (5-6), semanales (10), mensuales (11) y anuales (13) con pesos explícitos.

Arquitectura de Vista Rápida¶

Arquitectura del Motor Completo¶

Arquitectura de Solicitud a Respuesta¶

Tubería Determinista1. El Gateway valida la autenticación, los límites y la política de la solicitud.¶

1. Validación del contrato de la solicitud aplica el esquema y las opciones aceptadas.
2. El motor resuelve la fuente de firma, la ventana de tiempo y la configuración de la ephemeris.
3. Swiss Ephemeris calcula posiciones, aspectos y casas (cuando es elegible).
4. La capa de agregación muestrea el período, extrae eventos (aspectos, ingresos, estaciones, lunaciones, eclipses) y clasifica los conductores.
5. El motor de interpretación mapea las especificaciones de factores al contenido editorial utilizando un orden fijo, pesos explícitos y la selección de variantes de hash estables.
6. El motor editorial genera narrativas de secciones a partir de paquetes de contenido V2 con composición de arco específica del período (inicio → cambio → resultado).
7. El Gateway devuelve el payload del motor más envoltorios empresariales (_enterprise, _api_metadata_) para los metadatos de integración.

Garantías de Determinismo¶

El determinismo no es una coincidencia: se aplica en cada capa:

Esto significa que puede generar un hash de dos solicitudes independientes con el mismo cuerpo y obtener la misma salida, lo que permite el almacenamiento en caché fiable, las pruebas de regresión de QA y la depuración reproducible.

Informes Públicos vs. Personalizados¶

Ambos son modos válidos para producción. La diferencia no es la calidad; es la profundidad de activación.

Modo Público (Basado en el Signo)¶

Proporcione solo un signo zodiacal y una fecha. El motor genera una lectura estable y compartida para todos los usuarios con ese signo en ese período.

• Ideal para feeds de gran audiencia y almacenamiento en caché eficiente (12 signos × 4 períodos × 365 días = ~17.520 cachés únicos diarios)
• Sin cálculos de casas — las asignaciones de rising_sign, house_cusps y el cuerpo house son null
• Excelente para una rápida implementación, horóscopos de estilo de revista y niveles freemium### Modo Personalizado (Basado en la Fecha de Nacimiento)

Proporcione el contexto de nacimiento (birth_time, coordenadas, zona horaria) para activar vectores más profundos. Dos usuarios con el mismo signo pueden recibir diferentes editoriales debido a que la posición de la casa y el signo ascendente modifican la ponderación de los factores.

• Campos obligatorios: birth_time (HH:MM) + birth_latitude + birth_longitude
• Desbloquea: signo ascendente, cúspedes de las 12 casas, asignaciones planeta-casa y factores de enfoque de casa (daily_house_focus, weekly_house_focus, monthly_house_focus, yearly_house_focus)
• Ideal para suscripciones premium y experiencias de alta retención
• Soporta módulos de aplicación más ricos y canales de personalización

Modelo de Editorial Basado en Factores¶

El motor se basa en pilas de factores deterministas, que son interpretaciones computadas a partir de instantáneas celestiales y agregación de períodos. Cada período tiene un orden de factores definido y pesos explícitos.

Pilas de Factores por Período¶

Se incluyen capas adicionales de factores dedicados: - Planeta: planet_core_archetypes, planet_condition_archetypes, planet_house_focus, planet_sign_archetypes - Cumpleaños: solar_return_tone, birthday_year_reset, natal_sun_house_year_theme - Aspecto: Pilas basadas en el aspecto, con aspectos dominantes calculados o sobrescritos. - Tránsitos: Pilas basadas en los tránsitos, con arquetipos de tránsito dominantes calculados o sobrescritos.

Cada factor tiene un peso explícito (por ejemplo, moon_in_sign: 1.15 (diario), yearly_theme_archetypes: 1.30 (anual)) que influye en la puntuación de la sección y en la derivación de la intensidad.

Este modelo evita la deriva aleatoria del texto y mantiene el tono editorial vinculado a los factores calculados, con trazabilidad completa en factor_details.

Estadísticas de la Aplicación Personalizadas Diarias (Horóscopo Principal)¶

Para el modo diario personalizado, el motor devuelve bloques de estadísticas de la aplicación listos para usar en data.daily_personalized_stats. Estos son ideales para tarjetas de panel y widgets de resumen.

Activador: period=daily y la solicitud de nacimiento personalizada incluye tanto birth_time como coordinates. Bloques clave:

• overall_pulse — puntuación compuesta de vitalidad diaria- archetype_scores — análisis en ocho dimensiones (wisdom, creativity, confidence, intuition, allure, romance, career, emotions)

• harmony_discord — los 4 signos más armoniosos y los 4 signos más disonantes principales

• elemental_balance — distribución de fuego/tierra/aire/agua

• momentum_channels — señales de impulso planetario Control de la densidad de la carga:

• daily_stats_detail: "full" para datos completos del gráfico con niveles de confianza por bloque- daily_stats_detail: "compact" para payloads de cliente más ligeros (ideal para widgets móviles)

Puntos destacados del diseño de la solicitud¶

The engine supports clear, typed controls for astrological configuration and rendering behavior. Opciones comunes incluyen:

Garantías de Forma de Respuesta en el Gateway¶

Las respuestas del Gateway incluyen los datos del motor y añaden metadatos:

• _enterprise — información del nivel de plan, cuota y límite de velocidad
• _api_metadata_ — información del punto final, idiomas admitidos y contexto de la solicitud

Para los puntos finales de informes con soporte del motor, _api_metadata_.supported_languages es solo en inglés:

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

Política de Idioma y Traducción¶

Los endpoints de informes respaldados por el motor en vivo actualmente solo admiten lang=en. Esto es intencional para preservar el matiz editorial determinista en producción mientras la fiabilidad de la traducción se cura por separado. La capa de ayuda de traducción del gateway (lang=en|es|de|fr|pt) proporciona salida traducida en el límite de la API para todos los endpoints de informes que no son de horóscopo.

Pipeline de Contenido: Paquetes de Contenido V2¶

Contenido editorial se obtiene de los paquetes de contenido V2 estructurados en el repositorio de contenido del motor. At runtime, the content repository selects variants deterministically via stable hash selection with a four-level fallback chain:

1. Coincidencia exacta (tipo_factor + valor_factor + intensidad)

---2. Cualquier valor para factor_type (factor_type + intensidad)3. Cualquier factor en la sección (sección + intensidad)

1. Plantilla de respaldo para secciones

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

Modelo de Confianza: Núcleo Cerrado + Código Abierto Ligero¶

Nuestro motor principal de producción es de código cerrado y está optimizado para fiabilidad empresarial, profundidad y operaciones gestionadas. Incluye:

• Informes personalizados completos, considerando todos los factores (todos los períodos)
• Informes del ciclo de cumpleaños con factores de retorno solar
• Conjuntos de informes de planeta, aspecto, tránsito, casa y planeta-casa
• Carta natal con renderizado configurable de SVG
• Caching de Redis, métricas, comprobaciones de estado y escalado horizontal

Para apoyar a los astrólogos independientes y la evaluación del desarrollador, también proporcionamos el motor de código abierto lite:

• Sitio de OpAstro
• GitHub de OpAstro
• PyPI de OpAstro

Utilice OpAstro para evaluar la calidad del motor, explorar la lógica de cálculo de factores y verificar la integración de Swiss Ephemeris. Escala a las rutas empresariales de NumerologyAPI para capas de informes más ricas, mayor cobertura de puntos finales y operaciones de producción gestionadas.

Camino de Integración1. Comience con informes de nivel público — diarios/semanales/mensuales/anuales utilizando únicamente sign. No se requiere información de nacimiento. Almacenamiento eficiente.¶

1. Añada campos de nacimiento personalizados — proporcione birth_time + coordenadas para desbloquear editoriales diferenciadas con factores conscientes de la casa.
2. Cree familias de informes especializados — planetarios, aspectos, transitos y puntos finales de la casa para superficies de producto más profundas.
3. Añada puntos finales de nacimiento — JSON completo del diagrama de nacimiento + rueda SVG para visualización y flujos de trabajo astrológicos avanzados.
4. Optimice con secciones — solicite únicamente la sections que necesite su interfaz de usuario (p. ej., ["general", "career"]) para reducir el tamaño del payload.
5. Utilice tenant_id para el aislamiento de la caché — niveles gratuitos/premium o variantes de pruebas A/B separados sin contaminación de caché.

Estrategia de Caché¶

Lectura Adicional¶

• Resumen de la API de Informes de Horóscopo
• Horóscopo de Hoy
• Horóscopo Semanal
• Horóscopo Mensual
• Horóscopo Anual
• Horóscopo de Cumpleaños
• Carta Natal