refactor(api): introduce UserContext schema for API dependency injection

Replace direct User database model imports in API endpoints with UserContext
schema, following the architecture principle that API routes should not import
database models directly.

Changes:
- Create UserContext schema in models/schema/auth.py with from_user() factory
- Update app/api/deps.py to return UserContext from all auth dependencies
- Add _get_user_model() helper for functions needing User model access
- Update 58 API endpoint files to use UserContext instead of User
- Add noqa comments for 4 legitimate edge cases (enums, internal helpers)

Architecture validation: 0 errors (down from 61), 11 warnings remain

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/api/v1/admin/messages.py

@@ -46,7 +46,7 @@ from app.modules.messaging.schemas import (
     ReopenConversationResponse,
     UnreadCountResponse,
 )
-from models.database.user import User
+from models.schema.auth import UserContext
 
 router = APIRouter(prefix="/messages")
 logger = logging.getLogger(__name__)
@@ -184,7 +184,7 @@ def list_conversations(
     skip: int = Query(0, ge=0),
     limit: int = Query(20, ge=1, le=100),
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> AdminConversationListResponse:
     """List conversations for admin (admin_vendor and admin_customer channels)."""
     conversations, total, total_unread = messaging_service.list_conversations(
@@ -211,7 +211,7 @@ def list_conversations(
 @router.get("/unread-count", response_model=UnreadCountResponse)
 def get_unread_count(
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> UnreadCountResponse:
     """Get total unread message count for header badge."""
     count = messaging_service.get_unread_count(
@@ -235,7 +235,7 @@ def get_recipients(
     skip: int = Query(0, ge=0),
     limit: int = Query(50, ge=1, le=100),
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> RecipientListResponse:
     """Get list of available recipients for compose modal."""
     if recipient_type == ParticipantType.VENDOR:
@@ -291,7 +291,7 @@ def get_recipients(
 def create_conversation(
     data: ConversationCreate,
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> ConversationDetailResponse:
     """Create a new conversation."""
     # Validate conversation type for admin
@@ -428,7 +428,7 @@ def get_conversation(
     conversation_id: int,
     mark_read: bool = Query(True, description="Automatically mark as read"),
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> ConversationDetailResponse:
     """Get conversation detail with messages."""
     conversation = messaging_service.get_conversation(
@@ -465,7 +465,7 @@ async def send_message(
     content: str = Form(...),
     files: list[UploadFile] = File(default=[]),
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> MessageResponse:
     """Send a message in a conversation, optionally with attachments."""
     # Verify access
@@ -522,7 +522,7 @@ async def send_message(
 def close_conversation(
     conversation_id: int,
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> CloseConversationResponse:
     """Close a conversation."""
     conversation = messaging_service.close_conversation(
@@ -551,7 +551,7 @@ def close_conversation(
 def reopen_conversation(
     conversation_id: int,
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> ReopenConversationResponse:
     """Reopen a closed conversation."""
     conversation = messaging_service.reopen_conversation(
@@ -580,7 +580,7 @@ def reopen_conversation(
 def mark_read(
     conversation_id: int,
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> MarkReadResponse:
     """Mark conversation as read."""
     success = messaging_service.mark_conversation_read(
@@ -608,7 +608,7 @@ def update_preferences(
     conversation_id: int,
     preferences: NotificationPreferencesUpdate,
     db: Session = Depends(get_db),
-    current_admin: User = Depends(get_current_admin_api),
+    current_admin: UserContext = Depends(get_current_admin_api),
 ) -> PreferencesUpdateResponse:
     """Update notification preferences for a conversation."""
     success = messaging_service.update_notification_preferences(