frontend for snapshotDetailsPage

backend/apps/github/graphql/nodes/release.py

@@ -1,6 +1,6 @@
 """GitHub release GraphQL node."""
 
-from graphene import Field
+import graphene
 
 from apps.common.graphql.nodes import BaseNode
 from apps.github.graphql.nodes.user import UserNode
@@ -10,7 +10,8 @@
 class ReleaseNode(BaseNode):
     """GitHub release node."""
 
-    author = Field(UserNode)
+    author = graphene.Field(UserNode)
+    project_name = graphene.String()
 
     class Meta:
         model = Release
@@ -21,3 +22,7 @@ class Meta:
             "published_at",
             "tag_name",
         )
+
+    def resolve_project_name(self, info):
+        """Return project name."""
+        return self.idx_project

backend/apps/owasp/admin.py

@@ -120,6 +120,7 @@ class SnapshotAdmin(admin.ModelAdmin):
         "new_users",
     )
     list_display = (
+        "title",
         "start_at",
         "end_at",
         "status",
@@ -133,6 +134,8 @@ class SnapshotAdmin(admin.ModelAdmin):
     )
     ordering = ("-start_at",)
     search_fields = (
+        "title",
+        "key",
         "status",
         "error_message",
     )

backend/apps/owasp/graphql/nodes/snapshot.py

@@ -0,0 +1,74 @@
+"""OWASP snapshot GraphQL node."""
+
+import graphene
+
+from apps.github.graphql.nodes.issue import IssueNode
+from apps.github.graphql.nodes.release import ReleaseNode
+from apps.github.graphql.nodes.user import UserNode
+from apps.owasp.graphql.nodes.chapter import ChapterNode
+from apps.owasp.graphql.nodes.common import GenericEntityNode
+from apps.owasp.graphql.nodes.project import ProjectNode
+from apps.owasp.models.snapshot import Snapshot
+
+RECENT_ISSUES_LIMIT = 100
+
+
+class SnapshotNode(GenericEntityNode):
+    """Snapshot node."""
+
+    key = graphene.String()
+    status = graphene.String()
+    error_message = graphene.String()
+    new_chapters = graphene.List(ChapterNode)
+    new_issues = graphene.List(IssueNode)
+    new_projects = graphene.List(ProjectNode)
+    new_releases = graphene.List(ReleaseNode)
+    new_users = graphene.List(UserNode)
+    updated_at = graphene.DateTime()
+
+    class Meta:
+        model = Snapshot
+        fields = (
+            "title",
+            "created_at",
+            "start_at",
+            "status",
+            "end_at",
+            "error_message",
+        )
+
+    def resolve_key(self, info):
+        """Resolve key."""
+        return self.key
+
+    def resolve_status(self, info):
+        """Resolve status."""
+        return self.status
+
+    def resolve_error_message(self, info):
+        """Resolve error message."""
+        return self.error_message
+
+    def resolve_new_chapters(self, info):
+        """Resolve new chapters."""
+        return self.new_chapters.all()
+
+    def resolve_new_issues(self, info):
+        """Resolve recent new issues."""
+        return self.new_issues.order_by("-created_at")[:RECENT_ISSUES_LIMIT]
+
+    def resolve_new_projects(self, info):
+        """Resolve recent new projects."""
+        return self.new_projects.order_by("-created_at")
+
+    def resolve_new_releases(self, info):
+        """Resolve recent new releases."""
+        return self.new_releases.order_by("-published_at")
+
+    def resolve_new_users(self, info):
+        """Resolve recent new users."""
+        return self.new_users.order_by("-created_at")
+
+    def resolve_updated_at(self, info):
+        """Resolve updated at."""
+        return self.updated_at

backend/apps/owasp/graphql/queries/__init__.py

@@ -4,8 +4,9 @@
 from .committee import CommitteeQuery
 from .event import EventQuery
 from .project import ProjectQuery
+from .snapshot import SnapshotQuery
 from .stats import StatsQuery
 
 
-class OwaspQuery(ChapterQuery, CommitteeQuery, EventQuery, ProjectQuery, StatsQuery):
+class OwaspQuery(ChapterQuery, CommitteeQuery, EventQuery, ProjectQuery, SnapshotQuery, StatsQuery):
     """OWASP queries."""

backend/apps/owasp/graphql/queries/snapshot.py

@@ -0,0 +1,32 @@
+"""OWASP snapshot GraphQL queries."""
+
+import graphene
+
+from apps.common.graphql.queries import BaseQuery
+from apps.owasp.graphql.nodes.snapshot import SnapshotNode
+from apps.owasp.models.snapshot import Snapshot
+
+
+class SnapshotQuery(BaseQuery):
+    """Snapshot queries."""
+
+    snapshot = graphene.Field(
+        SnapshotNode,
+        key=graphene.String(required=True),
+    )
+
+    recent_snapshots = graphene.List(
+        SnapshotNode,
+        limit=graphene.Int(default_value=8),
+    )
+
+    def resolve_snapshot(root, info, key):
+        """Resolve snapshot by key."""
+        try:
+            return Snapshot.objects.get(key=key)
+        except Snapshot.DoesNotExist:
+            return None
+
+    def resolve_recent_snapshots(root, info, limit):
+        """Resolve recent snapshots."""
+        return Snapshot.objects.order_by("-created_at")[:limit]

backend/apps/owasp/migrations/0015_snapshot.py

@@ -1,11 +1,11 @@
-# Generated by Django 5.1.6 on 2025-02-22 18:37
+# Generated by Django 5.1.6 on 2025-02-27 05:18
 
 from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
     dependencies = [
-        ("github", "0015_alter_release_author"),
+        ("github", "0016_user_is_bot"),
         ("owasp", "0014_project_custom_tags"),
     ]
 
@@ -19,6 +19,10 @@ class Migration(migrations.Migration):
                         auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
                     ),
                 ),
+                ("title", models.CharField(default="", max_length=255)),
+                ("key", models.CharField(max_length=7, unique=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
                 ("start_at", models.DateTimeField()),
                 ("end_at", models.DateTimeField()),
                 (
@@ -34,8 +38,6 @@ class Migration(migrations.Migration):
                         max_length=10,
                     ),
                 ),
-                ("created_at", models.DateTimeField(auto_now_add=True)),
-                ("updated_at", models.DateTimeField(auto_now=True)),
                 ("error_message", models.TextField(blank=True, default="")),
                 (
                     "new_chapters",

backend/apps/owasp/models/snapshot.py

@@ -1,6 +1,7 @@
 """OWASP app snapshot models."""
 
 from django.db import models
+from django.utils.timezone import now
 
 
 class Snapshot(models.Model):
@@ -16,6 +17,9 @@ class Status(models.TextChoices):
         COMPLETED = "completed", "Completed"
         ERROR = "error", "Error"
 
+    title = models.CharField(max_length=255, default="")
+    key = models.CharField(max_length=7, unique=True)  # Format: YYYY-mm
+
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
 
@@ -31,6 +35,12 @@ class Status(models.TextChoices):
     new_releases = models.ManyToManyField("github.Release", related_name="snapshots", blank=True)
     new_users = models.ManyToManyField("github.User", related_name="snapshots", blank=True)
 
+    def save(self, *args, **kwargs):
+        """Automatically set the key in YYYY-mm format before saving."""
+        if not self.key:
+            self.key = now().strftime("%Y-%m")
+        super().save(*args, **kwargs)
+
     def __str__(self):
         """Return a string representation of the snapshot."""
         return f"Snapshot {self.start_at} to {self.end_at} ({self.status})"

backend/tests/owasp/models/snapshot_test.py

@@ -12,6 +12,8 @@ def setUp(self):
         """Set up a mocked snapshot object."""
         self.snapshot = MagicMock(spec=Snapshot)  # Mock entire model
         self.snapshot.id = 1  # Set an ID to avoid ManyToMany errors
+        self.snapshot.title = "Mock Snapshot Title"
+        self.snapshot.key = "2025-02"
         self.snapshot.start_at = "2025-02-21"
         self.snapshot.end_at = "2025-02-21"
         self.snapshot.status = Snapshot.Status.PROCESSING
@@ -27,3 +29,8 @@ def test_mocked_many_to_many_relations(self):
         """Test ManyToMany relationships using mocks."""
         self.snapshot.new_chapters.set(["Mock Chapter"])
         self.snapshot.new_chapters.set.assert_called_once_with(["Mock Chapter"])
+
+    def test_snapshot_attributes(self):
+        """Test that title and key are correctly assigned."""
+        assert self.snapshot.title == "Mock Snapshot Title"
+        assert self.snapshot.key == "2025-02"

frontend/src/App.tsx

@@ -1,15 +1,16 @@
 import {
-  Home,
-  ProjectsPage,
-  CommitteesPage,
+  ChapterDetailsPage,
   ChaptersPage,
+  CommitteeDetailsPage,
+  CommitteesPage,
   ContributePage,
+  Home,
   ProjectDetailsPage,
-  CommitteeDetailsPage,
-  ChapterDetailsPage,
-  UsersPage,
-  UserDetailsPage,
+  ProjectsPage,
   RepositoryDetailsPage,
+  SnapshotDetailsPage,
+  UserDetailsPage,
+  UsersPage,
 } from 'pages'
 import { useEffect } from 'react'
 import { Routes, Route, useLocation } from 'react-router-dom'
@@ -43,6 +44,7 @@ function App() {
         <Route path="/committees/:committeeKey" element={<CommitteeDetailsPage />}></Route>
         <Route path="/chapters" element={<ChaptersPage />}></Route>
         <Route path="/chapters/:chapterKey" element={<ChapterDetailsPage />}></Route>
+        <Route path="/community/snapshot/:id" element={<SnapshotDetailsPage />}></Route>
         <Route path="/community/users" element={<UsersPage />}></Route>
         <Route path="/community/users/:userKey" element={<UserDetailsPage />}></Route>
         <Route path="*" element={<ErrorDisplay {...ERROR_CONFIGS['404']} />} />

frontend/src/api/queries/snapshotQueries.ts

@@ -0,0 +1,61 @@
+import { gql } from '@apollo/client'
+
+export const GET_SNAPSHOT_DETAILS = gql`
+  query GetSnapshotDetails($key: String!) {
+    snapshot(key: $key) {
+      title
+      key
+      updatedAt
+      createdAt
+      startAt
+      endAt
+      status
+      errorMessage
+      newReleases {
+        name
+        publishedAt
+        tagName
+        projectName
+      }
+      newProjects {
+        key
+        name
+        summary
+        starsCount
+        forksCount
+        contributorsCount
+        level
+        isActive
+        repositoriesCount
+        topContributors {
+          avatarUrl
+          contributionsCount
+          login
+          name
+        }
+      }
+      newChapters {
+        key
+        name
+        createdAt
+        suggestedLocation
+        region
+        summary
+        topContributors {
+          avatarUrl
+          contributionsCount
+          login
+          name
+        }
+        updatedAt
+        url
+        relatedUrls
+        geoLocation {
+          lat
+          lng
+        }
+        isActive
+      }
+    }
+  }
+`