Skip to content

๐Ÿšข iOS App zum Verwalten und Dokumentieren von Kreuzfahrt-Reisen. SwiftUI + SwiftData + Gemini AI fรผr Buchungs-Import.

License

Notifications You must be signed in to change notification settings

andyholiday/ShipTrip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

13 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ShipTrip ๐Ÿšข

Eine iOS-App zum Verwalten und Dokumentieren von Kreuzfahrt-Reisen.

Swift iOS SwiftUI SwiftData Version

๐Ÿ“‹ Changelog | ๐Ÿ“– Dokumentation

โœจ Features

Kreuzfahrten verwalten

  • ๐Ÿ“‹ Kreuzfahrten mit allen Details erfassen (Schiff, Reederei, Kabine, Buchungsnummer)
  • ๐Ÿ—บ๏ธ Interaktive Karte mit Routen-Visualisierung
  • ๐Ÿ“ธ Fotos zu jeder Reise hinzufรผgen
  • โญ Bewertungssystem
  • ๐ŸŒŠ Seetage erfassen

KI-gestรผtzter Import

  • ๐Ÿค– Gemini 2.5 Flash Integration - Buchungsbestรคtigungen per KI analysieren
  • Automatische Extraktion von:
    • Reisedaten (Titel, Datum, Schiff, Reederei)
    • Hรคfen mit Ankunfts-/Abfahrtszeiten
    • Seetage

๐Ÿ›ณ๏ธ ~1.800 Hรคfen weltweit

  • ๐ŸŒ Europa, Karibik, Asien, Ozeanien, Afrika, VAE/Oman
  • Autocomplete bei der Hafen-Suche
  • Automatische Koordinaten-Zuordnung

Statistiken

  • ๐Ÿ“Š Kreuzfahrten pro Jahr
  • ๐Ÿ’ฐ Ausgaben nach Kategorie
  • ๐Ÿ† Top Reedereien
  • Besuchte Lรคnder & Hรคfen

Weitere Features

  • ๐Ÿ’ธ Ausgaben-Tracking
  • ๐Ÿ”” Push-Benachrichtigungen vor Reisestart
  • ๐ŸŽจ Dark Mode Support
  • ๐Ÿ“ฑ Native iOS 17 Design

๐Ÿ› ๏ธ Technologie-Stack

Komponente Technologie
UI Framework SwiftUI 5.0
Datenbank SwiftData
Karten MapKit
Charts Swift Charts
AI Google Gemini 2.5 Flash
Sicherheit Keychain Services
Notifications UserNotifications

๐Ÿ“ Projektstruktur

ShipTrip/
โ”œโ”€โ”€ App/
โ”‚   โ””โ”€โ”€ ShipTripApp.swift          # App Entry Point
โ”œโ”€โ”€ Models/
โ”‚   โ”œโ”€โ”€ Cruise.swift               # Kreuzfahrt-Model
โ”‚   โ”œโ”€โ”€ Port.swift                 # Hafen-Model
โ”‚   โ”œโ”€โ”€ Expense.swift              # Ausgaben-Model
โ”‚   โ”œโ”€โ”€ Deal.swift                 # Angebote-Model
โ”‚   โ”œโ”€โ”€ Photo.swift                # Foto-Model
โ”‚   โ”œโ”€โ”€ ShippingLine.swift         # Reederei-Daten
โ”‚   โ””โ”€โ”€ PortSuggestion.swift       # ~1.800 Hafen-Datenbank
โ”œโ”€โ”€ Views/
โ”‚   โ”œโ”€โ”€ Cruises/
โ”‚   โ”‚   โ”œโ”€โ”€ CruiseListView.swift   # รœbersicht
โ”‚   โ”‚   โ”œโ”€โ”€ CruiseDetailView.swift # Details
โ”‚   โ”‚   โ””โ”€โ”€ CruiseFormView.swift   # Erstellen/Bearbeiten
โ”‚   โ”œโ”€โ”€ Map/
โ”‚   โ”‚   โ””โ”€โ”€ MapView.swift          # Weltkarte mit Routen
โ”‚   โ”œโ”€โ”€ Deals/
โ”‚   โ”‚   โ””โ”€โ”€ DealsView.swift        # Angebote
โ”‚   โ”œโ”€โ”€ Stats/
โ”‚   โ”‚   โ””โ”€โ”€ StatsView.swift        # Statistiken
โ”‚   โ””โ”€โ”€ Settings/
โ”‚       โ””โ”€โ”€ SettingsView.swift     # Einstellungen
โ”œโ”€โ”€ Services/
โ”‚   โ”œโ”€โ”€ GeminiService.swift        # AI Integration
โ”‚   โ”œโ”€โ”€ KeychainService.swift      # Sichere Speicherung
โ”‚   โ””โ”€โ”€ NotificationService.swift  # Push-Benachrichtigungen
โ””โ”€โ”€ Assets.xcassets/               # App Icon & Assets

๐Ÿ“š Dokumentation

Dokument Beschreibung
Setup Guide Installation & Einrichtung
Architektur Technische Architektur
Datenmodelle SwiftData Models
API Integration Gemini, Keychain, Notifications
Contributing Beitragsrichtlinien
Changelog Versionshistorie

๐Ÿš€ Installation

Voraussetzungen

  • Xcode 15.0+
  • iOS 17.0+ Simulator oder Gerรคt
  • Apple Developer Account (fรผr Gerรคt-Tests)

Schritte

  1. Repository klonen

    git clone https://github.com/DEIN-USERNAME/ShipTrip.git
    cd ShipTrip
  2. Projekt รถffnen

    open ShipTrip.xcodeproj
  3. Gemini API Key einrichten (optional, fรผr KI-Features)

    • Google AI Studio รถffnen
    • API Key erstellen
    • In der App unter Einstellungen โ†’ API Key eingeben
  4. Bauen & Starten

    • โŒ˜B zum Bauen
    • โŒ˜R zum Starten

๐Ÿ“ธ Screenshots

Kommt bald

๐Ÿ”ฎ Roadmap

v1.0 โœ…

  • Kreuzfahrten verwalten
  • Karten-Integration
  • KI-Import
  • Statistiken
  • ~1.800 Hรคfen (Wikidata Import)

v2.0 (geplant)

  • Export/Import (JSON)
  • CloudKit Sync
  • Hafen-Bilder + KI-Generierung
  • Wetter-API Integration
  • Auto-Import von Reederei-Angeboten

๐Ÿค Contributing

Contributions sind willkommen! Bitte erst ein Issue erstellen, bevor du einen PR einreichst.

๐Ÿ“„ Lizenz

MIT License - siehe LICENSE fรผr Details.

๐Ÿ‘จโ€๐Ÿ’ป Autor

Entwickelt mit โค๏ธ und ๐Ÿค– AI-Unterstรผtzung.


Made for cruise lovers ๐Ÿšข

About

๐Ÿšข iOS App zum Verwalten und Dokumentieren von Kreuzfahrt-Reisen. SwiftUI + SwiftData + Gemini AI fรผr Buchungs-Import.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages