anti-plagiarism/services/api/app/core/security.py

"""JWT, хэширование паролей, dependency получения пользователя с кэшированием."""

import json
import logging
from datetime import UTC, datetime, timedelta
from typing import Any

from fastapi import Depends, HTTPException, Query, WebSocket, status
from fastapi.security import OAuth2PasswordBearer
from jose import JWTError, jwt
from passlib.context import CryptContext
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession

from app.config import settings
from app.core.redis_client import get_redis
from app.database import get_db

logger = logging.getLogger(__name__)

pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/api/auth/login")

# TTL кэша пользователя в Redis (5 минут)
_USER_CACHE_TTL = 300


def hash_password(password: str) -> str:
    return pwd_context.hash(password)


def verify_password(plain: str, hashed: str | None) -> bool:
    # OAuth-пользователи не имеют пароля (hashed_password=None) — попытка
    # войти паролем должна отвечать "неверный пароль", а не падать 500-й.
    if hashed is None:
        return False
    return pwd_context.verify(plain, hashed)


def create_access_token(data: dict[str, Any], expires_delta: timedelta | None = None) -> str:
    payload = data.copy()
    expire = datetime.now(UTC) + (
        expires_delta or timedelta(minutes=settings.ACCESS_TOKEN_EXPIRE_MINUTES)
    )
    payload["exp"] = expire
    return jwt.encode(payload, settings.SECRET_KEY, algorithm=settings.ALGORITHM)


def _decode_token(token: str) -> int:
    """
    Декодировать JWT и вернуть user_id.
    Raises HTTPException 401 при любой проблеме с токеном.
    """
    try:
        payload = jwt.decode(token, settings.SECRET_KEY, algorithms=[settings.ALGORITHM])
        sub = payload.get("sub")
        if sub is None:
            raise ValueError("missing sub")
        return int(sub)
    except (JWTError, ValueError):
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="Невалидный или просроченный токен",
            headers={"WWW-Authenticate": "Bearer"},
        ) from None


async def _load_user(user_id: int, db: AsyncSession):
    """Загрузить пользователя из Redis-кэша или из БД."""
    from app.models.user import User  # избегаем circular import на уровне модуля

    cache_key = f"user:cache:{user_id}"
    r = get_redis()

    # Пробуем кэш
    cached = await r.get(cache_key)
    if cached:
        data = json.loads(cached)
        # Возвращаем "живой" объект из БД только по id, но без лишнего SELECT
        # Создаём User без ORM-связей (достаточно для проверок в роутерах)
        u = User.__new__(User)
        u.__dict__.update(data)
        return u

    # Кэш пустой — идём в БД
    result = await db.execute(select(User).where(User.id == user_id))
    user = result.scalar_one_or_none()

    if user is None:
        raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Пользователь не найден")

    # Сохраняем в кэш (только безопасные поля, без hashed_password)
    safe = {
        "id": user.id,
        "email": user.email,
        "name": user.name,
        "plan": user.plan,
        "is_verified": user.is_verified,
        "is_admin": user.is_admin,
    }
    await r.setex(cache_key, _USER_CACHE_TTL, json.dumps(safe))

    return user


async def get_current_user(
    token: str = Depends(oauth2_scheme),
    db: AsyncSession = Depends(get_db),
):
    """Dependency: текущий пользователь из JWT с Redis-кэшем."""
    user_id = _decode_token(token)
    return await _load_user(user_id, db)


async def get_current_verified_user(current_user=Depends(get_current_user)):
    """Dependency: только верифицированные пользователи."""
    if not current_user.is_verified:
        raise HTTPException(
            status_code=status.HTTP_403_FORBIDDEN,
            detail="Необходимо подтвердить email адрес",
        )
    return current_user


async def get_ws_user(
    websocket: WebSocket,
    token: str = Query(..., description="JWT токен (передаётся как query-параметр ?token=...)"),
    db: AsyncSession = Depends(get_db),
):
    """
    Dependency для WebSocket: аутентификация через query-параметр ?token=JWT.

    WebSocket API браузера не позволяет передавать Authorization header,
    поэтому токен передаётся в query-строке:
        ws://host/ws/tasks/{public_id}?token=<JWT>
    """
    user_id = _decode_token(token)
    return await _load_user(user_id, db)


async def invalidate_user_cache(user_id: int) -> None:
    """Сбросить кэш пользователя (при смене тарифа, пароля и т.д.)."""
    r = get_redis()
    await r.delete(f"user:cache:{user_id}")