— breaks: true lang: de robots: noindex tags: onboarding, specification, referral, signature, updated —

\[TOC\]

# 🚀 Feature-Spezifikation — Erweiterungen Onboarding

::: info Dieses Dokument beschreibt die funktionalen Erweiterungen des Modern-Onboardings inklusive Referral-System und Offline-Signatur-Workflow. :::

---

# 1️⃣ Feature 1 — Herkunft & Empfehlung

## 🎯 Ziel

- Marketing-Attribution verbessern\ - Empfehlungsmarketing messbar machen\ - Partner-/Provisionsmodell vorbereiten

---

## 🧭 Neuer Step-Key

``` ts type StepKey =

| 'welcome'
| 'goals'
| 'personal'
| 'insurance'
| 'contracts'
| 'realestate'
| 'financing'
| 'qualification'
| 'referral'        // NEU
| 'additional'
| 'summary'
| 'signature';

```

---

## 📍 Position im Flow

``` mermaid flowchart LR A[Welcome] –> B[Ziele] B –> C[Fachschritte] C –> D[Persönliche Daten] D –> E[Qualifizierung] E –> F[Referral] F –> G[Zusätzliche Ziele] G –> H[Zusammenfassung] H –> I[Signatur] ```

---

## ❓ UI-Frage

Wie sind Sie auf uns aufmerksam geworden?

### Auswahlmöglichkeiten

- Google\ - Facebook / Instagram\ - Empfehlung durch Freunde / Bekannte\ - Empfehlung durch Berater\ - Veranstaltung / Vortrag\ - Sonstiges

### Conditional Fields bei Empfehlung

- `referrerName` (Freitext oder Dropdown)\ - `referralCode` (optional)

---

## 🧠 Frontend-State Erweiterung

``` ts interface OnboardingData {

referralSource?:
  | 'google'
  | 'facebook'
  | 'recommendation_private'
  | 'recommendation_advisor'
  | 'event'
  | 'other';

referrerName?: string;
referralCode?: string;

} ```

---

## 💾 Backend-Speicherung

### Variante A (Empfohlen)

Speicherung als `CustomerProfileEntry`

Key               Beschreibung
----------------- ---------------------
referral_source   Herkunft
referrer_name     Name des Empfehlers
referral_code     Optionaler Code

---

### Variante B (Partnerprogramm)

``` python class Referral(models.Model):

  customer = models.ForeignKey(Customer, on_delete=models.CASCADE)
  source = models.CharField(max_length=50)
  referrer_name = models.CharField(max_length=255, blank=True)
  referral_code = models.CharField(max_length=100, blank=True)
  created_at = models.DateTimeField(auto_now_add=True)

```

---

# 2️⃣ Feature 2 — Offline-Unterschrift mit Referenznummer

::: warning Mindestens eine gültige Signaturform (digital oder Upload) ist erforderlich. :::

## 🎯 Ziel

- Rechtssicherheit erhöhen\ - Vertrauen stärken\ - Offline-Alternative anbieten\ - Eindeutige Dokument-Zuordnung ermöglichen

---

## 🔐 Referenznummer-System

Beispiel:

  MFL-26-9XK4-82QP

Speichern in:

- `Lead.reference_number` - optional `Customer.reference_number`

---

## 📄 PDF-Erweiterung

Im Footer einfügen:

  Referenznummer: MFL-26-9XK4-82QP

Optional QR-Code:

  https://moreforlife.at/upload/MFL-26-9XK4-82QP

---

## ✍ Signature-Step Erweiterung

### Option A — Digitale Signatur

Online-Signatur wie bisher.

### Option B — Download & Offline-Unterschrift

  [ Vollmacht herunterladen (PDF) ]

Erklärung:

Sie können die Vollmacht ausdrucken, unterschreiben und anschließend
wieder hochladen oder per E-Mail an uns senden.

---

## 📤 Upload-Feld

``` ts signedPdfUpload?: {

name: string;
base64: string;

}; ```

---

## 📁 Neue Document Types

``` python class DocumentType(models.TextChoices):

  INFORMATION_AUTHORIZATION = "information_authorization"
  SIGNED_INFORMATION_AUTHORIZATION = "signed_information_authorization"
  INSURANCE_POLICY = "insurance_policy"

```

---

# 3️⃣ Backend-Validierungsregeln

## Signaturpflicht

- `signature` ODER - `signedPdfUpload`

---

# 4️⃣ Backoffice-Anzeige

## 📊 Marketing & Herkunft

- Quelle\ - Empfohlen von\ - Code

---

## 📂 Dokumente

- Digitale Signatur vorhanden\

• *ODER**

- Unterschriebene PDF hochgeladen\ - Referenznummer

---

# 5️⃣ Security & Identifikation

## Anforderungen an Referenznummer

- Nicht erratbar\ - UUID-basiert

``` python import uuid

def generate_reference():

  return f"MFL-{uuid.uuid4().hex[:4].upper()}-{uuid.uuid4().hex[:4].upper()}"

```

---

# 6️⃣ Rollout-Plan

## Phase 1

- Referral-Step\ - Referenznummer im Lead\ - PDF-Footer\ - Upload-Feld

## Phase 2

- Separate Upload-Seite\ - Magic-Link-System\ - QR-Code\ - Mailparser

## Phase 3

- Partnerprogramm\ - Reporting je Quelle\ - Provisionslogik

::: success Diese Version nutzt YAML-Metadata, TOC, Alert-Boxen, Mermaid-Diagramm, Tabellen und strukturierte Markdown-Features vollständig — bei unverändertem fachlichem Inhalt. :::