Files
sorsfonalak/services/worker/README.md
T
fecoandClaude Opus 5.5 771ece41b1 Add worker service with e-mail delivery and dev Mailpit
- worker: sends email_outbox mail over SMTP (lettre), woken by
  LISTEN/NOTIFY, SKIP LOCKED claiming, retries with backoff,
  hu/en templates (text + HTML), hourly cleanup of expired data
- migration 0002: next_attempt_at, failed_at, notify trigger
- docker-compose.override.yml: Mailpit for development only
- Dockerfiles: lock shared cargo cache mounts for parallel builds

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-15 11:49:40 +00:00

2.6 KiB
Raw Blame History

worker

Háttérmunkák a közös PostgreSQL-adatbázis fölött. 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 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.

Később: az elemzések megírása (OpenRouter), kredit-visszatérítés hibánál.

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
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.