# Simex Distribution Hub

> Český systém pro distribuci marketingového obsahu z jednoho místa: e-mailové kampaně a newslettery, letáky a příspěvky na facebookové stránce, příběhy na Instagramu, příspěvky na Google firemní profil a placená reklama na Facebooku vytvořená z letáku. Hlídá souhlasy příjemců, odhlášené adresy a doložitelnost každého odeslání. Rozhraní i dokumentace jsou česky.

Systém vyvinula česká softwarová firma Quantiva (https://quantiva.cz) pro TRUCK SHOP
SIMEX, s.r.o., kde běží v ostrém provozu. Každá instalace slouží jedné firmě. Veřejná
registrace, ceník ani zkušební verze nejsou; o ukázku systému se lze ozvat přes
kontaktní formulář na úvodní stránce.

Administrace nikdy neodesílá sama. Uživatel v ní připraví obsah a příjemce, systém
data zvaliduje a založí distribuční úlohy do fronty; fyzické odeslání provádějí
samostatné worker služby, kterých může běžet víc vedle sebe. Výpadek serveru,
externího API ani worker procesu proto neznamená ztracenou ani dvakrát odeslanou
zprávu.

Technologie: C# / .NET 10, ASP.NET Core, Blazor Server, Entity Framework Core,
Microsoft SQL Server, .NET Worker Service, REST API se Swaggerem, Serilog.

**Kanály:**

- **E-mail**: rozesílání přes SMTP; poskytovatel je za rozhraním a dá se vyměnit. Rozesílku jde rozložit do denních dávek, aby doména bez historie neskončila ve spamu.
- **Facebooková stránka**: letáky a příspěvky přes Meta Graph API, postupně s rozestupem, s odebíráním předchozího letáku a s rotací letáků dokola. Ke každému letáku systém vydává vlastní veřejnou stránku, jejíž náhledový obrázek je právě ten leták.
- **Příběhy na Instagramu**: leták jako příběh na profesionálním účtu propojeném s facebookovou stránkou; obrázek 1080 × 1920 se připraví z letáku. Příběh sám zmizí po 24 hodinách.
- **Google firemní profil**: letáky jako místní příspěvky. Konektor je hotový; ostrý provoz podmiňuje schválení přístupu k rozhraní ze strany Googlu.
- **Placená reklama na Facebooku**: z letáku vznikne u Mety pozastavená reklama, kterou spustí jen oprávněný člověk po opsání částky. Rozpočet je vždy celoživotní s pevným koncem, systém má vlastní stropy na jednu reklamu i na měsíc a jedním tlačítkem zastaví všechny reklamy.

Každý kanál má vlastní vypínač; publikace i reklama mají režim nanečisto. Odesílání je
po instalaci vypnuté a zapíná se vědomě.

**Co systém umí:**

- **Kontakty**: evidence kontaktů a jejich komunikačních kanálů, ruční zakládání a úpravy v administraci. E-mailová adresa je v databázi šifrovaná (AES-256-GCM), pro hledání duplicit slouží klíčovaný otisk a ve výpisech se zobrazuje maskovaná. Celou adresu smí vidět jen uživatel se samostatným oprávněním a zobrazení se zapíše do auditu.
- **Souhlasy**: u každého kontaktu je doložitelné, kdo souhlasil, kdy, s čím, odkud souhlas pochází a kdy byl případně odvolán.
- **Blokované adresy (suppression list)**: adresy, kterým se už nesmí nic poslat (odhlášení, nedoručitelnost, stížnost na spam, ruční zápis). Kontroluje se znovu těsně před každým odesláním.
- **Skupiny a segmentace**: kontakt může patřit do víc skupin; skupina může být i dynamická, definovaná podmínkami nad údaji kontaktu.
- **Import**: nahrání kontaktů z CSV nebo XLSX. Data se nejdřív načtou do dávky, uživatel dostane přehled validních, duplicitních, neplatných a odhlášených řádků a teprve pak import schválí.
- **Synchronizace z e-shopu**: pravidelné doplňování zákazníků ze zákaznické databáze e-shopu; systém do ní jen čte.
- **Šablony**: HTML šablony s verzováním a proměnnými pro personalizaci (jméno, firma, odhlašovací odkaz a další).
- **Podklady**: knihovna letáků a obrázků, které se připojují ke kampaním.
- **Kampaně**: jedna kampaň může mířit do víc kanálů najednou a výpadek jedné větve nezastaví ostatní. Obsah je verzovaný, seznam příjemců se před odesláním zafixuje do snapshotu. Kampaň prochází kroky obsah → kontrola → volitelné testovací odeslání → volitelné schválení → spuštění a dá se naplánovat na určený čas, pozastavit i zrušit.
- **Fronta úloh**: každá úloha má jednoznačný klíč s unikátním indexem v databázi, takže dvojí odeslání nemůže projít ani při souběhu workerů.
- **Opakování a chybné úlohy**: dočasná selhání se opakují s rostoucí prodlevou, trvalá ne. Co se nepodaří ani po posledním pokusu, skončí v samostatné obrazovce, kde jde úlohu prohlédnout, opakovat nebo zrušit.
- **Sledování a odhlášení**: měření otevření a prokliků, webová verze e-mailu a jednoklikové odhlášení podle RFC 8058. Odkazy jsou podepsané.
- **Statistiky**: přehled stavu systému a výsledků kampaní včetně grafů vykreslených na serveru.
- **Externí systémy**: poskytovatelé se zapínáním a limity souběhu a počtu operací za minutu a za hodinu.
- **Uživatelé a oprávnění**: přihlášení jménem a heslem, dvoufázové ověření (TOTP se záložními kódy), uzamčení účtu po opakovaných chybných pokusech, oprávnění přidělovaná jednotlivě.
- **Audit**: záznamy o změnách se jen přidávají, nikdy nepřepisují; hodnoty citlivých sloupců se do nich zapisují maskované.
- **Provoz**: REST API s JWT autentizací (kontakty, kampaně, šablony, podklady) a health checky pro monitoring.

**Co systém nedělá** (tenhle výčet je tu proto, aby se systému nepřipisovaly funkce, které nemá):

- Není v něm žádná umělá inteligence – nic negeneruje ani nedoporučuje obsah.
- Placenou reklamu kupuje jen u Mety (na Facebooku); v Google Ads, Skliku ani jinde neinzeruje.
- Neposílá SMS ani push notifikace. SMS, Heureka a další systémy jsou v kódu připravené jako rozšiřující body, konektor pro ně ale zatím není.
- Neumí automatické série zpráv (uvítací série, připomínky) ani sběr kontaktů přes přihlašovací formulář k odběru; kontakty se zakládají ručně v administraci, importem z CSV nebo XLSX, přes REST API nebo synchronizací z e-shopu.
- Netvoří tiskové podklady; letáky se do knihovny nahrávají hotové.
- Nemá vícejazyčné rozhraní ani veřejnou registraci – účty zakládá správce.

**Adresy:**

- Úvodní stránka a administrace: `https://newsletter.algorax.eu`
- Veřejné koncové body (odhlášení z odběru, sledování, stránky letáků, REST API, webhooky) běží na samostatném hostiteli.

## Stránky

- [Úvodní stránka produktu](https://newsletter.algorax.eu/): popisuje, co systém dělá. Čísla v sekci „Skutečné výsledky“ se načítají z databáze této instalace. Čísla v ilustračním náhledu aplikace v horní části stránky jsou ukázková, ne skutečná.
- [Kontaktní formulář](https://newsletter.algorax.eu/#contact): dotazy k rozesílkám a žádost o ukázku systému.
- [Zásady ochrany osobních údajů](https://newsletter.algorax.eu/soukromi): jaké údaje systém zpracovává, jak dlouho je drží, komu je předává a jak se z rozesílky odhlásit.
- [Podmínky služby](https://newsletter.algorax.eu/podminky): k čemu systém slouží, co musí dodržet obsluha, dostupnost a odpovědnost za obsah.

## Optional

- [Autor systému](https://quantiva.cz/): Quantiva, česká softwarová firma.