Files
sorsfonalak/docs/levelkuldes.md
T
fecoandClaude Opus 5.5 7272d0f1f3 Invitation-only sign-up, invitation e-mails and waitlist
- SIGNUP_MODE=invite (default): a new account needs an open invitation for
  its address, or the invitation link (then any Google account will do)
- admin page "Meghívók": invite many addresses at once, personal message,
  resend (max 3, 24 h apart), revoke, copy link, mail preview and test copy,
  waitlist
- invitation e-mail in HTML and plain text; Message-ID on the sender's
  domain, List-Unsubscribe with one-click POST, opt-out list (hashes only)
- e-mail texts moved to a shared crate (crates/email-templates)
- login page shows the invitation; waitlist for uninvited visitors;
  unsubscribe page; privacy policy updated
- docs/levelkuldes.md: Brevo, DNS (SPF, DKIM, DMARC) and the SMTP setup

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

4.0 KiB

Levélküldés élesben (meghívók, értesítések)

Élesben most nincs levélküldő beállítva (SMTP_URL üres), így minden levél az email_outbox táblában vár. Amíg ez így van, a meghívót kézzel is továbbadhatod: az admin „Meghívók” oldala küldés után kiírja a linket („Link másolása”).

A meghívó a legkényesebb levéltípus, mert a címzett nem kérte. A spammappát elsősorban a feladó hírneve és a domain hitelesítése dönti el, a sablon csak ezután számít. Ezért kell a lenti négy lépés.

1. Levélküldő szolgáltatás

Javaslat: Brevo (EU-s, napi 300 levélig ingyenes; egy induló, meghívásos oldalnak bőven elég). Ha később fontosabb lesz a kézbesítési arány, a Postmark (fizetős) a legjobb; a beállítás ugyanígy megy.

A DigitalOcean a dropleteken alapból tiltja a kimenő SMTP-portokat (25, 465, 587), ezért a 2525-ös portot kell használni; ezt a Brevo és a Postmark is tudja.

  1. Brevo-fiók létrehozása.
  2. Senders, Domains & Dedicated IPs → Domains → Add a domain: sorsfonalak.hu. A Brevo kiírja a szükséges DNS-rekordokat (lásd 2. pont).
  3. Senders: feladó felvétele, javaslat: hello@sorsfonalak.hu. A noreply cím a szűrőknél rosszabb, és válaszolni sem lehet rá.
  4. SMTP & API → SMTP: itt van az SMTP-login (…@smtp-brevo.com alakú) és egy új SMTP-kulcs (ez a jelszó).

2. DNS a Cloudflare-en

A rekordokat a Brevo pontosan megadja; ezek szoktak lenni:

Típus Név Tartalom
TXT sorsfonalak.hu brevo-code:… (a domain igazolása)
CNAME brevo1._domainkey a Brevo által megadott cél (DKIM)
CNAME brevo2._domainkey a Brevo által megadott cél (DKIM)
TXT _dmarc v=DMARC1; p=none; rua=mailto:<a te címed>
  • A CNAME-ek legyenek DNS only (szürke felhő), különben a DKIM nem működik.
  • SPF: ha a Brevo kér SPF-et, egy domainnek csak egy v=spf1 rekordja lehet, a szolgáltatókat abba kell összevonni (például v=spf1 include:spf.brevo.com ~all).
  • DMARC: induláskor p=none (csak jelentés). Ha pár hétig minden levél átmegy a DKIM-en, szigorítható p=quarantine-ra.
  • Ha a hello@sorsfonalak.hu címre érkező válaszokat is olvasni szeretnéd: a Cloudflare Email Routing ingyen továbbítja őket a Gmailedre. Ez MX- és SPF-rekordot is ad; az SPF-et ilyenkor a Brevóéval egy rekordba kell összevonni.

3. A szerver .env fájlja

/opt/sorsfonalak/.env:

SMTP_URL=smtp://<login>:<smtp-kulcs>@smtp-relay.brevo.com:2525?tls=required
MAIL_FROM=Sorsfonalak <hello@sorsfonalak.hu>
  • A loginban lévő @ jelet %40-re kell írni (például abc123%40smtp-brevo.com), mert az URL-ben az @ választja el a jelszót a géptől.
  • Utána: docker compose up -d worker. A naplóban ennek kell megjelennie: e-mail delivery enabled.
  • Az eddig várakozó levelek ekkor kimennek. Ha ezt nem szeretnéd, előtte töröld őket: DELETE FROM email_outbox WHERE sent_at IS NULL;.

4. Próba

  1. Admin → Meghívók → Teszt küldése magamnak: megérkezik-e, és nem a spamben van-e.
  2. A Gmailben a levélnél ⋮ → Eredeti megjelenítése: az SPF, a DKIM és a DMARC mellett is PASS álljon.
  3. A mail-tester.com ad egy egyszeri címet: küldj rá meghívót az admin oldalról (utána vond vissza), és nézd meg a pontszámot. 9/10 fölött jó.

Amit a kód már elintéz

  • HTML és szöveges változat ugyanazzal a tartalommal; egyhasábos, képek és követés nélkül; minden link a saját domainre mutat.
  • Message-ID a feladó domainjén.
  • List-Unsubscribe és List-Unsubscribe-Post (RFC 8058): a Gmail és a többi levelező saját „Leiratkozás” gombot mutat. Aki leiratkozik, annak a címére soha többé nem megy meghívó (email_optouts, csak a cím hash-e).
  • Meghívót csak admin küldhet; egy meghívó legfeljebb háromszor megy ki, 24 óránként egyszer. A személyes üzenet legfeljebb 300 karakter, és nem lehet benne link.