Веб-приложение на Python Django: от идеи до реализации

Как выбрать между функциональными и классовыми представлениями?

Функциональные представления (FBV) просты в написании и подходят для несложных страниц. Классовые представления (CBV) предоставляют готовые методы для стандартных действий (список, деталь, создание, обновление, удаление) и уменьшают дублирование кода.

Пример CBV для списка статей:

from django.views.generic import ListView
from .models import Article

class ArticleListView(ListView):
    model = Article
    template_name = 'myapp/article_list.html'
    context_object_name = 'articles'

Цель использования: CBV рекомендуется применять, когда логика представления повторяет стандартные паттерны (отображение списка, деталей, форм). Если требуется нестандартная обработка запроса, FBV даёт больше гибкости.

Типичные ошибки: в CBV часто забывают указать template_name или context_object_name, что приводит к использованию шаблонов по умолчанию, которые могут отсутствовать. В FBV разработчики иногда дублируют код в разных представлениях.

Как создать RESTful API на основе моделей Django?

Для создания API используется Django REST Framework (DRF). Он предоставляет сериализаторы, классы представлений и маршрутизацию.

# serializers.py
from rest_framework import serializers
from .models import Article

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article
        fields = ['id', 'title', 'content', 'pub_date']

# views.py
from rest_framework import generics
from .models import Article
from .serializers import ArticleSerializer

class ArticleListCreate(generics.ListCreateAPIView):
    queryset = Article.objects.all()
    serializer_class = ArticleSerializer

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('api/articles/', views.ArticleListCreate.as_view()),
]

После добавления rest_framework в INSTALLED_APPS и запуска сервера API становится доступным. Для полного CRUD можно использовать ViewSet и Router:

# views.py
from rest_framework import viewsets
from .models import Article
from .serializers import ArticleSerializer

class ArticleViewSet(viewsets.ModelViewSet):
    queryset = Article.objects.all()
    serializer_class = ArticleSerializer

# urls.py
from rest_framework.routers import DefaultRouter
from . import views

router = DefaultRouter()
router.register(r'articles', views.ArticleViewSet)

urlpatterns = router.urls

Цель использования: DRF подходит для создания бэкенда под мобильные приложения, SPA на React/Vue/Angular или для интеграции с внешними сервисами.

Ошибки: неверное указание queryset в представлении, отсутствие прав доступа (permissions), нехватка сериализаторов для вложенных объектов.

Как настроить интерфейс администратора Django под свои нужды?

Django предоставляет мощную административную панель, которую можно кастомизировать с помощью класса ModelAdmin в файле admin.py.

from django.contrib import admin
from .models import Article

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'pub_date', 'is_published')
    list_filter = ('pub_date', 'is_published')
    search_fields = ('title', 'content')
    fieldsets = (
        (None, {
            'fields': ('title', 'content')
        }),
        ('Дата и статус', {
            'fields': ('pub_date', 'is_published'),
            'classes': ('collapse',)
        }),
    )

Можно также добавлять встроенные модели (inlines) для связанных объектов.

class CommentInline(admin.TabularInline):
    model = Comment
    extra = 1

class ArticleAdmin(admin.ModelAdmin):
    inlines = [CommentInline]

Цель использования: кастомизация админки полезна для удобного управления данными без написания отдельного интерфейса. Часто используется в проектах, где админка выступает основным интерфейсом для контент-менеджеров.

Ошибки: неправильно указанный model в декораторе или встроенной модели, отсутствие регистрации модели в админке.

Как обрабатывать данные форм с кастомной валидацией?

Django предоставляет классы Form и ModelForm. Кастомная валидация реализуется через методы clean_ и общий clean.

from django import forms
from .models import Article

class ArticleForm(forms.ModelForm):
    class Meta:
        model = Article
        fields = ['title', 'content', 'is_published']

    def clean_title(self):
        title = self.cleaned_data['title']
        if len(title) < 10:
            raise forms.ValidationError('Заголовок должен содержать не менее 10 символов')
        return title

    def clean(self):
        cleaned_data = super().clean()
        content = cleaned_data.get('content')
        if content and 'spam' in content.lower():
            raise forms.ValidationError('Контент не должен содержать слово spam')

Использование формы в представлении:

from django.shortcuts import render, redirect
from .forms import ArticleForm

def create_article(request):
    if request.method == 'POST':
        form = ArticleForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('myapp:article_list')
    else:
        form = ArticleForm()
    return render(request, 'myapp/article_form.html', {'form': form})

Цель использования: формы с кастомной валидацией необходимы, когда стандартные проверки (тип поля, обязательность) недостаточны. Подходит для любых сайтов с пользовательским вводом.

Ошибки: вызов raise forms.ValidationError без указания кода или с неправильным аргументом, забыв выполнить super().clean() при переопределении clean.