adds repeating events.

Author: ljonesfl

resources/database/migrate/20260619140000_add_recurrence_to_events.php

@@ -0,0 +1,72 @@
+<?php
+
+use Phinx\Migration\AbstractMigration;
+
+/**
+ * Add recurrence (RFC 5545 RRULE) support to the events table.
+ *
+ * A recurring event stores its rule in `rrule` (the master). Individual
+ * occurrences are expanded on the fly at query time. A modified single
+ * occurrence is stored as a child "override" row that points back to its
+ * master via `recurrence_parent_id` and identifies the original occurrence it
+ * replaces via `recurrence_id`. `recurrence_until` caches the last occurrence
+ * date of a bounded rule (NULL for an infinite rule) so range queries can skip
+ * masters whose window does not intersect the requested range.
+ *
+ * NOTE: For EXISTING installations that already ran the original
+ * create_events_table migration. New installations pick up the columns from
+ * this migration when running migrations in order.
+ */
+class AddRecurrenceToEvents extends AbstractMigration
+{
+	/**
+	 * Add recurrence columns to events table
+	 */
+	public function change()
+	{
+		$table = $this->table( 'events' );
+
+		if( !$table->hasColumn( 'rrule' ) )
+		{
+			$table->addColumn( 'rrule', 'text', [
+				'null' => true,
+				'after' => 'all_day'
+			] )->update();
+		}
+
+		if( !$table->hasColumn( 'recurrence_parent_id' ) )
+		{
+			$table->addColumn( 'recurrence_parent_id', 'integer', [
+				'signed' => false,
+				'null' => true,
+				'after' => 'rrule'
+			] )
+				->addIndex( [ 'recurrence_parent_id' ] )
+				->addForeignKey( 'recurrence_parent_id', 'events', 'id', [
+					'delete' => 'CASCADE',
+					'update' => 'CASCADE'
+				] )
+				->update();
+		}
+
+		if( !$table->hasColumn( 'recurrence_id' ) )
+		{
+			$table->addColumn( 'recurrence_id', 'datetime', [
+				'null' => true,
+				'after' => 'recurrence_parent_id'
+			] )
+				->addIndex( [ 'recurrence_id' ] )
+				->update();
+		}
+
+		if( !$table->hasColumn( 'recurrence_until' ) )
+		{
+			$table->addColumn( 'recurrence_until', 'datetime', [
+				'null' => true,
+				'after' => 'recurrence_id'
+			] )
+				->addIndex( [ 'recurrence_until' ] )
+				->update();
+		}
+	}
+}

resources/database/migrate/20260619140001_create_event_recurrence_exceptions_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Phinx\Migration\AbstractMigration;
+
+/**
+ * Create event_recurrence_exceptions table.
+ *
+ * Stores excluded occurrence dates (EXDATE) for a recurring master event.
+ * A cancelled single occurrence is recorded here; when expanding the master
+ * rule any occurrence whose start matches an exception row is skipped.
+ */
+class CreateEventRecurrenceExceptionsTable extends AbstractMigration
+{
+	/**
+	 * Create event_recurrence_exceptions table
+	 */
+	public function change()
+	{
+		$table = $this->table( 'event_recurrence_exceptions', [ 'signed' => false ] );
+
+		$table->addColumn( 'event_id', 'integer', [ 'signed' => false, 'null' => false ] )
+			->addColumn( 'occurrence_date', 'datetime', [ 'null' => false ] )
+			->addColumn( 'created_at', 'timestamp', [ 'default' => 'CURRENT_TIMESTAMP' ] )
+			->addIndex( [ 'event_id', 'occurrence_date' ], [ 'unique' => true ] )
+			->addForeignKey( 'event_id', 'events', 'id', [ 'delete' => 'CASCADE', 'update' => 'CASCADE' ] )
+			->create();
+	}
+}

resources/database/migrate/20260619140002_add_occurrence_date_to_event_registrations.php

@@ -0,0 +1,35 @@
+<?php
+
+use Phinx\Migration\AbstractMigration;
+
+/**
+ * Add occurrence_date to event_registrations.
+ *
+ * For recurring events, a registration targets a specific occurrence so that
+ * capacity and duplicate-email checks are scoped per occurrence. For
+ * non-recurring events the column is NULL and behaviour is unchanged.
+ *
+ * NOTE: For EXISTING installations that already ran the
+ * create_event_registrations_table migration. New installations pick up the
+ * column from this migration when running migrations in order.
+ */
+class AddOccurrenceDateToEventRegistrations extends AbstractMigration
+{
+	/**
+	 * Add occurrence_date column to event_registrations table
+	 */
+	public function change()
+	{
+		$table = $this->table( 'event_registrations' );
+
+		if( !$table->hasColumn( 'occurrence_date' ) )
+		{
+			$table->addColumn( 'occurrence_date', 'datetime', [
+				'null' => true,
+				'after' => 'event_id'
+			] )
+				->addIndex( [ 'event_id', 'occurrence_date' ] )
+				->update();
+		}
+	}
+}