Contribute Mail to Quick Access

src/govoplan_mail/backend/manifest.py

@@ -26,6 +26,8 @@ from govoplan_core.core.modules import (
     ModuleManifest,
     NavItem,
     PermissionDefinition,
+    ProductAreaContribution,
+    QuickAccessTool,
     RoleTemplate,
 )
 from govoplan_core.core.provider_governance import (
@@ -376,6 +378,33 @@ manifest = ModuleManifest(
             ViewSurface(id="mail.admin.group-servers", module_id="mail", kind="section", label="Group mail servers", order=20),
             ViewSurface(id="mail.admin.user-servers", module_id="mail", kind="section", label="User mail servers", order=20),
             ViewSurface(id="mail.settings.profiles", module_id="mail", kind="section", label="Personal mail profiles", order=10),
+            ViewSurface(id="mail.quick_access.messages", module_id="mail", kind="quick_access", label="Mail Quick Access", order=80),
+        ),
+        product_areas=(
+            ProductAreaContribution(
+                id="communication",
+                module_id="mail",
+                label="i18n:govoplan-core.product_area.communication",
+                icon="mail",
+                description="i18n:govoplan-core.product_area.communication_description",
+                surface_ids=("mail.nav.mail", "mail.route.mail"),
+                order=40,
+            ),
+        ),
+        quick_access_tools=(
+            QuickAccessTool(
+                id="mail.messages",
+                module_id="mail",
+                category_id="messages",
+                label="i18n:govoplan-mail.mail.92379cbb",
+                description="i18n:govoplan-mail.quick_access_description",
+                surface_id="mail.quick_access.messages",
+                icon="mail",
+                full_page_path="/mail",
+                required_any=("mail:mailbox:read",),
+                order=10,
+                modes=("browse", "compose"),
+            ),
         ),
     ),
     migration_spec=MigrationSpec(
@@ -418,6 +447,33 @@ manifest = ModuleManifest(
         ).SqlMailBounceProcessingProvider(),
     },
     documentation=(
+        DocumentationTopic(
+            id="mail.quick-access-and-product-area",
+            title="Mail in Communication and Messages",
+            summary="Use Mail in the Communication product area and the shared Messages Quick Access drawer.",
+            body=(
+                "Mail contributes its full mailbox to Communication. When Quick Access is enabled, its compact provider surface "
+                "appears inside the shared Messages drawer alongside independent Postbox and future chat contributions. "
+                "The shared drawer does not merge channel state, credentials, custody, delivery semantics, or authorization."
+            ),
+            layer="configured",
+            documentation_types=("user", "admin"),
+            audience=("mail_user", "mail_admin", "administrator"),
+            related_modules=("quick_access", "views", "postbox"),
+            translations={
+                "de": {
+                    "title": "Mail in Kommunikation und Nachrichten",
+                    "summary": "Mail im Produktbereich Kommunikation und in der gemeinsamen Schnellzugriffseinblendung Nachrichten verwenden.",
+                    "body": (
+                        "Mail ordnet das vollständige Postfach Kommunikation zu. Ist der Schnellzugriff aktiviert, erscheint die kompakte "
+                        "Mail-Oberfläche gemeinsam mit unabhängigen Beiträgen aus Postbox und künftig Chat unter Nachrichten. "
+                        "Die gemeinsame Darstellung führt weder Kanalzustand noch Zugangsdaten, Verwahrung oder Berechtigungen zusammen."
+                    ),
+                }
+            },
+            metadata={"kind": "reference", "help_contexts": ["mail.quick_access.messages"]},
+            order=37,
+        ),
         DocumentationTopic(
             id="mail.search.mailbox-messages",
             title="Search authorized mailbox messages",