Align document handlers/repo with contract updates

docs/openapi.yaml

@@ -1571,6 +1571,34 @@ paths:
       summary: List all documents accessible to the user
       security:
         - tokenAuth: []
+      parameters:
+        - in: query
+          name: residence
+          description: Filter by residence ID
+          schema:
+            type: integer
+            format: uint
+        - in: query
+          name: document_type
+          description: Filter by document type
+          schema:
+            type: string
+        - in: query
+          name: is_active
+          description: Filter by active/inactive status (default true)
+          schema:
+            type: boolean
+        - in: query
+          name: expiring_soon
+          description: Return warranties expiring in N days
+          schema:
+            type: integer
+            minimum: 1
+        - in: query
+          name: search
+          description: Case-insensitive search over title/description
+          schema:
+            type: string
       responses:
         '200':
           description: List of documents