FuhrparkDesktop für macOS

Native macOS-App (SwiftUI + Core Data) zur Verwaltung eines kleinen Fuhrparks: Fahrzeuge, Betankungen, sonstige Ausgaben, Belege und Spritpreise an einem Ort.

[!WARNING] Dies ist ein reines vibe - coding Projekt, weil ich die Möglichkeiten von Claude Code antesten wollte, d.h. die App und die zugeörige Webseite sind komplett KI generiert. Nutzung auf eigene Gefahr! :)

Funktionen

• Fahrzeugverwaltung – Kennzeichen, Hersteller, Modell, Tachostand; Kennzeichen werden beim Anlegen auf Duplikate geprüft (stillgelegte Fahrzeuge blockieren ihr Kennzeichen nicht, ein Nachfolgefahrzeug darf es erneut nutzen).
• Fahrzeug stilllegen – stillgelegte Fahrzeuge erscheinen in einer eigenen Sidebar-Sektion, können keine Betankungen mehr erfassen (sonstige Ausgaben weiterhin) und lassen sich nicht reaktivieren.
• Betankungen – Menge, Preis, Verbrauch (automatisch oder manuell), Historie mit Verlaufs-Charts. Eine fahrzeugübergreifende Tabelle aller Betankungen mit Filter, Sortierung und wählbaren Spalten öffnet sich als eigenes Fenster über Ansichten → Betankungen.
• Sonstige Ausgaben/Einnahmen – mit frei definierbaren Kategorien und Empfänger-Autovervollständigung. Eine fahrzeugübergreifende Tabelle aller Buchungen mit Filter, Sortierung, wählbaren Spalten und anklickbaren Belegen öffnet sich als eigenes Fenster über Ansichten → Sonstige Buchungen. In beiden Tabellenfenstern (Betankungen, Sonstige Buchungen) bleiben von Hand eingestellte Spaltenbreiten erhalten, auch über einen Neustart hinweg.
• Dokumente – Belege (PDF, Fotos, …) einer oder mehreren sonstigen Ausgaben desselben Fahrzeugs zuordnen, auch nachträglich; die zentrale Dokumenten-Übersicht mit Filter nach Fahrzeug/Kategorie öffnet sich als eigenes Fenster über Ansichten → Dokumente. Die Datei wird dabei nur einmal abgelegt.
• Erinnerungen - laß Dich an den nächsten TÜV Termin oder an die fällige Versicherung/Steuer erinnern. Die Seitenleiste zeigt unter „Erinnerungen“ die fälligen; die vollständige, fahrzeugübergreifende Liste mit Filter nach Status und Fahrzeug öffnet sich als eigenes Fenster über Ansichten → Erinnerungen.
• Notizen – fahrzeugbezogene Notizen mit Datum, Text und optional angehängten Dokumenten. Die fahrzeugübergreifende Liste mit Filter nach Fahrzeug und Zeitraum öffnet sich als eigenes Fenster über Ansichten → Notizen.
• Statistik – Kosten pro Kategorie, pro Jahr, pro Fahrzeug.
• PDF-Export – Fahrzeugbericht und Statistikübersicht als mehrseitiges PDF mit Kopf-/Fußzeile und sauberen Seitenumbrüchen, direkt aus dem jeweiligen Aktionsmenü.
• Spritpreise – Umkreissuche über die Tankerkönig-API (eigener API-Key erforderlich, wird lokal gespeichert und nicht mit exportiert).
• Konfigurierbare Seitenleiste – Erinnerungen, Spritpreise und KI-Zugriff lassen sich einzeln aus der Seitenleiste ausblenden.
• Datenexport/-import – vollständiges JSON-Backup aller Fahrzeuge, Betankungen, Ausgaben, Kategorien und Dokumente (Tools → Daten exportieren / importieren).
• KI-Zugriff (MCP) – die Daten lassen sich einer KI wie Claude über das Model Context Protocol zum Lesen bereitstellen, siehe unten.

Voraussetzungen

• macOS 26 oder neuer
• Xcode (aktuelle Version)
• XcodeGen (brew install xcodegen)

KI-Zugriff (MCP)

Die App kann ihre Daten über das Model Context Protocol für eine KI wie Claude lesbar machen. Damit lassen sich Fragen wie „Was kostet mich der Wagen pro Kilometer?" oder „Was wird demnächst fällig?" direkt im Chat beantworten.

Dazu läuft dasselbe App-Binary wahlweise als GUI oder – mit --mcp-stdio gestartet – als MCP-Server. Weil dieser Prozess die App selbst ist, liest er die Daten direkt aus deren Datenbank: ohne Kopie, ohne Zwischendatei und immer auf aktuellem Stand. Die App muss dafür nicht laufen.

Einrichtung: in der App auf KI-Zugriff in der Seitenleiste gehen. Dort stehen die fertigen Konfigurationsangaben für Claude Desktop und Claude Code zum Kopieren, dazu ein Selbsttest, der die Verbindung sofort prüft.

Angeboten werden neun ausschließlich lesende Werkzeuge: Flottenübersicht, Fahrzeugdetails, Listen für Betankungen, Ausgaben, Erinnerungen und Belege, Kostenauswertung, Volltextsuche und eine Diagnose. Es gibt keinen Weg, über den die KI Daten anlegen, ändern oder löschen könnte.

Datenschutz

Alle eingegebenen Daten bleiben auf deinem Rechner. Es werden keinerlei Daten in die Cloud gesendet.

Ausnahme: der Tankerkönig-API Key - falls eingegeben - muss natürlich an den Tankerkönig Server gesendet werden, sonst funktioniert die Tankstellen Umkreissuche nicht.

Zur Update-Prüfung: Die App kann beim Start höchstens einmal täglich nachsehen, ob eine neue Version vorliegt. Dazu lädt sie eine kleine, für alle identische Datei von fuhrpark-macos.gerd-klaus.de – ohne jeden Parameter, insbesondere ohne die verwendete Version. Beim Webserver landet dabei nur, was bei jedem Seitenaufruf anfällt (IP-Adresse und Zeitpunkt); ein Nutzungsprofil lässt sich daraus nicht bilden. Die Prüfung wird beim ersten Start ausdrücklich erfragt und lässt sich jederzeit im Menü „FuhrparkDesktop“ → „Automatisch nach Updates suchen“ abschalten. Heruntergeladen oder installiert wird nichts von selbst – die App verweist nur auf die Download-Seite.

Zum KI-Zugriff: Er ist nur aktiv, wenn Du ihn selbst in Deinem MCP-Client einträgst, und überträgt nichts von sich aus. Was Du fragst, entscheidet, welche Daten an die KI gehen – und damit an deren Anbieter.

Sicherung & Wiederherstellung

Zwei Wege, die unterschiedliche Zwecke haben:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗