Backend and the workers also write their log as JSON into the logs volume, one file a day kept 30 days (LOG_DIR, LOG_NAME, LOG_KEEP_DAYS), so errors can be looked up after a container is replaced. The Docker health check (/healthz every 30 s) no longer goes into the request log of the backend and the horoscope API. The home, login and packages pages no longer compare the analyses to an experienced astrologer's depth; they say what the user gets: detailed, personal text in minutes, for a fraction of a personal consultation's price. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
worker
Háttérmunkák a közös PostgreSQL-adatbázis fölött: e-mail-küldés, szöveges elemzések (LLM), takarítás. Nincs nyilvános API-ja, csak egy /healthz végpontja (8082) a Docker healthcheckhez. Induláskor lefuttatja a migrációkat, ugyanúgy, mint a backend.
Munkák
E-mail-küldés (email_outbox → SMTP)
- A backend a levelet az
email_outboxtáblába teszi. Egy adatbázis-trigger (NOTIFY email_outbox) azonnal felébreszti a workert, így a levél másodperceken belül kimegy. Ha az értesítés elveszne, a workerPOLL_INTERVAL_SECSmásodpercenként úgyis ránéz. - A sorokat
FOR UPDATE SKIP LOCKEDzárolással veszi fel, ezért több worker is futhat egyszerre, és nem küldik el kétszer ugyanazt. A kézbesítés „legalább egyszer” elvű: ha a worker éppen küldés közben áll le, a levél újra kimehet. - Átmeneti hibánál (hálózat, SMTP 4xx) újrapróbálja 1, 2, 4, … percenként, legfeljebb 6 óránként.
MAX_EMAIL_ATTEMPTSpróbálkozás után a levelet sikertelennek jelöli (failed_at,last_error). - Végleges hibánál nem próbálja újra: ilyen a hibás cím, az SMTP 5xx és az ismeretlen sablon.
- Sablonok magyarul és angolul, a címzett nyelve szerint (
crates/email-templates, a backend admin-előnézete is ezt használja):verify_email,reset_password,invite_accepted,invitation. Mindegyik szöveges és HTML-változatban megy ki; a felhasználói szöveget HTML-ben escape-eli, és a vezérlőkaraktereket eltávolítja belőle. - A spamszűrők miatt a
Message-IDa feladó domainjén van (<outbox-id@domain>), a meghívóknál pedigList-UnsubscribeésList-Unsubscribe-Postfejléc is megy (egykattintásos leiratkozás). Élesítés:docs/levelkuldes.md. - Ha nincs
SMTP_URL, a worker nem küld semmit, a levelek az outboxban várnak.
Takarítás (induláskor, majd óránként)
- lejárt munkamenetek és e-mail-tokenek;
- elküldött e-mailek 7 nap után (tokenes linkek vannak bennük), sikertelenek 30 nap után;
- el nem fogadott „Mennyire illünk össze?” meghívók 30 nappal a lejáratuk után;
- el nem fogadott oldalmeghívók 30 nappal a lezárásuk (lejárat vagy visszavonás) után, az elfogadottak pedig, ha a fiókot törölték.
Szöveges elemzések (analyses, pending → running → done/failed)
-
A backend létrehozza a
pendingsort, és levon egy elemzési egységet. Egy trigger (NOTIFY analyses) felébreszti a workert; egyszerreANALYSIS_CONCURRENCYelemzés készül. -
Két sáv, saját helyekkel, hogy egy rövid szöveg ne várjon a hosszúak mögött:
- gyors sáv (
QUICK_CONCURRENCY, alapból 2): előbb a kérdések, aztán a rövid összefoglalók; - lassú sáv (
ANALYSIS_CONCURRENCY, alapból 4): a részletes elemzések és az előrejelzések. Ha nincs ilyen, a szabad hely gyors munkát vesz fel, végül az admin próbafuttatásait. - A 0 kikapcsolja a sávot, így a két sáv külön telepítésként is futhat (például Kubernetesen: egy gyors és egy lassú deployment).
- gyors sáv (
-
Több worker is dolgozhat ugyanabból a sorból: a sorokat
FOR UPDATE SKIP LOCKEDfoglalja, egy munkát csak egy worker kap meg. Leálláskor mindegyik csak a saját félbehagyott munkáit adja vissza a sorba, az elakadt (15 percnél régebben futó) munkákat bármelyik visszateszi. Az e-mail-küldés és a takarítás is biztonságos több példányban. -
A prompt a tárolt képletből készül (
src/analysis/compact.rs). Ez egy tömör szöveg, amely csak a pozíciókat tartalmazza: jegyek, fokok, házak, fényszögek, elemek. Név, születési dátum, idő, hely és koordináta nem megy ki. Ismeretlen születési időnél nincsenek házak, Aszcendens és MC. -
5 fokos szabály: ha egy pont legfeljebb 5°-kal (
CUSP_ORB) a következő ház csúcsa előtt áll, a szöveg már abban a házban adja meg, és odaírja, hogy formálisan az előzőben van („house 11 (on the cusp: 2°00' before it, formally house 10)”). Így olvassák az asztrológusok. A számított ház, a képlet rajza és a táblázatok nem változnak. Ugyanez érvényes az összevetés házátfedéseire, a szolár Aszcendensre, az év urára és a fogyatkozásokra. -
A modell OpenRouteren keresztül válaszol, azzal a modellel, amely a sor
modelmezőjében áll. A válasznak kötött JSON-sémát kell követnie (crates/analysis-prompt,PROMPT_VERSION = v3; ha a sorprompt_version-jev3-r<id>, a system prompt az admin által szerkesztettprompt_revisionssorból jön):title,summary;sections, radixnál:personality,emotions,mind,love,work,growth; szinasztriánál:attraction,communication,emotional_bond,friction,long_term;strengths,challenges,advice;- a rövid összefoglalónál (
summary) csaktitleés egy 3–4 mondatossummary.
A worker a választ maga is ellenőrzi a sémán. Magyar szövegben az egyenes idézőjelpárokat („…”) alakra cseréli.
-
Ha nincs esedékes elemzés, a worker az admin próbafuttatásait írja (
prompt_previews): a mentetlen system prompttal, egyetlen próbálkozással, egység nélkül. 30 nap után a takarítás törli őket. -
Eltárolja a ténylegesen válaszoló modellt (
model_used; azopenrouter/automögött ez más lehet), a tokenszámot és a költséget (cost_usd). -
Átmeneti hiba (hálózat, 429, 5xx, elfogyott OpenRouter-egyenleg, hibás vagy csonka válasz): újrapróbálja 30 mp, 2 perc, majd 8 perc múlva.
-
Végleges hiba (például ismeretlen modell), vagy ha elfogyott a
MAX_ANALYSIS_ATTEMPTSpróbálkozás: az elemzésfailedlesz, és az egység visszajár (refund, elemzésenként legfeljebb egyszer). -
Ha a worker elemzés közben leáll, a félkész elemzést visszateszi a sorba. Ha összeomlik, az elemzés 15 perc múlva magától visszakerül.
-
Szinasztriánál a modell a két félnek együtt szól; ha meg kell különböztetnie őket, „első fél” és „második fél” néven említi.
Később: streaming a frontend felé.
Modellek összevetése
A 2026-11-15-i összevetésen két képletet hét modell írt meg; az egyiket a tulajdonos, a másikat egy hivatásos asztrológus pontozta. Részletes elemzésenként: Claude Haiku 5.5 kb. 0,006 dollár, GPT-5.6 Terra kb. 0,05, Claude Opus 5.5 kb. 0,16 (szinasztria kb. 0,21). Az asztrológus szerint egyértelműen az Opus a legjobb, ezért a fizetős elemzés vele készül (ANALYSIS_MODEL, backend).
A MiniMax M3 olcsó, de az asztrológus szerint többször felcserélt dolgokat.
Az ingyenes rövid összefoglalót (2026-11-16) a Haiku és a Sonnet négy képleten írta meg. Mindkettő tényszerűen helyes volt, de a Sonnet jobban válogat és fogalmaz (kb. 0,009 dollár, a Haiku kb. 0,001). 2026-11-18 óta minden funkció alapmodellje az Opus 5.5 (SUMMARY_MODEL, ANALYSIS_MODEL); olcsóbb modell az admin Modellek oldalán választható, hiba esetén az Opus 5.5 a tartalék.
OPENROUTER_API_KEY=... worker compare-models --chart natal.json \
--models minimax/minimax-m3,anthropic/claude-sonnet-5.5 --language hu --out exports/model-compare
Ugyanazt a radix-elemzést több modellel is megírja, véletlenszerű betűkkel (A.md, B.md, …).
- A
key.jsonmondja meg, melyik betű melyik modell, a tokenszámmal, a költséggel és az idővel együtt. - A
prompt.mda teljes promptot tartalmazza. - A
--charta horoscope-api/v1/natalválasza;--summarymellett a rövid összefoglalót írja meg. - A
--synastry FILE(a--charthelyett) a horoscope-api/v1/synastryválasza, és szinasztria-elemzést ír.
Konfiguráció
| Változó | Alapérték | Jelentés |
|---|---|---|
DATABASE_URL |
– (kötelező) | PostgreSQL kapcsolat |
SMTP_URL |
– | smtp://mailpit:1025 (fejlesztés), smtp://user:pass@host:587?tls=required (STARTTLS), smtps://user:pass@host:465 (TLS) |
AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY |
– | Amazon SES, ha nincs SMTP_URL (a .env.secrets fájlból; más nevek is jók, lásd src/ses.rs). A titkos kulcsból a worker kiszámolja az SMTP-jelszót. Helyettük SES_SMTP_USERNAME + SES_SMTP_PASSWORD is megadható |
SES_REGION, SES_SMTP_PORT |
eu-central-1, 2587 |
SES-régió és port (a DigitalOcean a 25-ös, 465-ös és 587-es portot tiltja) |
MAIL_FROM |
Sorsfonalak <noreply@sorsfonalak.local> |
feladó |
POLL_INTERVAL_SECS |
30 |
tartalék lekérdezési időköz |
MAX_EMAIL_ATTEMPTS |
8 |
ennyi próbálkozás után sikertelen a levél |
OPENROUTER_API_KEY |
– | OpenRouter-kulcs (compose-ban a .env.secrets fájlból); nélküle az elemzések várnak |
OPENROUTER_BASE_URL |
https://openrouter.ai/api/v1 |
|
PUBLIC_BASE_URL |
– | HTTP-Referer fejléc az OpenRouter felé |
WORKER_TASKS |
email,cleanup,analyses |
a folyamat feladatai; élesben worker: email,cleanup, worker-ai: analyses |
ANALYSIS_CONCURRENCY |
4 |
lassú sáv: egyszerre írt részletes elemzések és előrejelzések (0: kikapcsolva) |
QUICK_CONCURRENCY |
2 |
gyors sáv: egyszerre írt rövid összefoglalók és válaszok (0: kikapcsolva) |
MAX_ANALYSIS_ATTEMPTS |
3 |
ennyi próbálkozás után sikertelen az elemzés (az egység visszajár) |
BIND_ADDR, LOG_FORMAT, RUST_LOG |
0.0.0.0:8082, text, info |
Fejlesztés: Mailpit
A docker-compose.override.yml csak fejlesztéskor töltődik be. Elindítja a Mailpitet, és a workert rá irányítja. Minden levél ott landol, kifelé semmi nem megy ki. Webes felület: http://<szerver>:8025, API: http://<szerver>:8025/api/v1/messages.