Contribute Tasks to product presentation

src/govoplan_tasks/backend/manifest.py

@@ -22,6 +22,8 @@ from govoplan_core.core.modules import (
     ModuleManifest,
     NavItem,
     PermissionDefinition,
+    ProductAreaContribution,
+    QuickAccessTool,
     RoleTemplate,
 )
 from govoplan_core.core.provider_governance import declared_module_architecture
@@ -120,6 +122,33 @@ ROLE_TEMPLATES = (
 )
 
 DOCUMENTATION = (
+    DocumentationTopic(
+        id="tasks.quick-access-and-product-area",
+        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, "
+            "the same provider-owned open-work summary can appear beside the current page. Views may hide or reorder "
+            "the contribution, but neither presentation grants task access or changes completion state."
+        ),
+        layer="configured",
+        documentation_types=("user", "admin"),
+        audience=("user", "tenant_admin", "module_admin"),
+        related_modules=("quick_access", "views"),
+        translations={
+            "de": {
+                "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, "
+                    "kann dieselbe vom Modul verantwortete Zusammenfassung offener Arbeit neben der aktuellen Seite erscheinen. "
+                    "Ansichten dürfen den Beitrag ausblenden oder ordnen, erteilen aber keine Aufgabenberechtigung."
+                ),
+            }
+        },
+        metadata={"kind": "reference", "help_contexts": ["tasks.quick_access.work"]},
+        order=9,
+    ),
     DocumentationTopic(
         id="tasks.work-inbox",
         title="Unified work inbox",
@@ -265,6 +294,39 @@ manifest = ModuleManifest(
                 label="Open work widget",
                 order=60,
             ),
+            ViewSurface(
+                id="tasks.quick_access.work",
+                module_id=MODULE_ID,
+                kind="quick_access",
+                label="Work Quick Access",
+                order=70,
+            ),
+        ),
+        product_areas=(
+            ProductAreaContribution(
+                id="work",
+                module_id=MODULE_ID,
+                label="i18n:govoplan-core.product_area.work",
+                icon="list-checks",
+                description="i18n:govoplan-core.product_area.work_description",
+                surface_ids=("tasks.route.work",),
+                order=10,
+            ),
+        ),
+        quick_access_tools=(
+            QuickAccessTool(
+                id="tasks.work",
+                module_id=MODULE_ID,
+                category_id="work",
+                label="i18n:govoplan-tasks.work",
+                description="i18n:govoplan-tasks.quick_access_description",
+                surface_id="tasks.quick_access.work",
+                icon="list-checks",
+                full_page_path="/tasks",
+                required_any=(READ_SCOPE,),
+                order=10,
+                modes=("browse", "resume"),
+            ),
         ),
     ),
     tenant_summary_providers=(_tenant_summary,),