80 — Akademie: Kurse & Lektionen

Die Akademie ist das Schulungs-Modul von PartnerDesk. Tenant-Admins erstellen Kurse mit Lektionen — Partner durchlaufen sie und tracken ihren Fortschritt.

Aufbau

Ebene	Inhalt
Kurs	Logischer Container — z. B. „Onboarding für neue Partner"
Lektion	Einzelne Lerneinheit (Video + Resources + optional Quiz)
Fortschritt	Pro Partner und Lektion: Status open/completed

Kurs anlegen (Admin)

Admin-Portal → „Akademie" → „Neuer Kurs":

Feld	Bedeutung
Titel	z. B. „Onboarding für neue Partner"
Beschreibung	Was lernen die Partner
Vorschaubild	URL zum Cover-Image
Sortier-Reihenfolge	Position in der Liste
isPublished	Master-Switch — unveröffentlichte Kurse sehen Partner nicht

Lektion anlegen

Innerhalb eines Kurses → „Lektion hinzufügen":

Feld	Bedeutung
Titel	z. B. „1. Dein Dashboard verstehen"
Video-Quelle	YouTube/Vimeo-Embed-URL ODER direkt-hochgeladenes Video
Dauer (Sekunden)	Display-Zeit
Resources (HTML)	Zusatzmaterial — TipTap-WYSIWYG-Editor: Links, Bilder, formatierter Text

Video-Optionen

Variante A: YouTube/Vimeo-Embed

Schnell, kostenfrei, hosted. Aber: öffentlich oder mit „unlisted" sichtbar.

Setup: Video bei YouTube/Vimeo hochladen → Embed-URL kopieren → in PartnerDesk eintragen.

Variante B: Direkt-Upload

Video bleibt privat auf der PartnerDesk-Plattform. Für sensible/kostenpflichtige Inhalte.

Setup:

• Limits: bis zu 500 MB pro Video.
• Formate: MP4, WebM, MOV, MKV.
• Upload via Drag&Drop im Lektion-Editor mit Progress-Bar.
• Stream wird mit HTTP Range-Support ausgeliefert → seekbar im Browser.
• controlsList="nodownload" verhindert Browser-Standard-Download.

Partner-Sicht

Partner-Portal → „Akademie":

• Kurs-Cards mit Progress-Bar (z. B. „3 von 7 Lektionen abgeschlossen").
• Klick auf Kurs → Detail-Layout:
  • YouTube/Vimeo-Embed (16:9 Aspect-Ratio) oder Custom-Video-Player.
  • Lektions-Liste rechts, click-to-switch.
  • „Als abgeschlossen markieren"-Button unter jeder Lektion.
• Resources (HTML) werden unter dem Video gerendert.

Fortschritts-Tracking

Pro Partner und Lektion wird gespeichert, ob sie abgeschlossen wurde. Statistiken:

• Anzahl abgeschlossener Lektionen pro Kurs.
• Prozent-Fortschritt.
• Datum der letzten Aktivität.

Mit Quiz

Optional kann jede Lektion ein Quiz haben (siehe 81). Bei aktiver Lektion mit Quiz:

• Partner muss das Quiz bestehen, bevor die Lektion als completed gilt.
• Ohne Quiz: manuelle „Abschließen"-Klick reicht.

Nach Kurs-Komplettierung

Wenn ein Partner alle Lektionen eines Kurses abgeschlossen hat:

1. Notification wird ausgelöst (academy.course_completed).
2. Zertifikat-PDF kann der Partner herunterladen (siehe 82).

Use-Cases

• Onboarding: Neue Partner lernen das System.
• Produkt-Training: Wie verkaufe ich Produkt X optimal?
• Compliance: AGB-Schulung, Werberichtlinien.
• Vertriebs-Akademie: Best Practices, Skript-Vorlagen.

Verwandte Kapitel

• 81 — Quiz-System
• 82 — Zertifikate
• 70 — Notifications

---

Technische Tiefen-Doku: ../098-academy.md, ../111-academy-video-upload.md, ../113-tiptap-wysiwyg.md