feat: add admin user management API
All checks were successful
CI/CD Pipeline / Code Quality Checks (push) Successful in 2m59s
CI/CD Pipeline / Run Tests (push) Successful in 5m2s
CI/CD Pipeline / Build and Push Dev Images (push) Successful in 21m9s
CI/CD Pipeline / Deploy Dev via Compose (push) Successful in 54s

This commit is contained in:
2026-08-05 11:24:49 +02:00
parent 2b9ecc2681
commit 2259ee1209
5 changed files with 796 additions and 21 deletions

View File

@@ -1,13 +1,18 @@
from urllib.parse import urlencode
from apps.core.models import BackgroundJob
from apps.core.services import BackgroundJobService
from django.contrib.auth import authenticate, get_user_model
from django.contrib.auth.hashers import check_password
from django.core.paginator import Paginator
from django.db.models import F
from django.db.models.functions import Coalesce
from django.shortcuts import get_object_or_404
from drf_yasg import openapi
from drf_yasg.utils import swagger_auto_schema
from rest_framework import generics, status
from rest_framework.decorators import api_view, permission_classes
from rest_framework.exceptions import ValidationError
from rest_framework.permissions import AllowAny, IsAdminUser, IsAuthenticated
from rest_framework.response import Response
from rest_framework.views import APIView
@@ -15,8 +20,12 @@ from rest_framework_simplejwt.exceptions import TokenError
from rest_framework_simplejwt.tokens import RefreshToken
from .serializers import (
AdminUserCreateSerializer,
AdminUserListResponseSerializer,
AdminUserUpdateSerializer,
CurrentUserSerializer,
LoginSerializer,
ManagedUserSerializer,
PasswordChangeSerializer,
ProfileUpdateSerializer,
TokenSerializer,
@@ -34,6 +43,56 @@ AUTH_TAG = "Аутентификация"
USER_TAG = "Пользователь"
def _build_page_url(request, page_number: int) -> str:
query_params = request.query_params.copy()
query_params["page"] = page_number
encoded_query = urlencode(query_params, doseq=True)
return request.build_absolute_uri(f"{request.path}?{encoded_query}")
def _paginate_user_queryset(request, queryset):
"""Пагинирует только запросы с явными page/page_size для legacy-совместимости."""
if "page" not in request.query_params and "page_size" not in request.query_params:
return {
"count": queryset.count(),
"next": None,
"previous": None,
"results": list(queryset),
}
page_size_raw = request.query_params.get("page_size", "20")
page_raw = request.query_params.get("page", "1")
try:
page_size = max(1, min(int(page_size_raw), 100))
page_number = max(1, int(page_raw))
except (TypeError, ValueError) as exc:
raise ValidationError(
{
"detail": (
"Параметры page и page_size должны быть положительными "
"целыми числами."
)
}
) from exc
paginator = Paginator(queryset, page_size)
page_obj = paginator.get_page(page_number)
return {
"count": paginator.count,
"next": (
_build_page_url(request, page_obj.next_page_number())
if page_obj.has_next()
else None
),
"previous": (
_build_page_url(request, page_obj.previous_page_number())
if page_obj.has_previous()
else None
),
"results": list(page_obj.object_list),
}
class RegisterView(APIView):
"""
Регистрация нового пользователя.
@@ -239,7 +298,7 @@ class PasswordChangeView(APIView):
class AdminUsersManagementView(APIView):
"""Список пользователей для административной страницы управления."""
"""Список и создание пользователей в административной панели."""
permission_classes = [IsAdminUser]
@@ -276,15 +335,152 @@ class AdminUsersManagementView(APIView):
operation_summary="Список пользователей (admin)",
operation_description=(
"Возвращает пользователей для административной панели управления. "
"Включает метрики последней фоновой задачи пользователя."
"Включает роль, профиль и метрики последней фоновой задачи пользователя."
),
responses={200: UserManagementSerializer(many=True)},
manual_parameters=[
openapi.Parameter(
"search",
openapi.IN_QUERY,
type=openapi.TYPE_STRING,
required=False,
),
openapi.Parameter(
"ordering",
openapi.IN_QUERY,
type=openapi.TYPE_STRING,
required=False,
),
openapi.Parameter(
"page",
openapi.IN_QUERY,
type=openapi.TYPE_INTEGER,
required=False,
),
openapi.Parameter(
"page_size",
openapi.IN_QUERY,
type=openapi.TYPE_INTEGER,
required=False,
),
],
responses={200: AdminUserListResponseSerializer},
)
def get(self, request):
users = User.objects.all().select_related("profile").order_by("id")
self._attach_latest_jobs(list(users))
queryset = UserService.get_filtered_users_queryset(
search=request.query_params.get("search", ""),
ordering=request.query_params.get("ordering", ""),
)
paginated = _paginate_user_queryset(request, queryset)
users = paginated["results"]
self._attach_latest_jobs(users)
serializer = UserManagementSerializer(users, many=True)
return Response({"results": serializer.data})
return Response(
{
"count": paginated["count"],
"next": paginated["next"],
"previous": paginated["previous"],
"results": serializer.data,
}
)
@swagger_auto_schema(
tags=[USER_TAG],
operation_summary="Создать пользователя (admin)",
request_body=AdminUserCreateSerializer,
responses={201: ManagedUserSerializer},
)
def post(self, request):
serializer = AdminUserCreateSerializer(data=request.data)
serializer.is_valid(raise_exception=True)
user = UserService.create_managed_user(**serializer.validated_data)
return Response(
ManagedUserSerializer(user).data,
status=status.HTTP_201_CREATED,
)
class AdminUserDetailView(APIView):
"""Просмотр и частичное обновление пользователя администратором."""
permission_classes = [IsAdminUser]
@staticmethod
def _get_user(user_id: int):
return get_object_or_404(UserService.get_users_queryset(), id=user_id)
@swagger_auto_schema(
tags=[USER_TAG],
operation_summary="Детали пользователя (admin)",
responses={200: UserManagementSerializer},
)
def get(self, request, user_id: int):
user = self._get_user(user_id)
AdminUsersManagementView._attach_latest_jobs([user])
return Response(UserManagementSerializer(user).data)
@swagger_auto_schema(
tags=[USER_TAG],
operation_summary="Обновить пользователя (admin)",
request_body=AdminUserUpdateSerializer,
responses={200: ManagedUserSerializer},
)
def patch(self, request, user_id: int):
user = self._get_user(user_id)
serializer = AdminUserUpdateSerializer(user, data=request.data, partial=True)
serializer.is_valid(raise_exception=True)
if request.user.id == user.id:
if serializer.validated_data.get("is_active") is False:
return Response(
{"detail": "Нельзя деактивировать самого себя."},
status=status.HTTP_400_BAD_REQUEST,
)
if serializer.validated_data.get("role") == UserService.ROLE_USER:
return Response(
{"detail": "Нельзя снять у себя роль администратора."},
status=status.HTTP_400_BAD_REQUEST,
)
updated_user = UserService.update_managed_user(
user_id=user.id,
**serializer.validated_data,
)
return Response(ManagedUserSerializer(updated_user).data)
class AdminUserDeactivateView(APIView):
"""Деактивация пользователя администратором."""
permission_classes = [IsAdminUser]
@swagger_auto_schema(
tags=[USER_TAG],
operation_summary="Деактивировать пользователя (admin)",
responses={200: ManagedUserSerializer},
)
def post(self, request, user_id: int):
if request.user.id == user_id:
return Response(
{"detail": "Нельзя деактивировать самого себя."},
status=status.HTTP_400_BAD_REQUEST,
)
user = UserService.deactivate_user(user_id)
return Response(ManagedUserSerializer(user).data)
class AdminUserActivateView(APIView):
"""Активация пользователя администратором."""
permission_classes = [IsAdminUser]
@swagger_auto_schema(
tags=[USER_TAG],
operation_summary="Активировать пользователя (admin)",
responses={200: ManagedUserSerializer},
)
def post(self, request, user_id: int):
user = UserService.activate_user(user_id)
return Response(ManagedUserSerializer(user).data)
@swagger_auto_schema(