更新admin 和 swagger

backend/shop/views.py

@@ -2,9 +2,14 @@ from rest_framework import viewsets, status
 from rest_framework.decorators import action
 from rest_framework.response import Response
 from django.shortcuts import render
+from drf_spectacular.utils import extend_schema, extend_schema_view, OpenApiParameter, OpenApiExample
 from .models import ESP32Config, Order, WeChatPayConfig, Service, ARService, ServiceOrder
 from .serializers import ESP32ConfigSerializer, OrderSerializer, ServiceSerializer, ARServiceSerializer, ServiceOrderSerializer
 
+@extend_schema_view(
+    list=extend_schema(summary="获取AR服务列表", description="获取所有可用的AR服务"),
+    retrieve=extend_schema(summary="获取AR服务详情", description="获取指定AR服务的详细信息")
+)
 class ARServiceViewSet(viewsets.ReadOnlyModelViewSet):
     """
     AR服务列表和详情
@@ -21,6 +26,10 @@ def order_check_view(request):
     """
     return render(request, 'shop/order_check.html')
 
+@extend_schema_view(
+    list=extend_schema(summary="获取AI服务列表", description="获取所有可用的AI服务"),
+    retrieve=extend_schema(summary="获取AI服务详情", description="获取指定AI服务的详细信息")
+)
 class ServiceViewSet(viewsets.ReadOnlyModelViewSet):
     """
     AI服务列表和详情
@@ -35,6 +44,10 @@ class ServiceOrderViewSet(viewsets.ModelViewSet):
     queryset = ServiceOrder.objects.all()
     serializer_class = ServiceOrderSerializer
 
+@extend_schema_view(
+    list=extend_schema(summary="获取ESP32配置列表", description="获取所有可用的ESP32硬件配置选项"),
+    retrieve=extend_schema(summary="获取ESP32配置详情", description="获取指定ESP32配置的详细信息")
+)
 class ESP32ConfigViewSet(viewsets.ReadOnlyModelViewSet):
     """
     提供ESP32配置选项的列表和详情