fix(config): default meilisearch_url to http://meilisearch:7700 for Docker/K8s service discovery

Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>

app/api/__init__.py

@@ -15,6 +15,7 @@ from app.api.logs import router as logs_router
 from app.api.onedrive import router as onedrive_router
 from app.api.openai import router as openai_router
 from app.api.process import router as process_router
+from app.api.search import router as search_router
 from app.api.settings import router as settings_router
 from app.api.url_upload import router as url_upload_router
 
@@ -40,3 +41,4 @@ router.include_router(google_drive_router)
 router.include_router(logs_router)
 router.include_router(settings_router)
 router.include_router(url_upload_router)
+router.include_router(search_router)

app/api/search.py

@@ -0,0 +1,99 @@
+"""Full-text search API endpoints.
+
+Provides document search across OCR text, AI metadata, filenames, and tags
+via Meilisearch.  Designed to serve as the backend for the UI search bar on
+the /files page and as a standalone API for integrations.
+
+Future extension point: the OCR text stored in the index is also suitable
+for RAG (Retrieval Augmented Generation) chatbot workflows.
+"""
+
+import logging
+from typing import Optional
+
+from fastapi import APIRouter, Query, Request
+
+from app.auth import require_login
+from app.utils.meilisearch_client import search_documents
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter()
+
+
+@router.get("/search")
+@require_login
+def search_api(
+    request: Request,
+    q: str = Query(..., min_length=1, max_length=512, description="Full-text search query"),
+    mime_type: Optional[str] = Query(None, description="Filter by MIME type (e.g. application/pdf)"),
+    document_type: Optional[str] = Query(None, description="Filter by document type (e.g. Invoice)"),
+    language: Optional[str] = Query(None, description="Filter by language code (e.g. de, en)"),
+    date_from: Optional[int] = Query(None, description="Filter results created after this Unix timestamp"),
+    date_to: Optional[int] = Query(None, description="Filter results created before this Unix timestamp"),
+    page: int = Query(1, ge=1, description="Page number (1-based)"),
+    per_page: int = Query(20, ge=1, le=100, description="Results per page"),
+):
+    """Search documents by full text, metadata, and tags.
+
+    Searches across:
+    - Document title and filename
+    - OCR / extracted text
+    - Tags, sender, recipient, document type
+    - Correspondent and reference number
+
+    Results are ranked by Meilisearch relevance and include highlighted
+    snippets showing where the query terms matched.
+
+    Query Parameters:
+    - q: Search query (required)
+    - mime_type: Filter by MIME type
+    - document_type: Filter by document type
+    - language: Filter by language code
+    - date_from: Unix timestamp lower bound
+    - date_to: Unix timestamp upper bound
+    - page: Page number (default: 1)
+    - per_page: Results per page (default: 20, max: 100)
+
+    Example:
+    ```
+    GET /api/search?q=invoice&document_type=Invoice&date_from=1704067200&page=1&per_page=20
+    ```
+
+    Response:
+    ```json
+    {
+      "results": [
+        {
+          "file_id": 42,
+          "original_filename": "2026-01-15_Invoice_Amazon.pdf",
+          "document_title": "Amazon Invoice January 2026",
+          "document_type": "Invoice",
+          "tags": ["amazon", "invoice"],
+          "_formatted": {
+            "document_title": "Amazon <mark>Invoice</mark> January 2026",
+            "ocr_text": "...total amount of the <mark>invoice</mark> is..."
+          }
+        }
+      ],
+      "total": 42,
+      "page": 1,
+      "pages": 3,
+      "query": "invoice"
+    }
+    ```
+    """
+    logger.info(f"Search request: q={q!r}, mime_type={mime_type}, page={page}, per_page={per_page}")
+
+    result = search_documents(
+        q,
+        mime_type=mime_type,
+        document_type=document_type,
+        language=language,
+        date_from=date_from,
+        date_to=date_to,
+        page=page,
+        per_page=per_page,
+    )
+
+    return result