# Gitty: drei Detaildiagramme

Die Diagramme beschreiben den Code bei Revision `47b8544ba889a1357f6578469d2163bbd438ab00`.
Die Inhalte sind Deutsch; feste Archify-Bedienelemente und HTML-Sprachkennung bleiben Englisch.

- [KI-Commit-Nachricht](ai-commit.html): Datenfluss von vorgemerkten Änderungen und Notizen zum bearbeitbaren Vorschlag.
- [Repository klonen](clone-repository.html): Hauptablauf, Anmeldung mit Wiederholung und LFS-Nachbereitung.
- [Merge und Konfliktauflösung](merge-conflicts.html): Zustände des normalen Merge mit konfliktfreiem Abschluss und Abbruch.

## Geprüfte Codebelege

| Thema | Datei und Einstieg | Aussage |
|---|---|---|
| KI-Aufruf | `src/App.svelte:1327`, `src/lib/git.ts:425` | Bestehende Nachricht wird als Notiz verwendet; Schlüssel werden geladen und per IPC weitergegeben. Die Antwort ersetzt das Nachrichtenfeld. |
| KI-Datenbasis | `src-tauri/src/git.rs:2178` | Staged-Dateiliste und gecachter Diff; generierte Lockfiles sind im Detaildiff ausgenommen. |
| KI-Anbieter | `src-tauri/src/git.rs:2216`, `src-tauri/crates/commit_ai/src/cloud.rs` | OpenAI, Anthropic oder eigener Endpunkt; native HTTP-Anfrage und Antwortverarbeitung. Der Diagrammpfeil zum Vorschlag fasst den Rückweg durch Rust und IPC zusammen. |
| Prompt | `src-tauri/crates/commit_ai/src/lib.rs:51` | Leere Änderungen werden abgewiesen; der Diff wird vor der Anfrage begrenzt. Die Instruktionen sind kein technischer Geheimnisfilter. |
| Clone-UI | `src/App.svelte:2571` | Zugangsdaten aus dem Store, Auth-Fehlerdialog, erneuter Versuch und Anwenden des RepositoryBundle. |
| Clone-Backend | `src-tauri/src/git.rs:648`, `src-tauri/src/git.rs:5840` | spawn_blocking, Zielprüfung, Git-Clone, LFS-Nachbereitung und Bundle. LFS-Fehler werden als Warnung weitergegeben. |
| Merge | `src-tauri/src/git.rs:3279` | Konflikte kommen als GitStatus zurück. Andere Merge-Fehler werden als Fehler gemeldet. |
| Fortsetzen / Abbruch | `src-tauri/src/git.rs:3336` | Fortsetzen prüft laufenden Merge und offene Konflikte; commit --no-edit. Abbruch: merge --abort. |
| Konflikt lösen | `src-tauri/src/git.rs:5000`, `src-tauri/src/git.rs:5042` | ours/theirs übernehmen oder Text schreiben; danach git add und aktualisierter Status. |

## Abstraktion und Grenzen

Die KI-Grafik zeigt Datenherkunft und Empfänger, keine vollständige Aufrufsequenz. Der OS-Keychain-Pfeil umfasst den Weg über native Credential-Befehle, UI und den erneuten Tauri-Aufruf.

Der Merge-Hauptpfad liest sich von links nach rechts: Starten, bei Konflikten warten, alle Dateien lösen und vormerken, anschließend ausdrücklich fortsetzen. Wiederholte Dateiauflösungen sind in diesem Hauptzustand zusammengefasst. Ein erfolgreicher konfliktfreier Merge überspringt die Konfliktzustände. Abbruch ist auch nach vollständiger Auflösung möglich, solange der Merge noch läuft; diese zusätzliche Kante ist zugunsten der Übersicht ausgelassen. Squash und reine ff-only-Ablehnungen sind nicht als normaler Konfliktpfad dargestellt.

## Prüfung

Alle drei Artefakte: 9/9 Showcase-Prüfungen, keine Kompositionsfehler oder Warnungen. Browserprüfung: 1440×900, 1600×1000, 1920×1080 und 2048×1320 ohne Seitenüberlauf. Visuelle Prüfung der finalen Screenshots: 1440×900 dunkel und 2048×1320 hell.

Die JSON-Spezifikationen liegen neben den HTML-Dateien. `handoff-receipts.json` enthält Typ, Pfad, SHA-256, Dateigrößen und getrennte Validierungs-, Browser- und Sichtprüfungsstatus. Die jeweiligen `.delivery.json` und `.browser.json` sind die unveränderten Werkzeugprotokolle.