Technik

Was unter der Haube steckt

Native macOS App

Überweisungen ist eine native macOS-App, gebaut mit SwiftUI und optimiert für Apple Silicon. Kein Electron, kein Web-Wrapper — echtes macOS-Feeling.

Frameworks & Technologien

  • SwiftUI — Modernes deklaratives UI-Framework mit NavigationSplitView
  • CoreData — Lokale Datenpersistenz für alle Überweisungen und Tags
  • Vision — Apples OCR-Framework für Texterkennung in Bildern und Scans
  • PDFKit — PDF-Verarbeitung und Textextraktion
  • DeepSeek API — KI-Datenextraktion mit konfigurierbarem System-Prompt
  • AppleScript — Automatisierte Kommunikation mit MoneyMoney

Architektur

Die App folgt einer klaren Service-Architektur:

  • DocumentParserService — Zentrale Dokumentenverarbeitung mit async/await und Background-Threading
  • DeepSeekService — API-Kommunikation mit Token-Tracking
  • MCPServerService — Eingebetteter HTTP/JSON-RPC 2.0 Server für KI-Integration
  • MoneyMoneyService — AppleScript-basierte Bankübertragungen an MoneyMoney
  • PersistenceController — CoreData-Stack-Management
  • ContentView — Haupt-UI mit NavigationSplitView (Sidebar + Detail)

Datenverarbeitung

  1. Dokument wird per Drag & Drop importiert
  2. Textextraktion je nach Format (PDF direkt, Bild via OCR)
  3. Extrahierter Text wird an DeepSeek API gesendet
  4. JSON-Antwort wird geparst und als CoreData-Entität gespeichert
  5. Überweisung erscheint in der Sidebar mit Status “Offen”

MCP Server

Der eingebettete MCP (Model Context Protocol) Server ermöglicht die Steuerung der App durch KI-Assistenten:

  • Network.framework — Apples NWListener für den TCP/HTTP-Server
  • JSON-RPC 2.0 — Standard-Protokoll für Tool-Aufrufe
  • 12 Tools — CRUD für Überweisungen, MoneyMoney-Integration, Statistiken, CSV-Export
  • Localhost-only — Sicherheit durch lokale Bindung
  • @MainActor Singleton — Thread-safe CoreData-Zugriff

JSON Import & Export

  • Export: Alle Überweisungen als strukturiertes JSON mit Tags, Metadaten, Scan-Informationen
  • Import: Duplikaterkennung per UUID, Tag-Wiederherstellung, automatische Datumskonvertierung (ISO 8601)
  • Menü-Integration: Ablage → Überweisungen importieren/exportieren (⇧⌘I / ⇧⌘E)

Systemanforderungen

  • macOS 14.0 Sonoma oder neuer
  • Apple Silicon oder Intel Mac
  • Internetverbindung für KI-Analyse (DeepSeek API)
  • MoneyMoney (optional, für Überweisungsfunktion — eigenständige App von MRH applications)