Calendar

tom_base/settings.py

@@ -62,6 +62,7 @@
     'tom_observations',
     'tom_dataproducts',
     'tom_dataservices',
+    'tom_calendar',
 ]
 
 SITE_ID = 1

tom_calendar/admin.py

@@ -0,0 +1,5 @@
+from django.contrib import admin
+
+from .models import CalendarEvent
+
+admin.site.register(CalendarEvent)

tom_calendar/apps.py

@@ -0,0 +1,12 @@
+from django.apps import AppConfig
+
+
+class TomCalendarConfig(AppConfig):
+    name = 'tom_calendar'
+
+    def nav_items(self):
+        """
+        Integration point for adding items to the navbar.
+        This method should return a list of partial templates to be included in the navbar.
+        """
+        return [{'partial': 'tom_calendar/partials/navbar_item.html'}]

tom_calendar/migrations/0001_initial.py

@@ -0,0 +1,27 @@
+# Generated by Django 4.2.27 on 2026-02-27 22:33
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='CalendarEvent',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200)),
+                ('description', models.TextField(blank=True, default='')),
+                ('start_time', models.DateTimeField()),
+                ('end_time', models.DateTimeField()),
+                ('url', models.URLField(blank=True, default='')),
+                ('created', models.DateTimeField(auto_now_add=True)),
+                ('modified', models.DateTimeField(auto_now=True)),
+            ],
+        ),
+    ]

tom_calendar/migrations/0002_calendarevent_target_list.py

@@ -0,0 +1,20 @@
+# Generated by Django 4.2.27 on 2026-03-05 17:52
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('tom_targets', '0030_alter_basetarget_slope'),
+        ('tom_calendar', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='calendarevent',
+            name='target_list',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='tom_targets.targetlist'),
+        ),
+    ]

tom_calendar/migrations/0003_calendarevent_proposal_calendarevent_telescope_and_more.py

@@ -0,0 +1,28 @@
+# Generated by Django 4.2.27 on 2026-03-05 22:35
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('tom_calendar', '0002_calendarevent_target_list'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='calendarevent',
+            name='proposal',
+            field=models.CharField(blank=True, default='', max_length=200),
+        ),
+        migrations.AddField(
+            model_name='calendarevent',
+            name='telescope',
+            field=models.CharField(blank=True, default='', max_length=200),
+        ),
+        migrations.AddField(
+            model_name='calendarevent',
+            name='user',
+            field=models.CharField(blank=True, default='', max_length=200),
+        ),
+    ]

tom_calendar/migrations/0004_eventtodo.py

@@ -0,0 +1,25 @@
+# Generated by Django 4.2.27 on 2026-03-05 23:42
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('tom_calendar', '0003_calendarevent_proposal_calendarevent_telescope_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='EventTodo',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('description', models.CharField(max_length=200)),
+                ('is_completed', models.BooleanField(default=False)),
+                ('created', models.DateTimeField(auto_now_add=True)),
+                ('modified', models.DateTimeField(auto_now=True)),
+                ('event', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='todos', to='tom_calendar.calendarevent')),
+            ],
+        ),
+    ]

tom_calendar/migrations/0005_calendarevent_instrument.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.2.27 on 2026-03-12 20:58
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('tom_calendar', '0004_eventtodo'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='calendarevent',
+            name='instrument',
+            field=models.CharField(blank=True, default='', max_length=200),
+        ),
+    ]

tom_calendar/models.py

@@ -0,0 +1,51 @@
+from django.db import models
+
+from tom_targets.models import TargetList
+
+from .utils import BOOTSTRAP_COLORS
+
+
+class EventTodo(models.Model):
+    event = models.ForeignKey('CalendarEvent', on_delete=models.CASCADE, related_name='todos')
+    description = models.CharField(max_length=200)
+    is_completed = models.BooleanField(default=False)
+    created = models.DateTimeField(auto_now_add=True)
+    modified = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return f'Todo for {self.event.title}: {self.description}'
+
+
+class CalendarEvent(models.Model):
+    """
+    Class representing an event in the calendar.
+
+    Other applications can create calendar events by creating instances of this class.
+
+    """
+    title = models.CharField(max_length=200)
+    description = models.TextField(blank=True, default="")
+    start_time = models.DateTimeField()
+    end_time = models.DateTimeField()
+    url = models.URLField(blank=True, default="")
+    """The URL a user can visit for more information or associated object."""
+    target_list = models.ForeignKey(TargetList, on_delete=models.SET_NULL, null=True, blank=True)
+    user = models.CharField(max_length=200, blank=True, default="")
+    proposal = models.CharField(max_length=200, blank=True, default="")
+    telescope = models.CharField(max_length=200, blank=True, default="")
+    instrument = models.CharField(max_length=200, blank=True, default="")
+    created = models.DateTimeField(auto_now_add=True)
+    modified = models.DateTimeField(auto_now=True)
+
+    todos: models.Manager[EventTodo]
+
+    def __str__(self):
+        return self.title
+
+    @property
+    def color(self) -> str:
+        return BOOTSTRAP_COLORS[self.pk % len(BOOTSTRAP_COLORS)]
+
+    @property
+    def active_todos(self):
+        return self.todos.filter(is_completed=False)

tom_calendar/templates/tom_calendar/calendar_page.html

@@ -0,0 +1,30 @@
+{% extends 'tom_common/base.html' %}
+{% block title %}Calendar{% endblock %}
+{% block content %}
+  {% include 'tom_calendar/partials/calendar.html' %}
+  <!-- Modal -->
+  <div class="modal fade" id="cal-modal" tabindex="-1" aria-labelledby="calModalLabel" aria-hidden="true">
+    <div class="modal-dialog modal-lg">
+      <div class="modal-content">
+        <div class="modal-header">
+          <button type="button" class="close" data-dismiss="modal" aria-label="Close">
+            <span aria-hidden="true">&times;</span>
+          </button>
+        </div>
+        <div class="modal-body" id="cal-modal-body">
+        </div>
+      </div>
+    </div>
+  </div>
+{% endblock %}
+{% block extra_javascript %}
+<script>
+  document.body.addEventListener("calClose", function () {
+    $("#cal-modal").modal("hide");
+  });
+  document.body.addEventListener("calRefresh", function () {
+    const cal = document.getElementById("calendar-partial");
+    htmx.ajax("GET", cal.dataset.url, {target: "#calendar-partial", swap: "outerHTML"});
+  });
+</script>
+{% endblock %}