- Credits become analysis units (migration 0006): a natal analysis uses one 'natal' unit, a synastry analysis one 'synastry' unit. No monthly free credits, no model tiers: ANALYSIS_MODEL (default Opus 5.5) writes every paid analysis. Admins grant units per kind; the worker refunds the right unit on failure. - Chart page: the detailed analysis card (offer with units left and a confirmation, progress while writing, the finished six sections). - Public /pelda page: a full Opus analysis of a made-up chart, with the free summary and a login call to action. - The worker sends the JSON schema with properties in 'required' order. serde_json sorted them, so the title came after ~9000 tokens of text and Opus sometimes left it empty (3 failed attempts in a live test); with the order fixed the same analysis succeeded at the first try. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
6.6 KiB
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 felhasználó nyelve szerint (
src/templates.rs):verify_email,reset_password,invite_accepted. Mindegyik szöveges és HTML-változatban megy ki; a felhasználó nevét HTML-ben escape-eli, és a vezérlőkaraktereket eltávolítja belőle. - 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 meghívók 30 nappal a lejáratuk után.
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. -
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. -
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 (src/analysis/prompt.rs,PROMPT_VERSION = v2):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.
-
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, ezért ez az alapértelmezett (SUMMARY_MODEL, kb. 0,009 dollár, a Haiku kb. 0,001). A fizetős részletes elemzés az Opus 5.5-tel készül.
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) |
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é |
ANALYSIS_CONCURRENCY |
4 |
egyszerre írt elemzések |
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.