Yearly forecast: solar return, transits, progressions, profection, eclipses
CI / test (push) Successful in 56s
CI / build (push) Successful in 4m41s
CI / deploy (push) Skipped

- astro-engine: forecast module (solar return moment, slow-planet transits
  with exact dates and periods, natal house ingresses, secondary
  progressions, annual profection, eclipses via Swiss Ephemeris)
- horoscope-api: POST /v1/forecast, solar return chart cast for the place
  of the birthday
- backend: forecasts table, /v1/charts/{id}/forecasts, /v1/forecasts/{id}
  and its analyses using a new 'forecast' unit; current year of life open,
  the next one 30 days before the birthday
- packages: Páros and Család include forecasts (6 000 / 11 000 Ft),
  +1 éves előrejelzés add-on 2 500 Ft; Egy elemzés unchanged
- worker and prompt: forecast kind with five sections and forecast rules
  (trends, no event predictions); no birth data, place or exact age sent
- frontend: /kepletek/{id}/elorejelzes with the solar return wheel, the
  keys of the year, a monthly timeline, transit list and detailed forecast
- data export: forecasts added, model name removed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
This commit is contained in:
feco
2026-11-18 08:19:13 +00:00
co-authored by Claude Opus 5.5
parent 829c33e52f
commit f1bd34c394
42 changed files with 4764 additions and 85 deletions
+38
View File
@@ -0,0 +1,38 @@
# Éves előrejelzés
Egy év születésnaptól születésnapig, több bevett előrejelző módszerből összerakva, ahogy egy asztrológus éves konzultációja is.
## Módszerek
| Módszer | Mit ad | Hol számolódik |
|---|---|---|
| **Szolár** (szoláris visszatérés) | Az a pillanat, amikor a Nap visszatér a születéskori hosszúságára; az erre a pillanatra és a születésnapi tartózkodási helyre felállított képlet „az év képlete”. | `astro_engine::forecast::solar_return`, a képlet a horoscope-api-ban |
| **Tranzitok** | A Jupiter, Szaturnusz, Uránusz, Neptunusz és Plútó fő fényszögei (együttállás, szextil, kvadrát, trigon, szembenállás) a tíz bolygóhoz, az Aszcendenshez és az MC-hez, 1° hatásfokkal: pontos dátumok (retrográd áthaladásokkal) és hatásidők. A lassú bolygók házai és házváltásai. | `forecast.rs`, `Year::transits` |
| **Szekunder direkció** | „Egy nap = egy év”: a progresszív Nap, Hold, Merkúr, Vénusz, Mars helye, jegy- és házváltásai, fényszögei a születési képlethez, a progresszív holdfázis. | `Year::progressions` |
| **Éves profekció** | Minden életév egy házat aktivál (egész jegyes házak az Aszcendenstől); a jegy hagyományos uralkodója „az év ura”. | `Year::profection` |
| **Fogyatkozások** | Az év nap- és holdfogyatkozásai (a félárnyékos holdfogyatkozás nélkül), a születési házuk, és ha 3°-on belül érintenek egy születési pontot. | Swiss Ephemeris `swe_sol_eclipse_when_glob`, `swe_lun_eclipse_when` |
A dátumok a születésnapi hely időzónájában értendő naptári napok. Egy év számítása kb. 0,2 másodperc.
**Ismeretlen születési idő:** nincs szolár képlet (a pillanat akár fél napot is tévedhet), nincs profekció, ház és tengely; a Hold kimarad a fényszögekből. A tranzitok és a progresszió megmaradnak.
## Folyamat
1. `POST /v1/charts/{id}/forecasts` (`{year?, location?}`): a backend a képlet születési adataival hívja a horoscope-api `POST /v1/forecast` végpontját, és az eredményt a `forecasts` táblába menti. Ingyenes; ugyanaz a kérés a meglévőt adja vissza.
- A felhasználó a mostani életévét, és a születésnapja előtti 30 napban a következőt kérheti; admin bármelyiket.
- Képletenként legfeljebb 20 előrejelzés (év × hely).
- Javított születési adatnál új előrejelzés készül (a kulcsban benne van a `chart_hash`).
2. Az oldal (`/kepletek/{id}/elorejelzes`) ebből ingyen mutatja a szolár kört, „az év kulcsait” és a havi idővonalat.
3. `POST /v1/forecasts/{id}/analyses`: a részletes szöveg egy `forecast` egységet használ (admin: ingyen). A worker a `compact::forecast` szövegből és az `analysis-prompt` `Forecast` fajtájából írja: öt fejezet (az év témája, kapcsolatok, munka, belső fejlődés, negyedéves idővonal), lehetőségek, kihívások, útravaló.
A modellhez nem megy születési dátum, hely vagy pontos életkor (csak évtized), a születésnapi hely sem.
## Megfogalmazás
Trendekről, lehetőségekről és időzítésről szól, nem biztos eseményekről. Betegségről, halálról, balesetről, terhességről, perekről és pénzügyi nyereségről vagy veszteségről nem jósol (`FORECAST_RULES` a promptban).
## Később
- Havi előrejelzés: holdvisszatérés és a hónap gyorsabb tranzitjai (Mars, Vénusz, Nap).
- Tranzitok a kompozit képletre: „mi vár rátok idén”.
- Az admin promptszerkesztőben az előrejelzés promptja is szerkeszthető legyen.