Ephemeris

Designs for the astronomy layer behind every astrology calculation: planetary and lunar positions, houses, zodiac and ayanamsa handling, and their provider contracts.

Product features consume canonical astronomy values through reusable packages. Consumers connect provider selection, normalization and semantics, and own optional storage and transport.

Designs

• Astro Binder — current package scope, ownership and calculation flow.
  • Provider router
  • Swiss adapter
  • NASA adapter
  • Canonical normalizer
  • Astrology semantics
  • Drift validator

Standalone facade, result-cache and provenance-store services are dropped from binder scope. Their earlier designs remain linked there as historical context.

Consumed by

• Astrology — composes natal charts, vargas, dashas, panchang, transits, compatibility, and muhurta from this contract.

Not in this domain

• Chart interpretation, dashas, panchang, compatibility logic (product/astrology domains).
• User, birth-record, saved-chart storage (account/data domains).
• NASA APIs unrelated to solar-system positions: NeoWs, APOD, DONKI.

Conventions

• Each design keeps guide and diagrams together: binder/README.md with binder/architecture.svg.
• Diagrams are labelled reference designs unless the behaviour is already deployed.
• Provider facts link to the vendor documentation they came from.