🛳️ MEIN SCHIFF FLOW · TUI CRUISES PILOT

xCAR.GO — Installation Guide

xCAR.GO — Installationsanleitung

Equipment inventory & cargo-list verification tool for Mein Schiff Flow technical staff. Setup takes ~5 minutes per device.

Equipment-Inventar- & Lieferschein-Verifikationstool für die Technik-Crew der Mein Schiff Flow. Setup dauert ~5 Minuten pro Gerät.

v0.7.0 · Build 4 · TestFlight beta

📦 About xCAR.GO

📦 Über xCAR.GO

xCAR.GO is a digital tool that replaces paper-based equipment inventory and cargo-list verification with iPhone/iPad scanning. Built by an SLT for SLT and lighting/sound technicians on cruise ships, it speaks the technical language of live entertainment production.

During this pilot, your team on Mein Schiff Flow will test the app on real workflows: scanning equipment in venues like Klanghaus and verifying physical deliveries against Lieferschein PDFs from suppliers like Protones.

📷

Barcode & AI scan

Native AVFoundation barcode scanner + Claude Vision AI for automatic equipment identification from labels and photos.

📄

Photo / PDF waybill OCR

Photograph a multi-page Lieferschein or upload a PDF — Vision AI extracts header, items, quantities, and DE→EN translates them.

🛟

Works offline

Scans save locally to the device — when you re-enter onboard Wi-Fi, everything syncs automatically to the local Pi5 server.

🔒

Stays on board

All data lives on a local Pi5 server (no cloud dependency). AI keys are managed by AXV, never exposed to devices.

xCAR.GO ist ein digitales Werkzeug, das papierbasierte Equipment-Inventare und Lieferschein-Verifikation durch iPhone/iPad-Scanning ersetzt. Entwickelt von einem SLT für SLT- und Licht-/Ton-Techniker auf Kreuzfahrtschiffen, spricht es die Fachsprache der Live-Entertainment-Produktion.

Während dieses Pilotprojekts wird Eure Crew auf der Mein Schiff Flow die App in echten Workflows testen: Equipment-Scanning in Venues wie dem Klanghaus und Verifikation physischer Lieferungen gegen Lieferschein-PDFs von Lieferanten wie Protones.

📷

Barcode- & KI-Scan

Nativer AVFoundation-Barcode-Scanner + Claude Vision AI für automatische Equipment-Erkennung von Etiketten und Fotos.

📄

Foto-/PDF-Lieferschein-OCR

Mehrseitige Lieferscheine fotografieren oder als PDF hochladen — Vision AI extrahiert Header, Positionen, Mengen und übersetzt DE→EN.

🛟

Funktioniert offline

Scans werden lokal gespeichert — sobald Ihr wieder im Bord-WLAN seid, synchronisiert die App automatisch mit dem lokalen Pi5-Server.

🔒

Bleibt an Bord

Alle Daten leben auf einem lokalen Pi5-Server (keine Cloud-Abhängigkeit). KI-Schlüssel werden von AXV verwaltet, nie an Geräten exponiert.

1Hardware requirements

iPhone with iOS 15.0+ (iPhone 8/SE2 and newer)
iPad with iPadOS 15.0+
Apple ID account (any region, no credit card needed)
TestFlight app (free from App Store)
Connection to xcargo-net Wi-Fi (onboard router, installed in Klanghaus)

Note: the app communicates with a local Pi5 server on board (xcargo.local). Outside the onboard network only offline scanning works — sync happens automatically when you reconnect.

2Install TestFlight

Open App Store
Search TestFlight
Tap GET → authorize with Face ID / Touch ID
TestFlight icon now on your home screen

TestFlight is Apple's official beta testing app — free, no card required, no Apple Developer account needed.

3Install xCAR.GO via TestFlight

After opening the link on your device:

TestFlight launches automatically
Tap Accept (accept the beta invitation)
Tap Install — downloads ~10 MB
After install: xCAR.GO icon appears on home screen (with a small yellow dot indicating beta)

Beta builds expire after 90 days — TestFlight will notify you about updates. Each new build resets the 90-day timer.

4Connect to onboard Wi-Fi

The app syncs with a local Pi5 server on board — your device must be on the same network.

SSIDxcargo-net

Password(provided on board)

Serverxcargo.local

IP fallback192.168.88.10

Quick test: in Safari open http://xcargo.local/ — the onboard dashboard should load.

Out of xcargo-net range the app works offline — scans queue locally and sync when you're back in range.

5First launch & permissions

The first time you open xCAR.GO, iOS asks for permissions. Accept all — the app needs them for core functionality:

📷Camera
scan barcodes, serial numbers, AI identifyrequired 🎤Microphone
dictate descriptions / notesoptional 🗣Speech Recognition
voice-to-text transcriptionoptional 🖼Photo Library
AI identify from gallery photosoptional

Accidentally rejected? Go to Settings → xCAR.GO → toggle each permission ON and restart the app.

6API key (automatic)

The app auto-discovers the Pi5 server and fetches the AI API key. If auto-setup fails:

In the app: Settings → Scan API key QR
On a laptop / another device: open the onboard dashboard at http://xcargo.local/ → menu → API Key QR
Scan the QR with the app's camera — key saves locally to the device

The API key never leaves the onboard network. It's a per-fleet key managed by AXV; devices receive it via local QR exchange only.

7Troubleshooting

● offline in sidebar

App cannot reach Pi5. Verify Wi-Fi → xcargo-net. In Safari open http://xcargo.local/ping — should return JSON. If not: toggle iPhone Wi-Fi off/on.

"No projects" on launch

The Pi5 hasn't been set up with projects yet. Contact the AXV technical lead — the project for Mein Schiff Flow needs to be created in the dashboard first.

AI identify doesn't work

The server may be missing an API key configuration. Report it to the technical lead — needs server-side fix.

Camera permission denied

Settings → xCAR.GO → Camera → toggle ON. Restart the app afterwards.

Scanner won't read barcode

Check lighting. Hold the device ~15 cm from the code, parallel to the surface. Native scanner supports EAN-13, Code128, QR, DataMatrix, PDF417.

App freezes after update

Force quit (swipe up + swipe app off) and reopen. If issues persist — uninstall and reinstall via TestFlight (local unsynced data may be lost; report this if it happens).

"TestFlight invitation expired"

Each build has a 90-day lifespan. Contact AXV for a refresh — usually a new build is already available.

iPad doesn't rotate to landscape

By design — the app is portrait-only with full-screen mode for scanning focus. Hold the iPad vertically.

8Update to a new version

TestFlight sends a push notification: "xCAR.GO has a new beta available"
Open TestFlight → xCAR.GO → tap Update
After update: read the "What to Test" notes — describes changes & what to focus on

9Feedback & bug reports

In TestFlight: tap xCAR.GO → Send Beta Feedback
Shake the iPhone while in the app (TestFlight intercepts & shows feedback dialog)
Attach a screenshot + describe what happened & what you expected
Urgent issues: contact AXV directly (see footer)

1Hardware-Voraussetzungen

iPhone mit iOS 15.0+ (iPhone 8/SE2 und neuer)
iPad mit iPadOS 15.0+
Apple ID (beliebige Region — keine Kreditkarte nötig)
TestFlight-App (kostenlos im App Store)
Verbindung zum WLAN xcargo-net (Bord-Router, im Klanghaus installiert)

Hinweis: Die App kommuniziert mit einem lokalen Pi5-Server an Bord (xcargo.local). Außerhalb des Bordnetzes funktioniert nur Offline-Scanning — die Synchronisation erfolgt automatisch bei erneuter Verbindung.

2TestFlight installieren

App Store öffnen
Nach TestFlight suchen
Auf Laden tippen → mit Face ID / Touch ID bestätigen
TestFlight erscheint auf dem Home-Bildschirm

TestFlight ist Apples offizielle App für Beta-Tests — kostenlos, keine Kreditkarte, kein Apple Developer Account nötig.

3xCAR.GO über TestFlight installieren

Nach dem Öffnen des Links auf dem Gerät:

TestFlight startet automatisch
Akzeptieren tippen (Beta-Einladung annehmen)
Installieren tippen — Download ~10 MB
Nach der Installation erscheint das xCAR.GO-Symbol auf dem Home-Bildschirm (mit kleinem gelben Punkt = Beta)

Beta-Builds laufen nach 90 Tagen ab — TestFlight benachrichtigt automatisch über Updates. Jeder neue Build setzt die 90 Tage zurück.

4Mit Bord-WLAN verbinden

Die App synchronisiert mit dem lokalen Pi5-Server an Bord — das Gerät muss im selben Netzwerk sein.

SSIDxcargo-net

Passwort(an Bord erhältlich)

Serverxcargo.local

IP-Fallback192.168.88.10

Schnelltest: in Safari http://xcargo.local/ öffnen — das Bord-Dashboard sollte erscheinen.

Außerhalb der xcargo-net-Reichweite arbeitet die App offline — Scans werden lokal in einer Warteschlange gespeichert und synchronisiert, sobald wieder Verbindung besteht.

5Erster Start & Berechtigungen

Beim ersten Öffnen von xCAR.GO fragt iOS nach Berechtigungen. Alle erlauben — die App benötigt sie für die Kernfunktionalität:

📷Kamera
Barcodes, Seriennummern, KI-Erkennungerforderlich 🎤Mikrofon
Beschreibungen / Notizen diktierenoptional 🗣Spracherkennung
Sprache zu Textoptional 🖼Fotomediathek
KI-Erkennung aus Galeriefotosoptional

Versehentlich abgelehnt? Einstellungen → xCAR.GO → jede Berechtigung auf EIN und App neu starten.

6API-Schlüssel (automatisch)

Die App erkennt den Pi5-Server automatisch und holt den KI-Schlüssel. Falls das nicht klappt:

In der App: Einstellungen → API-Key-QR scannen
Auf einem Laptop / anderen Gerät: Bord-Dashboard unter http://xcargo.local/ öffnen → Menü → API Key QR
QR mit der App-Kamera scannen — Schlüssel wird lokal gespeichert

Der API-Schlüssel verlässt nie das Bordnetz. Es ist ein Flottenschlüssel, verwaltet von AXV; Geräte erhalten ihn nur per lokalem QR-Austausch.

7Troubleshooting

● offline in Sidebar

App erreicht den Pi5 nicht. WLAN prüfen → xcargo-net. In Safari http://xcargo.local/ping öffnen — sollte JSON zurückgeben. Falls nicht: iPhone-WLAN aus/einschalten.

„Keine Projekte" beim Start

Der Pi5 ist noch nicht mit Projekten eingerichtet. Technical Lead kontaktieren — das Projekt für Mein Schiff Flow muss erst im Dashboard angelegt werden.

KI-Erkennung funktioniert nicht

Dem Server fehlt möglicherweise eine API-Key-Konfiguration. An den Technical Lead melden — Server-seitiger Fix nötig.

Kamera-Berechtigung verweigert

Einstellungen → xCAR.GO → Kamera → auf EIN. Danach App neu starten.

Scanner liest Barcode nicht

Beleuchtung prüfen. Gerät ~15 cm vom Code halten, parallel zur Oberfläche. Native Scanner unterstützt EAN-13, Code128, QR, DataMatrix, PDF417.

App stürzt nach Update ab

Force Quit (nach oben wischen + App wegwischen) und neu öffnen. Falls weiter problematisch — über TestFlight neu installieren (lokal nicht synchronisierte Daten gehen evtl. verloren; bitte melden, falls das passiert).

„TestFlight-Einladung abgelaufen"

Jeder Build hat eine Lebensdauer von 90 Tagen. AXV kontaktieren für einen neuen Link — meist ist bereits ein neuer Build verfügbar.

iPad dreht nicht ins Querformat

So gewollt — die App ist Portrait-only mit Vollbild-Modus für Scanning-Fokus. iPad senkrecht halten.

8Auf neue Version aktualisieren

TestFlight sendet Push-Benachrichtigung: „xCAR.GO has a new beta available"
TestFlight öffnen → xCAR.GO → Update tippen
Nach dem Update: „What to Test"-Hinweise lesen — beschreibt Änderungen & Testschwerpunkte

9Feedback & Fehlermeldungen

In TestFlight: xCAR.GO antippen → Beta-Feedback senden
iPhone in der App schütteln (TestFlight zeigt Feedback-Dialog)
Screenshot anhängen + beschreiben, was passiert ist & was erwartet wurde
Dringende Probleme: AXV direkt kontaktieren (siehe Footer)