MedZeit is an iOS app for time tracking for medical professionals: overtime, on-call duties, night and weekend premiums, insights into workload and earnings, and achievements that reflect your pace. This guide reflects the app’s English UI labels (Overview, Entries, Insights, Achievements).

Getting started

Requirements

• Device: iPhone with a supported iOS version (see App Store listing).
• Account: Email sign-in is available for sync; without Firebase you may still use local/demo flows as implemented in your build.
• Network: Needed for sign-in, cloud sync (when enabled), and optional AI analysis.

First launch

On first use, Welcome to MedZeit walks you through basics: base hourly rate (contractual rate—you can change it later) and work week (which days count as regular workdays). Finish to reach the main app.

Language

MedZeit supports English and German. The sign-in screen can switch language; in Settings → General you set the app language. If translations fail to load, built-in fallbacks may show.

Signing in

Use Email and Password to sign in or create an account. After sign-in, your data can sync with the cloud when that feature is active. The login screen highlights trust: secure sign-in and sync. If you sign out, you’ll need credentials again to reach cloud-backed data.

Main navigation

Four sections appear in the bottom bar:

1. Overview — today’s progress, month stats, prognosis, recharge, quick add.
2. Entries — calendar, list/table views, timers, editing and deletion.
3. Insights — compliance-style dashboard, wellbeing, earnings heatmap, workload, optional AI summary.
4. Achievements — goals and badges.

Settings opens from Overview (gear). Choose your default tab in Settings so the app opens where you prefer.

Overview tab

The Overview is your daily cockpit.

Header messages

• Streak: consecutive workdays logged.
• Monthly goal: congratulation when reached.
• Month close deadline: days left to close the month (for your own planning).

Shift day and “extra” banners

Shift day marks days you plan to work. Banners explain on-call, extra hours, and premium (night/weekend/holiday) states: planned, timer running, or already logged—so you don’t double-count.

Time to recharge

A wellness-style card shows recovery context after shifts (percentage “charged”, time until rest target, short encouraging lines). This is motivational, not medical advice.

Key cards

• Prognosis: projected hours and pay for the month when enough data exists.
• Extra hours / services / pay: snapshot of overtime-style hours, how many calendar days have entries, and pay totals.
• Monthly forecast & comparison: pace-based forecast; compare month or quarter vs the previous period (hours, pay, overtime).
• Daily progress: today vs target hours; on days off, work logged is called out separately.
• Previous month review: quick link to review last month’s hours.

Quick add

Use Quick add for presets you define in Settings (for example a fixed on-call lump sum or +1h overtime). Presets save taps for recurring patterns.

Entries tab

Views

Switch between Day, Week, and Table layouts. Use Sort (ascending/descending), Expand all / Collapse all for long lists.

New entry

Add an entry with:

• Date & time — from, to, break minutes.
• Category — see categories below.
• Description — free-text note.

You can Start timer for a live session; stopping asks to save or discard.

Categories (default set)

Examples available in the app (names may match your employer’s scheme):

• Overtime
• On-call 1 / 2 / 3
• Attendance on-call
• On-call (no incident)
• Phone call
• Night work
• Saturday / Sunday work
• Holiday

Enable or disable categories under Settings → Categories. Some categories are always on by app design.

Deleting data

You can delete a single entry, an entire day, or a week—each asks for confirmation. Deletion is permanent.

Insights tab

Compliance dashboard

Shows high-level status for legal and contractual checks derived from your entries, such as:

• Working time law: daily max (e.g. 10h) and weekly max (e.g. 60h) where implemented.
• Rest period: minimum rest between shifts (e.g. 11h).

Text may reference provisions such as the German Working Time Act (ArbZG) for illustration. Verify against your contract and local law.

Contractual limits

Tracks indicators like night shifts per month and weekend services per quarter against limits you configure in Settings, plus compensation earned where applicable.

Earnings heatmap

Calendar-style view of daily earnings for the current month (more intense color = higher amount).

Workload analysis

Distribution of hours and weekly overview; filters such as This month and Last 3 months.

Wellbeing analysis

Additional perspective on workload patterns (informational).

AI analysis (optional)

If you add a Gemini API key (from Google AI Studio) in Settings → AI analysis, you can generate a personal compliance summary. Tap Update to run requests deliberately and save API usage. Errors usually mean missing key or no connectivity. Data is sent to Google only when you trigger this feature.

Achievements tab

Goals include (among others): Hour Club (hours in a month), Streak master (consecutive workdays), Night owl, Weekend warrior, Phone titan, Early bird (shifts before 6:00), Hours collector (lifetime hours), Clinic king (long shift), and All-rounder (diverse service types in one month). Enable or adjust targets under Settings → Achievements.

Settings (detailed)

Open Settings from Overview and tap Save when done.

Account

Shows Logged in as (email or identifier). Backup/subscription status appears here when applicable.

General

• Appearance: System, Light, Dark, or Cool tones.
• Language: English / German.
• Default view: which tab opens first.
• Hide pay by default: privacy blur for on-screen pay figures.
• Export author name & currency: for official exports (e.g. timesheet PDF) and money formatting (ISO currency code; defaults to EUR if unset).

Work time

• Weekly hours and Work days — define your contract pattern.
• Max night shifts per month / Max weekend services per quarter / Overtime factor — used for insights and limits.

Categories

Toggle which entry types appear. Some are required by the app. Descriptions explain quick-add and “always active” categories.

Note templates

Default note text per category to speed up logging.

Achievements

Enable goals and tune thresholds.

Rates

• Base hourly rate and per-category rates.
• On-call calculation: Percentage of base or Lump sum multipliers for weekday vs weekend.
• Surcharges per category — night, Saturday, Sunday, holiday.

Quick entries

Create labeled shortcuts with duration and linked categories (for example “+1h overtime”).

Notifications

Smart reminders: daily wrap-up time (optional workdays only) and weekly review. iOS permission is required; if blocked, open System Settings. Preview shows how reminders will read.

AI analysis

Optional Gemini API key for Insights (see above).

Danger zone

• Sign out — leaves the account session.
• Clear data — removes all entries, settings, and achievements on device (irreversible).
• Delete account — removes account and associated data where supported (irreversible).

MedZeit Backup (Premium)

Optional MedZeit Backup adds encrypted cloud sync, JSON import for restore and new devices, and uses your Apple ID for billing. Features described on the in-app paywall include encryption before data leaves the device and multi-device use. Subscriptions are managed in Apple Settings → Apple ID → Subscriptions. Restore purchases if you reinstall.

Export and import

• Export data / Year summary — generate files for your records (availability depends on build).
• Import from JSON — replaces existing data; confirmation required. Use only trusted backup files.

Troubleshooting

• Data not syncing: check network, sign-in, and Backup subscription status.
• AI analysis fails: verify API key, network, and that you tapped Update.
• Notifications missing: enable in iOS Settings → Notifications → MedZeit.
• Wrong pay totals: review base rate, category rates, on-call method, and surcharges in Settings.

Privacy reminder

Use Hide pay by default in public places. Read our Privacy Policy for data processing.

Legal & support

Terms of Use · Privacy Policy · Support & Contact

Questions: p.r.struijkerboudier[at]me.com

MedZeit ist eine iOS-App zur Zeiterfassung für medizinisches Personal: Überstunden, Bereitschaft, Nacht- und Wochenendzuschläge, Einblicke in Arbeitsbelastung und Vergütung sowie Erfolge, die Ihr Tempo widerspiegeln. Dieses Handbuch beschreibt die deutsche Oberfläche der App (Übersicht, Einträge, Insights, Erfolge) und den Funktionsstand ab Version 1.1.8.

Was Sie mit MedZeit können

• Arbeit erfassen: Dienste, Bereitschaft, Überstunden und Zuschläge — mit Notizen, Live-Timer und optionalen Einheiten pro Eintrag (z. B. RVU-ähnlich) für eigene Unterlagen und Exporte.
• Kategorien umbenennen: eigene Bezeichnungen in den Einstellungen; sie erscheinen in der App und in PDF-/CSV-Exporten (interne Kategorie-IDs bleiben stabil).
• Übersicht & Schnelleintrag: Prognose, Periodenvergleich, dienstbezogene Karten und von Ihnen definierte Presets für wiederkehrende Muster.
• Insights: konfigurierbare Compliance-ähnliche Hinweise (nur Information), vertragliche Grenzen, Vergütungs-Heatmap, Arbeitslastanalyse (inkl. Summen optionaler Einheiten) und Wohlbefinden bezogen auf Ihr Wochenstundenlimit.
• Export & Währung: PDF, CSV und JSON; Spalten-Presets (alle Spalten, kompaktes internationales Layout oder eigene Auswahl); optionaler Name auf dem PDF; ISO-Währung für Summen.
• Englische Oberfläche: bei App-Sprache Englisch wählen Sie in den Einstellungen International (EU) oder US (hospital) für medizinische Begriffe — konsistent in der ganzen App (Tabs, Formulare, Mitteilungen u. a.).
• Sprachen & Backup: Deutsch und Englisch; optionales MedZeit Backup für verschlüsselte Cloud-Synchronisation und JSON-Import (Abo).

Erste Schritte

Voraussetzungen

• Gerät: iPhone mit unterstützter iOS-Version (siehe App Store).
• Konto: Anmeldung per E-Mail für Sync; ohne Firebase können je nach Build lokale/Demo-Abläufe möglich sein.
• Netzwerk: für Anmeldung, Cloud-Sync (wenn aktiv) und optionale KI-Analyse.

Erster Start

Beim ersten Start führt Willkommen bei MedZeit durch die Grundlagen: Basis-Stundensatz (Vertragssatz — später änderbar) und Arbeitswoche (welche Tage als reguläre Arbeitstage gelten). Abschließen, um zur Hauptansicht zu gelangen.

Sprache

MedZeit unterstützt Deutsch und Englisch. Auf dem Anmeldebildschirm kann die Sprache gewechselt werden; unter Einstellungen → Allgemein stellen Sie die App-Sprache ein. Bei Englisch können Sie zusätzlich die medizinische Terminologie wählen: International (EU) oder US (hospital) — Labels werden app-weit aktualisiert. Bei Ladefehlern können eingebaute Fallback-Texte erscheinen.

Anmeldung

Mit E-Mail und Passwort anmelden oder Konto erstellen. Nach der Anmeldung können Ihre Daten bei aktivem Cloud-Backup synchronisiert werden. Der Login-Bildschirm betont Vertrauen: sichere Anmeldung und Sync. Nach Abmelden benötigen Sie die Zugangsdaten erneut für cloudgebundene Daten.

Hauptnavigation

Vier Bereiche in der unteren Leiste:

1. Übersicht — Tagesfortschritt, Monatsstatistik, Prognose, Aufladen, Schnelleintrag.
2. Einträge — Kalender, Listen-/Tabellenansicht, Timer, Bearbeiten und Löschen.
3. Insights — Compliance-Dashboard, Wohlbefinden, Vergütungs-Heatmap, Arbeitslast, optionale KI-Zusammenfassung.
4. Erfolge — Ziele und Abzeichen.

Einstellungen öffnen Sie von der Übersicht (Zahnrad). Unter Einstellungen wählen Sie den Standard-Tab für den App-Start.

Tab Übersicht

Die Übersicht ist Ihr tägliches Cockpit.

Kopfmeldungen

• Serie: aufeinanderfolgende erfasste Arbeitstage.
• Monatsziel: Glückwunsch bei Erreichen.
• Monatsabschluss: verbleibende Tage bis zum Monatsende (eigene Planung).

Diensttag und „Extra“-Hinweise

Diensttag markiert geplante Arbeitstage. Banner erklären Bereitschaft, Mehrstunden und Zuschläge (Nacht/Wochenende/Feiertag): geplant, Timer läuft oder bereits erfasst — damit nichts doppelt gezählt wird.

Zeit zum Aufladen

Eine Wellness-Karte zeigt Erholungskontext nach Diensten (Prozent „aufgeladen“, Zeit bis zum Ruheziel, kurze motivierende Texte). Das ist Motivation, keine medizinische Beratung.

Wichtige Karten

• Prognose: voraussichtliche Stunden und Vergütung im Monat bei ausreichend Daten.
• Mehrstunden / Dienste / Vergütung: Überblick über Überstunden-artige Stunden, Tage mit Einträgen und Vergütungssummen.
• Monatsprognose & Vergleich: Tempo-basierte Prognose; Monat oder Quartal vs. Vorperiode (Stunden, Vergütung, Überstunden).
• Tagesfortschritt: heute vs. Soll-Stunden; an freien Tagen wird erfasste Arbeit separat ausgewiesen.
• Vormonat: Kurzlink zur Stundenübersicht des letzten Monats.

Schnelleintrag

Schnelleintrag nutzt Presets aus den Einstellungen (z. B. fester Bereitschaftspauschalbetrag oder +1 h Überstunden). Weniger Tippen bei wiederkehrenden Mustern.

Tab Einträge

Ansichten

Wechsel zwischen Tag, Woche und Tabelle. Sortieren (auf-/absteigend), Alle aufklappen / Alle zuklappen bei langen Listen.

Neuer Eintrag

Eintrag mit:

• Datum & Uhrzeit — von, bis, Pausenminuten.
• Kategorie — siehe Kategorien unten.
• Beschreibung — Freitextnotiz.
• Einheiten (optional) — z. B. RVU; für Dokumentation, Arbeitslast und Exporte — nicht für die Vergütungsberechnung.

Timer starten für eine laufende Session; beim Stoppen speichern oder verwerfen.

Kategorien (Standard)

Beispiele in der App (unter Einstellungen → Kategorien umbenennen, wie sie in UI und Export erscheinen):

• Überstunden
• Bereitschaft 1 / 2 / 3
• Anwesenheit Bereitschaft
• Bereitschaft ohne Vorkommnis
• Telefonat
• Nachtarbeit
• Samstags- / Sonntagsarbeit
• Feiertag

Kategorien unter Einstellungen → Kategorien ein- oder ausschalten. Einige sind vom App-Design her immer aktiv.

Daten löschen

Sie können einen Eintrag, einen ganzen Tag oder eine Woche löschen — jeweils mit Bestätigung. Die Löschung ist endgültig.

Tab Insights

Compliance-Dashboard

Überblick zu gesetzlichen und vertraglichen Prüfungen aus Ihren Einträgen. Standard-Hinweise orientieren sich oft an EU-ähnlichen Grenzen (z. B. Tages- und Wochenobergrenzen, Mindestruhe zwischen Einträgen) — Schwellen können Sie unter Einstellungen → Arbeitszeit anpassen. Nur zur Information, keine Rechtsberatung.

Texte können Rahmen wie das deutsche Arbeitszeitgesetz (ArbZG) erwähnen. Prüfen Sie Vertrag und lokales Recht.

Vertragliche Grenzen

Indikatoren z. B. Nachtdienste pro Monat und Wochenenddienste pro Quartal gegen von Ihnen gesetzte Grenzen, plus Vergütung wo zutreffend.

Vergütungs-Heatmap

Kalenderansicht der Tagesvergütung im aktuellen Monat (intensivere Farbe = höherer Betrag).

Arbeitslastanalyse

Stundenverteilung und Wochenüberblick; Filter wie Dieser Monat und Letzte 3 Monate. Bei optionalen Einheiten auf Einträgen können Summen hier erscheinen.

Wohlbefinden

Zusätzliche Perspektive auf Arbeitsmuster (Information), skaliert auf Ihre vertraglichen Wochenstunden aus den Einstellungen.

KI-Analyse (optional)

Mit einem Gemini-API-Schlüssel (Google AI Studio) unter Einstellungen → KI-Analyse können Sie eine persönliche Compliance-Zusammenfassung erzeugen. Aktualisieren startet Anfragen bewusst und spart API-Nutzung. Fehler bedeuten meist fehlenden Schlüssel oder keine Verbindung. Daten gehen nur bei von Ihnen ausgelöster Nutzung an Google.

Tab Erfolge

Ziele u. a.: Stunden-Club (Stunden im Monat), Serienmeister (aufeinanderfolgende Arbeitstage), Nachteule, Wochenendkrieger, Telefon-Titan, Frühaufsteher (Schicht vor 6:00), Stundensammler (Gesamtstunden), Klinik-König (lange Schicht), Allrounder (verschiedene Diensttypen in einem Monat). Unter Einstellungen → Erfolge aktivieren und Schwellen anpassen.

Einstellungen (im Detail)

Einstellungen von der Übersicht öffnen und bei Änderungen Speichern.

Konto

Angemeldet als (E-Mail oder Kennung). Backup-/Abo-Status erscheint hier, wenn zutreffend.

Allgemein

• Erscheinungsbild: System, Hell, Dunkel oder Cool.
• Sprache: Deutsch / Englisch.
• Medizinische Terminologie (nur englische UI): International (EU) oder US (hospital).
• Standardansicht: welcher Tab zuerst öffnet.
• Vergütung standardmäßig ausblenden: Unschärfe für Beträge in der App.
• Optionaler Name auf PDF & Währung: Name auf PDF-Stundennachweisen; ISO-Währungscode (Standard EUR wenn leer).

Arbeitszeit

• Wochenstunden und Arbeitstage — Vertragsmuster (auch für Wohlbefinden vs. Ihr Limit).
• Konfigurierbare Compliance-Hinweise: Obergrenzen Stunden/Tag/Woche und Mindestruhe — nur Information.
• Max. Nachtdienste/Monat / Max. Wochenenddienste/Quartal / Überstundenfaktor — für Insights und Grenzen.

Kategorien

Eintragstypen ein-/ausschalten. Einige sind pflichtig. Eigene Bezeichnungen für UI und Export (leer = Standard für Ihre Sprache). Beschreibungen erklären Schnelleintrag und „immer aktiv“.

Notizvorlagen

Standardnotiz pro Kategorie zum schnelleren Erfassen.

Erfolge

Ziele aktivieren und Schwellen anpassen.

Sätze & Zuschläge

• Basis-Stundensatz und Sätze pro Kategorie.
• Bereitschaft: Prozent vom Basis oder Pauschale mit Faktoren Werktag vs. Wochenende.
• Zuschläge pro Kategorie — Nacht, Samstag, Sonntag, Feiertag.

Schnelleinträge

Kurzlabels mit Dauer und verknüpften Kategorien (z. B. „+1 h Überstunden“). Vorlage kann Standard-Presets durch EU-Klinik- oder internationale englische Labels ersetzen (bestehende Einträge bleiben unverändert).

Benachrichtigungen

Intelligente Erinnerungen: tägliche Zusammenfassung (optional nur Arbeitstage) und Wochenreview. iOS-Berechtigung nötig; bei Blockierung Systemeinstellungen öffnen. Vorschau zeigt den Wortlaut.

KI-Analyse

Optionaler Gemini-API-Schlüssel für Insights (siehe oben).

Gefahrenzone

• Abmelden — beendet die Sitzung.
• Alle Daten löschen — entfernt alle Einträge, Einstellungen und Erfolge auf dem Gerät (unwiderruflich).
• Konto löschen — entfernt Cloud-Inhalte zu diesem Konto und meldet ab; das Login-Konto (E-Mail) wird dabei nicht automatisch gelöscht. Vollständige Löschung des Logins: siehe Datenschutzerklärung.

MedZeit Backup (Premium)

Optionales MedZeit Backup: verschlüsselte Cloud-Synchronisation, JSON-Import für Wiederherstellung und Gerätewechsel, Abrechnung über Ihre Apple-ID. Die Paywall in der App beschreibt Verschlüsselung vor dem Upload und Nutzung auf mehreren Geräten. Abos verwalten: Einstellungen → Apple-ID → Abonnements. Bei Neuinstallation Käufe wiederherstellen.

Export und Import

• Daten exportieren / Jahresübersicht — PDF, CSV oder JSON.
• Exportspalten (CSV & PDF): Preset (alle Spalten, kompakt international oder individuell) und einzelne Spalten; Datumsspalte immer enthalten.
• Import aus JSON — ersetzt bestehende Daten; Bestätigung nötig. Nur vertrauenswürdige Backup-Dateien (mit MedZeit Backup, wo erforderlich).

Fehlerbehebung

• Kein Sync: Netzwerk, Anmeldung und Backup-Abo prüfen.
• KI-Analyse schlägt fehl: API-Schlüssel, Netzwerk und Tipp auf Aktualisieren.
• Keine Mitteilungen: iOS Einstellungen → Mitteilungen → MedZeit.
• Falsche Vergütung: Basis, Kategoriesätze, Bereitschaftsmethode und Zuschläge in den Einstellungen prüfen.

Datenschutz

Vergütung standardmäßig ausblenden in der Öffentlichkeit. Details: Datenschutzerklärung.

Rechtliches & Support

Nutzungsbedingungen · Datenschutzerklärung · Support & Kontakt

Fragen: p.r.struijkerboudier@me.com