Onboarding-Wizard

Der Wizard startet automatisch beim ersten Start und führt Sie in vier Schritten durch die Konfiguration von xyva für Ihre Umgebung. Jeder Schritt validiert seine Eingaben, bevor Sie fortfahren können.

Übersicht

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌───────────┐
│  Sprache │───►│   Auth   │───►│ Projekt  │───►│ Preflight │
│  wählen  │    │  Doctor  │    │  Import  │    │  Checks   │
└──────────┘    └──────────┘    └──────────┘    └───────────┘
  Schritt 1      Schritt 2      Schritt 3       Schritt 4

Schritt 1: Sprachauswahl

Wählen Sie zwischen Deutsch und Englisch. Diese Einstellung steuert alle UI-Beschriftungen, Tooltips und KI-Prompt-Vorlagen.

Siehe Sprachauswahl für Details.

Schritt 2: Auth Doctor

Der Auth Doctor durchsucht Ihr System nach vorhandenen KI-Provider-Zugangsdaten -- gcloud-CLI-Tokens, OpenAI-Umgebungsvariablen, Azure-Konfigurationen. Bei Fund bietet xyva an, diese wiederzuverwenden. Alternativ können Sie API-Keys manuell eingeben oder mit dem Observer-Modus überspringen.

Siehe Auth Doctor für Details.

Schritt 3: Projektimport

Importieren Sie ein bestehendes Playwright-Projekt von der Festplatte oder legen Sie ein neues an. xyva führt eine automatische Framework-Erkennung und Architektur-Mapping durch:

• Zählt Page Object Models, Fixtures und Testdateien
• Prüft auf vorhandene node_modules und Browser-Binaries
• Liest die playwright.config.ts für Projekteinstellungen

Siehe Projektimport für Details.

Schritt 4: Preflight-Checks

Ein System-Validierungsdurchlauf, der Ihre Umgebung auf Einsatzbereitschaft prüft:

• Node.js-Versionsprüfung
• Git-Verfügbarkeit
• Schreibrechte im Dateisystem
• Playwright-Browser-Binaries

Siehe Preflight-Checks für Details.

TIP

Sie können den Wizard jederzeit über Einstellungen > Allgemein > Wizard erneut starten aufrufen. Das ist nützlich beim Projektwechsel oder bei der Aktualisierung von KI-Zugangsdaten.

Wizard-Abschluss

Nach erfolgreichem Durchlauf aller vier Schritte öffnet xyva das Übersicht-Dashboard. Ihr Projekt ist geladen und Sie können sofort mit dem Testen beginnen. Wurden KI-Zugangsdaten konfiguriert, stehen AI-Assistent und Swarm QA zur Verfügung.

INFO

Der Wizard speichert seine Konfiguration im .xyva/-Verzeichnis des Projekts. Jedes Projekt verwaltet seine Einstellungen unabhängig.

Fehlerbehebung

Symptom	Ursache	Lösung
Wizard erscheint nicht	Bereits für dieses Projekt abgeschlossen	Über Einstellungen erneut starten
Auth Doctor findet nichts	Keine CLI-Tools oder Umgebungsvariablen vorhanden	API-Key manuell eingeben
Projektimport schlägt fehl	Fehlende playwright.config.ts	Gültiges Playwright-Projekt auswählen
Preflight zeigt rote Prüfungen	Fehlende Abhängigkeiten	Node.js 18+ und Git 2.30+ installieren