- 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
2.6 KiB
2.6 KiB
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_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.
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.