Astral Ephemeris Service

Serviço de cálculo astrológico baseado em Swiss Ephemeris via Kerykeion.

Este repositório é software livre sob AGPL-3.0, conforme exigido pelo uso do Swiss Ephemeris e do pyswisseph. Ele é mantido separado do restante da plataforma Astral para respeitar a licença e manter o produto principal fechado.

Endpoints

• GET /health — healthcheck (único isento de auth)
• POST /natal-chart — calcula Mapa Natal e retorna JSON (contrato v2) + SVG
• POST /transits — trânsitos dos planetas lentos num período (usado pelo tier Premium e pelo painel de consultoria)
• POST /big-three — só Sol/Lua/Ascendente (lead magnet), sem SVG/aspectos
• POST /pdf — renderiza o PDF do Mapa Natal a partir de um SVG e de uma interpretação (HTML ou texto). A interpretação é sanitizada: tags/atributos perigosos são removidos, mantendo a formatação (h2, p, ul, strong...).

Payload do /pdf

{
  "name": "Nome",
  "birthDate": "1990-01-01",
  "birthTime": "12:00",
  "city": "São Paulo, SP",
  "svg": "<svg ...>...</svg>",
  "interpretation": "<h2>...</h2><p>...</p>"
}

Retorna { "pdf_base64": "..." }.

Executar localmente

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

Auth: em produção o serviço exige ASTRAL_SERVICE_SECRET e não sobe sem ele (sys.exit(1)). Para rodar local sem secret, use ASTRAL_ALLOW_INSECURE=1.

Arquivos de efeméride (ephe/)

O Swiss Ephemeris pode usar arquivos .se1 para máxima precisão. Este serviço aponta EPHE_PATH (default ./ephe, em Docker /app/ephe) para essa pasta:

• Pasta vazia ou ausente (estado atual): o pyswisseph cai no modelo analítico Moshier embutido — sem arquivos externos, precisão suficiente para signos, casas e aspectos usados aqui. É o comportamento em produção hoje.
• Para usar os arquivos .se1: baixe os planetários e de asteroides de https://www.astro.com/ftp/swisseph/ephe/ (ou do repositório oficial do Swiss Ephemeris) e coloque em ephe/. Cobrem o intervalo de datas de nascimento esperado (ex.: sepl_18.se1, semo_18.se1, seas_18.se1). O docker-compose.yml já monta ./ephe:/app/ephe. Os .se1 não são versionados neste repo.

Testes

pip install -r requirements-dev.txt
pytest

Licença

AGPL-3.0 — ver LICENSE.