feat(coupons): add fixed and percentage coupon endpoints

Author: tyronejosee

apps/coupons/urls.py

@@ -2,10 +2,20 @@
 
 from django.urls import path
 
-from .views import FixedCouponListAPIView, CheckCouponAPIView
+from .views import (
+    FixedCouponListAPIView, FixedCouponDetailAPIView,
+    PercentageCouponListAPIView, PercentageCouponDetailAPIView,
+    CheckCouponAPIView
+)
 
 
 urlpatterns = [
     path("api/v1/coupons/fixed-coupons/", FixedCouponListAPIView.as_view()),
+    path("api/v1/coupons/fixed-coupons/<uuid:fixed_coupon_id>",
+         FixedCouponDetailAPIView.as_view()),
+    path("api/v1/coupons/percentage-coupons/",
+         PercentageCouponListAPIView.as_view()),
+    path("api/v1/coupons/percentage-coupons/<uuid:percentage_coupon_id>",
+         PercentageCouponDetailAPIView.as_view()),
     path("api/v1/coupons/check-coupons/", CheckCouponAPIView.as_view())
 ]

apps/coupons/views.py

@@ -2,6 +2,7 @@
 
 from django.db import transaction
 from django.core.cache import cache
+from django.shortcuts import get_object_or_404
 from rest_framework.views import APIView
 from rest_framework.response import Response
 from rest_framework.permissions import IsAuthenticated
@@ -15,14 +16,14 @@
 
 
 class FixedCouponListAPIView(APIView):
-    """Pending."""
+    """APIView for listing and creating fixed coupons."""
     permission_classes = [IsAuthenticated]
     serializer_class = FixedCouponSerializer
     pagination_class = MediumSetPagination
     CACHE_TIMEOUT = 7200  # Cache for 2 hours
 
     def get(self, request, format=None):
-        # Pending
+        # Get a list of available fixed coupons
         cache_key = f"fixed_coupon_{request.user.id}"
         cached_data = cache.get(cache_key)
 
@@ -41,7 +42,7 @@ def get(self, request, format=None):
 
     @transaction.atomic
     def post(self, request, format=None):
-        # Pending
+        # Create a new fixed coupon
         serializer = self.serializer_class(data=request.data)
         if serializer.is_valid():
             serializer.save()
@@ -58,6 +59,125 @@ def post(self, request, format=None):
         )
 
 
+class FixedCouponDetailAPIView(APIView):
+    """APIView to retrieve, update, and delete a fixed coupon."""
+    permission_classes = [IsAuthenticated]
+    serializer_class = FixedCouponSerializer
+
+    def get_object(self, fixed_coupon_id):
+        # Get a fixed coupon instance by id
+        return get_object_or_404(FixedCoupon, pk=fixed_coupon_id)
+
+    def get(self, request, fixed_coupon_id):
+        # Get details of a fixed coupon
+        fixed_coupon = self.get_object(fixed_coupon_id)
+        serializer = self.serializer_class(fixed_coupon)
+        return Response(serializer.data, status=status.HTTP_200_OK)
+
+    @transaction.atomic
+    def put(self, request, fixed_coupon_id):
+        # Update a fixed coupon
+        fixed_coupon = self.get_object(fixed_coupon_id)
+        serializer = self.serializer_class(fixed_coupon, data=request.data)
+        if serializer.is_valid():
+            serializer.save()
+            return Response(serializer.data, status=status.HTTP_200_OK)
+        return Response(
+            serializer.errors,
+            status=status.HTTP_400_BAD_REQUEST
+        )
+
+    @transaction.atomic
+    def delete(self, request, fixed_coupon_id):
+        # Delete a fixed coupon
+        fixed_coupon = self.get_object(fixed_coupon_id)
+        fixed_coupon.delete()
+        return Response(status=status.HTTP_204_NO_CONTENT)
+
+
+class PercentageCouponListAPIView(APIView):
+    """APIView for listing and creating percentage coupons."""
+    permission_classes = [IsAuthenticated]
+    serializer_class = PercentageCouponSerializer
+    pagination_class = MediumSetPagination
+    CACHE_TIMEOUT = 7200  # Cache for 2 hours
+
+    def get(self, request, format=None):
+        # Get a list of available percentage coupons
+        cache_key = f"percentage_coupon_{request.user.id}"
+        cached_data = cache.get(cache_key)
+
+        if cached_data is None:
+            coupons = PercentageCoupon.objects.filter(
+                available=True).order_by("id")
+            if coupons.exists():
+                serializer = self.serializer_class(coupons, many=True)
+                # Set cache
+                cache.set(cache_key, serializer.data, self.CACHE_TIMEOUT)
+                return Response(serializer.data, status=status.HTTP_200_OK)
+            return Response(
+                {"detail": "No percentage coupons available."},
+                status=status.HTTP_404_NOT_FOUND
+            )
+        return Response(cached_data, status=status.HTTP_200_OK)
+
+    @transaction.atomic
+    def post(self, request, format=None):
+        # Create a new percentage coupon
+        serializer = self.serializer_class(data=request.data)
+        if serializer.is_valid():
+            serializer.save()
+            # Invalidate cache
+            cache_key = f"percentage_coupon_{request.user.id}"
+            cache.delete(cache_key)
+            return Response(
+                serializer.data,
+                status=status.HTTP_201_CREATED
+            )
+        return Response(
+            serializer.errors,
+            status=status.HTTP_400_BAD_REQUEST
+        )
+
+
+class PercentageCouponDetailAPIView(APIView):
+    """APIView to retrieve, update, and delete a percentage coupon."""
+    permission_classes = [IsAuthenticated]
+    serializer_class = PercentageCouponSerializer
+
+    def get_object(self, percentage_coupon_id):
+        # Get a percentage coupon instance by id
+        return get_object_or_404(PercentageCoupon, pk=percentage_coupon_id)
+
+    def get(self, request, percentage_coupon_id):
+        # Get details of a percentage coupon
+        percentage_coupon = self.get_object(percentage_coupon_id)
+        serializer = self.serializer_class(percentage_coupon)
+        return Response(serializer.data, status=status.HTTP_200_OK)
+
+    @transaction.atomic
+    def put(self, request, percentage_coupon_id):
+        # Update a percentage coupon
+        percentage_coupon = self.get_object(percentage_coupon_id)
+        serializer = self.serializer_class(
+            percentage_coupon, data=request.data
+        )
+        if serializer.is_valid():
+            serializer.save()
+            return Response(serializer.data, status=status.HTTP_200_OK)
+        return Response(
+            serializer.errors,
+            status=status.HTTP_400_BAD_REQUEST
+        )
+
+    @transaction.atomic
+    def delete(self, request, percentage_coupon_id):
+        # Delete a percentage coupon
+        percentage_coupon = self.get_object(percentage_coupon_id)
+        percentage_coupon.delete()
+        return Response(status=status.HTTP_204_NO_CONTENT)
+
+
 class CheckCouponAPIView(APIView):
     """APIView to check the validity of a coupon code."""