Veröffentlichen & Subdomain

Der Weg zur Live-Kampagne

Damit deine Kampagne öffentlich erreichbar wird, müssen drei Dinge erfüllt sein:

Dein Tenant hat eine aktive Lizenz (siehe Tarife & Rechnungen).
Bei Tarif Plus+ ist die Subdomain vom Super-Admin freigegeben (provisioniert). Bei Tarif Basic reicht ein eindeutiger Slug.
Der Kampagnen-Status ist auf published gesetzt.

Zwei Veröffentlichungs-Modi je nach Tarif

Tarif	URL-Schema	Subdomain-Approval nötig?
Basic	`https://adventdigital.de/kampagne/<slug>`	Nein — der Slug muss nur eindeutig sein.
Plus / Pro / Premium	`https://<subdomain>.adventdigital.de/`	Ja — Super-Admin muss die Subdomain provisionieren.

Slug = Subdomain-Feld: Du gibst beim Anlegen nur einen Wert ein. Bei Plus+ ist er der Subdomain-Name, bei Basic der Pfad-Slug. Wechselst du nachträglich den Tarif (z. B. Plus → Basic), bleibt die Kampagne erreichbar — der Slug-Pfad funktioniert auch dann, wenn keine Subdomain provisioniert wurde.

Ohne aktive Lizenz erscheint statt des grünen Veröffentlichen-Buttons ein indigofarbener Button „Tarif buchen", der dich zur Preise-Seite leitet. Bestehende veröffentlichte Kampagnen aus früheren Lizenzen bleiben erstmal erreichbar; bestätigt sich aber, dass die Lizenz abgelaufen ist, werden neue Teilnehmer-Registrierungen blockiert.

Subdomain-Lifecycle (nur Tarif Plus+)

Status	Was bedeutet das?	Was kannst du tun?
Entwurf (kein `subdomain_approved_at`)	Frisch angelegte Kampagne. Super-Admin hat die Subdomain noch nicht gesehen.	Du kannst Subdomain noch ändern und weiter am Inhalt arbeiten.
`pending`	Super-Admin hat freigegeben; KeyHelp-Provisionierung läuft (Job im Hintergrund).	Warten — meist 30–90 Sekunden. Bei Fehler wechselt Status auf `failed`.
`provisioned`	Subdomain live, Let's-Encrypt-Zertifikat eingerichtet.	Du kannst jetzt veröffentlichen. Der Veröffentlichen-Button wird grün.
`failed`	Provisionierung ist gescheitert (DNS, API-Fehler, …).	Super-Admin kontaktieren — er kann mit einem Klick „Erneut versuchen".

Subdomain-Freigabe anfordern

Sobald deine Kampagne angelegt ist, informiere den Super-Admin (intern per Mail, Ticket oder Chat). Er öffnet den Bereich Subdomains im Super-Admin-Backend, prüft deinen Wunschnamen und klickt auf „Freigeben". Falls der Name besetzt ist oder gegen Konventionen verstößt, kann er ihn im gleichen Dialog korrigieren.

Nach der Freigabe ist die Subdomain fixiert. Du kannst sie als Tenant danach nicht mehr ändern — das verhindert kaputte Links, sobald die Kampagne im Umlauf ist.

Kampagne veröffentlichen

Auf der Edit-Seite erscheint — sobald der Status provisioned ist — ein grüner Button „Veröffentlichen". Ein Klick setzt status = published. Die Kampagne ist ab sofort unter ihrer FQDN erreichbar:

https://<subdomain>.adventdigital.de/

Zurück in den Entwurf

Falls nötig kannst du mit „Zurück in Entwurf" die Veröffentlichung temporär zurückziehen. Die Subdomain bleibt erhalten (ein Besuch landet dann auf einer Hinweisseite).

Was macht die Provisionierung technisch?

KeyHelp-API wird per POST /domains angesprochen, legt die Subdomain an und setzt den Webroot auf das Plattform-Verzeichnis.
Let's Encrypt (wenn in den Super-Admin-Einstellungen aktiviert) wird per PUT /domains/{id} angefordert.
Bei Erfolg wird subdomain_status auf provisioned und keyhelp_domain_id gesetzt.
Bei einem Löschen der Kampagne wirft der CampaignObserver einen DeprovisionCampaignSubdomain-Job, der die Subdomain wieder aus KeyHelp entfernt.

Für dich als Tenant: Du siehst nur den Status (Entwurf, pending, aktiv, fehlgeschlagen). Die API-Calls laufen im Hintergrund — kein manueller Eingriff nötig.