新增自学模块

announcement/views/admin.py

@@ -2,8 +2,11 @@ from account.decorators import super_admin_required
 from utils.api import APIView, validate_serializer
 
 from announcement.models import Announcement
-from announcement.serializers import (AnnouncementSerializer, CreateAnnouncementSerializer,
+from announcement.serializers import (
-                                      EditAnnouncementSerializer)
+    AnnouncementSerializer,
+    CreateAnnouncementSerializer,
+    EditAnnouncementSerializer,
+)
 
 
 class AnnouncementAdminAPI(APIView):
@@ -50,7 +53,9 @@ class AnnouncementAdminAPI(APIView):
         announcement = Announcement.objects.all().order_by("-create_time")
         if request.GET.get("visible") == "true":
             announcement = announcement.filter(visible=True)
-        return self.success(self.paginate_data(request, announcement, AnnouncementSerializer))
+        return self.success(
+            self.paginate_data(request, announcement, AnnouncementSerializer)
+        )
 
     @super_admin_required
     def delete(self, request):

tutorial/migrations/0002_tutorial_code_tutorial_type.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.2.3 on 2025-06-15 04:45
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('tutorial', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='tutorial',
+            name='code',
+            field=models.TextField(default=''),
+        ),
+        migrations.AddField(
+            model_name='tutorial',
+            name='type',
+            field=models.CharField(choices=[('python', 'Python'), ('c', 'C')], default='python', max_length=10),
+        ),
+    ]

tutorial/models.py

@@ -2,8 +2,15 @@ from django.db import models
 from account.models import User
 
 class Tutorial(models.Model):
+    TYPE_CHOICES = [
+        ('python', 'Python'),
+        ('c', 'C'),
+    ]
+    
     title = models.CharField(max_length=128)
     content = models.TextField()
+    code = models.TextField(default="")
+    type = models.CharField(max_length=10, choices=TYPE_CHOICES, default='python')
     created_by = models.ForeignKey(User, on_delete=models.CASCADE)
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)

tutorial/serializers.py

@@ -2,11 +2,54 @@ from rest_framework import serializers
 from .models import Tutorial
 from account.serializers import UserSerializer
 
-class TutorialSerializer(serializers.ModelSerializer):
+
+class TutorialListSerializer(serializers.ModelSerializer):
     created_by = UserSerializer(read_only=True)
-    
+
     class Meta:
         model = Tutorial
-        fields = ['id', 'title', 'content', 'created_by', 'created_at', 
+        fields = [
-                 'updated_at', 'is_public', 'order']
+            "id",
-        read_only_fields = ['id', 'created_by', 'created_at', 'updated_at'] 
+            "title",
+            "created_by",
+            "created_at",
+            "updated_at",
+            "is_public",
+            "order",
+            "type",
+        ]
+        read_only_fields = ["id", "created_by", "created_at", "updated_at"]
+
+
+class TutorialSerializer(serializers.ModelSerializer):
+    created_by = UserSerializer(read_only=True)
+
+    class Meta:
+        model = Tutorial
+        fields = [
+            "id",
+            "title",
+            "content",
+            "created_by",
+            "created_at",
+            "updated_at",
+            "is_public",
+            "order",
+            "type",
+            "code",
+        ]
+        read_only_fields = ["id", "created_by", "created_at", "updated_at"]
+
+
+class CreateTutorialSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Tutorial
+        fields = ["title", "content", "is_public", "order", "type", "code"]
+
+
+class EditTutorialSerializer(serializers.ModelSerializer):
+    id = serializers.IntegerField()
+
+    class Meta:
+        model = Tutorial
+        fields = ["id", "title", "content", "is_public", "order", "type", "code"]

tutorial/urls/admin.py

@@ -1,10 +1,10 @@
-from django.urls import path, include
+from django.urls import path
-from rest_framework.routers import DefaultRouter
+from ..views.admin import TutorialAdminAPI, TutorialVisibilityAPI
-from ..views.admin import AdminTutorialViewSet
-
-router = DefaultRouter()
-router.register(r'tutorials', AdminTutorialViewSet)
 
 urlpatterns = [
-    path('', include(router.urls)),
+    path("tutorial", TutorialAdminAPI.as_view()),
-] 
+    path(
+        "tutorial/visibility",
+        TutorialVisibilityAPI.as_view(),
+    ),
+]

tutorial/urls/tutorial.py

@@ -1,10 +1,7 @@
-from django.urls import path, include
+from django.urls import path
-from rest_framework.routers import DefaultRouter
+from ..views.oj import TutorialAPI, TutorialTitlesAPI
-from ..views.tutorial import TutorialViewSet
-
-router = DefaultRouter()
-router.register(r'tutorials', TutorialViewSet)
 
 urlpatterns = [
-    path('', include(router.urls)),
+    path("tutorial", TutorialAPI.as_view()),
-] 
+    path("tutorials", TutorialTitlesAPI.as_view()),
+]

tutorial/views/admin.py

@@ -1,17 +1,92 @@
-from rest_framework import viewsets, permissions
+from account.decorators import super_admin_required
-from ..models import Tutorial
+from utils.api import APIView, validate_serializer
-from ..serializers import TutorialSerializer
+
+from tutorial.models import Tutorial
+from tutorial.serializers import (
+    TutorialSerializer,
+    TutorialListSerializer,
+    CreateTutorialSerializer,
+    EditTutorialSerializer,
+)
 
 
-class IsSuperAdminUser(permissions.BasePermission):
+class TutorialAdminAPI(APIView):
-    def has_permission(self, request, view):
+    @validate_serializer(CreateTutorialSerializer)
-        return bool(request.user and request.user.is_super_admin())
+    @super_admin_required
+    def post(self, request):
+        """
+        create tutorial
+        """
+        data = request.data
+        tutorial = Tutorial.objects.create(**data, created_by=request.user)
+        return self.success(TutorialSerializer(tutorial).data)
+
+    @validate_serializer(EditTutorialSerializer)
+    @super_admin_required
+    def put(self, request):
+        """
+        edit tutorial
+        """
+        data = request.data
+        try:
+            tutorial = Tutorial.objects.get(id=data.pop("id"))
+        except Tutorial.DoesNotExist:
+            return self.error("Tutorial does not exist")
+
+        for k, v in data.items():
+            setattr(tutorial, k, v)
+        tutorial.save()
+
+        return self.success(TutorialSerializer(tutorial).data)
+
+    @super_admin_required
+    def get(self, request):
+        """
+        get tutorial list / get one tutorial
+        """
+        tutorial_id = request.GET.get("id")
+        if tutorial_id:
+            try:
+                tutorial = Tutorial.objects.get(id=tutorial_id)
+                return self.success(TutorialSerializer(tutorial).data)
+            except Tutorial.DoesNotExist:
+                return self.error("Tutorial does not exist")
+                
+        tutorials = Tutorial.objects.all().order_by("order", "-created_at")
+        # 按 type 分组返回数据
+        result = {
+            "python": TutorialListSerializer(
+                tutorials.filter(type="python"), 
+                many=True
+            ).data,
+            "c": TutorialListSerializer(
+                tutorials.filter(type="c"), 
+                many=True
+            ).data
+        }
+        return self.success(result)
+
+    @super_admin_required
+    def delete(self, request):
+        if request.GET.get("id"):
+            Tutorial.objects.filter(id=request.GET["id"]).delete()
+        return self.success()
 
 
-class AdminTutorialViewSet(viewsets.ModelViewSet):
+class TutorialVisibilityAPI(APIView):
-    queryset = Tutorial.objects.all()
+    @super_admin_required
-    serializer_class = TutorialSerializer
+    def put(self, request):
-    permission_classes = [IsSuperAdminUser]
+        """
-
+        change tutorial visibility
-    def perform_create(self, serializer):
+        """
-        serializer.save(created_by=self.request.user) 
+        tutorial_id = request.data.get("id")
+        is_public = request.data.get("is_public")
+        if tutorial_id is None or is_public is None:
+            return self.error("Invalid parameter")
+        try:
+            tutorial = Tutorial.objects.get(id=tutorial_id)
+        except Tutorial.DoesNotExist:
+            return self.error("Tutorial does not exist")
+        tutorial.is_public = is_public
+        tutorial.save()
+        return self.success(TutorialSerializer(tutorial).data)

tutorial/views/oj.py

@@ -0,0 +1,23 @@
+from utils.api import APIView
+
+from tutorial.models import Tutorial
+from tutorial.serializers import TutorialSerializer
+
+
+class TutorialAPI(APIView):
+    def get(self, request):
+        id = request.GET.get("id")
+        try:
+            tutorial = Tutorial.objects.get(id=id, is_public=True)
+            return self.success(TutorialSerializer(tutorial).data)
+        except Tutorial.DoesNotExist:
+            return self.error("Tutorial does not exist")
+
+
+class TutorialTitlesAPI(APIView):
+    def get(self, request):
+        type = request.GET.get("type") or "python"
+        tutorials = Tutorial.objects.filter(is_public=True, type=type).values(
+            "id", "title"
+        )
+        return self.success(list(tutorials))

tutorial/views/tutorial.py

@@ -1,8 +0,0 @@
-from rest_framework import viewsets, permissions
-from ..models import Tutorial
-from ..serializers import TutorialSerializer
-
-class TutorialViewSet(viewsets.ReadOnlyModelViewSet):
-    queryset = Tutorial.objects.filter(is_public=True)
-    serializer_class = TutorialSerializer
-    permission_classes = [permissions.AllowAny]