agendas: document reminder minimal delay (#53309)

chrono/agendas/management/commands/send_booking_reminders.py

@@ -51,11 +51,10 @@ class Command(BaseCommand):
         starts_before = timezone.now() + reminder_delta
         starts_after = timezone.now() + reminder_delta - timedelta(hours=6)
 
-        # prevent user who just booked from getting a reminder
+        # prevent user who just booked from getting a reminder (also documented in a help_text)
         created_before = timezone.now() - timedelta(hours=12)
 
         bookings = Booking.objects.filter(
-            event__agenda__reminder_settings__days__isnull=False,  # useless ?
             cancellation_datetime__isnull=True,
             creation_datetime__lte=created_before,
             reminder_datetime__isnull=True,

chrono/agendas/migrations/0062_auto_20200915_1401.py

@@ -32,6 +32,9 @@ class Migration(migrations.Migration):
                         ],
                         null=True,
                         verbose_name='Send reminder',
+                        help_text=(
+                            'In order to prevent users from getting a reminder shortly after booking, a reminder is sent less only if at least 12 hours have elapsed since booking time.'
+                        ),
                     ),
                 ),
                 ('send_email', models.BooleanField(default=False, verbose_name='Notify by email')),

chrono/agendas/models.py

@@ -2529,7 +2529,15 @@ class AgendaReminderSettings(models.Model):
     ]
 
     agenda = models.OneToOneField(Agenda, on_delete=models.CASCADE, related_name='reminder_settings')
-    days = models.IntegerField(null=True, blank=True, choices=CHOICES, verbose_name=_('Send reminder'))
+    days = models.IntegerField(
+        null=True,
+        blank=True,
+        choices=CHOICES,
+        verbose_name=_('Send reminder'),
+        help_text=_(
+            'In order to prevent users from getting a reminder shortly after booking, a reminder is sent less only if at least 12 hours have elapsed since booking time.'
+        ),
+    )
     send_email = models.BooleanField(default=False, verbose_name=_('Notify by email'))
     email_extra_info = models.TextField(
         blank=True,