Feature: Add feature to complete profile of the students if the challenge requires (#4965)

* Backend: Enhance user profile model and serializers to support additional fields and validation

* Backend: Update profile serializer and challenge tests to include new fields and improve response validation

* Backend: Add 'require_complete_profile' field to challenge and participant tests for improved data handling

* Backend: Update participant tests to include additional address fields and improve JSON response handling

* Backend: Refactor invitation error messages in participant view for improved readability and consistency

Author: RishabhJain2018

apps/accounts/migrations/0003_add_profile_address_fields.py

@@ -0,0 +1,38 @@
+# Generated by Django 2.2.20 on 2026-01-28 07:50
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("accounts", "0002_add_jwt_access_token_model"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="profile",
+            name="address_city",
+            field=models.CharField(blank=True, max_length=100, null=True),
+        ),
+        migrations.AddField(
+            model_name="profile",
+            name="address_country",
+            field=models.CharField(blank=True, max_length=100, null=True),
+        ),
+        migrations.AddField(
+            model_name="profile",
+            name="address_state",
+            field=models.CharField(blank=True, max_length=100, null=True),
+        ),
+        migrations.AddField(
+            model_name="profile",
+            name="address_street",
+            field=models.CharField(blank=True, max_length=500, null=True),
+        ),
+        migrations.AddField(
+            model_name="profile",
+            name="university",
+            field=models.CharField(blank=True, max_length=512, null=True),
+        ),
+    ]

apps/accounts/models.py

@@ -46,10 +46,41 @@ class Profile(TimeStampedModel):
     github_url = models.URLField(max_length=200, null=True, blank=True)
     google_scholar_url = models.URLField(max_length=200, null=True, blank=True)
     linkedin_url = models.URLField(max_length=200, null=True, blank=True)
+    # Student profile fields for challenges requiring complete profile
+    address_street = models.CharField(max_length=500, null=True, blank=True)
+    address_city = models.CharField(max_length=100, null=True, blank=True)
+    address_state = models.CharField(max_length=100, null=True, blank=True)
+    address_country = models.CharField(max_length=100, null=True, blank=True)
+    university = models.CharField(max_length=512, null=True, blank=True)
 
     def __str__(self):
         return "{}".format(self.user)
 
+    @property
+    def is_complete(self):
+        """
+        Check if the user's profile is complete for challenges requiring complete profile.
+        A complete profile requires: first_name, last_name, address_street, address_city,
+        address_state, address_country, and university.
+        """
+        user = self.user
+        required_fields = [
+            user.first_name,
+            user.last_name,
+            self.address_street,
+            self.address_city,
+            self.address_state,
+            self.address_country,
+            self.university,
+        ]
+        return all(field and field.strip() for field in required_fields)
+
+    def get_full_name(self):
+        """Returns the full name of the user."""
+        return "{} {}".format(
+            self.user.first_name, self.user.last_name
+        ).strip()
+
     class Meta:
         app_label = "accounts"
         db_table = "user_profile"

apps/accounts/serializers.py

@@ -41,6 +41,23 @@ class ProfileSerializer(UserDetailsSerializer):
     linkedin_url = serializers.URLField(
         source="profile.linkedin_url", allow_blank=True
     )
+    # Student profile fields
+    address_street = serializers.CharField(
+        source="profile.address_street", allow_blank=True, required=False
+    )
+    address_city = serializers.CharField(
+        source="profile.address_city", allow_blank=True, required=False
+    )
+    address_state = serializers.CharField(
+        source="profile.address_state", allow_blank=True, required=False
+    )
+    address_country = serializers.CharField(
+        source="profile.address_country", allow_blank=True, required=False
+    )
+    university = serializers.CharField(
+        source="profile.university", allow_blank=True, required=False
+    )
+    is_profile_complete = serializers.SerializerMethodField()
 
     class Meta(UserDetailsSerializer.Meta):
         fields = (
@@ -53,14 +70,31 @@ class Meta(UserDetailsSerializer.Meta):
             "github_url",
             "google_scholar_url",
             "linkedin_url",
+            "address_street",
+            "address_city",
+            "address_state",
+            "address_country",
+            "university",
+            "is_profile_complete",
         )
 
+    def get_is_profile_complete(self, obj):
+        """Returns whether the user's profile is complete."""
+        if hasattr(obj, "profile"):
+            return obj.profile.is_complete
+        return False
+
     def update(self, instance, validated_data):
         profile_data = validated_data.pop("profile", {})
         affiliation = profile_data.get("affiliation")
         github_url = profile_data.get("github_url")
         google_scholar_url = profile_data.get("google_scholar_url")
         linkedin_url = profile_data.get("linkedin_url")
+        address_street = profile_data.get("address_street")
+        address_city = profile_data.get("address_city")
+        address_state = profile_data.get("address_state")
+        address_country = profile_data.get("address_country")
+        university = profile_data.get("university")
 
         instance = super(ProfileSerializer, self).update(
             instance, validated_data
@@ -72,6 +106,16 @@ def update(self, instance, validated_data):
             profile.github_url = github_url
             profile.google_scholar_url = google_scholar_url
             profile.linkedin_url = linkedin_url
+            if address_street is not None:
+                profile.address_street = address_street
+            if address_city is not None:
+                profile.address_city = address_city
+            if address_state is not None:
+                profile.address_state = address_state
+            if address_country is not None:
+                profile.address_country = address_country
+            if university is not None:
+                profile.university = university
             profile.save()
         return instance
 
@@ -88,6 +132,11 @@ class Meta:
             "github_url",
             "google_scholar_url",
             "linkedin_url",
+            "address_street",
+            "address_city",
+            "address_state",
+            "address_country",
+            "university",
         )
 
 

apps/challenges/migrations/0114_add_require_complete_profile.py

@@ -0,0 +1,24 @@
+# Generated by Django 2.2.20 on 2026-01-28 07:51
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("challenges", "0113_add_github_branch_field_and_unique_constraint"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="challenge",
+            name="require_complete_profile",
+            field=models.BooleanField(
+                default=False,
+                help_text="If enabled, participants must have a complete "
+                "profile (name, address, city, state, country) before "
+                "joining this challenge.",
+                verbose_name="Require Complete Profile",
+            ),
+        ),
+    ]

apps/challenges/models.py

@@ -83,6 +83,11 @@ def __init__(self, *args, **kwargs):
     anonymous_leaderboard = models.BooleanField(default=False)
     participant_teams = models.ManyToManyField(ParticipantTeam, blank=True)
     manual_participant_approval = models.BooleanField(default=False)
+    require_complete_profile = models.BooleanField(
+        default=False,
+        verbose_name="Require Complete Profile",
+        help_text="If enabled, participants must have a complete profile (name, address, city, state, country) before joining this challenge.",
+    )
     approved_participant_teams = models.ManyToManyField(
         ParticipantTeam,
         blank=True,

apps/challenges/serializers.py

@@ -67,6 +67,7 @@ class Meta:
             "allowed_email_domains",
             "blocked_email_domains",
             "banned_email_ids",
+            "require_complete_profile",
             "approved_by_admin",
             "forum_url",
             "is_docker_based",
@@ -318,6 +319,7 @@ class Meta:
             "allowed_email_domains",
             "blocked_email_domains",
             "banned_email_ids",
+            "require_complete_profile",
             "forum_url",
             "remote_evaluation",
             "allow_resuming_submissions",

apps/challenges/utils.py

@@ -406,6 +406,35 @@ def is_user_in_blocked_email_domains(email, challenge_pk):
     return False
 
 
+def get_participants_with_incomplete_profiles(participant_team):
+    """
+    Check if all team members have complete profiles.
+
+    Arguments:
+        participant_team {ParticipantTeam} -- The participant team to check
+
+    Returns:
+        list -- List of usernames of team members with incomplete profiles
+    """
+    from accounts.models import Profile
+    from participants.models import Participant
+
+    incomplete_profiles = []
+    participants = Participant.objects.filter(
+        team=participant_team
+    ).select_related("user", "user__profile")
+
+    for participant in participants:
+        try:
+            profile = participant.user.profile
+            if not profile.is_complete:
+                incomplete_profiles.append(participant.user.username)
+        except Profile.DoesNotExist:
+            incomplete_profiles.append(participant.user.username)
+
+    return incomplete_profiles
+
+
 def get_unique_alpha_numeric_key(length):
     """
     Returns unique alpha numeric key of length
@@ -536,28 +565,24 @@ def send_subscription_plans_email(challenge):
 
                 emails_sent += 1
                 logger.info(
-                    "Subscription plans email sent to {} for challenge {}".format(
-                        email, challenge.pk
-                    )
+                    "Subscription plans email sent to {} for challenge "
+                    "{}".format(email, challenge.pk)
                 )
             except Exception as e:
                 logger.error(
-                    "Failed to send subscription plans email to {} for challenge {}: {}".format(
-                        email, challenge.pk, str(e)
-                    )
+                    "Failed to send subscription plans email to {} for "
+                    "challenge {}: {}".format(email, challenge.pk, str(e))
                 )
 
         logger.info(
-            "Sent subscription plans email to {}/{} hosts for challenge {}".format(
-                emails_sent, len(challenge_host_emails), challenge.pk
-            )
+            "Sent subscription plans email to {}/{} hosts for challenge "
+            "{}".format(emails_sent, len(challenge_host_emails), challenge.pk)
         )
 
     except Exception as e:
         logger.error(
-            "Error sending subscription plans email for challenge {}: {}".format(
-                challenge.pk, str(e)
-            )
+            "Error sending subscription plans email for challenge {}: "
+            "{}".format(challenge.pk, str(e))
         )