# Private-Alpha-Test

## Mit dem vorbereiteten Testpaket starten

1. Einen separaten, leeren Desktop-Vault in Obsidian anlegen.
2. Den mitgelieferten Ordner `code-explorer` nach `<Test-Vault>/.obsidian/plugins/` kopieren.
3. `example.code-explorer.json` nach `<Test-Vault>/Code Explorer/Projects/` kopieren (Ordner bei Bedarf anlegen).
4. Obsidian für diesen Vault neu laden und unter Community-Plugins `Code Explorer` aktivieren.
5. Über die Befehlspalette `Code Explorer: Open Code Explorer` öffnen. Der Beispielgraph muss erscheinen.

Das Paket enthält alle vier Plugin-Dateien und benötigt keinen Paketmanager. Eine lokale Node-Installation ist nur für den separaten CLI-Aufruf nötig. AI-Erklärungen sind optional und benötigen eine bereits eingerichtete Claude-CLI. Die Grundfunktionen lassen sich ohne Claude testen.

Prüfsummen: Im entpackten Paket `shasum -a 256 -c SHA256SUMS` ausführen.

Bei einer bereits vorhandenen Installation das Installationsskript aus dem Repository verwenden. Es sichert die vorige Plugin-Version samt Einstellungen unter `<Test-Vault>/.code-explorer-backups/`. Zum Zurücksetzen Obsidian schließen und den gesicherten Ordner als `.obsidian/plugins/code-explorer` wiederherstellen.

## Aufbau

1. `pnpm check` ausführen.
2. Plugin mit `node scripts/install-test-vault.mjs <test-vault>` in einen separaten Vault kopieren.
3. `code-explorer` ausschließlich im Test-Vault aktivieren.
4. Ein vorbereitetes TypeScript-/JavaScript-Projekt ausdrücklich analysieren.

## Drei Architektur- und Impact-Fragen

1. Welche Module bilden die wichtigsten Einstiegspunkte, und welche Dateien enthalten sie?
2. Welche Elemente hängen direkt vom zentralen Domänenmodell ab?
3. Welche Komponenten oder Aufrufer könnten von einer Änderung an einem ausgewählten Kernsymbol betroffen sein, und welche Evidenz stützt diese Einschätzung?

## Erfolgskriterium

Alle drei Fragen lassen sich in höchstens 20 Minuten nur mit Code Explorer beantworten, ohne IDE und ohne vollständige Quellcodeansicht. Beobachtete Unsicherheiten, fehlende Kanten und falsche Beziehungen werden separat notiert.

## Abnahme vor Abschluss der privaten Alpha

- [ ] Beispielgraph in Obsidian geladen; keine Laufzeitfehler.
- [ ] Suche, Typfilter, Auswahl und Quellbelege funktionieren.
- [ ] Container lassen sich öffnen und schließen; Positionen bleiben nach erneutem Öffnen erhalten.
- [ ] Screenshot-Prüfung bei großem und schmalem Desktop-Fenster bestanden.
- [ ] Drei Architekturfragen mit Vertriebspost und Book Library geprüft; Resultate dokumentiert.
- [ ] Optionaler AI-Pfad: Abbrechen überträgt nichts; Bestätigen liefert eine Erklärung oder eine klare Fehlermeldung.

Automatisierte Tests und ein validierter Beispielgraph ersetzen diese Obsidian-Abnahme nicht. Öffentliche Beta, weitere Sprachen und Community-Listung sind spätere Schritte.
