feat: promote work to a stable product destination

src/govoplan_tasks/backend/manifest.py

@@ -26,7 +26,9 @@ from govoplan_core.core.modules import (
     ModuleManifest,
     NavItem,
     PermissionDefinition,
+    ProductAvailabilityExplanation,
     ProductAreaContribution,
+    ProductSurfaceContribution,
     QuickAccessTool,
     RoleTemplate,
 )
@@ -47,7 +49,7 @@ from govoplan_tasks.backend.service import SqlTaskService
 
 MODULE_ID = "tasks"
 MODULE_NAME = "Tasks"
-MODULE_VERSION = "0.1.21"
+MODULE_VERSION = "0.1.22"
 READ_SCOPE = "tasks:item:read"
 WRITE_SCOPE = "tasks:item:write"
 ADMIN_SCOPE = "tasks:item:admin"
@@ -209,7 +211,8 @@ DOCUMENTATION = (
         title="Work in product navigation and Quick Access",
         summary="Keep assigned work available in the Work area and the optional right-side Quick Access rail.",
         body=(
-            "Tasks contributes its authorized workspace to the Work product area. When Quick Access is enabled, "
+            "Tasks contributes its authorized workspace to the stable Work destination at /work. The owner route "
+            "/tasks remains available through All available tools and as a compatible deep link. When Quick Access is enabled, "
             "a bounded seven-item authorized inbox and detail can appear beside the current page. Explicit Tasks can be "
             "started or completed there; work from another provider exposes only that provider's launch path. Every load "
             "and command is rechecked by Tasks, and completion returns a typed work-item reference to the host. Views may "
@@ -224,7 +227,8 @@ DOCUMENTATION = (
                 "title": "Arbeit in Produktnavigation und Schnellzugriff",
                 "summary": "Zugewiesene Arbeit im Produktbereich Arbeit und optional in der rechten Schnellzugriffsleiste verwenden.",
                 "body": (
-                    "Tasks ordnet den berechtigten Arbeitsbereich dem Produktbereich Arbeit zu. Ist der Schnellzugriff aktiviert, "
+                    "Tasks ordnet den berechtigten Arbeitsbereich dem stabilen Produktziel Arbeit unter /work zu. Der Eigentümerpfad "
+                    "/tasks bleibt unter Alle verfügbaren Werkzeuge und als kompatibler Direktlink erreichbar. Ist der Schnellzugriff aktiviert, "
                     "kann ein begrenzter, berechtigungsgeprüfter Arbeitsvorrat mit sieben Einträgen und Details neben der "
                     "aktuellen Seite erscheinen. Explizite Tasks lassen sich dort beginnen oder abschließen; fremde Quellen "
                     "behalten ihre eigenen Befehle und Startpfade. Jeder Aufruf wird erneut durch Tasks geprüft. Ansichten "
@@ -407,6 +411,30 @@ manifest = ModuleManifest(
                 order=10,
             ),
         ),
+        product_surfaces=(
+            ProductSurfaceContribution(
+                id="work.items",
+                module_id=MODULE_ID,
+                label="i18n:govoplan-core.product_surface.work",
+                description="i18n:govoplan-core.product_surface.work_description",
+                icon="list-checks",
+                entry_path="/work",
+                route_path="/tasks",
+                surface_ids=("tasks.route.work",),
+                presentations=("task", "reader"),
+                help_context_ids=("tasks.route.work",),
+                documentation_topic_ids=("tasks.quick-access-and-product-area",),
+                required_any=(READ_SCOPE,),
+                order=10,
+                unavailable=ProductAvailabilityExplanation(
+                    reason="authorization",
+                    title="i18n:govoplan-core.product_surface.unavailable",
+                    description="i18n:govoplan-core.product_surface.unavailable_description",
+                    resolution="i18n:govoplan-core.product_surface.unavailable_resolution",
+                    responsible_role="i18n:govoplan-core.access_administrator",
+                ),
+            ),
+        ),
         quick_access_tools=(
             QuickAccessTool(
                 id="tasks.work",