implemented matching model and Added slack models

backend/Makefile

@@ -13,6 +13,9 @@ collect-static:
 django-shell:
 	@CMD="python manage.py shell" $(MAKE) exec-backend-command-it
 
+match-user:
+	@CMD="python manage.py matching_users $(model)" $(MAKE) exec-backend-command-it
+
 dump-data:
 	@echo "Dumping Nest data"
 	@CMD="python manage.py dumpdata github owasp --indent=2" $(MAKE) exec-backend-command > backend/data/nest.json

backend/apps/common/management/commands/matching_users.py

@@ -0,0 +1,139 @@
+"""A command to perform fuzzy and exact matching of leaders/slack members with User model."""
+
+from django.core.management.base import BaseCommand
+from django.db.utils import DatabaseError
+from thefuzz import fuzz
+
+from apps.github.models.user import User
+from apps.owasp.models.chapter import Chapter
+from apps.owasp.models.committee import Committee
+from apps.owasp.models.project import Project
+from apps.slack.models import Member
+
+MIN_NO_OF_WORDS = 2
+
+
+class Command(BaseCommand):
+    help = "Process raw leaders or Slack members and match with GitHub users."
+
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "model_name",
+            type=str,
+            choices=["chapter", "committee", "project", "member"],
+            help="Model name to process: chapter, committee, project, or member",
+        )
+        parser.add_argument(
+            "--threshold",
+            type=int,
+            default=85,
+            help="Threshold for fuzzy matching (0-100)",
+        )
+
+    def handle(self, *args, **kwargs):
+        model_name = kwargs["model_name"].lower()
+        threshold = max(0, min(kwargs["threshold"], 100))
+
+        model_map = {
+            "chapter": (Chapter, "suggested_leaders"),
+            "committee": (Committee, "suggested_leaders"),
+            "project": (Project, "suggested_leaders"),
+            "member": (Member, "suggested_users"),
+        }
+
+        if model_name not in model_map:
+            self.stdout.write(
+                self.style.ERROR(
+                    "Invalid model name! Choose from: chapter, committee, project, member"
+                )
+            )
+            return
+
+        model_class, relation_field = model_map[model_name]
+
+        # Pre-fetch GitHub users
+        all_users = User.objects.values("id", "login", "name")
+        filtered_users = {
+            u["id"]: u for u in all_users if self._is_valid_user(u["login"], u["name"])
+        }
+
+        instances = model_class.objects.prefetch_related(relation_field)
+        for instance in instances:
+            self.stdout.write(f"Processing {model_name} {instance.id}...")
+            if model_name == "member":
+                leaders_raw = [field for field in [instance.username, instance.real_name] if field]
+            else:
+                leaders_raw = instance.leaders_raw
+
+            exact_matches, fuzzy_matches, unmatched = self.process_leaders(
+                leaders_raw, threshold, filtered_users
+            )
+
+            matched_user_ids = {user["id"] for user in exact_matches + fuzzy_matches}
+            getattr(instance, relation_field).set(matched_user_ids)
+
+            if unmatched:
+                self.stdout.write(f"Unmatched for {instance}: {unmatched}")
+
+    def _is_valid_user(self, login, name):
+        """Check if GitHub user meets minimum requirements."""
+        return len(login) >= MIN_NO_OF_WORDS and name and len(name) >= MIN_NO_OF_WORDS
+
+    def process_leaders(self, leaders_raw, threshold, filtered_users):
+        """Process leaders with optimized matching."""
+        if not leaders_raw:
+            return [], [], []
+
+        exact_matches = []
+        fuzzy_matches = []
+        unmatched_leaders = []
+        processed_leaders = set()
+
+        user_list = list(filtered_users.values())
+
+        for leader in leaders_raw:
+            if not leader or leader in processed_leaders:
+                continue
+
+            processed_leaders.add(leader)
+            leader_lower = leader.lower()
+
+            try:
+                exact_match = next(
+                    (
+                        u
+                        for u in user_list
+                        if u["login"].lower() == leader_lower
+                        or (u["name"].lower() == leader_lower)
+                    ),
+                    None,
+                )
+
+                if exact_match:
+                    exact_matches.append(exact_match)
+                    self.stdout.write(f"Exact match found for {leader}: {exact_match['login']}")
+                    continue
+
+                matches = [
+                    u
+                    for u in user_list
+                    if (fuzz.partial_ratio(leader_lower, u["login"].lower()) >= threshold)
+                    or (
+                        u["name"]
+                        and fuzz.partial_ratio(leader_lower, u["name"].lower()) >= threshold
+                    )
+                ]
+
+                new_fuzzy_matches = [m for m in matches if m not in exact_matches]
+                if new_fuzzy_matches:
+                    fuzzy_matches.extend(new_fuzzy_matches)
+                    for match in new_fuzzy_matches:
+                        self.stdout.write(f"Fuzzy match found for {leader}: {match['login']}")
+                else:
+                    unmatched_leaders.append(leader)
+
+            except DatabaseError as e:
+                unmatched_leaders.append(leader)
+                self.stdout.write(self.style.ERROR(f"Error processing leader {leader}: {e}"))
+
+        return exact_matches, fuzzy_matches, unmatched_leaders

backend/apps/owasp/admin.py

@@ -1,6 +1,6 @@
 """OWASP app admin."""
 
-from django.contrib import admin
+from django.contrib import admin, messages
 from django.utils.safestring import mark_safe
 
 from apps.owasp.models.chapter import Chapter
@@ -41,12 +41,31 @@ def custom_field_owasp_url(self, obj):
             f"<a href='https://owasp.org/{obj.key}' target='_blank'>↗️</a>"
         )
 
+    def approve_suggested_leaders(self, request, queryset):
+        """Approve all suggested leaders for selected entities."""
+        for entity in queryset:
+            suggestions = entity.suggested_leaders.all()
+            entity.leaders.add(*suggestions)
+            self.message_user(
+                request,
+                f"Approved {suggestions.count()} leader suggestions for {entity.name}",
+                messages.SUCCESS,
+            )
+
     custom_field_github_urls.short_description = "GitHub 🔗"
     custom_field_owasp_url.short_description = "OWASP 🔗"
+    approve_suggested_leaders.short_description = "Approve all suggested leaders"
+
+
+class LeaderEntityAdmin(admin.ModelAdmin, GenericEntityAdminMixin):
+    """Admin class for entities that have leaders."""
+
+    actions = ["approve_suggested_leaders"]
+    filter_horizontal = ("suggested_leaders",)
 
 
-class ChapterAdmin(admin.ModelAdmin, GenericEntityAdminMixin):
-    autocomplete_fields = ("owasp_repository",)
+class ChapterAdmin(LeaderEntityAdmin):
+    autocomplete_fields = ("owasp_repository", "leaders")
     list_display = (
         "name",
         "region",
@@ -62,8 +81,8 @@ class ChapterAdmin(admin.ModelAdmin, GenericEntityAdminMixin):
     search_fields = ("name", "key")
 
 
-class CommitteeAdmin(admin.ModelAdmin):
-    autocomplete_fields = ("owasp_repository",)
+class CommitteeAdmin(LeaderEntityAdmin):
+    autocomplete_fields = ("owasp_repository", "leaders")
     search_fields = ("name",)
 
 
@@ -92,12 +111,13 @@ class PostAdmin(admin.ModelAdmin):
     )
 
 
-class ProjectAdmin(admin.ModelAdmin, GenericEntityAdminMixin):
+class ProjectAdmin(LeaderEntityAdmin):
     autocomplete_fields = (
         "organizations",
         "owasp_repository",
         "owners",
         "repositories",
+        "leaders",
     )
     list_display = (
         "custom_field_name",

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

@@ -0,0 +1,73 @@
+# Generated by Django 5.1.6 on 2025-02-22 21:43
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("github", "0015_alter_release_author"),
+        ("owasp", "0014_project_custom_tags"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="chapter",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="normal_%(class)s",
+                to="github.user",
+                verbose_name="Leaders",
+            ),
+        ),
+        migrations.AddField(
+            model_name="chapter",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="exact_matched_%(class)s",
+                to="github.user",
+                verbose_name="Exact Match Users",
+            ),
+        ),
+        migrations.AddField(
+            model_name="committee",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="normal_%(class)s",
+                to="github.user",
+                verbose_name="Leaders",
+            ),
+        ),
+        migrations.AddField(
+            model_name="committee",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="exact_matched_%(class)s",
+                to="github.user",
+                verbose_name="Exact Match Users",
+            ),
+        ),
+        migrations.AddField(
+            model_name="project",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="normal_%(class)s",
+                to="github.user",
+                verbose_name="Leaders",
+            ),
+        ),
+        migrations.AddField(
+            model_name="project",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="exact_matched_%(class)s",
+                to="github.user",
+                verbose_name="Exact Match Users",
+            ),
+        ),
+    ]

backend/apps/owasp/migrations/0031_merge_20250320_2001.py

@@ -0,0 +1,12 @@
+# Generated by Django 5.1.7 on 2025-03-20 20:01
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("owasp", "0015_chapter_leaders_chapter_suggested_leaders_and_more"),
+        ("owasp", "0030_chapter_is_leaders_policy_compliant_and_more"),
+    ]
+
+    operations = []

backend/apps/owasp/migrations/0032_alter_chapter_leaders_and_more.py

@@ -0,0 +1,73 @@
+# Generated by Django 5.1.7 on 2025-03-23 07:04
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("github", "0018_alter_issue_managers_alter_pullrequest_managers"),
+        ("owasp", "0031_merge_20250320_2001"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="chapter",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="assigned_%(class)s",
+                to="github.user",
+                verbose_name="Assigned leaders",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="chapter",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="matched_%(class)s",
+                to="github.user",
+                verbose_name="Matched Users",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="committee",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="assigned_%(class)s",
+                to="github.user",
+                verbose_name="Assigned leaders",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="committee",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="matched_%(class)s",
+                to="github.user",
+                verbose_name="Matched Users",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="project",
+            name="leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="assigned_%(class)s",
+                to="github.user",
+                verbose_name="Assigned leaders",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="project",
+            name="suggested_leaders",
+            field=models.ManyToManyField(
+                blank=True,
+                related_name="matched_%(class)s",
+                to="github.user",
+                verbose_name="Matched Users",
+            ),
+        ),
+    ]

backend/apps/owasp/models/common.py

@@ -173,6 +173,20 @@ def get_metadata(self):
                 extra={"repository": getattr(self.owasp_repository, "name", None)},
             )
 
+    # M2M
+    suggested_leaders = models.ManyToManyField(
+        "github.User",
+        verbose_name="Matched Users",
+        related_name="matched_%(class)s",
+        blank=True,
+    )
+    leaders = models.ManyToManyField(
+        "github.User",
+        verbose_name="Assigned leaders",
+        related_name="assigned_%(class)s",
+        blank=True,
+    )
+
     def get_related_url(self, url, exclude_domains=(), include_domains=()):
         """Get OWASP entity related URL."""
         if (