Merge pull request #78 from UNLV-CS472-672/submissions_endpoints

Submissions Endpoints and Testing

Author: aviendha-andrus

backend/apps/submissions/managers.py

@@ -0,0 +1,82 @@
+from django.db import models
+from django.apps import apps
+
+class SubmissionManager(models.Manager):
+    # POST /submissions/: Create a new submission
+    def create_submission(self, student_profile, submission_status=None, score=None):
+        """Helper method to create a new submission"""
+        Submissions = apps.get_model('submissions', 'Submissions')  # Dynamically import the Submissions model
+        submission = Submissions.objects.create(
+            student_profile=student_profile,
+            submission_status=submission_status or Submissions.NOT_SUBMITTED,
+            score=score
+        )
+        return submission
+    
+    # PATCH /submissions/{submission_id}/
+    def update_submission_status(self, submission_id, status):
+        """Update the status of a submission"""
+        Submissions = apps.get_model('submissions', 'Submissions')
+        submission = Submissions.objects.get(pk=submission_id)  # Directly use Submissions.objects.get
+        submission.submission_status = status
+        submission.save()
+        return submission
+
+    # GET /submissions/{submission_id}/: Retrieve a specific submission.
+    def get_submission(self, submission_id):
+        """Retrieve a specific submission by ID"""
+        Submissions = apps.get_model('submissions', 'Submissions')
+        return Submissions.objects.get(id=submission_id)
+
+    # GET /submissions/: Retrieves all submissions
+    def get_all_submissions(self):
+        """Retrieve all submissions"""
+        Submissions = apps.get_model('submissions', 'Submissions') 
+        return Submissions.objects.all()
+
+class FileSubmissionManager(models.Manager):
+    # POST /submissions/: Create a new submission (file)
+    def create_file_submission(self, submission, file):
+        """Helper method to create a file submission"""
+        FileSubmissions = apps.get_model('submissions', 'FileSubmissions') 
+        file_submission = FileSubmissions.objects.create(
+            submission=submission,
+            file=file
+        )
+        return file_submission
+
+class QuizSubmissionManager(models.Manager):
+    # POST /submissions/quiz-submissions: Create a new submission (quiz)
+    def create_quiz_submission(self, submission):
+        """Create a new quiz submission entry"""
+        QuizSubmissions = apps.get_model('submissions', 'QuizSubmissions') 
+        quiz_submission = QuizSubmissions.objects.create(
+            submission=submission
+        )
+        return quiz_submission
+
+    # POST /submissions/quizzes/{submission_id}/answers/: Saves an answer to a specific quiz question.
+    def save_quiz_answer(self, quiz_submission, student_response, is_correct):
+        """Save a student’s answer to a quiz question"""
+        StudentQuizAnswers = apps.get_model('submissions', 'StudentQuizAnswers') 
+        answer = StudentQuizAnswers.objects.create(
+            quiz_submission=quiz_submission,
+            student_response=student_response,
+            is_correct=is_correct
+        )
+        return answer
+
+    # GET /submissions/quizzes/{submission_id}/answers/: Fetches all answers for a student’s quiz attempt.
+    def get_quiz_answers(self, quiz_submission_id):
+        """Fetch all answers for a specific quiz submission"""
+        StudentQuizAnswers = apps.get_model('submissions', 'StudentQuizAnswers') 
+        return StudentQuizAnswers.objects.filter(quiz_submission_id=quiz_submission_id)
+
+    # POST /submissions/quizzes/{submission_id}/submit/: Marks the quiz as submitted.
+    def mark_quiz_as_submitted(self, quiz_submission):
+        """Mark a quiz submission as submitted"""
+        Submissions = apps.get_model('submissions', 'Submissions')
+        quiz_submission.submission.submission_status = Submissions.SUBMITTED
+        quiz_submission.submission.save()
+        return quiz_submission.submission.submission_status
+

backend/apps/submissions/models.py

@@ -1,6 +1,7 @@
 from django.db import models
 from django.utils import timezone
 from django.core.exceptions import ValidationError
+from apps.submissions.managers import SubmissionManager, FileSubmissionManager, QuizSubmissionManager
 
 ### Missing fields will be added in as other apps are updated
 
@@ -39,6 +40,9 @@ class Submissions(models.Model):
     submitted_at = models.DateTimeField(default=timezone.now)  # Changed to DateTimeField for better accuracy
     graded_at = models.DateTimeField(null=True, blank=True, auto_now_add=True)  # Ensures it's only set once
 
+    # Submission manager 
+    objects = SubmissionManager()
+
     def clean(self):
         """Custom validation for submission"""
         # Ensure student_profile is set
@@ -74,6 +78,9 @@ class FileSubmissions(models.Model):
         blank=True
     )
 
+    # File submission manager 
+    objects = FileSubmissionManager()
+
     def __str__(self):
         return f"File Submission for {self.submission.id}"
 
@@ -86,6 +93,9 @@ class QuizSubmissions(models.Model):
     submission = models.OneToOneField(Submissions, on_delete=models.CASCADE)
     ### quiz = models.ForeignKey('app.Quiz', on_delete=models.CASCADE)
 
+    # Quiz submission manager
+    objects = QuizSubmissionManager()
+
     def __str__(self):
         return f"Quiz Submission for {self.submission.id}"
 

backend/apps/submissions/serializers.py

@@ -0,0 +1,28 @@
+from rest_framework import serializers
+from .models import Submissions, FileSubmissions, QuizSubmissions, StudentQuizAnswers
+
+
+class SubmissionsSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Submissions
+        fields = '__all__'
+
+    def validate_score(self, value):
+        if value is not None and value < 0:
+            raise serializers.ValidationError("Score cannot be negative.")
+        return value
+
+class QuizSubmissionsSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = QuizSubmissions
+        fields = '__all__'
+
+class StudentQuizAnswersSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = StudentQuizAnswers
+        fields = '__all__'
+
+class FileSubmissionsSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = FileSubmissions
+        fields = '__all__'