From 529a0d8b1d510147d252b8ec4bf77224cc7ede1d Mon Sep 17 00:00:00 2001
From: jeremygan2021 <jeremygan2021@gmail.com>
Date: Mon, 2 Feb 2026 14:41:21 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0admin=20=E5=92=8C=20swagger?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../__pycache__/settings.cpython-313.pyc      | Bin 3855 -> 3818 bytes
 backend/config/settings.py                    |  10 ++++------
 .../shop/__pycache__/views.cpython-313.pyc    | Bin 6806 -> 7638 bytes
 backend/shop/views.py                         |  13 +++++++++++++
 4 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/backend/config/__pycache__/settings.cpython-313.pyc b/backend/config/__pycache__/settings.cpython-313.pyc
index 707d1a555cab2d2669eae7366050a82532786a8f..11ed20be7648b28ff3a1dbbb636641c18deb4ecf 100644
GIT binary patch
delta 246
zcmeB|dnL>JnU|M~0SHdIHDoqV<dtNM+o-O?Xs#Bl7ObwvStK2-5v&=k6|5bs6RaDo
z7pxy_5NsH16l@%95^Nf57HqD^ZNM08p~q4rlg^}Rxp@L(J0l~{WC`Z8V&W-9Y4ODc
zsmUdY$)!1oMe)U%DXGbuA2Dk&Gm38JWw&JFzQrEw>Ei0_7^KNLxsNl!ls`D!(cRrO
zC_dCP-o-OG<d!&+fSY5Or?bCbyho6$+bymjR~LV0u%gXkT&~QFizmnM`m*y1F*Wdg
jlH0t2mx)nGT;Ybi#tk9qkHTCMOcxkLKFCZy!{-bDo-IY{

delta 266
zcmaDQ+b_ranU|M~0SHz*H)L*@$ScX1vQb@!k)Jgf1l9GJgEjOxilisUG0F)9Tj+5c
zFa}%du@uRqGih3F?qY0bWaOSK#C&%14`y{{Mv=`5?3PR(RowcC1)2I~(FVGfv6{@c
zxKmP73w$#3vNQA2Z;2G778Pd}mpGP|WaJlRRwb5X=I7lKO35rP$Vsg92g-s)JX16|
zCZ}*FXbA;7d${^K#s@ftc*F+;xw?5q+!78BcXW4m4T=x-j1P7V3GwuE4=$CM{D4Dr
zvjCSKGvn&X_PoCAJVHzje4k`CPv&J}l#<eTATE7FLFI;=(nod{8Mcptyb??o7(_lO
JO<vCD3;^BkPiO!D

diff --git a/backend/config/settings.py b/backend/config/settings.py
index 571e92e..6229f8b 100644
--- a/backend/config/settings.py
+++ b/backend/config/settings.py
@@ -42,6 +42,7 @@ INSTALLED_APPS = [
     'rest_framework',
     'corsheaders',
     'drf_spectacular',  # Swagger文档生成
+    'drf_spectacular_sidecar',
     'shop',
 ]
 
@@ -150,12 +151,9 @@ SPECTACULAR_SETTINGS = {
     'SERVE_INCLUDE_SCHEMA': True,
     'SERVE_PERMISSIONS': ['rest_framework.permissions.AllowAny'],
     'COMPONENT_SPLIT_REQUEST': True,
-    'SCHEMA_PATH_PREFIX': r'/api/v[0-9]',
-    'SWAGGER_UI_SETTINGS': {
-        'deepLinking': True,
-        'persistAuthorization': True,
-        'displayOperationId': True,
-    },
+    'SWAGGER_UI_DIST': 'SIDECAR',
+    'SWAGGER_UI_FAVICON_HREF': 'SIDECAR',
+    'REDOC_DIST': 'SIDECAR',
 }
 
 # django-unfold配置
diff --git a/backend/shop/__pycache__/views.cpython-313.pyc b/backend/shop/__pycache__/views.cpython-313.pyc
index 54f0fe280c19ad744f9fc4f689b06a8790a00b11..757f1fc56480e0ff2327a20bce8df2fb8d0afb3d 100644
GIT binary patch
delta 2336
zcma)7ZA?>F7(S=8^y{{imVPQwiU<{<8zPZm%$z#sWqyR45Y1RfEm!T<LUV4bIFnT~
z71{hik5l7ZGWKIJ(a567oH5I??ALyc#%;uF3|nRa|G{9%er-GNX{q8Q?xy$YIq!SU
z^S<Z(IQPQpU)pMCEfy1E&u5zsNB?#q^gB%EA47gHJ9oDBl{Auc?MBf=Orn{XMS%#S
zg;@MZDwg!^R<VSXh&EyqOG&9{Cw9?69AX(M<9b88Q*;rR=q7H_Lp-9Fcts!a`B9fS
zfVxZpBpD@>WNy{)u^?GsELmGM9>jDdJ|x+?u%@GhCa|w_b>1nmR6<f|dpRlR{}rTy
z|5uVq$?ikMU*L8~Wd&}h<XXV(X55}GoTK&>sH?bPFH`!MawD_5Bvf4>Tp}$k5SB|7
z3kWOO9{+y{mvO=>rVPvz>T33u2CL~1ZrvQzsusCFDfjktE0KM2JgnLmOuP3-<pZj1
zdqVDApNQ@VlW<&4%0#v1C7b%g@kC6fKj5#^sWKLysnfT!XD+Pon7DE(`{8i*#Ko!M
ztEuvWVq);{#FfG9nUTr!S0^tYonIH!sCp$8kB7-Y)!ZX15fV)#qkX;4p`04|V&a2i
zsp=<`CkL`OF0b#X&6#AZY{}%^<Bz@_o;WhXn6<H}l2i>uPLim+U#3SipJF4eEF#!W
z&lN4lZhEJv0aww<qFt^EMoR#U>{S{W97i)I+NrHCZs009pdG-Cv_$99z03q|x<a=k
z4XUSI-SR(ApI`T!t&5#9zhmJc@d!K9NAxG14VTlbE|B(vt5poP1uY~169^Ys22caA
z9H11S7N8Cw2(SWxH6tSR04o82i15=xJjkkffUGL80z#zG8K#So&3z_4n5M^z%X8sc
zMIY)D)T?*mIvUbfzMb<)SllNEkU#N>yW;`bqVBYS7NCw^)34;I;M0_w$#T`WN!qch
z>G82sli%FP7bJL{(>+s=eCg!y^+$KV%58Xjc<}M?o#&I~lLW!clbx)9T71gh!bFYG
zU-d_Di0(EtM_(8UE2Dij6wqOdhoTj<03r4&kaAwU{}}uxo<2}T&XzjqI^%b^?WU<w
zgZ(rll;d@DtFX*b!qnWLTD&J3V_i;y^r#RhehK8S(d$Bh75<NcA8(-3!T@f#)o*!F
z<lDfsDcCx7<MZsPkF&RLPMjZkboUb3cq?A2$F?_Mw+(=&bqhUe|D@(km;<k>NxZA-
z`bZDEQ!EGM$i8s0JJQ#?C%TvP(2b57+(qAU>|}PocQoUUTYoujVrKZ7Q;V@gzjU=Z
z!@#5kkOB4qM9;Yc6$KMS0a=oP0_*(jA&vA^cN0EA757`Yih*nd@wT9C@zN}WC)X~#
zG@U@rOH&7<?Evos3;;ltJ=;BNK?cyqUgaP{bgSo(nWqP&!R7RxCy{pckUiZ>LXITE
zkyI>98dJ$=Od)V75%_2lGl0NAEspo~$V|t}h5N{Z&70c}tDvP+vm%pdI2L_RCJNzI
z#9il|4vj*f$<(qAIoz|oH%2ddt!aK0@_6or1u+1)^7sXy3R}T!C;K``>|W(f$jgtP
z52E?x#!wAwnUATMypEh>3d~-`!Em|=V?2)PAEK4~S3Qp8dq^HfyT;J2@ia>RjMBeh
z$9<z~v~u<6hTR!s<i5o>THQLjIhL`+XLLmx&747p>xcTs+|3zx^DJVMStAoqgLqaz
zSa^WU50Lc_trj=W2uM@*Lbl-0&M{|G#(Ag-=z;~h;G9*58!y$3`9c|AXpZR`XRPyt
zYervBW{fHB-r7--WGqU-y@pGkF>g!8+X8$I1-^zkTPMaM9$GWzsLMF&{zQDr!}c%l
CEs(+h

delta 1561
zcmai!-ESL35WsgGpJV$zeD>L~@6yDMn-5z_Ts3v0HZF)tAjCx!)Pt%KsnRIEwpN^`
znhPzZLRTK3s!By*B~%HJc;FwPdEtR4-YeCrz|ut!A^rdgF+$=2v9rbjiXu+F-`&p4
z&dkls`rFz^M<;ewHBR_dJ9)G5wL!>_xaeKdUoX4$4<_bbketYT%#K6cmO-`^P;3=c
zTLaBbK%zh#$?2ch?Ia}a6r^ke3_A^JI|G>l$&n&)q84#ti}dsq`yy@}?d$r6tV5jm
zd=7HrX@V)97FdpK5f~IZ6~0sL?acOe9uPW>>k?cyhhFz|!$PNXUGhKs@<Ny5I-|Ew
z?fEQRjF;1_5IW923w_D{==+pL*(YJ38cRsy)L^sHG&NaWS{NAM`2!-#Z?D4fF8Mjc
z9!ZmtF`;7N$gSEqe+~3?sJpPVa>-p;UAo$EuR)oMQ~dT2H%TW-l+@<L!@-$H@{xz(
zBY+-w^gHZ9zfN=P`~ISz<03FQPL)-#a50EDfEYpyBUD5lQ9z6!iU<q@2N9zPbR?nx
zW(bo#U=(kP13xAtMIT3qo_*iH?K3|*6cZnYwrnlF#!|5i&9hQ0f3BOBvVU3$^#6BS
zBBM0Q_RR<j3Wz-WJT}#hj7uK*Z92|=idP%|8x;rp$*4NY_KkWNwFs<=hi0Ow@5zO3
zQxCKIazHCvca=(r_vI^Xh|aP=8#QFyh#we4E;O1OF2D#&CW?^~%IDbeM3E=Gm?&`b
zw-UGL*p{Sk_t6^r!N}1QTfZCqRDT9d6@)0%NtVofJoYTE(Mb@xvKmNYkOK9ZyK-rH
zV`*jm@`c7lSY)lt7=4BPmO0CVygX2)&uzUkaG&xh$8upx=h;(cEwg~0!iaN-^N3}3
z*DMb2#eh{5HaR>rEbt4)*#mQi-uTdZ%@^IrqL=BZvc7+__iE9dLDB3adKP7u@a=iT
zRfLZiMWE+@jARv;2<*Cdop(O4Zpb1Bl$J->`N1oGWNp3fHa!rn7J)?t#WB#(15REb
zdoDDVn~gVJ@IXv}$VZ$B{+~wxXE8{hc9-ifU2a}~5q+NF=hSgG#1ZdSYY8pu2t2;x
z%=m%wFJsJA%#X<YiBAfmCwR86H{GY<Hn*ev_U>>z?xU3Mkjd}Jl=vOoAq#D?utWTB
zh~EiIbaL~JcDCBeRy%|*b`?UEZ6a?I?Uz@>VOs4d5-o3@ZD(d$nHe-GcQlDs?v>is
op_X+BB^8uR-^;bl*_JtrlIf0qhEkhu9%~z=mQnhZh^1)2pDjNzcK`qY

diff --git a/backend/shop/views.py b/backend/shop/views.py
index 38b8606..26e9016 100644
--- a/backend/shop/views.py
+++ b/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配置选项的列表和详情