Show First time attendee stats (#297)

* Show First time attendee stats

Display number of first time attendee and the percentage

Closes #296

Author: Mariatta

attendee/migrations/0003_alter_attendeeprofile_participated_in_previous_event.py

@@ -0,0 +1,33 @@
+# Generated by Django 5.2.8 on 2025-12-05 00:11
+
+from django.db import migrations, models
+
+import portal.models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("attendee", "0002_attendeeprofile"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="attendeeprofile",
+            name="participated_in_previous_event",
+            field=portal.models.ChoiceArrayField(
+                base_field=models.CharField(
+                    blank=True,
+                    choices=[
+                        ("PyLadiesCon 2024", "PyLadiesCon 2024"),
+                        ("PyLadiesCon 2023", "PyLadiesCon 2023"),
+                        ("No this is my first one", "No this is my first one"),
+                    ],
+                    help_text="Have you participated in a previous event?",
+                    null=True,
+                ),
+                default=list,
+                size=None,
+            ),
+        ),
+    ]

attendee/models.py

@@ -34,7 +34,7 @@ class PretixOrderstatus(StrEnum):
 PARTICIPATED_IN_PREVIOUS_EVENT_CHOICES = [
     ("PyLadiesCon 2024", "PyLadiesCon 2024"),
     ("PyLadiesCon 2023", "PyLadiesCon 2023"),
-    ("No, this is my first one", "No, this is my first one"),
+    ("No this is my first one", "No this is my first one"),
 ]
 CURRENT_POSITION_CHOICES = [
     ("Engineer", "Engineer"),

portal/common.py

@@ -1,10 +1,17 @@
 from django.core.cache import cache
 from django.db.models import Count, Sum
 
-from attendee.models import AttendeeProfile, PretixOrder, PretixOrderstatus
+from attendee.models import (
+    PARTICIPATED_IN_PREVIOUS_EVENT_CHOICES,
+    AttendeeProfile,
+    PretixOrder,
+    PretixOrderstatus,
+)
 from portal.constants import (
     CACHE_KEY_ATTENDEE_BREAKDOWN,
     CACHE_KEY_ATTENDEE_COUNT,
+    CACHE_KEY_ATTENDEE_FIRST_TIME_COUNT,
+    CACHE_KEY_ATTENDEE_FIRST_TIME_PERCENT,
     CACHE_KEY_DONATION_BREAKDOWN,
     CACHE_KEY_DONATION_TOWARDS_GOAL_PERCENT,
     CACHE_KEY_DONATIONS_TOTAL_AMOUNT,
@@ -619,6 +626,11 @@ def get_attendee_stats_dict():
     stats_dict = {}
     stats_dict[CACHE_KEY_ATTENDEE_COUNT] = get_attendee_count_cache()
     stats_dict[CACHE_KEY_ATTENDEE_BREAKDOWN] = get_attendee_breakdown()
+    stats_dict[CACHE_KEY_ATTENDEE_FIRST_TIME_COUNT] = get_first_time_attendee_count()
+    stats_dict[CACHE_KEY_ATTENDEE_FIRST_TIME_PERCENT] = (
+        get_first_time_attendee_percent()
+    )
+
     return stats_dict
 
 
@@ -657,6 +669,46 @@ def get_attendee_current_position_breakdown(attendee_profiles):
     return current_position_breakdown
 
 
+def get_first_time_attendee_count():
+    """Returns the count of first-time attendees."""
+    first_time_attendee_count = cache.get(CACHE_KEY_ATTENDEE_FIRST_TIME_COUNT)
+    if not first_time_attendee_count:
+        first_time_attendee_count = AttendeeProfile.objects.filter(
+            order__status=PretixOrderstatus.PAID,
+            participated_in_previous_event__contains=[
+                PARTICIPATED_IN_PREVIOUS_EVENT_CHOICES[2][0]
+            ],
+        ).count()
+
+        cache.set(
+            CACHE_KEY_ATTENDEE_FIRST_TIME_COUNT,
+            first_time_attendee_count,
+            STATS_CACHE_TIMEOUT,
+        )
+    return first_time_attendee_count
+
+
+def get_first_time_attendee_percent():
+    """Returns the percent of first-time attendees."""
+    cache.clear()
+    first_time_attendee_percent = cache.get(CACHE_KEY_ATTENDEE_FIRST_TIME_PERCENT)
+    if not first_time_attendee_percent:
+        attendee_total_count = get_attendee_count_cache()
+        attendee_first_time_count = get_first_time_attendee_count()
+        first_time_attendee_percent = (
+            (attendee_first_time_count / attendee_total_count) * 100
+            if attendee_total_count > 0
+            else 0
+        )
+
+        cache.set(
+            CACHE_KEY_ATTENDEE_FIRST_TIME_PERCENT,
+            first_time_attendee_percent,
+            STATS_CACHE_TIMEOUT,
+        )
+    return first_time_attendee_percent
+
+
 def get_attendee_breakdown():
     """Returns the attendee demographic breakdown stats."""
     attendee_breakdown = cache.get(CACHE_KEY_ATTENDEE_BREAKDOWN)

portal/constants.py

@@ -33,6 +33,9 @@
 SPONSORSHIP_GOAL = "sponsorship_goal"
 
 CACHE_KEY_ATTENDEE_COUNT = "attendee_count"
+CACHE_KEY_ATTENDEE_FIRST_TIME_COUNT = "attendee_first_time_count"
+CACHE_KEY_ATTENDEE_FIRST_TIME_PERCENT = "attendee_first_time_percent"
+
 CACHE_KEY_ATTENDEE_BREAKDOWN = "attendee_breakdown"
 CACHE_KEY_ATTENDEE_BY_ROLE = "attendee_by_role"
 CACHE_KEY_ATTENDEE_BY_COUNTRY = "attendee_by_country"

templates/attendee/attendee_stats.html

@@ -1,6 +1,46 @@
 <h3 id="attendee_demographic">
     Attendee Demographic
 </h3>
+<div class="container border rounded-3 p-3 mb-4">
+    <div class="row">
+        <div class="col-sm-4">
+            <div class="card border-0">
+                <div class="card-body">
+                    <h5 class="card-title">
+                        Registered Attendees
+                    </h5>
+                    <h1 class="display-4 text-info">
+                        {{ stats.attendee_count }}
+                    </h1>
+                </div>
+            </div>
+        </div>
+        <div class="col-sm-4">
+            <div class="card border-0">
+                <div class="card-body">
+                    <h5 class="card-title">
+                        First Time Attendees
+                    </h5>
+                    <h1 class="display-4 text-success">
+                        {{ stats.attendee_first_time_count }}
+                    </h1>
+                </div>
+            </div>
+        </div>
+        <div class="col-sm-4">
+            <div class="card border-0 text-bg-success">
+                <div class="card-body">
+                    <h5 class="card-title">
+                        % of First Time Attendees
+                    </h5>
+                    <h1 class="display-4 text-warning">
+                        {{ stats.attendee_first_time_percent |floatformat:0 }}%
+                    </h1>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
 {% for breakdown in stats.attendee_breakdown %}
     <div class="container border rounded-3 p-3 mb-4">
         <div class="row">