✅ Решения практикума 10

Решение 1.1 — Автоматическое добавление клиента при оформлении заказа

# views.py
from rest_framework import viewsets
from rest_framework.permissions import IsAuthenticated
from .models import Order
from .serializers import OrderSerializer

class OrderListCreateView(viewsets.ModelViewSet):
    queryset = Order.objects.all()
    serializer_class = OrderSerializer
    permission_classes = [IsAuthenticated]

    def perform_create(self, serializer):
        serializer.save(customer=self.request.user)

Решение 1.2 — Извлечение объектов, где пользователь является владельцем

# views.py
from rest_framework.generics import ListAPIView
from rest_framework.permissions import IsAuthenticated
from .models import Order
from .serializers import OrderSerializer

class UserOrderListView(ListAPIView):
    serializer_class = OrderSerializer
    permission_classes = [IsAuthenticated]

    def get_queryset(self):
        return Order.objects.filter(customer=self.request.user)

Решение 1.3 — Обновление маршрутов

# urls.py
from django.urls import path
from .views import UserOrderListView, OrderListCreateView

urlpatterns = [
    path('user-orders/', UserOrderListView.as_view(), name='user-orders'),
    path('orders/', OrderListCreateView.as_view({'get': 'list', 'post': 'create'}), name='orders'),
]

Решение 2.1 — IsCustomerOrReadOnly

# permissions.py
from rest_framework.permissions import BasePermission

class IsCustomerOrReadOnly(BasePermission):
    """
    Разрешает редактирование объектов только их владельцам (customer),
    остальным — только чтение.
    """
    def has_object_permission(self, request, view, obj):
        # Все пользователи могут просматривать
        if request.method in ['GET', 'HEAD', 'OPTIONS']:
            return True
        # Только владелец может изменять объект
        return obj.customer == request.user

Решение 2.2 — Применение IsCustomerOrReadOnly к представлению

# views.py
from rest_framework.generics import RetrieveUpdateDestroyAPIView
from .models import Order
from .serializers import OrderSerializer
from .permissions import IsCustomerOrReadOnly

class OrderDetailUpdateDeleteView(RetrieveUpdateDestroyAPIView):
    queryset = Order.objects.all()
    serializer_class = OrderSerializer
    permission_classes = [IsCustomerOrReadOnly]

Решение 3.1 — Пользовательское разрешение в Meta

# models.py
from django.db import models

class Order(models.Model):
    order_date = models.DateTimeField(auto_now_add=True)
    customer = models.ForeignKey(Customer, on_delete=models.PROTECT,
                                  related_name='orders')

    class Meta:
        permissions = [
            ("can_view_statistics", "Can view statistics"),
        ]

Решение 3.2 — Кастомное разрешение CanViewStatistics

# permissions.py
from rest_framework.permissions import BasePermission

class CanViewStatistics(BasePermission):
    """
    Разрешает доступ к статистике только пользователям с соответствующим
    разрешением.
    """
    def has_permission(self, request, view):
        return request.user.has_perm('store.can_view_statistics')

Решение 3.3 — Эндпоинт для статистики

# views.py
from rest_framework.views import APIView
from rest_framework.response import Response
from .permissions import CanViewStatistics
from .models import Order

class OrderStatisticsView(APIView):
    permission_classes = [CanViewStatistics]

    def get(self, request, *args, **kwargs):
        total_orders = Order.objects.count()
        data = {
            'total_orders': total_orders,
        }
        return Response(data)

Решение 3.4 — Маршрут для статистики

# urls.py
from .views import OrderStatisticsView

urlpatterns += [
    path('order-statistics/', OrderStatisticsView.as_view(), name='order-statistics'),
]

Решение 3.5 — Миграции

python manage.py makemigrations
python manage.py migrate

Решение 3.6 — Группа в Django Admin

1. Зайдите в http://127.0.0.1:8000/admin/
2. Перейдите в раздел Groups (Группы)
3. Создайте группу "Statistic"
4. Добавьте в группу разрешение "Can view statistics" (ищите в фильтре)
5. Сохраните группу
6. Перейдите в раздел Users (Пользователи)
7. Найдите нужного пользователя (первый admin)
8. В разделе Groups добавьте группу "Statistic"
9. Сохраните пользователя

Решение 4.1 — Создание дампа базы данных

# Создать дамп всех объектов проекта
python manage.py dumpdata --indent=4 > db_backup.json

Решение 4.2 — Восстановление базы данных из дампа

# После удаления БД: применить миграции (создать структуру таблиц)
python manage.py migrate

# Загрузить данные из дампа
python manage.py loaddata db_backup.json

Решение 5.1 — Установка библиотеки

pip install drf-spectacular

Решение 5.2 — Настройка в settings.py

# settings.py
INSTALLED_APPS = [
    ...
    'rest_framework',
    'drf_spectacular',
]

REST_FRAMEWORK = {
    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
}

SPECTACULAR_SETTINGS = {
    'TITLE': 'API Documentation',
    'DESCRIPTION': 'API documentation for the project',
    'VERSION': '1.0.0',
    'SERVE_INCLUDE_SCHEMA': False,
}

Решение 5.3 — Маршруты для схемы и UI

# urls.py
from drf_spectacular.views import (
    SpectacularAPIView,
    SpectacularRedocView,
    SpectacularSwaggerView,
)

urlpatterns += [
    path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
    path('api/docs/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
    path('api/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
]