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

@@ -7,6 +7,7 @@ from rest_framework import serializers
from rest_framework.validators import UniqueValidator
from .models import Profile
from .services import UserService
User = get_user_model()
@@ -126,25 +127,14 @@ class CurrentUserSerializer(serializers.ModelSerializer):
@staticmethod
def get_role(obj) -> str:
if obj.is_superuser:
return "admin"
if obj.is_staff:
return "staff"
return "user"
return UserService.get_user_role(obj)
def get_role_label(self, obj) -> str:
labels = {
"admin": "Администратор системы",
"staff": "Сотрудник системы",
"user": "Пользователь системы",
}
return labels[self.get_role(obj)]
return UserService.get_role_label(self.get_role(obj))
@staticmethod
def get_capabilities(obj) -> dict[str, bool]:
return {
"can_access_admin_page": bool(obj.is_staff or obj.is_superuser),
}
return UserService.get_user_capabilities(obj)
class Meta:
model = User
@@ -169,6 +159,11 @@ class UserManagementSerializer(serializers.Serializer):
email = serializers.EmailField(read_only=True)
phone = serializers.CharField(read_only=True, allow_null=True)
is_active = serializers.BooleanField(read_only=True)
is_verified = serializers.BooleanField(read_only=True)
role = serializers.SerializerMethodField()
role_label = serializers.SerializerMethodField()
capabilities = serializers.SerializerMethodField()
profile = CurrentUserProfileSerializer(read_only=True)
first_name = serializers.SerializerMethodField()
middle_name = serializers.SerializerMethodField()
last_name = serializers.SerializerMethodField()
@@ -196,6 +191,17 @@ class UserManagementSerializer(serializers.Serializer):
def get_last_name(self, obj: User) -> str:
return self._get_profile_value(getattr(obj, "profile", None), "last_name")
@staticmethod
def get_role(obj: User) -> str:
return UserService.get_user_role(obj)
def get_role_label(self, obj: User) -> str:
return UserService.get_role_label(self.get_role(obj))
@staticmethod
def get_capabilities(obj: User) -> dict[str, bool]:
return UserService.get_user_capabilities(obj)
@staticmethod
def _get_latest_job(obj: User) -> Any | None:
return getattr(obj, "latest_job", None)
@@ -243,6 +249,157 @@ class UserManagementSerializer(serializers.Serializer):
return job.is_successful
class AdminUserListResponseSerializer(serializers.Serializer):
"""Пагинированный ответ списка пользователей для административного UI."""
count = serializers.IntegerField(read_only=True)
next = serializers.URLField(read_only=True, allow_null=True)
previous = serializers.URLField(read_only=True, allow_null=True)
results = UserManagementSerializer(many=True, read_only=True)
class ManagedUserSerializer(serializers.ModelSerializer):
"""Короткий ответ мутаций административного управления пользователями."""
role = serializers.SerializerMethodField()
role_label = serializers.SerializerMethodField()
class Meta:
model = User
fields = (
"id",
"username",
"email",
"phone",
"role",
"role_label",
"is_active",
)
read_only_fields = fields
@staticmethod
def get_role(obj: User) -> str:
return UserService.get_user_role(obj)
def get_role_label(self, obj: User) -> str:
return UserService.get_role_label(self.get_role(obj))
class AdminUserCreateSerializer(serializers.ModelSerializer):
"""Входные данные для создания пользователя администратором."""
password = serializers.CharField(
write_only=True,
min_length=8,
help_text="Пароль (минимум 8 символов)",
)
role = serializers.ChoiceField(
choices=UserService.ROLE_CHOICES,
default=UserService.ROLE_USER,
help_text="Прикладная роль пользователя",
)
first_name = serializers.CharField(max_length=50, allow_blank=False)
middle_name = serializers.CharField(
max_length=50,
required=False,
allow_blank=True,
)
last_name = serializers.CharField(max_length=50, allow_blank=False)
class Meta:
model = User
fields = (
"email",
"username",
"phone",
"password",
"role",
"is_active",
"is_verified",
"first_name",
"middle_name",
"last_name",
)
extra_kwargs = {
"email": {
"validators": [UniqueValidator(queryset=User.objects.all())],
},
"username": {
"validators": [UniqueValidator(queryset=User.objects.all())],
},
}
class AdminUserUpdateSerializer(serializers.ModelSerializer):
"""Входные данные частичного обновления пользователя администратором."""
password = serializers.CharField(
write_only=True,
required=False,
min_length=8,
help_text="Новый пароль (опционально)",
)
role = serializers.ChoiceField(
choices=UserService.ROLE_CHOICES,
required=False,
help_text="Прикладная роль пользователя",
)
first_name = serializers.CharField(
max_length=50,
required=False,
allow_blank=True,
)
middle_name = serializers.CharField(
max_length=50,
required=False,
allow_blank=True,
)
last_name = serializers.CharField(
max_length=50,
required=False,
allow_blank=True,
)
class Meta:
model = User
fields = (
"email",
"username",
"phone",
"password",
"role",
"is_active",
"is_verified",
"first_name",
"middle_name",
"last_name",
)
def validate(self, attrs):
profile_fields = {"first_name", "middle_name", "last_name"}
if not any(field in attrs for field in profile_fields):
return attrs
profile = getattr(self.instance, "profile", None) if self.instance else None
first_name = attrs.get(
"first_name",
profile.first_name if profile is not None else None,
)
last_name = attrs.get(
"last_name",
profile.last_name if profile is not None else None,
)
errors = {}
if not str(first_name or "").strip():
errors["first_name"] = "Обязательное поле."
if not str(last_name or "").strip():
errors["last_name"] = "Обязательное поле."
if errors:
raise serializers.ValidationError(errors)
return attrs
class UserUpdateSerializer(serializers.ModelSerializer):
"""Сериализатор для обновления данных пользователя"""