Files
sorsfonalak/services/worker
fecoandClaude Opus 5.5 b0fc547b73
CI / test (push) Successful in 1m29s
CI / build (push) Successful in 5m52s
CI / deploy (push) Skipped
Tarot readings: AI-written, drawn on the server, sold as units
A new Kártyajóslás page: choose a spread (1, 3 or 5 cards), ask a
question, pick the cards from the fanned deck and watch them turn over;
the reading is written by the detailed-analysis model from the cards,
their positions and base meanings, the question and the reader's Sun,
Moon and Ascendant. The server shuffles and draws, so nobody can draw
again for free. A reading is a 'tarot' analysis (worker, retries,
fallback, refunds and admin regeneration as for analyses), uses one
'tarot' unit, and survives recalculations; deleting the account
deletes it.

Packages carry 2/5/10 readings, the new +5 kártyajóslás addon costs
1 000 Ft. The card artwork comes from the tarot design studio
(celestial astrolabe style); the deck JSON is shared by the frontend
and the prompt. A public example is at /kartyajoslas/pelda.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-20 14:35:50 +00:00
..
2026-11-17 18:43:39 +00:00

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_outbox tá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 worker POLL_INTERVAL_SECS másodpercenként úgyis ránéz.
  • A sorokat FOR UPDATE SKIP LOCKED zá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_ATTEMPTS pró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-ID a feladó domainjén van (<outbox-id@domain>), a meghívóknál pedig List-Unsubscribe és List-Unsubscribe-Post fejlé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 pending sort, és levon egy elemzési egységet. Egy trigger (NOTIFY analyses) felébreszti a workert; egyszerre ANALYSIS_CONCURRENCY elemzé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).
  • Több worker is dolgozhat ugyanabból a sorból: a sorokat FOR UPDATE SKIP LOCKED foglalja, 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 model mezőjében áll. A válasznak kötött JSON-sémát kell követnie (crates/analysis-prompt, PROMPT_VERSION = v3; ha a sor prompt_version-je v3-r<id>, a system prompt az admin által szerkesztett prompt_revisions sorbó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) csak title és egy 3–4 mondatos summary.

    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; az openrouter/auto mö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_ATTEMPTS próbálkozás: az elemzés failed lesz, é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.json mondja meg, melyik betű melyik modell, a tokenszámmal, a költséggel és az idővel együtt.
  • A prompt.md a teljes promptot tartalmazza.
  • A --chart a horoscope-api /v1/natal válasza; --summary mellett a rövid összefoglalót írja meg.
  • A --synastry FILE (a --chart helyett) a horoscope-api /v1/synastry vá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.