Contribute Postbox to Quick Access

src/govoplan_postbox/backend/manifest.py

@@ -28,6 +28,8 @@ from govoplan_core.core.modules import (
     ModuleManifest,
     NavItem,
     PermissionDefinition,
+    ProductAreaContribution,
+    QuickAccessTool,
     RoleTemplate,
 )
 from govoplan_core.core.provider_governance import declared_module_architecture
@@ -357,6 +359,39 @@ manifest = ModuleManifest(
                 label="Postbox templates and bindings",
                 order=30,
             ),
+            ViewSurface(
+                id="postbox.quick_access.messages",
+                module_id=MODULE_ID,
+                kind="quick_access",
+                label="Postbox Quick Access",
+                order=35,
+            ),
+        ),
+        product_areas=(
+            ProductAreaContribution(
+                id="communication",
+                module_id=MODULE_ID,
+                label="i18n:govoplan-core.product_area.communication",
+                icon="mail",
+                description="i18n:govoplan-core.product_area.communication_description",
+                surface_ids=("postbox.nav.postbox", "postbox.route.postbox"),
+                order=40,
+            ),
+        ),
+        quick_access_tools=(
+            QuickAccessTool(
+                id="postbox.messages",
+                module_id=MODULE_ID,
+                category_id="messages",
+                label="i18n:govoplan-postbox.postbox",
+                description="i18n:govoplan-postbox.quick_access_description",
+                surface_id="postbox.quick_access.messages",
+                icon="inbox",
+                full_page_path="/postbox",
+                required_any=(READ_SCOPE,),
+                order=20,
+                modes=("browse", "author"),
+            ),
         ),
     ),
     route_factory=_router,
@@ -393,6 +428,33 @@ manifest = ModuleManifest(
         CAPABILITY_POSTBOX_ROUTING: _configure,
     },
     documentation=(
+        DocumentationTopic(
+            id="postbox.quick-access-and-product-area",
+            title="Postbox in Communication and Messages",
+            summary="Use function-bound Postboxes in Communication and the shared Messages Quick Access drawer.",
+            body=(
+                "Postbox contributes its inbox to Communication. With Quick Access enabled, its owner-rendered unread summary "
+                "appears beside Mail and future chat providers inside Messages while retaining function assignment, classification, "
+                "read-receipt, retention, encryption, and evidence semantics in Postbox."
+            ),
+            layer="configured",
+            documentation_types=("user", "admin"),
+            audience=("administrator", "user", "campaign_manager"),
+            related_modules=("quick_access", "views", "mail"),
+            translations={
+                "de": {
+                    "title": "Postfach in Kommunikation und Nachrichten",
+                    "summary": "Funktionsgebundene Postfächer in Kommunikation und der gemeinsamen Schnellzugriffseinblendung Nachrichten verwenden.",
+                    "body": (
+                        "Postbox ordnet seinen Eingang Kommunikation zu. Ist der Schnellzugriff aktiviert, erscheint die vom Modul gerenderte "
+                        "Zusammenfassung ungelesener Nachrichten neben Mail und künftigen Chat-Anbietern unter Nachrichten. "
+                        "Funktionszuordnung, Klassifikation, Lesestatus, Aufbewahrung, Verschlüsselung und Nachweise verbleiben bei Postbox."
+                    ),
+                }
+            },
+            metadata={"kind": "reference", "help_contexts": ["postbox.quick_access.messages"]},
+            order=33,
+        ),
         DocumentationTopic(
             id="postbox.search.messages",
             title="Search authorized Postbox messages",