Merge pull request #21622 from opf/merge-release/17.0-20260111040139

Merge release/17.0 into dev

Author: myabc

docs/mobile-app-guide/README.md

@@ -0,0 +1,100 @@
+---
+sidebar_navigation:
+  title: Mobile app guide (Beta)
+  priority: 972
+description: User guide for the OpenProject Mobile application.
+keywords: Mobile app guide, mobile, mobile application, iOS, android, app store, appstore, app-store, google play
+---
+# Mobile app guide (Beta)
+
+We are excited to announce the **Beta Release** of the **OpenProject Mobile app** — now available in the **App Store** and **Google Play Store**. This Beta version marks the beginning of our journey to bring **OpenProject** to your mobile devices, enabling you to stay connected and productive wherever you are.
+
+> [!NOTE]
+> The app is currently under active development, and core features are being continuously improved. We invite you to test the app, share feedback, and help shape the future of OpenProject Mobile.
+
+## Purpose and Vision
+
+The **OpenProject Mobile app** is designed as a **companion application** to the OpenProject web and desktop experience. It allows you to:
+
+- **Access your work packages** and projects on the go.
+- **React and respond** quickly to updates, comments, and notifications.
+- **Stay informed** about project progress, tasks, and deadlines — anytime, anywhere.
+- **Track your work and log time** directly within the app to keep your reporting up to date.
+
+The goal is to provide **lightweight mobile access** for essential collaboration and project management tasks, perfectly complementing the full web experience of OpenProject.
+
+## Current Beta Features
+
+In this initial Beta version, you can:
+
+*   Log in securely with your **OpenProject credentials.**
+*   View and edit your **work packages.**
+*   **Comment** and **reply** to discussions.
+*   View your **portfolio, program or project** details.
+*   Receive **notifications** about updates and mentions.
+*   Quickly **search** and **filter** work packages.
+*   **Track** and **log** your work time.
+
+## Mobile-Only Features
+
+The **OpenProject Mobile App** introduces a set of features built specifically for mobile devices, designed to make project management faster, more focused, and more convenient wherever you are:
+*   **Attach photos directly from your camera:** Capture and upload images instantly to work packages or comments — ideal for documenting on-site work, visual progress, or issues in real time.
+*   **Local notifications:** Stay up to date with mentions, comments, and task updates through local notifications — even when the app isn’t open. *These notifications are not yet real-time push notifications.*
+*   **Create work packages fast:** Quickly add new work packages in a distraction-free interface designed for fast, mobile-friendly input.
+*   **Run timers in focus mode:** Track your work time effortlessly with built-in timers that run in the background, helping you stay focused and accurate with time logs.
+*   **Configure modules and dashboards:** Customize what you see by enabling only the modules and views most relevant to you — keeping your mobile workspace clean and efficient.
+*   **Optimized touch interface:** Navigate with ease using gestures, adaptive layouts, and mobile-first design tailored for smaller screens.
+
+These mobile-specific capabilities enhance your ability to **work efficiently, document instantly, and stay connected** — all while maintaining focus and flexibility on the go.
+
+## Coming Soon
+
+The app is still under development, and many core features are planned for future updates, including:
+
+*   **Deep-linking (including on-premises support):** Seamlessly open specific work packages, projects, or comments directly from links in emails, chats, or browser pages — whether you’re using the cloud or an on-premises instance.
+*   **Multi-device UI:** Enjoy a consistent, responsive experience across phones, tablets and macOS, with layouts optimized for each device size and orientation.
+*   **Real-time push notifications:** Receive updates instantly as they happen — from mentions and comments to task status changes — ensuring you never miss important activity.
+*   **Write internal comments:** Add internal comments directly from the app, enabling secure collaboration within your project team while keeping external communications separate.
+*   **Meeting agendas in the app:** Access and review meeting agendas on the go to stay prepared and aligned with your team wherever you are.
+
+These upcoming features will make the OpenProject Mobile App even more connected, collaborative, and aligned with the full OpenProject experience.
+
+## Feedback and Involvement
+
+As a Beta user, your feedback is invaluable. If you encounter issues or have suggestions, please let us know: 
+
+*   Using the **flow to provide feedback** directly from the **app** in the user settings.
+![Entry point for the OpenProject mobile app flow to provide user feedback](mobile_app_feedback_flow_entrypoint.png)
+*   Create a **feedback work package** directly in [OpenProject **Community** instance](https://community.openproject.org/) and assign it to *Stream Mobile App*.
+
+Your input directly helps improve the mobile experience and ensure a stable, feature-rich public release.
+
+## Availability
+
+The **OpenProject Mobile App (Beta)** is available now for:
+
+*   **iOS:** [App Store link](https://apps.apple.com/us/app/openproject/id6474431879).
+*   **Android:** [Google Play link](https://play.google.com/store/apps/details?id=org.openproject.app).
+
+## Requirements
+
+To access and use the **OpenProject Mobile App (Beta)**, you’ll need the following:
+
+*   **An active OpenProject account:** Either from an **OpenProject Cloud** workspace or an **OpenProject On-premises** installation with API access enabled.
+*   Having a **signed certificate** (**https**, not http) on your instance to be able to log in.
+*   **OpenProject version:** 17.0.0 or above
+> [!NOTE]
+> If you have a previous version of OpenProject you can connect your OpenProject instance by asking your administrator to enable the Built in OAuth applications flag under_ `_{BASE_URL}/admin/settings/experimental_`.
+*   **Minimum system requirements:**
+    *   **iOS 15** or later
+    *   **Android 12** or later
+*   **Built-in OAuth applications enabled:** Make sure that the built-in OAuth applications are **enabled in your administration settings** (`{BASE_URL}/admin/oauth/applications`). This is required for successful login from the mobile app.
+![Applications setting to enable the built-in OAuth](mobile_app_oauth_authentication.png)
+*   **Network connection:** Internet access is required for syncing data with your OpenProject instance.
+> [!NOTE]
+> Some features, such as deep-linking and real-time push notifications, may depend on your organization’s configuration or will become available in future updates.
+
+## Disclaimer
+
+> [!IMPORTANT]
+> This is a **Beta Release**, which means the app may contain incomplete features and occasional bugs. We recommend using it alongside the **OpenProject web application** for the full experience.

docs/mobile-app-guide/core-features/README.md

@@ -0,0 +1,41 @@
+---
+sidebar_navigation:
+  title: Mobile app core features
+  priority: 800
+description: The OpenProject Mobile App is designed to keep you connected to your projects wherever you are. While it doesn’t replace the full desktop experience, it provides access to the essential tools you need to stay productive on the go.
+keywords: Mobile app core features, mobile, mobile app, core, mobile core, core features
+---
+
+# Mobile app core features
+
+The **OpenProject Mobile App** is designed to keep you connected to your projects wherever you are. While it doesn’t replace the full desktop experience, it provides access to the essential tools you need to stay productive on the go.
+
+This section introduces the **core features** of the app and links to detailed guides for each functionality.
+
+## Overview
+
+With the mobile app, you can:
+*   **Stay informed** about project updates and notifications
+*   **Manage work packages** efficiently from anywhere
+*   **Track your time** and log progress
+*   **Access project dashboards and overviews** at a glance
+*   **Customize your settings** to tailor the app to your workflow
+    
+
+Each feature is designed to complement the OpenProject web and desktop experience, giving you the flexibility to react, update, and communicate on the go.
+
+## Core Features
+
+The following core features are available in the mobile app:
+
+| Feature | Description |
+|---------------------------------------------------------------------|:-----------------------------------------------------------------------------------|
+| [Home Dashboard](home-dashboard) | Your personal overview of tasks, notifications, and project updates — giving you a quick snapshot of what matters most. |
+| [Projects](projects) | Browse your projects, access project-specific details, and stay on top of deadlines and activities. |
+| [Time Tracking](time-tracking) | Track time spent on work packages, run timers in focus mode, and keep your reporting accurate and up to date. |
+| [Work Packages](work-packages)| Create, view, and edit work packages directly from the app. Work packages are organized for quick access and easy collaboration. |
+| [Notification Center](notification-center) | Receive updates about comments, mentions, and work package changes — ensuring you never miss an important activity. |
+| [User Settings](user-settings) | Configure your account, manage app preferences, and tailor notifications to suit your workflow. |
+
+> [!TIP]
+> For a seamless experience, use the mobile app alongside the web or desktop version of OpenProject. The app is designed as a companion, so you can stay informed, respond quickly, and keep your projects moving — even when you’re away from your desk.

docs/mobile-app-guide/core-features/home-dashboard/README.md

@@ -0,0 +1,87 @@
+---
+sidebar_navigation:
+  title: Home Dashboard
+  priority: 790
+description: Create a personalized overview of your projects, work packages, and activities.
+keywords: Mobile app features home dashboard
+---
+
+# Home Dashboard
+
+The **Home Dashboard** is your go-to screen for staying informed, focused, and efficient on mobile — providing an at-a-glance view of everything that matters across your projects. It allows creating a **personalized overview of your projects, work packages, and activities**, helping you stay informed and productive on the go.
+
+The dashboard is designed to give you **quick access to the information you care about most**, without needing to navigate deep into individual projects or work packages.
+
+## Purpose
+
+The Home Dashboard is your **central hub** for project management on mobile. Its main purposes include:
+*   **Quickly reviewing your priorities:** See which work packages, deadlines, or updates need your attention.
+*   **Monitoring project activity:** Stay up to date on work package changes, comments, and progress across all your projects.
+*   **Accessing relevant widgets:** Customize what you see based on your workflow and focus areas.
+*   **Saving time:** Avoid switching between multiple screens — everything important is consolidated in one view.
+
+## Available Widgets
+
+The Home Dashboard consists of **modular widgets** that provide snapshots of your most relevant data. Depending on your role and project access, some widgets may vary.
+
+### **Notifications**
+
+*   Displays recent notifications, such as mentions, comments, or work package updates.
+*   Enables you to **react quickly** without leaving the dashboard.
+
+![Home dashboard notifications widget in the OpenProject mobile app](mobile_app_homewidget_notifications.png)
+
+### **Favorite Projects**
+
+*   Displays projects you’ve marked as favorites for **quick access**.
+*   Ideal for prioritizing high-importance projects.
+
+![Home dashboard displaying "favorite projects" widget in the OpenProject mobile app](mobile_app_homewidget_favoriteprojects.png)
+
+### **Time Tracker**
+
+*   Shows the **currently running timer** or allows you to start a new focus timer.
+*   Helps track work time efficiently and accurately.
+
+![Home dashboard displaying the "time tracker" widget in OpenProject mobile app](mobile_app_homewidget_timetracker.png)
+
+### **Week Time Tracking**
+
+*   Provides an overview of **time logged during the current week**.
+*   Helps you monitor your productivity and ensure accurate reporting.
+
+![Home dashboard displaying "week time tracking" widget in the OpenProject mobile app](mobile_app_homewidget_weektimetracking.png)
+
+### **Portfolios**
+
+*   Shows a snapshot of the portfolios available.
+*   Useful for portfolio managers and team members tracking **high-level progress** across multiple projects.
+
+![Home dashboard displaying "portfolios" widget in the OpenProject mobile app](mobile_app_homewidget_portfolios.png)
+
+### **Assigned to Me**
+
+*   Lists all **work packages currently assigned to you**.
+*   Includes work package types and status indicators for quick task management.
+
+![Home dashboard displaying "work packages assigned to me" widget in the OpenProject mobile app](mobile_app_homewidget_assignedtome.png)
+
+### **Recently Edited**
+
+*   Shows a list of **recently edited work packages**.
+*   Allows **fast navigation** back to items that are work in progress.
+
+![Home dashboard displaying "work packages recently edited" widget in the OpenProject mobile app](mobile_app_homewidget_recentlyedited.png)
+
+## Customizing the Dashboard
+
+While the mobile dashboard is designed for simplicity, the **order and visibility of widgets** can be customized by using the **edit widgets button** on the right side of the top navigation bar. Clicking the icon allows you to:
+
+*   Activate and deactivate widgets
+*   Reorder widgets
+
+![Home dashboard edit widgets entry point in OpenProject mobile app](mobile_app_home_addwidget.png)
+![Home dashboard edit widgets bottom sheet configuration in OpenProject mobile app](mobile_app_home_addwidget_bottomsheet.png)
+
+> [!NOTE]
+> If you don't have the right permissions or have disabled a feature, the related widgets will be deactivated in the home dashboard tab.