Skip to content

Flow: newsletter signup and the 5% welcome voucher

The banner lives above the footer on every website page except the social impact page. The rules below are enforced in portal code and pinned by specs; the Terms of Service (section 17) carries the legal text.

flowchart TD
    A[Visitor on keferboeck.com] --> B["Banner step 1: first name, last name,\nemail, company (optional but needed for voucher)"]
    B -->|next: form swipes right| C[Contact stored in portal immediately]
    C --> D[Confirmation email queued, 10 s delay]
    B --> E["Step 2: service interests\nStep 3: articles + project updates"]
    E -->|done| F[Topics granted in consent ledger]
    D --> G{Clicks tokened link in inbox?}
    G -->|no| H[Stored but never in any send audience]
    G -->|yes| I[confirmed_at set]
    I --> J{Company given AND topics > 0\nAND offer window open\nAND no voucher ever for this email?}
    J -->|no| K[Newsletter only]
    J -->|yes| L["Voucher issued: KEF5 code,\n1% per topic capped at 5%,\nexpires in 3 months"]
    L --> M[Voucher email with code, expiry, terms link]
    M --> N{Stays subscribed?}
    N -->|unsubscribes all topics| O["Voucher voided instantly,\nreason + timestamp,\nnever revives"]
    N -->|yes| P[Georg marks redeemed in admin\nagainst first retainer invoice]

Key invariants: one voucher per email and per company, ever; percentage fixed at confirmation; the preference centre warns holders before they void themselves; admin shows percentage, state, void reason and date.