年次プロフェクション API

エンドポイントは出生データと対象日付を受け取り、出生時点から経過した年数を数えて、アセンダントからその年数分だけサインを1つずつ進める。レスポンスはカウントした年齢、該当サインの0始まりインデックス、そしてそのサインの支配星を lordOfYear として返す。また、出生アセンダント、MC、太陽、月も併せて返すので、2回目の呼び出しなしでチャート上にその年を描画できる。ハウス番号は年齢から直接求められ、サイクルは12年なので、ハウスは (年齢 % 12) + 1 になる。たとえば年齢36は1ハウスに戻り、アセンダントと同じサインになるので、サンプルチャート（アセンダントが乙女座169.97°）は signIndex が5で、水星がその年の支配星になる。カウントはカレンダーではなく出生時点から始まるため、プロフェクションの年は誕生日に切り替わり、1月1日ではない。

curl -X POST https://api.astroway.info/v1/profections \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-05-15"
}'

{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}

エフェメリスなしで読者が追えるタイミング層が必要なときにプロフェクションを使う。各年は支配星が1つだけなので、年次予測や誕生日レポート、AIによる物語を1つの明確な宣言で作れる。トランジットやリターンと特に相性が良く、まずその年の支配星を見つけ、次にその星のトランジットをチェックすれば、2回の呼び出しで古典的な2段階リーディングができる。太陽回帰とも組み合わせられ、同じ年を別角度からカバーできる。この手法は意図的に粗く、人生のどの領域が活性化され誰が司るかを示すだけで、午後の具体的な出来事までは示さない。だから、細かいタイミングを掛ける枠組みとして使ってくれ。

アセンダントからの全サインプロフェクションで、完了した年ごとに1サイン進む。伝統的なドミサイル支配星がその年の支配者になる。年齢は出生時点から数えるので、年は誕生日に切り替わる。出生アセンダント、MC、太陽、月は Swiss Ephemeris エンジン（熱帯黄道）から取得し、度数で返す。