Create a health evaluation criteria

backend/apps/owasp/management/commands/owasp_update_project_health_metrics.py

@@ -0,0 +1,49 @@
+"""A command to update OWASP project health metrics."""
+
+from django.core.management.base import BaseCommand
+
+from apps.owasp.models.project import Project
+from apps.owasp.models.project_health_metrics import ProjectHealthMetrics
+
+MINIMUM_LEADERS = 3
+
+
+class Command(BaseCommand):
+    help = "Update OWASP project health metrics."
+
+    def handle(self, *args, **options):
+        projects = Project.objects.all()
+        field_mappings = {
+            "contributors_count": "contributors_count",
+            "created_at": "created_at",
+            "forks_count": "forks_count",
+            "last_released_at": "released_at",
+            "last_committed_at": "pushed_at",
+            "open_issues_count": "open_issues_count",
+            "open_pull_requests_count": "open_pull_requests_count",
+            "pull_request_last_created_at": "pull_request_last_created_at",
+            "recent_releases_count": "recent_releases_count",
+            "stars_count": "stars_count",
+            "total_issues_count": "issues_count",
+            "total_pull_requests_count": "pull_requests_count",
+            "total_releases_count": "releases_count",
+            "unanswered_issues_count": "unanswered_issues_count",
+            "unassigned_issues_count": "unassigned_issues_count",
+        }
+        for project in projects:
+            self.stdout.write(self.style.NOTICE(f"Updating metrics for project: {project.name}"))
+            metrics = ProjectHealthMetrics.objects.get_or_create(project=project)[0]
+
+            # Update metrics based on requirements
+            # TODO(ahmedxgouda): update from owasp page: owasp_page_last_updated_at
+            # TODO(ahmedxgouda): update is_funding_requirements_compliant,
+            # TODO(ahmedxgouda): add score
+            for metric_field, project_field in field_mappings.items():
+                value = getattr(project, project_field)
+                setattr(metrics, metric_field, value)
+
+            is_leaders_compliant = project.leaders_count >= MINIMUM_LEADERS
+            metrics.is_project_leaders_requirements_compliant = is_leaders_compliant
+            metrics.save()
+
+        self.stdout.write(self.style.SUCCESS("Project health metrics updated successfully."))

backend/apps/owasp/migrations/0035_rename_total_pull_request_count_projecthealthmetrics_total_pull_requests_count.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.2.1 on 2025-06-03 14:47
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("owasp", "0034_alter_chapter_leaders_and_more"),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name="projecthealthmetrics",
+            old_name="total_pull_request_count",
+            new_name="total_pull_requests_count",
+        ),
+    ]

backend/apps/owasp/models/project.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
+import datetime
 from functools import lru_cache
 
 from django.db import models
+from django.utils import timezone
 
 from apps.common.index import IndexBase
 from apps.common.models import BulkSaveModel, TimestampedModel
@@ -18,6 +20,8 @@
 from apps.owasp.models.managers.project import ActiveProjectManager
 from apps.owasp.models.mixins.project import ProjectIndexMixin
 
+RECENT_RELEASES_PERIOD = timezone.now() - datetime.timedelta(days=60)
+
 
 class Project(
     BulkSaveModel,
@@ -154,6 +158,11 @@ def issues(self):
             "repository",
         )
 
+    @property
+    def issues_count(self) -> int:
+        """Return count of issues."""
+        return self.issues.count()
+
     @property
     def nest_key(self) -> str:
         """Get Nest key."""
@@ -164,6 +173,11 @@ def nest_url(self) -> str:
         """Get Nest URL for project."""
         return get_absolute_url(f"projects/{self.nest_key}")
 
+    @property
+    def leaders_count(self) -> int:
+        """Return the count of leaders."""
+        return len(self.leaders_raw)
+
     @property
     def open_issues(self):
         """Return open issues."""
@@ -173,6 +187,11 @@ def open_issues(self):
             "repository",
         )
 
+    @property
+    def open_pull_requests_count(self) -> int:
+        """Return count of open pull requests."""
+        return self.pull_requests.filter(state="open").count()
+
     @property
     def pull_requests(self):
         """Return pull requests."""
@@ -182,6 +201,18 @@ def pull_requests(self):
             "repository",
         )
 
+    @property
+    def pull_requests_count(self) -> int:
+        """Return count of pull requests."""
+        return self.pull_requests.count()
+
+    @property
+    def pull_request_last_created_at(self) -> datetime.datetime | None:
+        """Return last created pull request."""
+        if pull_request := self.pull_requests.order_by("-created_at").first():
+            return pull_request.created_at
+        return None
+
     @property
     def published_releases(self):
         """Return project releases."""
@@ -202,6 +233,23 @@ def recent_milestones(self):
             "repository",
         )
 
+    @property
+    def recent_releases_count(self) -> int:
+        """Return count of recent releases per a specific period."""
+        return self.published_releases.filter(
+            published_at__gte=RECENT_RELEASES_PERIOD,
+        ).count()
+
+    @property
+    def unanswered_issues_count(self) -> int:
+        """Return count of unanswered issues."""
+        return self.issues.filter(comments_count=0).count()
+
+    @property
+    def unassigned_issues_count(self) -> int:
+        """Return count of unassigned issues."""
+        return self.issues.filter(assignees__isnull=True).count()
+
     def deactivate(self) -> None:
         """Deactivate project."""
         self.is_active = False

backend/apps/owasp/models/project_health_metrics.py

@@ -51,7 +51,7 @@ class Meta:
     )
     stars_count = models.PositiveIntegerField(verbose_name="Stars", default=0)
     total_issues_count = models.PositiveIntegerField(verbose_name="Total issues", default=0)
-    total_pull_request_count = models.PositiveIntegerField(
+    total_pull_requests_count = models.PositiveIntegerField(
         verbose_name="Total pull requests", default=0
     )
     total_releases_count = models.PositiveIntegerField(verbose_name="Total releases", default=0)

cspell/custom-dict.txt

@@ -27,6 +27,7 @@ WSL
 Whistleblower
 Wörld
 a2eeef
+ahmedxgouda
 algoliasearch
 ansa
 apk