Разработка административной панели на Django Admin

Разработка административной панели на Django Admin

Django Admin — встроенная система управления данными в Django. Работает "из коробки" для любой модели, требует минимального кода для базового CRUD. При правильной настройке закрывает большинство операционных нужд бизнеса.

Базовая регистрация модели

# admin.py
from django.contrib import admin
from .models import Order, OrderItem, Customer

@admin.register(Order)
class OrderAdmin(admin.ModelAdmin):
    list_display       = ['id', 'customer', 'status', 'total_display', 'created_at']
    list_filter        = ['status', 'created_at']
    search_fields      = ['id', 'customer__email', 'customer__phone']
    list_select_related= ['customer']
    ordering           = ['-created_at']
    date_hierarchy     = 'created_at'
    readonly_fields    = ['created_at', 'updated_at', 'total']
    list_per_page      = 50

    def total_display(self, obj):
        return f'₽{obj.total / 100:,.0f}'
    total_display.short_description = 'Сумма'
    total_display.admin_order_field = 'total'

    def get_queryset(self, request):
        return super().get_queryset(request).prefetch_related('items__product')

Inline-редактирование связанных объектов

class OrderItemInline(admin.TabularInline):
    model          = OrderItem
    fields         = ['product', 'quantity', 'price', 'total']
    readonly_fields= ['total']
    extra          = 0  # не показывать пустые строки для добавления

@admin.register(Order)
class OrderAdmin(admin.ModelAdmin):
    inlines = [OrderItemInline]

Кастомные действия

@admin.action(description='Отметить как выполненные')
def mark_completed(modeladmin, request, queryset):
    updated = queryset.filter(status='pending').update(
        status='completed',
        completed_at=timezone.now()
    )
    modeladmin.message_user(request, f'{updated} заказов отмечены как выполненные.')

@admin.action(description='Экспорт в Excel')
def export_excel(modeladmin, request, queryset):
    # Генерация Excel через openpyxl
    response = HttpResponse(content_type='application/vnd.ms-excel')
    response['Content-Disposition'] = 'attachment; filename=orders.xlsx'
    export_orders_to_excel(queryset, response)
    return response

class OrderAdmin(admin.ModelAdmin):
    actions = [mark_completed, export_excel]

Кастомная страница статистики

from django.contrib.admin.views.decorators import staff_member_required
from django.shortcuts import render
from django.db.models import Sum, Count
from django.db.models.functions import TruncDate

@staff_member_required
def order_statistics(request):
    stats = Order.objects.filter(
        status='completed',
        created_at__gte=timezone.now() - timedelta(days=30)
    ).annotate(
        date=TruncDate('created_at')
    ).values('date').annotate(
        revenue=Sum('total'),
        count=Count('id')
    ).order_by('date')

    return render(request, 'admin/order_statistics.html', {'stats': list(stats)})

Настройка прав доступа

class OrderAdmin(admin.ModelAdmin):
    def has_delete_permission(self, request, obj=None):
        return request.user.has_perm('orders.delete_order') and request.user.is_superuser

    def has_change_permission(self, request, obj=None):
        if obj and obj.status == 'completed':
            return request.user.is_superuser  # только суперадмин может редактировать завершённые
        return super().has_change_permission(request, obj)

Кастомизация интерфейса (django-jazzmin)

pip install django-jazzmin

# settings.py
INSTALLED_APPS = ['jazzmin', 'django.contrib.admin', ...]

JAZZMIN_SETTINGS = {
    'site_title':  'Мой Магазин',
    'site_header': 'Администрирование',
    'site_brand':  'Магазин',
    'theme':       'flatly',
    'icons': {
        'orders.order':    'fas fa-shopping-cart',
        'auth.user':       'fas fa-user',
        'catalog.product': 'fas fa-box'
    }
}

django-import-export: импорт/экспорт CSV/Excel

from import_export import resources, fields
from import_export.admin import ImportExportModelAdmin

class ProductResource(resources.ModelResource):
    class Meta:
        model = Product
        fields = ('id', 'name', 'sku', 'price', 'stock')
        import_id_fields = ('sku',)  # обновлять по SKU, не по ID

@admin.register(Product)
class ProductAdmin(ImportExportModelAdmin):
    resource_classes = [ProductResource]

Срок разработки: 2–3 недели для полноценной панели с кастомными действиями, инлайнами, правами и экспортом.