add expiration date

Author: el-agua

backend/Pipfile

@@ -0,0 +1,11 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+
+[dev-packages]
+
+[requires]
+python_version = "3.11"

backend/courses/management/commands/cache_course_reviews.py

@@ -1,6 +1,7 @@
 from tqdm import tqdm
 from django.core.management.base import BaseCommand
 from django.db import transaction
+import django.utils.timezone as timezone
 
 from courses.models import Course, Section
 from courses.models import course_reviews, sections_with_reviews
@@ -29,7 +30,6 @@ def handle(self, *args, **options):
         self.stdout.write(self.style.SUCCESS("Finished calculating Section review averages."))
 
     def update_courses(self):
-        print("Starting this lol")
         queryset = course_reviews(
             Course.objects.all(),
             prefix=PREFIX,
@@ -40,6 +40,7 @@ def update_courses(self):
         for course in tqdm(queryset, desc="Updating Courses", file=self.stdout):
             for field in REVIEW_FIELDS:
                 setattr(course, field, getattr(course, PREFIX + field))
+            course.annotation_expiration = timezone.now + timezone.timedelta(days=30) 
             courses_to_update.append(course)
 
         with transaction.atomic():
@@ -60,6 +61,7 @@ def update_sections(self):
         for section in tqdm(queryset, desc="Updating Sections", file=self.stdout):
             for field in REVIEW_FIELDS:
                 setattr(section, field, getattr(section, PREFIX + field))
+            section.annotation_expiration = timezone.now + timezone.timedelta(days=30)
             sections_to_update.append(section)
 
         with transaction.atomic():

backend/courses/migrations/0072_course_annotations_expiration_and_more.py

@@ -0,0 +1,30 @@
+# Generated by Django 5.0.2 on 2026-02-20 22:47
+
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("courses", "0071_course_num_activities"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="course",
+            name="annotations_expiration",
+            field=models.DateTimeField(
+                default=django.utils.timezone.now,
+                help_text="\nThe expiration time for the annotations of this course, these fields should be refreshed\nevery month\n",
+            ),
+        ),
+        migrations.AddField(
+            model_name="section",
+            name="annotation_expiration",
+            field=models.DateTimeField(
+                default=django.utils.timezone.now,
+                help_text="\nThe expiration time for the annotations of this section, these fields should be refreshed\nevery month\n",
+            ),
+        ),
+    ]

backend/courses/models.py

@@ -130,6 +130,9 @@ def course_reviews(queryset, prefix=""):
 
 class CourseManager(models.Manager):
     def get_queryset(self):
+        queryset = super().get_queryset()
+        if (queryset.filter(annotation_expiration_lt=timezone.now()).exists()):
+            return course_reviews(queryset).order_by("full_code", "semester")
         return super().get_queryset()
 
 
@@ -282,6 +285,16 @@ class Course(models.Model):
             """
         ),
     )
+
+    annotations_expiration = models.DateTimeField(
+        default=timezone.now,
+        help_text=dedent(
+            """
+            The expiration time for the annotations of this course, these fields should be refreshed
+            every month
+            """
+        ),
+    )
     course_quality = models.DecimalField(max_digits=4, decimal_places=3, null=True, blank=True, help_text=dedent(
         """
         The average course quality rating for this course, on a scale from 0 to 5 (precomputed for efficiency).
@@ -838,7 +851,16 @@ class Meta:
         default=0,
         help_text="The number of active PCA registrations watching this section.",
     )  # For the set of PCA registrations for this section, use the related field `registrations`.
-
+    
+    annotation_expiration = models.DateTimeField(
+        default=timezone.now,
+        help_text=dedent(
+            """
+            The expiration time for the annotations of this section, these fields should be refreshed
+            every month
+            """
+        ),
+    )
     course_quality = models.DecimalField(max_digits=4, decimal_places=3, null=True, blank=True)
     instructor_quality = models.DecimalField(max_digits=4, decimal_places=3, null=True, blank=True)
     difficulty = models.DecimalField(max_digits=4, decimal_places=3, null=True, blank=True)