chore: add some comments

.pre-commit-config.yaml

@@ -48,7 +48,7 @@ repos:
       - name: Check for uncreated migrations.
         id: migrations-check
         language: system
-        entry: sh -c "src/manage.py makemigrations --check --dry-run"
+        entry: sh -c "pdm manage makemigrations --check --dry-run"
         files: "models/.*.py$"
         types:
           - python

src/core/models/schedules.py

@@ -473,6 +473,7 @@ class ScheduleSource(models.Model):
             """
 
             # for the source id use the provided id, uuid or guid field (in order)
+            # TODO move id to end
             speaker_id = speaker_info.get('id') or speaker_info.get('uuid') or speaker_info.get('guid')
 
             # sanity check: verify that required attributes are present

src/core/schedules/schedulejson.py

@@ -15,12 +15,14 @@ class ScheduleJSONSupport(BaseScheduleSupport):
     identifier = 'schedule-json'
     readonly = True
 
+    # fmt: off
     configuration_fields = {
         # 'key':    (type, default value, mandatory, translation text)
         'feedback': ('bool',   True,       False, 'Enable/Disable feedback url generation'),
         'kind':     ('string', 'assembly', False, 'kind of events, either "assembly" or "official" or "sos" or "lightning"'),
         'headers':  ('dict',   {},         False, 'HTTP headers to send with the request e.g. Authorization'),
     }
+    # fmt: on
 
     def ready(self):
         r = s.head(self.remote_url)

src/core/schedules/schedulejsonfrab.py

@@ -19,6 +19,7 @@ class ScheduleJSONFrabSupport(ScheduleJSONSupport):
     identifier = 'schedule-json-frab'
     readonly = True
 
+    # fmt: off
     configuration_fields = {
         'feedback':        ('bool',   True, False, 'Enable/Disable feedback url generation'),
         'kind':            ('string', 'assembly', False, 'kind of events, either "assembly" or "official" or "sos" or "lightning"'),
@@ -26,6 +27,7 @@ class ScheduleJSONFrabSupport(ScheduleJSONSupport):
         'host':            ('string', 'https://frab.cccv.de/', False, 'overwrite Base URL of the schedule, used for feedback page, images, etc.'),
         'auth':            ('string',  None, False, 'login data for frab instance, format: user:password'),
     }
+    # fmt: on
 
     origin_base_url = None