Hilfe & Onboarding

Erstes Interview sauber aufsetzen

Diese Seite fuehrt dich vom Setup bis zum ersten echten Testlauf. Sie ist auf den aktuellen Produktstand abgestimmt: Interviewsprache ist Deutsch, die UI ist DE/EN umschaltbar.

Sprache:EN

0) Vorbereitung (einmalig)

API, Web und Worker laufen stabil; /health liefert status=ok.
Redis und Postgres sind verbunden (keine ECONNREFUSED-Fehler in API/Worker-Logs).
S3-kompatibler Storage ist eingerichtet (Bucket fuer Uploads vorhanden).
Du hast eine gueltige E-Mail-Adresse fuer den Magic-Link-Test.
Browser-Mikrofonberechtigung ist erlaubt, falls Sprache genutzt wird.

1) Erstes Interview im Tab Interview anlegen

1) Zugriff via Magic Link
E-Mail eintragen, Magic Link anfordern, Token aus der Mail (oder Preview-URL) in das Token-Feld kopieren und verifizieren.
2) Profil anlegen
Display Name, Slug und Typ setzen, dann Profil erstellen. Die profileId wird angezeigt und fuer Folgeaktionen genutzt.
3) Quelle + Datei-Upload + Ingest
Quelle erstellen, Datei hochladen und finalisieren, danach Ingest starten und pollen bis completed.
4) Consent aktivieren + Session starten
Consent-Checkbox aktivieren, Session starten, sessionId notieren und erste Frage laden.
5) Antworten aufnehmen
Antwort als Text speichern oder Audio aufnehmen, hochladen und dann als Antwort senden. Danach muss eine neue Folgefrage erscheinen.

2) Was bekommt dein Gespraechspartner und was macht er?

Was du ihm schickst

Interview-URL: https://<deine-web-domain>/de/interview
Magic-Link-E-Mail bzw. Token (aktueller Stand: Token wird im UI manuell verifiziert).
Kurzes Briefing: Thema, Ziel, erwartete Dauer, Hinweis auf Audio/Text-Option.
Hinweis: Interview wird auf Deutsch gefuehrt; UI kann bei Bedarf auf Englisch umgestellt werden.

Was dein Gespraechspartner genau tut

Interview-Link oeffnen.
Token im Bereich '1) Zugriff via Magic Link' eintragen und verifizieren.
Consent bestaetigen und Session starten.
Frage fuer Frage beantworten (Text oder Sprache).
Bei Sprache: Audio aufnehmen, stoppen, hochladen, danach Antwort senden.
Am Ende Session auf completed setzen (oder von dir abschliessen lassen).

Nachrichtenvorlage (copy/paste)

Hi <Name>,

hier ist dein Interview-Link:
https://<deine-web-domain>/de/interview

Bitte oeffne die Seite, trage den Token aus der Magic-Link-Mail ein und klicke auf 'Token verifizieren'.
Danach Consent bestaetigen, Session starten und die Fragen beantworten (Text oder Sprache).

Danke dir.

3) Funktionstest fuer den ersten Lauf

Session startet und zeigt eine sessionId.
Nach jeder Antwort steigt turnIndex und eine neue Frage wird erzeugt.
Audio-Flow funktioniert (record -> upload -> answer).
Session-Status Pause/Fortsetzen/Abschliessen funktioniert und sperrt Aktionen korrekt.
Session-Export als Markdown und JSON funktioniert.
Recent Sessions listet die Session und zeigt den richtigen Status.

4) Nach dem Interview: QA-Tab

In QA die Session laden und Analyse-Report pruefen.
Filter (Risk, Score, offene Turns) kurz gegenchecken.
Outputs generieren und Review-Status setzen.
Readiness pruefen, Snapshot erstellen und CMS Dry-Run testen.

Wenn etwas hakt

Token-Probleme: neuen Magic Link anfordern und erneut verifizieren.
Ingest haengt: Worker-Logs und Redis-Verbindung pruefen.
Audio geht nicht: Browser-Mikrofonrechte und HTTPS pruefen.
Keine Sessions sichtbar: profileId und Access Token im Interview-Tab kontrollieren.