Contribute Files to Quick Access

src/govoplan_files/backend/manifest.py

@@ -32,6 +32,8 @@ from govoplan_core.core.modules import (
     ModuleManifest,
     NavItem,
     PermissionDefinition,
+    ProductAreaContribution,
+    QuickAccessTool,
     RoleTemplate,
 )
 from govoplan_core.core.operations import OperationalCheckProviderRegistration
@@ -530,9 +532,83 @@ manifest = ModuleManifest(
                 label="File spaces widget",
                 order=35,
             ),
+            ViewSurface(
+                id="files.quick_access.files",
+                module_id="files",
+                kind="quick_access",
+                label="Files Quick Access",
+                order=40,
+            ),
+        ),
+        product_areas=(
+            ProductAreaContribution(
+                id="records-documents",
+                module_id="files",
+                label="i18n:govoplan-core.product_area.records_documents",
+                icon="folder",
+                description="i18n:govoplan-core.product_area.records_documents_description",
+                surface_ids=("files.nav.files", "files.route.files"),
+                order=30,
+            ),
+        ),
+        quick_access_tools=(
+            QuickAccessTool(
+                id="files.recent",
+                module_id="files",
+                category_id="files",
+                label="i18n:govoplan-files.files.6ce6c512",
+                description="i18n:govoplan-files.quick_access_description",
+                surface_id="files.quick_access.files",
+                icon="folder",
+                full_page_path="/files",
+                required_any=("files:file:read",),
+                order=10,
+                modes=("browse", "select", "upload"),
+            ),
         ),
     ),
     documentation=(
+        DocumentationTopic(
+            id="files.quick-access-and-product-area",
+            title="Files in Records and documents and Quick Access",
+            summary="Use managed files in the Records and documents area and keep a compact file surface beside current work.",
+            body=(
+                "Files contributes its authorized workspace to Records and documents. When Quick Access is enabled, the owner-rendered "
+                "file-space summary appears in Files on the right rail and links back to the complete workspace. View and rail settings "
+                "do not bypass file ownership, shares, connector policy, integrity gates, or purpose-aware access."
+            ),
+            layer="configured",
+            documentation_types=("user", "admin"),
+            audience=("file_user", "file_manager", "administrator"),
+            related_modules=("quick_access", "views", "records"),
+            conditions=(
+                DocumentationCondition(
+                    required_modules=("files",),
+                    any_scopes=("files:file:read", "files:file:admin"),
+                ),
+            ),
+            links=(
+                DocumentationLink(label="Files", href="/files", kind="runtime"),
+                DocumentationLink(
+                    label="Files handbook",
+                    href="govoplan-files/docs/FILES_HANDBOOK.md",
+                    kind="repository",
+                ),
+            ),
+            translations={
+                "de": {
+                    "title": "Dateien in Akten und Dokumente sowie im Schnellzugriff",
+                    "summary": "Verwaltete Dateien im Produktbereich Akten und Dokumente und optional neben der aktuellen Arbeit verwenden.",
+                    "body": (
+                        "Files ordnet seinen berechtigten Arbeitsbereich Akten und Dokumente zu. Ist der Schnellzugriff aktiviert, erscheint "
+                        "die vom Modul gerenderte Übersicht der Dateibereiche rechts neben der aktuellen Seite. Ansichts- und Leistenkonfiguration "
+                        "umgehen weder Eigentum, Freigaben, Connector-Richtlinien, Integritätsprüfungen noch zweckgebundenen Zugriff."
+                    ),
+                }
+            },
+            metadata={"kind": "reference", "help_contexts": ["files.quick_access.files"]},
+            order=39,
+        ),
         DocumentationTopic(
             id="files.forms-runtime.managed-evidence",
             title="Capture Form attachments as managed evidence",