Find optimal interview slot

backend/root/management/commands/seed_scripts/__init__.py

@@ -21,8 +21,10 @@
     recruitment_position,
     recruitment_applications,
     recruitment_occupied_time,
+    recruitment_occupied_time,
     recruitment_separate_position,
     recruitment_interviewavailability,
+    recruitment_position_interviewers,
 )
 
 # Insert seed scripts here (in order of priority)
@@ -53,6 +55,7 @@
     ('recruitment_separate_position', recruitment_separate_position.seed),
     ('recruitment_applications', recruitment_applications.seed),
     ('recruitment_occupied_time', recruitment_occupied_time.seed),
+    ('recruitment_position_interviewers', recruitment_position_interviewers.seed),
     # Example seed (not run unless targeted specifically)
     ('example', example.seed),
 ]

backend/root/management/commands/seed_scripts/recruitment_position_interviewers.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from random import sample, randint
+
+from samfundet.models.general import User
+from samfundet.models.recruitment import RecruitmentPosition, RecruitmentApplication
+
+
+def seed():
+    yield 0, 'recruitment_interviewers'
+    # Clear any existing interviewers
+    for position in RecruitmentPosition.objects.all():
+        position.interviewers.clear()
+    yield 0, 'Cleared old interviewers'
+
+    positions = RecruitmentPosition.objects.all()
+    applicants_by_position = RecruitmentApplication.objects.values_list('recruitment_position_id', 'user_id')
+
+    created_count = 0
+
+    for position_index, position in enumerate(positions):
+        # Get the users who have applied for this position
+        applicants_for_position = set(user_id for pos_id, user_id in applicants_by_position if pos_id == position.id)
+        # Get the list of interviewers excluding those who applied for this position
+        interviewers = User.objects.exclude(id__in=applicants_for_position)
+
+        available_interviewers = list(interviewers)
+        if len(available_interviewers) < 3:
+            print(f'Skipping position {position.id} due to insufficient interviewers')
+            continue  # Skip this position if there are not enough interviewers
+
+        # Select 3-6 random interviewers for each position
+        num_interviewers = randint(3, min(6, len(available_interviewers)))
+        selected_interviewers = sample(available_interviewers, num_interviewers)
+
+        # Assign interviewers to the position
+        position.interviewers.set(selected_interviewers)
+        created_count += num_interviewers
+
+        yield (position_index + 1) / len(positions), 'recruitment_interviewers'
+
+    yield 100, f'Assigned {created_count} interviewers to recruitment positions'

backend/samfundet/exceptions.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+
+class InterviewAllocationError(Exception):
+    """Base exception for interview allocation errors."""
+
+    pass
+
+
+class NoTimeBlocksAvailableError(InterviewAllocationError):
+    """Raised when there are no available time blocks for interviews."""
+
+    pass
+
+
+class NoApplicationsWithoutInterviewsError(InterviewAllocationError):
+    """Raised when there are no applications without interviews."""
+
+    pass
+
+
+class NoAvailableInterviewersError(InterviewAllocationError):
+    """Raised when there are no available interviewers for a given time slot."""
+
+    pass
+
+
+class AllApplicantsUnavailableError(InterviewAllocationError):
+    """Raised when all applicants are unavailable for the remaining time slots."""
+
+    pass
+
+
+class InsufficientTimeBlocksError(InterviewAllocationError):
+    """Raised when there are not enough time blocks to accommodate all applications."""
+
+    pass
+
+
+class NoFutureTimeSlotsError(InterviewAllocationError):
+    """Raised when there are no time slots available at least 24 hours in the future."""
+
+    pass

backend/samfundet/migrations/0002_interviewtimeblock.py

@@ -0,0 +1,27 @@
+# Generated by Django 5.0.7 on 2024-07-22 13:18
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('samfundet', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='InterviewTimeblock',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('date', models.DateField(help_text='Block date')),
+                ('start_dt', models.DateTimeField(help_text='Block start time')),
+                ('end_dt', models.DateTimeField(help_text='Block end time')),
+                ('rating', models.FloatField(help_text='Rating used for optimizing interview time')),
+                ('available_interviewers', models.ManyToManyField(blank=True, help_text='Interviewers in this time block', related_name='interview_timeblocks', to=settings.AUTH_USER_MODEL)),
+                ('recruitment_position', models.ForeignKey(help_text='The position which is recruiting', on_delete=django.db.models.deletion.CASCADE, related_name='interview_timeblocks', to='samfundet.recruitmentposition')),
+            ],
+        ),
+    ]

backend/samfundet/migrations/0004_merge_20240924_0058.py

@@ -0,0 +1,14 @@
+# Generated by Django 5.1.1 on 2024-09-23 22:58
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('samfundet', '0002_interviewtimeblock'),
+        ('samfundet', '0003_remove_gang_event_admin_group_and_more'),
+    ]
+
+    operations = [
+    ]

backend/samfundet/migrations/0006_merge_20240925_1842.py

@@ -0,0 +1,14 @@
+# Generated by Django 5.1.1 on 2024-09-25 16:42
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('samfundet', '0004_merge_20240924_0058'),
+        ('samfundet', '0005_role_content_type_role_created_at_role_created_by_and_more'),
+    ]
+
+    operations = [
+    ]

backend/samfundet/models/recruitment.py

@@ -449,6 +449,17 @@ def resolve_org(self, *, return_id: bool = False) -> Organization | int:
         return self.recruitment.resolve_org(return_id=return_id)
 
 
+class InterviewTimeblock(models.Model):
+    recruitment_position = models.ForeignKey(
+        'RecruitmentPosition', on_delete=models.CASCADE, help_text='The position which is recruiting', related_name='interview_timeblocks'
+    )
+    date = models.DateField(help_text='Block date', null=False, blank=False)
+    start_dt = models.DateTimeField(help_text='Block start time', null=False, blank=False)
+    end_dt = models.DateTimeField(help_text='Block end time', null=False, blank=False)
+    rating = models.FloatField(help_text='Rating used for optimizing interview time')
+    available_interviewers = models.ManyToManyField('User', help_text='Interviewers in this time block', blank=True, related_name='interview_timeblocks')
+
+
 class RecruitmentStatistics(FullCleanSaveMixin):
     recruitment = models.OneToOneField(Recruitment, on_delete=models.CASCADE, blank=True, null=True, related_name='statistics')
 

backend/samfundet/serializers.py

@@ -55,6 +55,7 @@
     Recruitment,
     InterviewRoom,
     OccupiedTimeslot,
+    InterviewTimeblock,
     RecruitmentDateStat,
     RecruitmentGangStat,
     RecruitmentPosition,
@@ -901,6 +902,12 @@ class Meta:
         fields = '__all__'
 
 
+class InterviewTimeblockSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = InterviewTimeblock
+        fields = '__all__'
+
+
 class ApplicantInfoSerializer(CustomBaseSerializer):
     occupied_timeslots = OccupiedTimeslotSerializer(many=True)
 

backend/samfundet/urls.py

@@ -50,6 +50,7 @@
 router.register('recruitment-applications-for-gang', views.RecruitmentApplicationForGangView, 'recruitment_applications_for_gang')
 router.register('recruitment-applications-for-position', views.RecruitmentApplicationForRecruitmentPositionView, 'recruitment_applications_for_position')
 router.register('interview', views.InterviewView, 'interview')
+router.register('interview-timeblocks', views.InterviewTimeblockView, 'interview_timeblock')
 
 app_name = 'samfundet'
 
@@ -137,5 +138,7 @@
     path('recruitment-interview-availability/', views.RecruitmentInterviewAvailabilityView.as_view(), name='recruitment_interview_availability'),
     path('recruitment/<int:id>/availability/', views.RecruitmentAvailabilityView.as_view(), name='recruitment_availability'),
     path('feedback/', views.UserFeedbackView.as_view(), name='feedback'),
+    path('generate-interview-blocks/<int:pk>', views.GenerateInterviewTimeblocksView.as_view(), name='generate_interview_blocks'),
     path('purchase-feedback/', views.PurchaseFeedbackView.as_view(), name='purchase_feedback'),
+    path('allocate-interviews/<int:pk>', views.AllocateInterviewsForPositionView.as_view(), name='allocated_interviews'),
 ]