E-maily

V jedné větě: Web posílá e-maily přes SMTP (knihovna MailKit) – v produkci přes Gmail, lokálně do „cvičné pošty“ Mailpit, kde je vidíte, ale nikomu neodejdou. Bez nastaveného serveru se e-mail jen zapíše do logu.

Přidáno v účty kroku 5.

Kdo co posílá

E-mail	Kdy	Jak
Potvrzení e-mailu	po registraci, nebo tlačítkem Poslat znovu v upozornění nahoře na stránce	hned během požadavku (AccountEmails)
Nové heslo	stránka Zapomenuté heslo	hned během požadavku
Objednávka potvrzená / zamítnutá / odeslaná (s číslem zásilky – e-shop krok 6) / doručená / zrušená	když se změní stav objednávky	z handleru doménové události za outboxem (EmailOrderNotifier)

flowchart LR
    subgraph web["Web"]
        pages["Stránky účtu<br/>Register, ForgotPassword,<br/>ResendConfirmation"]
        acc["AccountEmails<br/>odkaz s tokenem"]
        handlers["Handlery událostí objednávky<br/>(za outboxem, opakování)"]
        notif["EmailOrderNotifier"]
        sender["IEmailSender"]
    end
    smtp["SmtpEmailSender<br/>(MailKit)"]
    log["LoggingEmailSender<br/>(bez serveru – jen log)"]
    gmail[("Gmail SMTP<br/>produkce")]
    mailpit[("Mailpit<br/>lokálně")]

    pages --> acc --> sender
    handlers --> notif --> sender
    sender --> smtp
    sender -.-> log
    smtp --> gmail
    smtp --> mailpit
    click handlers "/Docs/eda/outbox"

Proč dvě cesty? Ordering má outbox – e-mail o objednávce se pošle spolehlivě, i když Gmail chvíli nejde (až 5 pokusů). Modul Accounts outbox nemá, e-mail účtu se posílá hned; když selže, uživatel to vidí a může to zkusit znovu (Poslat znovu, nové Zapomenuté heslo).

Odkazy s tokenem

sequenceDiagram
    autonumber
    actor U as Uživatel
    participant F as Account/ForgotPassword
    participant UM as UserManager
    participant M as Gmail / Mailpit
    participant R as Account/ResetPassword

    U->>F: e-mail
    F->>UM: najdi účet (když neexistuje, nic nepošle)
    UM-->>F: token (podepsaný, platí 2 h, obsahuje security stamp)
    F->>M: e-mail s odkazem …/ResetPassword?email=…&code=token
    F-->>U: „Pokud účet existuje, poslali jsme e-mail“ (vždy stejně)
    U->>R: otevře odkaz, zadá nové heslo
    R->>UM: ResetPasswordAsync(token) → nové heslo + nový security stamp
    Note over R,UM: Starý odkaz už neplatí (stamp se změnil)<br/>a ostatní zařízení se odhlásí

• Token vyrábí ASP.NET Core Identity (AddDefaultTokenProviders), podepisuje ho klíči Data Protection a platí 2 hodiny. Kdo ho změní, rozbije podpis.
• Stejná odpověď pro existující i neexistující e-mail – stránka neprozradí, kdo má v MiniShopu účet.
• Potvrzený e-mail je v cookie jako claim minishop:email_confirmed; bez něj ukazuje stránka upozornění. Od účtů kroku 9 je potvrzení povinné před objednávkou (policy RequireCustomer) – robot s vymyšlenou adresou nic neobjedná a e-maily o objednávkách nechodí cizím lidem.
• Do logu jde jen předmět e-mailu – adresa je osobní údaj a text obsahuje odkaz s tokenem.

Konfigurace (sekce Email)

Klíč	Lokálně (Aspire)	Produkce	Poznámka
Email:Host	adresa kontejneru Mailpit	smtp.gmail.com (EMAIL_HOST v production.env)	prázdný = jen log
Email:Port	port Mailpitu (1025)	587
Email:UseTls	false	true (STARTTLS)
Email:UserName	–	ftichy.gemini@gmail.com
Email:Password	–	secret SMTP_PASSWORD (heslo aplikace Gmailu)	viz Secrets
Email:FromAddress	minishop@localhost	ftichy.gemini@gmail.com	Gmail jinou adresu odesílatele přepíše

Kód: EmailSettings.cs, SmtpEmailSender.cs, EmailServiceCollectionExtensions.cs, Mailpit v AppHost.cs.

Mailpit lokálně

Při dotnet run --project src/MiniShop.AppHost spustí Aspire i kontejner mailpit. V Aspire dashboardu u prostředku mailpit klikněte na adresu http – otevře se schránka se všemi e-maily, které Web „odeslal“.

Přirovnání: Mailpit je cvičná poštovní schránka na stole – dopisy se do ní hodí, můžete si je přečíst i kliknout na odkaz, ale nikam neodjedou.

Známá omezení

• E-mail o objednávce může při pádu mezi odesláním a zápisem do inboxu přijít dvakrát (at-least-once).
• Gmail povolí zhruba 500 e-mailů denně a heslo aplikace dává přístup k celé schránce účtu – proto samostatný účet.
• Testovací účty s vymyšlenou adresou vrátí Gmail jako nedoručitelné (oznámení přijde do schránky odesílatele).