Emailer
Základní systémová služba pro doručování a ukládání e-mailů v BizKitHub platformě. Zajišťuje spolehlivé doručení všech typů e-mailových zpráv.
📧 Hlavní funkce
Emailer spravuje kompletní životní cyklus e-mailových zpráv od jejich vytvoření až po úspěšné doručení, včetně automatického opakování při selhání.
Klíčové funkce
Správa fronty e-mailů
Uložení a správa fronty e-mailů k doručení včetně kompletní konfigurace
Formátování šablon
Renderování šablon podle typu e-mailu s podporou HTML obsahu
Systémové zprávy
Rozesílání automatických systémových zpráv a notifikací
Fallback logika
Opakované doručení zpráv v případě neúspěchu s automatickými kontrolami
Fronta k doručení
Nejdůležitějším úkolem Emaileru je uložení všech zpráv, které se mají odeslat. O každém emailu evidujeme kompletní informace pro zajištění spolehlivého doručení.
Evidovaná pole e-mailu
| Pole | Typ | Význam |
|---|---|---|
id | int | Interní identifikátor e-mailu |
external_id | char(32) | Veřejný identifikátor e-mailu |
status | smallint | Stav doručení |
datetime_inserted | timestamp | Datum a čas vložení do fronty |
datetime_sent | timestamp | Datum a čas úspěšného doručení |
priority | smallint | Priorita doručení. Vyšší číslo je vyšší priorita |
failed_attempts_count | smallint | Počet selhání při pokusu o doručení |
send_earliest_at | timestamp | Email může být doručen nejdříve když nastane tento datum a čas |
send_earliest_next_attempt_at | timestamp | Datum a čas dalšího pokusu o doručení v případě selhání |
note | text | Interní poznámka k emailu, případně chybové zprávy a další informace |
from | text | Odesilatel |
to | text | Příjemce |
subject | text | Předmět emailu |
cc | text | Viditelná kopie |
bcc | text | Skrytá kopie |
reply_to | text | Odpověď na email posílat na tuto adresu |
html_body | text | Kompletní HTML obsah emailu |
organisation_id | int | ID organizace odesílající email |
from_member_id | int | ID člena organizace odesílající email |
tag | varchar(64) | Technický tag pro označení emailu (např. order-123) pro vyhledávání |
📋 Pořadí doručení
E-maily doručujeme v pořadí: orderBy: [{ priority: 'desc' }, { datetime_inserted: 'asc' }]
Způsob odbavení fronty
Odeslání e-mailu funguje asynchronně - vložení do fronty je okamžité, skutečné doručení probíhá na pozadí pomocí automatických robotů.
Vložení do fronty
E-mail se vloží do fronty k doručení - operace trvá desítky ms
Automatické zpracování
Robot pravidelně prochází frontu a načítá nové e-maily k odeslání
Paralelní odesílání
Až 25 e-mailů se odesílá současně podle priorit a pořadí ve frontě
Zpracování výsledku
Úspěšné doručení nebo označení pro opakovaný pokus později
⚡ Výkonnostní charakteristiky
Vložení do fronty
Desítky milisekund
Paralelní odesílání
Až 25 e-mailů současně
Globální zpracování
Napříč všemi organizacemi
Stavy doručení
Emailer podporuje následující stavy doručení pro sledování životního cyklu každého e-mailu:
in-queueVe frontě k doručení
Email je ve frontě k doručení
not-ready-to-queueNení připraven
Email ještě není připraven k doručení, zpracováváme data
preparing-errorChyba při zpracování
Při zpracování k doručení došlo k chybě
sending-errorChyba při odesílání
Při odesílání došlo k chybě
sentOdesláno
Email byl úspěšně odeslán
waiting-for-next-attemptČeká na další pokus
Email čeká na další pokus o doručení
undeliverableNedoručitelný
Email nelze doručit
Zpracování chyb a obnova
🔄 Automatické opakování
- • Opakované pokusy o doručení při selhání
- • Exponenciální prodleva mezi pokusy
- • Automatické označení nedoručitelných zpráv
- • Logování všech pokusů o doručení
🛡️ Ochrana před výpadky
- • Pozastavení fronty při výpadku SMTP serveru
- • Testovací e-maily pro ověření funkčnosti
- • Automatické obnovení po opravě problému
- • Zachování všech zpráv během výpadku
📊 Monitoring a logování
Všechny aktivity Emaileru jsou kompletně logovány a monitorovány. Systém poskytuje detailní informace o stavu doručení, chybách a výkonu pro každou organizaci i globálně.
Integrace s BizKitHub platformou
Emailer je plně integrován do BizKitHub ekosystému a automaticky zpracovává všechny typy e-mailových zpráv generovaných platformou.
🔗 API integrace
Přímé napojení na BizKitHub API pro odesílání systémových zpráv
📋 Šablony
Automatické formátování podle typu zprávy a organizace
📈 Statistiky
Detailní reporty o doručení pro každou organizaci