Add priority queue to ai-service and STATUS.md workflow

- Introduce async priority queue service in ai-service; all /chat calls now route through it
- Refactor chat router to separate execute_chat (core logic) from the HTTP handler
- Add /queue endpoints (status, pause, resume, cancel) for queue management
- Update ai-service config to use Pydantic v2 model_config style
- Add STATUS.md files for backend, ai-service, doc-service, and frontend
- Document STATUS.md workflow in CLAUDE.md
- Update doc-service documents router and schemas; frontend DocumentsPage and API client

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

features/doc-service/app/routers/documents.py

@@ -1,13 +1,14 @@
 import asyncio
 import json
+import math
 import uuid
 from datetime import datetime, timezone
 
 import aiofiles
 import pdfplumber
-from fastapi import APIRouter, BackgroundTasks, Depends, HTTPException, UploadFile
+from fastapi import APIRouter, BackgroundTasks, Depends, HTTPException, Query, UploadFile
 from fastapi.responses import StreamingResponse
-from sqlalchemy import select
+from sqlalchemy import func, or_, select
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
 
@@ -16,7 +17,7 @@ from app.deps import get_user_id
 from app.models.category import DocumentCategory
 from app.models.category_assignment import CategoryAssignment
 from app.models.document import Document
-from app.schemas.document import DocumentOut, DocumentStatusOut, DocumentTypeUpdate, TagsUpdate, TitleUpdate
+from app.schemas.document import DocumentOut, DocumentPage, DocumentStatusOut, DocumentTypeUpdate, TagsUpdate, TitleUpdate
 from app.services.ai_client import AIServiceError, classify_document
 from app.services.config_reader import load_doc_config
 from app.services.storage import delete_file, get_upload_path, save_upload
@@ -50,6 +51,7 @@ def _doc_with_categories(doc: Document) -> DocumentOut:
         id=doc.id,
         user_id=doc.user_id,
         filename=doc.filename,
+        title=doc.title,
         file_size=doc.file_size,
         status=doc.status,
         document_type=doc.document_type,
@@ -143,28 +145,83 @@ async def upload_document(
     )
     db.add(doc)
     await db.commit()
-    await db.refresh(doc)
 
     background_tasks.add_task(process_document, doc_id)
 
+    # Re-query with selectinload so category_assignments is eagerly loaded.
+    # A new doc has no categories yet, but we need the relationship populated
+    # to avoid MissingGreenlet in the async session.
+    doc = await _get_user_doc(doc_id, user_id, db)
     return _doc_with_categories(doc)
 
 
-@router.get("", response_model=list[DocumentOut])
+_SORT_COLUMNS = {
+    "created_at": Document.created_at,
+    "processed_at": Document.processed_at,
+    "filename": Document.filename,
+    "title": Document.title,
+    "file_size": Document.file_size,
+    "status": Document.status,
+    "document_type": Document.document_type,
+}
+
+
+@router.get("", response_model=DocumentPage)
 async def list_documents(
+    page: int = Query(default=1, ge=1),
+    per_page: int = Query(default=20, ge=1, le=100),
+    sort: str = Query(default="created_at"),
+    order: str = Query(default="desc", pattern="^(asc|desc)$"),
+    status: str | None = Query(default=None),
+    document_type: str | None = Query(default=None),
+    search: str | None = Query(default=None),
     user_id: str = Depends(get_user_id),
     db: AsyncSession = Depends(get_db),
-) -> list[DocumentOut]:
-    result = await db.execute(
+) -> DocumentPage:
+    sort_col = _SORT_COLUMNS.get(sort, Document.created_at)
+    sort_expr = sort_col.desc() if order == "desc" else sort_col.asc()
+
+    # Build filter conditions once and reuse for both count + items queries.
+    conditions = [Document.user_id == user_id]
+    if status:
+        conditions.append(Document.status == status)
+    if document_type:
+        conditions.append(Document.document_type == document_type)
+    if search:
+        like = f"%{search}%"
+        conditions.append(
+            or_(
+                Document.title.ilike(like),
+                Document.filename.ilike(like),
+                Document.tags.ilike(like),
+                Document.document_type.ilike(like),
+            )
+        )
+
+    count_result = await db.execute(
+        select(func.count(Document.id)).where(*conditions)
+    )
+    total = count_result.scalar_one()
+
+    items_result = await db.execute(
         select(Document)
-        .where(Document.user_id == user_id)
+        .where(*conditions)
         .options(
             selectinload(Document.category_assignments)
             .selectinload(CategoryAssignment.category)
         )
-        .order_by(Document.created_at.desc())
+        .order_by(sort_expr)
+        .offset((page - 1) * per_page)
+        .limit(per_page)
+    )
+    items = [_doc_with_categories(d) for d in items_result.scalars().all()]
+
+    return DocumentPage(
+        items=items,
+        total=total,
+        page=page,
+        pages=max(1, math.ceil(total / per_page)),
     )
-    return [_doc_with_categories(d) for d in result.scalars().all()]
 
 
 @router.get("/{doc_id}", response_model=DocumentOut)