presseportale/tests/Feature/Mail/EmailBrandingTest.php
Kevin Adametz 2691a4d988 conversion: Konversionsleiter mit Herkunft auf dem Magic-Link-Token (Block 0)
Die zu messende Strecke führt von einer Mail über presseecho.de per Magic Link
auf pressekonto.com und endet in einer Buchung — drei Wechsel, zwei Domains. Ein
cookiefreies Analytics-Tool verliert die Sitzung genau dort, wo die interessante
Konversion passiert. Claim, Registrierung und Buchung sind außerdem keine
Seitenaufrufe, sondern Zustandsänderungen in dieser Datenbank, bei denen die
Identität ohnehin bekannt ist. Deshalb eigene Ereignisdaten statt Umami; Umami
behält Seitenaufrufe und Suchbegriffe.

`conversion_events` hält Ereignistyp, Herkunft sowie Firmen- und Meldungsbezug
— keine Personen, keine Klartextadressen, keine IP. Der rote Faden durch den
Trichter ist die Firma; für die Frage "an welcher Stufe bricht es ab" reicht das
vollständig.

Der Kern ist die Herkunft auf dem Token (neue Spalte magic_links.source). Ohne
sie weiß die Auswertung am Ende, dass jemand gebucht hat, aber nicht, ob er aus
einer Ablehnungsmail kam. Eine Session überlebt den Domainwechsel nicht, das
Token schon. Die Mail-Links tragen zusätzlich `?src=` und `&pr=`; die
Meldungs-ID ist fälschbar, schaltet aber nichts frei und verfälscht im
schlimmsten Fall nur unsere eigene Statistik. Mit dem Magic-Link-Zugang aus 1b.2
entfällt sie.

Fünf Stufen statt gleichrangiger Punkte, jede mit ihrer Diagnose am Enum: Vier
beliebige Konversionspunkte sagen nicht, WO es hakt. Geschrieben wird an Stufe 1
(globale Middleware — die Mail-Links zeigen auf Hub, Spokes und öffentliche
Seiten, eine vergessene Route wäre eine unsichtbare Lücke), Stufe 2
(Magic-Link-Einlösung), Stufe 4 (Registrierung) und Stufe 5 (beide
Zahlungspfade, je Firma dedupliziert — eine zweite Buchung ist keine erste).
Stufe 3 ist definiert und wird ausgewertet; ihre Schreibstelle kommt mit der
Profilpflege aus 1b.3.

Für alle Schreibstellen gilt: Fehler werden geschluckt. Die Messung begleitet
einen Vorgang, sie ist nicht der Vorgang — eine kaputte Statistik darf keine
Anmeldung und erst recht keine Buchung scheitern lassen.

`conversion:funnel` zählt je Stufe die eindeutigen Firmen, nicht die Ereignisse:
Ein doppelter Klick ist kein doppelter Interessent, und nur mit derselben
Einheit auf allen Stufen ist ein Übergang überhaupt eine Quote. Ereignisse ohne
Firmenbezug stehen daneben statt im Nenner.

Aufbewahrung 395 Tage, zusammen mit der Tabelle festgelegt statt nachgetragen,
täglich im Scheduler bereinigt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-01 13:12:12 +00:00

169 lines
7 KiB
PHP

<?php
use App\Enums\Portal;
use App\Mail\ContactRequestSubmitted;
use App\Mail\GoLivePasswordReset;
use App\Mail\MagicLoginLink;
use App\Mail\PressReleaseDepublished;
use App\Mail\PressReleasePublished;
use App\Mail\PressReleaseRejected;
use App\Mail\TerminationRequestReceived;
use App\Mail\TerminationRequestSubmitted;
use App\Mail\WithdrawalRequestReceived;
use App\Mail\WithdrawalRequestSubmitted;
use App\Models\PressRelease;
use App\Models\TerminationRequest;
use App\Models\User;
use App\Models\WithdrawalRequest;
use Illuminate\Auth\Notifications\ResetPassword;
use Illuminate\Auth\Notifications\VerifyEmail;
/**
* Alle System-Mails müssen im pressekonto-CI erscheinen: Wortmarke,
* „Publisher · Hub"-Tagline und die Zugehörigkeits-Erklärung zur
* Brand-Familie (presseecho + businessportal24) aus dem zentralen
* E-Mail-Layout (components/emails/layout). Zusätzlich: Hub verlinkt,
* Rechts-Links (AGB/Impressum/Datenschutz) im Footer und keine direkte
* Service-Mailadresse im Fließtext.
*/
function assertHubEmailBranding(string $html): void
{
expect($html)
->toContain('Publisher · Hub')
->toContain('presseecho')
->toContain('businessportal24')
->toContain('ist der gemeinsame Publisher')
->toContain('#1A2540')
->toContain('#B07A3A')
// Hub ist verlinkt (Wortmarke im Header + Brand-Familien-Zeile).
->toContain('href="'.config('domains.domain_portal_url').'"')
// Rechtliche Links im Footer (alle auf dem Hub).
->toContain(config('domains.domain_portal_url').'/de/agb')
->toContain(config('domains.domain_portal_url').'/de/impressum')
->toContain(config('domains.domain_portal_url').'/de/datenschutz')
// Keine direkte Service-Mailadresse in der Mail.
->not->toContain(config('mail.from.address'));
}
test('the magic login link mail uses the hub ci layout', function () {
$user = User::factory()->make();
assertHubEmailBranding((new MagicLoginLink($user, 'https://pressekonto.test/magic-login/abc', '12.07.2026 10:00'))->render());
});
test('the go-live password reset mail uses the hub ci layout', function () {
$user = User::factory()->make();
assertHubEmailBranding((new GoLivePasswordReset($user, 'https://pressekonto.test/reset-password/abc'))->render());
});
test('the press release published and rejected mails use the hub ci layout', function () {
$pressRelease = PressRelease::factory()->published()->create();
$user = $pressRelease->user;
assertHubEmailBranding((new PressReleasePublished($user, $pressRelease))->render());
assertHubEmailBranding((new PressReleaseRejected($user, $pressRelease, 'Bitte Quellen ergänzen.'))->render());
});
test('the press release depublished mail uses the hub ci layout and explains the tombstone', function () {
$pressRelease = PressRelease::factory()->published()->create(['depublished_at' => now()]);
$user = $pressRelease->user;
$html = (new PressReleaseDepublished($user, $pressRelease))->render();
assertHubEmailBranding($html);
expect($html)
->toContain($pressRelease->title)
->toContain('Depubliziert am')
->toContain('auf Wunsch des Absenders entfernt');
});
test('the published mail names the portal with a link to the public detail page', function () {
$pressRelease = PressRelease::factory()->published()->forPortal(Portal::Presseecho)->create();
$html = (new PressReleasePublished($pressRelease->user, $pressRelease))->render();
expect($html)
->toContain('Veröffentlicht auf')
->toContain('Auf Presseecho ansehen')
->toContain(config('domains.domain_presseecho_url').'/de/press-release/'.$pressRelease->slug);
});
test('the published mail links both portals for a cross-portal press release', function () {
$pressRelease = PressRelease::factory()->published()->forPortal(Portal::Both)->create();
$html = (new PressReleasePublished($pressRelease->user, $pressRelease))->render();
expect($html)
->toContain('Auf Presseecho ansehen')
->toContain('Auf Businessportal24 ansehen')
->toContain(config('domains.domain_presseecho_url').'/de/press-release/'.$pressRelease->slug)
->toContain(config('domains.domain_businessportal_url').'/de/press-release/'.$pressRelease->slug);
});
test('the published mail links the account area below the portal links with a login hint', function () {
$pressRelease = PressRelease::factory()->published()->forPortal(Portal::Presseecho)->create();
$mailable = new PressReleasePublished($pressRelease->user, $pressRelease);
$html = $mailable->render();
$publicUrl = config('domains.domain_presseecho_url').'/de/press-release/'.$pressRelease->slug;
expect($html)
// Escapt verglichen: Die Mail-Links tragen seit der Konversionsmessung
// zwei Parameter (`src`, `pr`), und Blade escapt das trennende `&` im
// HTML korrekt zu `&amp;`.
->toContain(e($mailable->showUrl))
->toContain('Pressemitteilung im pressekonto öffnen')
->toContain('Login-Bereich')
->toContain('mit Ihrem Passwort oder per Magic-Link');
// Reihenfolge: erst der öffentliche Portal-Link, darunter der Konto-Link.
expect(mb_strpos($html, $publicUrl))->toBeLessThan(mb_strpos($html, 'Pressemitteilung im pressekonto öffnen'));
});
test('the termination mails use the hub ci layout', function () {
$terminationRequest = TerminationRequest::factory()->create();
assertHubEmailBranding((new TerminationRequestReceived($terminationRequest))->render());
assertHubEmailBranding((new TerminationRequestSubmitted($terminationRequest))->render());
});
test('the withdrawal mails use the hub ci layout', function () {
$withdrawalRequest = WithdrawalRequest::factory()->create();
assertHubEmailBranding((new WithdrawalRequestReceived($withdrawalRequest))->render());
assertHubEmailBranding((new WithdrawalRequestSubmitted($withdrawalRequest))->render());
});
test('the contact request mail uses the hub ci layout', function () {
assertHubEmailBranding(
(new ContactRequestSubmitted('Paula Presse', 'paula@example.test', 'Eine Frage zur Plattform.', 'pressekonto.test'))->render()
);
});
test('the password reset notification renders in the hub ci layout', function () {
$user = User::factory()->create();
$mailMessage = (new ResetPassword('test-token'))->toMail($user);
expect($mailMessage->subject)->toBe('Passwort zurücksetzen für Ihr pressekonto');
$html = (string) $mailMessage->render();
assertHubEmailBranding($html);
expect($html)->toContain('/reset-password/test-token');
});
test('the email verification notification renders in the hub ci layout', function () {
$user = User::factory()->unverified()->create();
$mailMessage = (new VerifyEmail)->toMail($user);
expect($mailMessage->subject)->toBe('E-Mail-Adresse bestätigen für Ihr pressekonto');
$html = (string) $mailMessage->render();
assertHubEmailBranding($html);
expect($html)->toContain('/verify-email/');
});