Add club diff feature

backend/clubs/models.py

@@ -698,6 +698,31 @@
                 reply_to=settings.OSA_EMAILS + [settings.BRANDING_SITE_EMAIL],
             )
 
+    def get_latest_and_latest_approved_versions(self):
+        """
+        Returns the latest and latest approved versions of club key fields
+        [name, description, image] contents that trigger reapproval.
+        """
+        latest_approved_version = (
+            self.history.filter(approved=True).order_by("-history_date").first()
+        )
+        latest_version = self.history.order_by("-history_date").first()
+
+        if (
+            not latest_version
+            or not latest_approved_version
+            or (latest_approved_version == latest_version)
+        ):
+            return {}
+
+        diff = latest_version.diff_against(latest_approved_version)
+
+        return {
+            change.field: {"old": change.old, "new": change.new}
+            for change in diff.changes
+            if change.field in ["name", "description", "image"]
+        }
+
     class Meta:
         ordering = ["name"]
         permissions = [

backend/clubs/views.py

@@ -2058,6 +2058,58 @@
             context=context,
         )
 
+    @action(detail=False, methods=["GET"])
+    def pending_clubs(self, request, *args, **kwargs):
+        """
+        Return old and new data for clubs that are pending approval.
+        ---
+        responses:
+            "200":
+                content:
+                    application/json:
+                        schema:
+                            type: array
+                            items:
+                                type: object
+                                properties:
+                                    name:
+                                        type: object
+                                        description: Changes in the name field
+                                        properties:
+                                            old:
+                                                type: string
+                                                description: Old name of the club
+                                            new:
+                                                type: string
+                                                description: New name of the club
+                                    description:
+                                        type: object
+                                        description: Changes in the club description
+                                        properties:
+                                            old:
+                                                type: string
+                                                description: Old description of the club
+                                            new:
+                                                type: string
+                                                description: New description of the club
+                                    image:
+                                        type: object
+                                        description: Changes in the image of the club
+                                        properties:
+                                            old:
+                                                type: string
+                                                description: Old image URL of the club
+                                            new:
+                                                type: string
+                                                description: New image URL of the club
+        ---
+        """
+        pending_clubs = Club.objects.filter(approved=None, active=True)
+
+        return Response(
+            [club.get_latest_and_latest_approved_versions() for club in pending_clubs]
+        )
+
     @action(detail=False, methods=["GET"])
     def fields(self, request, *args, **kwargs):
         """