Added nest app and slack command for sponsorship

backend/apps/github/common.py

@@ -1,9 +1,13 @@
 """GitHub app common module."""
 
 import logging
+import os
 from datetime import timedelta as td
+from urllib.parse import urlparse
 
+from django.core.exceptions import ValidationError
 from django.utils import timezone
+from github import Github
 from github.GithubException import UnknownObjectException
 
 from apps.github.models.issue import Issue
@@ -16,9 +20,72 @@
 from apps.github.models.user import User
 from apps.github.utils import check_owasp_site_repository
 
+FETCH_ISSUE_ERROR = "Failed to fetch issue from GitHub: {error}"
+MIN_PARTS_LENGTH = 4
+VALID_PROJECT_ERROR = (
+    "Issue does not have a valid project and cannot be considered for sponsorship."
+)
+
+
 logger = logging.getLogger(__name__)
 
 
+def sync_issue(issue_link):
+    """Sync GitHub issue data."""
+    try:
+        return Issue.objects.get(url=issue_link)
+    except Issue.DoesNotExist:
+        pass
+
+    parsed_url = urlparse(issue_link)
+    path_parts = parsed_url.path.strip("/").split("/")
+
+    github_token = os.getenv("GITHUB_TOKEN")
+    github_client = Github(github_token)
+
+    issue_number = int(path_parts[3])
+    owner = path_parts[0]
+    repo_name = path_parts[1]
+
+    try:
+        gh_repo = github_client.get_repo(f"{owner}/{repo_name}")
+        gh_issue = gh_repo.get_issue(issue_number)
+    except Exception as error:
+        raise ValidationError(FETCH_ISSUE_ERROR.format(error=error)) from error
+
+    try:
+        author = User.objects.get(login=gh_issue.user.login)
+    except User.DoesNotExist:
+        author = User.update_data(gh_issue.user)
+
+    try:
+        repository = Repository.objects.get(node_id=gh_repo.id)
+    except Repository.DoesNotExist:
+        try:
+            repo_owner = User.objects.get(login=gh_repo.owner.login)
+        except User.DoesNotExist:
+            repo_owner = User.update_data(gh_repo.owner)
+        try:
+            organization = Organization.objects.get(node_id=gh_repo.organization.id)
+        except Organization.DoesNotExist:
+            organization = Organization.update_data(gh_repo.organization)
+
+        repository = Repository.update_data(
+            gh_repository=gh_repo,
+            commits=gh_repo.get_commits(),
+            contributors=gh_repo.get_contributors(),
+            languages=gh_repo.get_languages(),
+            organization=organization,
+            user=repo_owner,
+        )
+
+        if not repository.project:
+            logger.exception(VALID_PROJECT_ERROR)
+            return None
+
+    return Issue.update_data(gh_issue, author=author, repository=repository)
+
+
 def sync_repository(gh_repository, organization=None, user=None):
     """Sync GitHub repository data.
 

backend/apps/nest/admin.py

@@ -0,0 +1,11 @@
+from django.contrib import admin
+
+from apps.nest.models.sponsorship import Sponsorship
+
+
+class SponsorshipAdmin(admin.ModelAdmin):
+    list_display = ("issue", "amount", "slack_user_id")
+    search_fields = ("issue__title", "slack_user_id")
+
+
+admin.site.register(Sponsorship, SponsorshipAdmin)

backend/apps/nest/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class NestConfig(AppConfig):
+    name = "apps.nest"

backend/apps/nest/migrations/0001_initial.py

@@ -0,0 +1,54 @@
+# Generated by Django 5.1.5 on 2025-03-16 07:43
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("github", "0016_user_is_bot"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="Sponsorship",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("nest_created_at", models.DateTimeField(auto_now_add=True)),
+                ("nest_updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "currency",
+                    models.CharField(
+                        choices=[("EUR", "Euro"), ("USD", "US Dollar")],
+                        default="USD",
+                        max_length=3,
+                    ),
+                ),
+                ("deadline_at", models.DateTimeField(blank=True, null=True)),
+                ("amount", models.FloatField()),
+                ("slack_user_id", models.CharField(max_length=100)),
+                (
+                    "issue",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="sponsorships",
+                        to="github.issue",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name_plural": "Sponsorships",
+                "db_table": "nest_sponsorships",
+            },
+        ),
+    ]

backend/apps/nest/models/sponsorship.py

@@ -0,0 +1,74 @@
+"""Nest app sponsorship model."""
+
+from django.core.exceptions import ValidationError
+from django.db import models
+from django.utils import timezone
+
+from apps.common.models import BulkSaveModel, TimestampedModel
+from apps.github.models.issue import Issue
+
+DEADLINE_FUTURE_ERROR = "Deadline must be in the future."
+ISSUE_LINK_ERROR = "Issue link must belong to an OWASP repository."
+PRICE_POSITIVE_ERROR = "Price must be a positive value."
+
+
+class Sponsorship(BulkSaveModel, TimestampedModel):
+    """Sponsorship model."""
+
+    class CurrencyType(models.TextChoices):
+        """Currency type choices."""
+
+        EUR = "EUR", "Euro"
+        USD = "USD", "US Dollar"
+
+    class Meta:
+        db_table = "nest_sponsorships"
+        verbose_name_plural = "Sponsorships"
+
+    currency = models.CharField(
+        max_length=3, choices=CurrencyType.choices, default=CurrencyType.USD
+    )
+    deadline_at = models.DateTimeField(null=True, blank=True)
+    amount = models.FloatField()
+    slack_user_id = models.CharField(max_length=100)
+
+    issue = models.ForeignKey(
+        Issue,
+        on_delete=models.CASCADE,
+        related_name="sponsorships",
+    )
+
+    def __str__(self):
+        """Sponsorship human readable representation."""
+        return f"Sponsorship for {self.issue.title} by {self.slack_user_id}"
+
+    def clean(self):
+        """Validate model data."""
+        super().clean()
+
+        # Validate amount is positive
+        if self.amount <= 0:
+            raise ValidationError(PRICE_POSITIVE_ERROR)
+
+        # Validate deadline is in the future
+        if self.deadline_at and self.deadline_at < timezone.now():
+            raise ValidationError(DEADLINE_FUTURE_ERROR)
+
+        # Validate GitHub issue link belongs to OWASP
+        if not self.issue.url.startswith("https://github.com/OWASP"):
+            raise ValidationError(ISSUE_LINK_ERROR)
+
+    def save(self, *args, **kwargs):
+        """Override save to run full validation."""
+        self.full_clean()
+        super().save(*args, **kwargs)
+
+    @staticmethod
+    def update_data(sponsorship, **kwargs):
+        """Update sponsorship data with the provided fields."""
+        fields_to_update = ["amount", "deadline_at", "slack_user_id"]
+        for field in fields_to_update:
+            if field in kwargs:
+                setattr(sponsorship, field, kwargs[field])
+        sponsorship.save()
+        return sponsorship