A `docker compose up` a `docker-compose.override.yml` fájlt is betölti. Ebben csak fejlesztői dolgok vannak: a **Mailpit**, ami minden kimenő e-mailt elkap (webes felület: `http://<szerver>:8025`), és a worker erre van irányítva. Élesben az override nélkül kell indítani, és az `SMTP_URL`-t meg kell adni:
```bash
SMTP_URL=smtps://user:jelszo@smtp.example.com:465 docker compose -f docker-compose.yml up -d
A horoscope-api image önálló (`scratch` alapú, kb. 70 MB, nem root felhasználóval fut). Benne van a statikus bináris és az összes adat. A container induláskor ~2 mp alatt betölti az adatokat, és ~190 MB memóriát használ. Egy horoszkóp kiszámítása 2–3 ms.
A `person1` és a `person2` ugyanazokat a mezőket fogadja, mint a `/v1/natal`, kivéve az `options` mezőt. Az `options` csak legfelső szinten adható meg, és mindkét képletre érvényes.
- **Fényszögek:** ugyanazokat a pontokat és orbiszokat használja, mint a születési képlet: a Nap és a Hold nagyobb orbiszt kap, a csomópontok, a Lilith és a Chiron kisebbet. Az alkalmazó/szeparáló jelzés itt nincs, mert két születési képlet között nincs értelme.
- **Kompozit:** minden pont a két születési pont közelebbi felezőpontja. A házcsúcsok a két születési házcsúcs felezőpontjai, sorrendhelyesen igazítva; a kompozit AC az 1., az MC a 10. házcsúcs.
- **Ismeretlen születési idő:** ha az egyik ember születési ideje ismeretlen, a tengelyei kimaradnak a fényszögekből, a másik ember pontjai nem kerülnek az ő házaiba, a kompozitnak pedig nincsenek tengelyei és házai. Erről a `warnings` mező is szól.
- **Hibák:** az egyik emberre vonatkozó hibánál a hibaobjektumban egy `person` mező is van (`"person1"` vagy `"person2"`), és az üzenet ezzel kezdődik.
| 404 | `place_not_found` (`suggestions` mezővel), `unknown_place_id` | nincs ilyen hely |
| 422 | `ambiguous_local_time`, `nonexistent_local_time` | óraátállításkor; az `ambiguous_time` mezővel kell dönteni |
| 422 | `calculation_failed`, `no_time_zone` | a számítás nem végezhető el |
## Időzónák és nyári időszámítás
1.**Az IANA tzdb `backzone` adatokkal van fordítva.** Az alap tzdb 1970 előtt összevon olyan zónákat, amelyek 1970 óta azonosak; Oslót például Berlinhez köti, pedig Norvégiában 1959–1965 között volt nyári idő, Németországban nem. A backzone-nal minden ország megtartja a saját történetét. Magyarország: 1941–1949 és 1954–1957 között volt nyári idő, 1958–1979 között nem, 1980 óta van.
2.**A zóna kiválasztásának sorrendje:** a `timezone` mező, ha meg van adva → a talált település zónája (GeoNames) → az ország egyetlen zónája → a legközelebbi település zónája ugyanabban az országban (több zónás országokban, pl. USA, Oroszország) → a `zone.tab` legközelebbi referenciapontja.
3.**Kétszer előforduló és nem létező időpontok** (őszi és tavaszi óraátállítás): alapértelmezésben hiba, amely mindkét lehetőséget leírja; az `ambiguous_time` mezővel lehet dönteni.
4.**Helyi középidő:** ahol még nem volt szabványidő (a tzdb `LMT`-t ad), ott a születési hely saját helyi középidejét használja (hosszúság/15 óra), nem a zóna referenciavárosáét. 1880-ban Debrecenben ez +01:26:30, Budapesten +01:16:20.
5.**Felülírás:** ha az anyakönyv eltér a tzdb-től (háborús idő, helyi szokás), a `utc_offset` mezővel fix eltérés adható meg.
**Ismert korlát:** a tzdb a mai közigazgatási zónát ismeri. Ha egy terület történelmileg más országhoz tartozott, azt nem követi. Példa: Észak-Erdély 1940 és 1944 között budapesti időt használt, a `Europe/Bucharest` zóna viszont ezt nem tartalmazza. Ilyenkor a `timezone: "Europe/Budapest"` vagy a `utc_offset` mezőt kell megadni.
## Számítási motor
- **Swiss Ephemeris** (Astrodienst), a csomagban kapott C forrásból fordítva. A belső verziószám `2.10.03`, a git tag `v2.10.3bfinal`. A bolygópozíciók ívmásodpercnél pontosabbak.
- A Rust-kötést automata tesztek vetik össze a hivatalos `swetest` program eredményeivel: bolygók, sebességek, házcsúcsok, Vertex, Delta T, sarkvidéki visszaesés.
- Az adatfájlok 1800–2399-et fedik le. Ezen kívül a motor a pontatlanabb Moshier-efemeriszre vált, a Chiron és a kisbolygók kimaradnak, és a válasz `warnings` mezőjében figyelmeztetés jelenik meg.
- A sarkkörökön túl a Placidus/Koch/Topocentrikus házrendszer nem értelmezhető; ilyenkor Porphyry-re vált, és figyelmeztetést ad.
- A motor az `astro_engine::Ephemeris` trait mögött van. Egy licenctiszta motor (pl. JPL DE440 + saját Rust kód) a trait implementálásával beköthető, a horoszkóplogika módosítása nélkül.
## Licencek
- **Swiss Ephemeris: AGPL-3.0** vagy fizetős *Swiss Ephemeris Professional License*. Ha a szolgáltatást mások a hálózaton keresztül használják, AGPL alatt a teljes forrást elérhetővé kell tenni, különben kereskedelmi licenc kell. Emiatt a workspace licence jelenleg `AGPL-3.0-or-later`.
- **GeoNames:** CC BY 4.0. A forrásmegjelölés benne van az API válaszában (`meta.data_sources`).