feat(webui): complete files quick access

src/govoplan_files/backend/routes/listing.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from typing import Literal
-from fastapi import APIRouter, Depends, Query
+from fastapi import APIRouter, Depends, HTTPException, Query, status
 from sqlalchemy.orm import Session
 
 from govoplan_core.auth import ApiPrincipal, require_scope
@@ -14,6 +14,7 @@ from govoplan_files.backend.storage.files import (
     count_assets_for_user,
     list_assets_for_user,
     list_assets_for_user_window,
+    list_recent_assets_for_user,
 )
 
 
@@ -79,6 +80,7 @@ def list_files(
     path_prefix: str | None = None,
     campaign_usage: Literal["linked", "unlinked"] | None = None,
     audit_relevant: bool | None = None,
+    sort: Literal["path", "recent"] = "path",
     page_size: int | None = Query(default=None, ge=1, le=1000),
     cursor: str | None = None,
     session: Session = Depends(get_session),
@@ -99,6 +101,31 @@ def list_files(
         audit_relevant=audit_relevant,
         is_admin=_is_admin(principal),
     )
+    if sort == "recent":
+        if cursor:
+            raise HTTPException(
+                status_code=status.HTTP_422_UNPROCESSABLE_CONTENT,
+                detail="Recent file projections do not accept a path-order cursor.",
+            )
+        recent_limit = page_size or 25
+        assets = list_recent_assets_for_user(
+            session,
+            tenant_id=principal.tenant_id,
+            user_id=principal.user.id,
+            limit=recent_limit,
+            owner_type=owner_type,
+            owner_id=owner_id,
+            campaign_id=campaign_id,
+            path_prefix=path_prefix,
+            campaign_usage=campaign_usage,
+            audit_relevant=audit_relevant,
+            is_admin=_is_admin(principal),
+        )
+        return FileListResponse(
+            files=_asset_list_response(session, assets, include_shares=True),
+            total=total,
+            watermark=watermark,
+        )
     effective_page_size = _cursor_page_size(FILES_LIST_CURSOR_SCOPE, cursor, page_size)
     if effective_page_size is not None:
         fingerprint = _files_list_fingerprint(