Merge pull request #87 from UNLV-CS472-672/pomodoro_endpoints

Added Pomodoro API Endpoints + CRUD

Author: alliekameda

backend/apps/pomodoro/managers.py

@@ -0,0 +1,24 @@
+from django.db import models
+from django.utils import timezone
+
+class PomodoroSessionManager(models.Manager):
+    def start_session(self, session_id):
+        session = self.get(id=session_id)
+        session.start_time = timezone.now()
+        session.save()
+
+    def pause_session(self, session_id):
+        session = self.get(id=session_id)
+        session.is_paused = True
+        session.save()
+
+    def resume_session(self, session_id):
+        session = self.get(id=session_id)
+        session.is_paused = False
+        session.save()
+
+    def complete_session(self, session_id):
+        session = self.get(id=session_id)
+        session.is_completed = True
+        session.end_time = timezone.now()
+        session.save()

backend/apps/pomodoro/migrations/0003_pomodorosession_is_paused.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.1.6 on 2025-03-26 18:04
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('pomodoro', '0002_alter_petcatalog_image'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='pomodorosession',
+            name='is_paused',
+            field=models.BooleanField(default=False),
+        ),
+    ]

backend/apps/pomodoro/models.py

@@ -1,8 +1,8 @@
 from django.db import models
 
-# Create your models here.
 from django.conf import settings
 from django.utils import timezone
+from .managers import PomodoroSessionManager
 
 class PomodoroSession(models.Model):
     student = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
@@ -12,6 +12,31 @@ class PomodoroSession(models.Model):
     pet_earned = models.BooleanField(default=False)
     start_time = models.DateTimeField(auto_now_add=True)
     end_time = models.DateTimeField(null=True, blank=True)
+    is_paused = models.BooleanField(default=False)
+
+    objects = PomodoroSessionManager()  # Use custom manager
+
+    def start(self):
+        self.start_time = timezone.now()
+        self.save()
+
+    def pause(self):
+        if not self.is_completed:
+            self.is_paused = True
+            self.save()
+
+    def resume(self):
+        if self.is_paused:
+            self.is_paused = False
+            self.save()
+
+    def cancel(self):
+        self.delete()
+
+    def complete(self):
+        self.is_completed = True
+        self.end_time = timezone.now()
+        self.save()
 
     def __str__(self):
         return f"Pomodoro Session ({self.start_time}) - {self.end_time}"

backend/apps/pomodoro/serializers.py

@@ -0,0 +1,8 @@
+from rest_framework import serializers
+from .models import PomodoroSession
+
+
+class PomodoroSessionSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = PomodoroSession
+        fields = '__all__'

backend/apps/pomodoro/urls.py

@@ -0,0 +1,20 @@
+from django.urls import path
+from .views import (
+    StartPomodoroSession,
+    PausePomodoroSession,
+    ResumePomodoroSession,
+    CancelPomodoroSession,
+    CompletePomodoroSession,
+    GetPomodoroSessionStatus,
+    GetPomodoroSessionHistory,
+)
+
+urlpatterns = [
+    path('api/pomodoro-session/<int:id>/start/', StartPomodoroSession.as_view(), name="start_pomodoro"),
+    path('api/pomodoro-session/<int:id>/pause/', PausePomodoroSession.as_view(), name="pause_pomodoro"),
+    path('api/pomodoro-session/<int:id>/resume/', ResumePomodoroSession.as_view(), name="resume_pomodoro"),
+    path('api/pomodoro-session/<int:id>/cancel/', CancelPomodoroSession.as_view(), name="cancel_pomodoro"),
+    path('api/pomodoro-session/<int:id>/complete/', CompletePomodoroSession.as_view(), name="complete_pomodoro"),
+    path('api/pomodoro-session/<int:id>/status/', GetPomodoroSessionStatus.as_view(), name="pomodoro_status"),
+    path('api/pomodoro-session/history/', GetPomodoroSessionHistory.as_view(), name="pomodoro_history"),
+]

backend/apps/pomodoro/views.py

@@ -1,3 +1,65 @@
 from django.shortcuts import render
 
-# Create your views here.
+from rest_framework import generics, status
+from rest_framework.response import Response
+from rest_framework.views import APIView
+from .models import PomodoroSession
+from .serializers import PomodoroSessionSerializer
+
+class StartPomodoroSession(APIView):
+    def post(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+            
+        session.start()
+        return Response({"message": "Pomodoro session started"}, status=status.HTTP_200_OK)
+
+class PausePomodoroSession(APIView):
+    def post(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+        
+        session.pause()
+        return Response({"message": "Pomodoro session paused"}, status=status.HTTP_200_OK)
+
+class ResumePomodoroSession(APIView):
+    def post(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+            
+        session.resume()
+        return Response({"message": "Pomodoro session resumed"}, status=status.HTTP_200_OK)
+
+class CancelPomodoroSession(APIView):
+    def post(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+            
+        session.cancel()
+        return Response({"message": "Pomodoro session canceled"}, status=status.HTTP_200_OK)
+
+class CompletePomodoroSession(APIView):
+    def post(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+            
+        session.complete()
+        return Response({"message": "Pomodoro session completed"}, status=status.HTTP_200_OK)
+
+class GetPomodoroSessionStatus(APIView):
+    def get(self, request, id):
+        session = PomodoroSession.objects.filter(id=id).first()
+        if not session:
+            return Response({"error": "Pomodoro session not found"}, status=status.HTTP_404_NOT_FOUND)
+            
+        serializer = PomodoroSessionSerializer(session)
+        return Response(serializer.data, status=status.HTTP_200_OK)
+
+class GetPomodoroSessionHistory(generics.ListAPIView):
+    queryset = PomodoroSession.objects.all()
+    serializer_class = PomodoroSessionSerializer

backend/backend/urls.py

@@ -29,6 +29,7 @@
     path('api/token/refresh/', TokenRefreshView.as_view(), name='token_refresh'),
     path('notifications/', include('apps.notifications.urls')),
     path('lessons/', include('apps.lessons.urls')),
-    path('submissions/', include('apps.submissions.urls'))
+    path('submissions/', include('apps.submissions.urls')),
+    path('pomodoro/', include('apps.pomodoro.urls')),
 ]