Christoph
f0ff1914c9
Add the generated Gitty runtime architecture documentation produced by archify: rendered HTML, JSON specification and delivery/browser receipts, visual-check screenshots and contact sheets, and accompanying diagram JSON/visual files under docs/diagrams. These are auto-generated static documentation artifacts (archify metadata present) and should not be edited by hand.
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: Datenfluss von vorgemerkten Änderungen und Notizen zum bearbeitbaren Vorschlag.
- Repository klonen: Hauptablauf, Anmeldung mit Wiederholung und LFS-Nachbereitung.
- Merge und Konfliktauflösung: 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.