# Ordio Mitarbeiter-App (Mobile App) Documentation **Last Updated:** 2026-02-02 Comprehensive documentation of the Ordio Mitarbeiter-App (employee mobile app) for workforce management: scheduling, time tracking, absences, and HR on the go. ## Basic Information - **Feature Name:** Ordio Mitarbeiter-App (Mobile App) - **Slug:** mobile-app - **Status:** Available - **Related Product Pages:** - App Store & Integrationen: `v2/pages/product_appstore.php` - Product page: https://www.ordio.com/appstore - **Screenshot Inventory:** 90 screens analyzed with Gemini Vision API (gemini-2.5-flash; `GEMINI_VISION_MODEL`) - **Analysis Date:** 2026-02-02 - **Coverage:** 100% (90/90 screens analyzed) ## Overview Die Ordio Mitarbeiter-App bringt Schichtplanung, Zeiterfassung, Abwesenheiten und HR-Funktionen aufs Smartphone. Mitarbeiter sehen ihre Schichten, stempeln unterwegs, beantragen Urlaub und erledigen Checklisten und Dokumente – immer synchron mit dem Ordio Workspace. **Value proposition:** Alles in einer App: Schichten einsehen, Zeiten erfassen, Abwesenheiten beantragen und Unterlagen erledigen. Ordio hält dich und dein Team mobil auf dem Laufenden. ## Use Cases ### Shift Viewing and Schedule Access **Scenario:** An employee needs to check their shifts for the week while away from the office. **Process:** 1. Open the Ordio Mitarbeiter-App and log in. 2. View the calendar or list of shifts (tagesaktuelle und zukünftige Schichten). 3. See time, location, work area, and notes for each shift. 4. Switch between daily, weekly, or monthly views as needed. **Benefits:** No need to call the office or check paper schedules; shifts are always up to date and visible on the phone. ### Time Tracking on the Go **Scenario:** Staff clock in and out from different locations (e.g. retail, hospitality). **Process:** 1. Open the app and tap to start (Starten) or end (Beenden) work. 2. Record breaks if required. 3. View time entries and submit corrections if needed. 4. Optional: use GPS location for proof of presence. **Benefits:** Compliant time recording from anywhere; managers get accurate data for payroll and reporting. ### Absence and Vacation Requests **Scenario:** An employee wants to request vacation or report an absence. **Process:** 1. Open the app and go to Abwesenheiten / Urlaub. 2. Submit a new request with dates and type (e.g. vacation, sick). 3. Track vacation balance and see approved/rejected requests. 4. Receive notifications when the request is processed. **Benefits:** Requests are submitted and tracked in one place; less back-and-forth with managers. ### Shift Applications and Swap Requests **Scenario:** An employee wants to pick up an open shift or swap with a colleague. **Process:** 1. Browse open shifts in the app. 2. Apply for shifts or submit change/swap requests. 3. View application status and get notifications on approval. 4. Managers handle requests in the Ordio web app. **Benefits:** More flexibility for employees and better coverage for employers. ### Checklists and Documents **Scenario:** New hires or existing staff need to complete checklists and upload documents. **Process:** 1. View assigned checklists and required documents in the app. 2. Complete checklist items and submit responses. 3. Upload documents (e.g. ID, certificates) and track status. 4. Receive reminders for pending items. **Benefits:** Onboarding and compliance tasks can be done from the phone; fewer missed deadlines. ## Target Audience ### Primary Users **Employees (Mitarbeiter):** - Need to view shifts, clock in/out, request absences, and complete checklists. - Benefit from one app for all daily tasks and real-time updates. - Use the app daily for schedule and time tracking. **Team leads / shift managers:** - May use the app to view their own schedule and time, and to approve or coordinate requests. - Benefit from mobile access when not at a desk. ### Secondary Users **HR / admins:** - Rely on data from the app (time, absences, documents) for payroll and compliance. - Benefit from fewer manual reminders and consistent processes. ### Industries **Gastronomie & Hotellerie, Einzelhandel, Logistik, Pflege:** - Shift-based work and multiple locations make mobile access to schedules and time tracking essential. - The Ordio app supports multi-language (Deutsch, English, Nederlands, Polski) for diverse teams. ## Key Functionality ### Core Capabilities - **Shift viewing:** Current and upcoming shifts in calendar or list; time, location, work area, notes. (17 screens analyzed) - **Time tracking:** Clock in/out, breaks, time entries, optional GPS; corrections and history. (19 screens analyzed) - **Absences:** Request vacation and other absences; view balance and request status. (3 screens analyzed) - **Dashboard:** Personalized greeting, time tracking quick actions, calendar, open shifts, salary, weather, broadcasts, documents, checklists, events. (7 screens analyzed) - **Checklists:** HACCP checklists, cleaning tasks, task completion tracking, archive. (7 screens analyzed) - **Documents:** Document list, upload capability, required documents tracking. (3 screens analyzed) - **Profile & settings:** Personal data (Stammdaten), login credentials, language (DE, EN, NL, PL). (1 profile screen + 6 login screens analyzed) - **Notifications:** Push notifications for shift assignments, schedule changes, approvals, documents. ### Advanced Features - **Shift applications:** Browse and apply for open shifts; view application status. (Included in Schichtplanung screens) - **Change/swap requests:** Request shift changes or swaps; receive notifications. (Change request forms identified) - **Availability management:** Set availability status, filter by availability, view availability details. (Multiple screens) - **Broadcasts:** View broadcast messages, broadcast overview, message previews. (Identified in dashboard and other screens) - **Events:** Event list, event details, event cards on dashboard. (Identified in screens) - **Working time account:** Daily working time account display, all working times section. (In Zeiterfassung screens) ### Technical Implementation - **Platform:** Native mobile app (iOS/Android). - **Data:** Synced with Ordio backend; real-time where applicable. - **Screenshots & analysis:** 90 screens captured and analyzed with Google Gemini Vision API (gemini-2.5-flash); **comprehensive multi-pass analysis complete** (100% coverage, all 5 passes) - see [mobile-app-comprehensive-analysis-complete.md](mobile-app-comprehensive-analysis-complete.md) and [mobile-app-comprehensive-analysis-guide.md](mobile-app-comprehensive-analysis-guide.md). - **Analysis Data:** Available in `docs/data/`: - Basic analysis: `mobile-app-screenshot-analysis.json` - **Comprehensive analysis: `mobile-app-screenshot-analysis-comprehensive.json`** ✅ Complete (90/90 screens, all 5 passes) - Screen relationships: `mobile-app-screen-relationships.json` - User flows: `mobile-app-user-flows-complete.json` - Feature relationships: `mobile-app-feature-relationships-deep.json` - Benefits: `mobile-app-benefits-comprehensive.json` - Value propositions: `mobile-app-value-propositions.json` - **Scripts:** `v2/scripts/mobile-app/`: - **Basic Analysis:** - `inventory-screenshots.py` - Catalog HEIC files - `convert-screenshots.py` - HEIC → WebP/PNG conversion - `analyze-screenshots-gemini.py` - Gemini Vision API analysis (primary) - `analyze-screenshots-ai.py` - OpenAI Vision API analysis (alternative) - **Comprehensive Analysis:** - `analyze-screenshots-comprehensive-parallel.py` - **Optimized parallel analysis** (5-10x faster, recommended) ✅ Complete - `analyze-screenshots-comprehensive.py` - Sequential multi-pass analysis (5 passes, fallback) - `analyze-screen-relationships.py` - Cross-screen relationship mapping - `extract-user-flows.py` - User journey extraction - `analyze-feature-relationships.py` - Feature dependency mapping - `analyze-app-structure.py` - App-level structure analysis - `integrate-helpdesk-content.py` - Helpdesk content integration - `extract-benefits.py` - Benefit extraction - `extract-value-propositions.py` - Value proposition refinement - **Processing & Validation:** - `validate-and-group-analysis.py` - Validation and grouping - `extract-features.py` - Feature extraction - `organize-screenshots.py` - Screenshot organization - `validate-comprehensive-analysis.py` - Comprehensive analysis validation - `validate-enhanced-documentation.py` - Documentation validation - `validate-documentation.py` - Basic documentation validation - `validate-images.py` - Image validation ## User Experience ### Navigation - **Main entry:** Login (6 screens) → Workspace Selection → Dashboard (7 screens). - **From dashboard:** Access Schichten (17 screens), Zeiterfassung (19 screens), Abwesenheiten (3 screens), Checklists (7 screens), Documents (3 screens), Profile, and menu. - **Sequence flow:** Documented in [mobile-app-navigation.md](mobile-app-navigation.md) with complete 90-screen sequence. - **Navigation patterns identified:** - Calendar → Shift Details → Applications/Availability - Dashboard → Clock In → Break Management → Clock Out - List → Request Form → Confirmation (for absences, checklists, documents) ### UI Components (from analysis) **Common Patterns Identified:** - **Bottom tab navigation** - Main navigation between feature areas - **Card-based layouts** - Dashboard cards, shift cards, checklist cards - **Calendar grids** - Weekly/monthly views for shifts - **Form inputs** - Date pickers, dropdowns, text fields, checkboxes - **Action buttons** - Starten, Beenden, Add, Delete, Archive, Filter - **Status indicators** - Availability status, completion status, confirmation indicators - **Filter menus** - Location, department, availability, date filters - **Dialog windows** - Forms, confirmations, details **German UI Labels Extracted:** 100+ labels including Schichten, Starten, Beenden, Heute, Kalender, Verfügbar, Urlaub, Abwesenheiten, Checklisten, Dokumente, and more (see `docs/data/mobile-app-features-catalog.json`). ## Visual Documentation ### Screenshots - **Location:** `/v2/img/mobile-app/screens/` (originals: HEIC; web: `webp/`, by feature area; thumbs: `thumbs/`). - **Naming:** `[feature-area]-[sequence]-[screenshot-id].webp` in `webp/[feature_area]/`. - **Mapping:** `docs/data/mobile-app-screenshot-name-mapping.json`. - **Screen-by-screen:** [mobile-app-screens.md](mobile-app-screens.md). ### Diagrams - Navigation and architecture diagrams: [mobile-app-diagrams.md](mobile-app-diagrams.md). ## Comprehensive Analysis System A comprehensive multi-pass analysis system is available for deep understanding of the mobile app: - **5 Analysis Passes:** Basic identification → Deep understanding → Cross-screen relationships → User flow extraction → Benefits and value extraction - **Deep Insights:** Context, user goals, business value, state transitions, interactions, edge cases, benefits, mental models - **Relationship Mapping:** How screens connect, data flow, navigation patterns, feature dependencies - **User Journey Extraction:** Complete user journeys, error recovery flows, flow variations - **Value Extraction:** User benefits by type, value propositions, use cases, differentiators See [mobile-app-comprehensive-analysis-guide.md](mobile-app-comprehensive-analysis-guide.md) for complete documentation of the comprehensive analysis system. **Note:** The comprehensive analysis can be run on-demand when deep insights are needed. Current documentation is based on basic analysis (90 screens) with comprehensive analysis available for enhancement. ## Accuracy Verification - **Feature descriptions:** Based on helpdesk workflows, existing [mobile-apps-documentation.md](mobile-apps-documentation.md) (Mitarbeiter-App section), and AI analysis of 90 screenshots. - **Navigation flows:** Derived from screenshot sequence, helpdesk content, and relationship analysis (see [mobile-app-navigation.md](mobile-app-navigation.md)). - **Use cases and benefits:** Aligned with helpdesk and product documentation; validated by documentation and image validation scripts (see `docs/data/mobile-app-documentation-validation.json`, `mobile-app-images-validation.json`). - **Comprehensive insights:** Available through multi-pass analysis system when needed (see [mobile-app-comprehensive-analysis-guide.md](mobile-app-comprehensive-analysis-guide.md)). ## Maintenance ### Update Schedule - **App updates:** Follow app store release cycle. - **Documentation:** Update when new screens or features are added; re-run `analyze-screenshots-gemini.py` (or `analyze-screenshots-ai.py` for OpenAI) to refresh analysis. - **Analysis refresh:** Run analysis scripts when app UI changes significantly or new screenshots are added. ### Common Updates - Add or update screenshots after app redesigns. - Refresh screen descriptions after full AI or manual review. - Update navigation flows and feature lists when flows change. ## Related Documentation - [mobile-app-screens.md](mobile-app-screens.md) – Screen-by-screen list and screenshot references - [mobile-app-navigation.md](mobile-app-navigation.md) – Navigation flows and user journeys - [mobile-app-analysis-summary.md](mobile-app-analysis-summary.md) – Complete analysis summary with findings - [mobile-app-comprehensive-analysis-guide.md](mobile-app-comprehensive-analysis-guide.md) – Comprehensive multi-pass analysis system guide - [mobile-app-feature-relationships.md](mobile-app-feature-relationships.md) – Feature relationships and dependencies (to be created) - [mobile-app-user-flows.md](mobile-app-user-flows.md) – Complete user journey documentation (to be created) - [mobile-app-benefits.md](mobile-app-benefits.md) – Comprehensive benefits documentation (to be enhanced) - [mobile-apps-documentation.md](mobile-apps-documentation.md) – App Store & Integrationen (incl. Mitarbeiter-App workflows from helpdesk) - [PRODUCT_FEATURES_INVENTORY.md](PRODUCT_FEATURES_INVENTORY.md) - [schichtplanung-documentation.md](schichtplanung-documentation.md) - [zeiterfassung-documentation.md](zeiterfassung-documentation.md) - [abwesenheiten-documentation.md](abwesenheiten-documentation.md) ## Related Cursor Rules - [product-features.mdc](.cursor/rules/product-features.mdc) - [shared-patterns.mdc](.cursor/rules/shared-patterns.mdc) - [global.mdc](.cursor/rules/global.mdc)