Feature/admin venue IC telegram handle

backend/treeckle/treeckle/common/constants.py

@@ -13,6 +13,7 @@
 IC_CONTACT_NUMBER = "ic_contact_number"
 IC_EMAIL = "ic_email"
 IC_NAME = "ic_name"
+IC_TELEGRAM_HANDLE = "ic_telegram_handle"
 ID = "id"
 IS_ACTIVE = "is_active"
 NAME = "name"

backend/treeckle/venues/logic.py

@@ -13,6 +13,7 @@
     IC_NAME,
     IC_EMAIL,
     IC_CONTACT_NUMBER,
+    IC_TELEGRAM_HANDLE,
     FORM_FIELD_DATA,
     ORGANIZATION,
     EMAIL,
@@ -44,6 +45,7 @@ def venue_to_json(venue: Venue, full_details: bool = False) -> dict:
                 IC_NAME: venue.ic_name,
                 IC_EMAIL: venue.ic_email,
                 IC_CONTACT_NUMBER: venue.ic_contact_number,
+                IC_TELEGRAM_HANDLE: venue.ic_telegram_handle,
                 FORM_FIELD_DATA: venue.form_field_data,
                 SHORT_NOTICE_ENABLED: venue.short_notice_enabled,
                 SHORT_NOTICE_DAYS: venue.short_notice_days,
@@ -116,6 +118,7 @@ def create_venue(
     ic_name: str,
     ic_email: str,
     ic_contact_number: str,
+    ic_telegram_handle: str,
     form_field_data: list[dict],
     short_notice_settings: Optional[dict] = None,
 ) -> Venue:
@@ -132,6 +135,7 @@ def create_venue(
         ic_name=ic_name,
         ic_email=ic_email,
         ic_contact_number=ic_contact_number,
+        ic_telegram_handle=ic_telegram_handle,
         form_field_data=form_field_data,
         **(short_notice_settings or {}),
     )
@@ -148,6 +152,7 @@ def update_venue(
     ic_name: str,
     ic_email: str,
     ic_contact_number: str,
+    ic_telegram_handle: str,
     form_field_data: list[dict],
     short_notice_settings: Optional[dict] = None,
 ) -> Venue:
@@ -164,6 +169,7 @@ def update_venue(
             "ic_name": ic_name,
             "ic_email": ic_email,
             "ic_contact_number": ic_contact_number,
+            "ic_telegram_handle": ic_telegram_handle,
             "form_field_data": form_field_data,
             **(short_notice_settings or {}),
         },

backend/treeckle/venues/migrations/0019_venue_ic_telegram_handle.py

@@ -0,0 +1,28 @@
+# Generated by Django 4.2.20 on 2026-10-28 14:35
+
+import django.core.validators
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("venues", "0018_venue_short_notice_settings"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="venue",
+            name="ic_telegram_handle",
+            field=models.CharField(
+                blank=True,
+                max_length=32,
+                validators=[
+                    django.core.validators.RegexValidator(
+                        "^[A-Za-z0-9_]{5,32}$",
+                        "Telegram handle must be 5-32 letters, numbers or underscores.",
+                    )
+                ],
+            ),
+        ),
+    ]

backend/treeckle/venues/models.py

@@ -1,4 +1,8 @@
-from django.core.validators import MaxValueValidator, MinValueValidator
+from django.core.validators import (
+    MaxValueValidator,
+    MinValueValidator,
+    RegexValidator,
+)
 from django.db import models
 
 from organizations.models import Organization
@@ -38,6 +42,17 @@ class Venue(TimestampedModel):
     ic_name = models.CharField(max_length=255, blank=True)
     ic_email = models.EmailField(blank=True)
     ic_contact_number = models.CharField(max_length=50, blank=True)
+    # stored without the leading "@"; Telegram usernames are 5-32 letters, digits or underscores
+    ic_telegram_handle = models.CharField(
+        max_length=32,
+        blank=True,
+        validators=[
+            RegexValidator(
+                r"^[A-Za-z0-9_]{5,32}$",
+                "Telegram handle must be 5-32 letters, numbers or underscores.",
+            )
+        ],
+    )
     form_field_data = models.JSONField()
     short_notice_enabled = models.BooleanField(default=True)
     short_notice_days = models.PositiveIntegerField(

backend/treeckle/venues/serializers.py

@@ -20,6 +20,7 @@ class Meta:
             "ic_name",
             "ic_email",
             "ic_contact_number",
+            "ic_telegram_handle",
             "form_field_data",
             "short_notice_enabled",
             "short_notice_days",

backend/treeckle/venues/tests.py

@@ -29,6 +29,7 @@ def create_test_venue(self, **short_notice_settings):
             ic_name="",
             ic_email="",
             ic_contact_number="",
+            ic_telegram_handle="",
             form_field_data=[],
             short_notice_settings=short_notice_settings,
         )
@@ -53,6 +54,7 @@ def test_update_changes_only_given_settings(self):
             ic_name="",
             ic_email="",
             ic_contact_number="",
+            ic_telegram_handle="",
             form_field_data=[],
             short_notice_settings={"short_notice_enabled": False},
         )
@@ -67,6 +69,20 @@ def test_serializer_rejects_invalid_days(self):
             self.assertFalse(serializer.is_valid())
             self.assertIn("short_notice_days", serializer.errors)
 
+    def test_serializer_validates_telegram_handle(self):
+        for handle in ("venue_ic", ""):
+            serializer = VenueSerializer(
+                data={**VENUE_DATA, "ic_telegram_handle": handle}
+            )
+            self.assertTrue(serializer.is_valid(), serializer.errors)
+
+        for handle in ("@venue_ic", "abc", "has space", "a" * 33):
+            serializer = VenueSerializer(
+                data={**VENUE_DATA, "ic_telegram_handle": handle}
+            )
+            self.assertFalse(serializer.is_valid())
+            self.assertIn("ic_telegram_handle", serializer.errors)
+
     def test_serializer_omits_missing_settings(self):
         serializer = VenueSerializer(data=VENUE_DATA)
 

backend/treeckle/venues/views.py

@@ -314,6 +314,7 @@ def delete(
                         "ic_name": "John Manager",
                         "ic_email": "john.manager@university.edu",
                         "ic_contact_number": "+65 9123 4567",
+                        "ic_telegram_handle": "venue_ic",
                         "form_field_data": [
                             {
                                 "field_name": "Purpose",
@@ -351,6 +352,7 @@ def delete(
                     "ic_name": "Library Staff",
                     "ic_email": "library@university.edu",
                     "ic_contact_number": "+65 9876 5432",
+                    "ic_telegram_handle": "venue_ic",
                     "form_field_data": [
                         {
                             "field_name": "Number of Students",
@@ -424,6 +426,7 @@ def post(self, request, requester: User):
                 ic_name=validated_data.get("ic_name", ""),
                 ic_email=validated_data.get("ic_email", ""),
                 ic_contact_number=validated_data.get("ic_contact_number", ""),
+                ic_telegram_handle=validated_data.get("ic_telegram_handle", ""),
                 form_field_data=validated_data.get("form_field_data", []),
                 short_notice_settings=get_short_notice_settings(validated_data),
             )
@@ -459,6 +462,7 @@ def post(self, request, requester: User):
                     "ic_name": "Events Manager",
                     "ic_email": "events.manager@university.edu",
                     "ic_contact_number": "+65 9111 2222",
+                    "ic_telegram_handle": "venue_ic",
                     "form_field_data": [
                         {
                             "field_name": "Event Type",
@@ -515,6 +519,7 @@ def post(self, request, requester: User):
                     "ic_name": "New Events Manager",
                     "ic_email": "new.events@university.edu",
                     "ic_contact_number": "+65 9333 4444",
+                    "ic_telegram_handle": "venue_ic",
                     "form_field_data": [
                         {
                             "field_name": "Event Type",
@@ -566,6 +571,7 @@ def post(self, request, requester: User):
                     "ic_name": "Events Manager",
                     "ic_email": "events@university.edu",
                     "ic_contact_number": "+65 9333 4444",
+                    "ic_telegram_handle": "venue_ic",
                     "form_field_data": [],
                     "organization": {"id": 1, "name": "University College"},
                 },
@@ -616,6 +622,7 @@ def put(self, request, requester: User, venue: Venue):
                 ic_name=validated_data.get("ic_name", ""),
                 ic_email=validated_data.get("ic_email", ""),
                 ic_contact_number=validated_data.get("ic_contact_number", ""),
+                ic_telegram_handle=validated_data.get("ic_telegram_handle", ""),
                 form_field_data=validated_data.get("form_field_data", []),
                 short_notice_settings=get_short_notice_settings(validated_data),
             )

frontend/src/components/booking-creation-help-button/booking-creation-help-button.tsx

@@ -13,6 +13,7 @@ function BookingCreationHelpButton() {
     icName,
     icEmail,
     icContactNumber,
+    icTelegramHandle,
   } = selectedVenue?.venueFormProps ?? {};
 
   const [showModal, hideModal] = useModal(
@@ -26,7 +27,7 @@ function BookingCreationHelpButton() {
           <LinkifyTextViewer>
             <h3>For any queries, do contact:</h3>
 
-            {icName || icEmail || icContactNumber ? (
+            {icName || icEmail || icContactNumber || icTelegramHandle ? (
               <>
                 {icName && (
                   <p>
@@ -43,6 +44,18 @@ function BookingCreationHelpButton() {
                     <strong>Contact Number:</strong> {icContactNumber}
                   </p>
                 )}
+                {icTelegramHandle && (
+                  <p>
+                    <strong>Telegram:</strong>{" "}
+                    <a
+                      href={`https://t.me/${icTelegramHandle}`}
+                      target="_blank"
+                      rel="noopener noreferrer"
+                    >
+                      @{icTelegramHandle}
+                    </a>
+                  </p>
+                )}
               </>
             ) : (
               <p>
@@ -53,7 +66,7 @@ function BookingCreationHelpButton() {
         }
       />
     ),
-    [venueName, icName, icEmail, icContactNumber],
+    [venueName, icName, icEmail, icContactNumber, icTelegramHandle],
   );
 
   return (

frontend/src/components/venue-details-form/venue-details-form.tsx

@@ -12,6 +12,7 @@ import {
   IC_CONTACT_NUMBER,
   IC_EMAIL,
   IC_NAME,
+  IC_TELEGRAM_HANDLE,
   LABEL,
   NAME,
   PHONE_NUM_REGEX,
@@ -21,6 +22,7 @@ import {
   SHORT_NOTICE_ENABLED,
   SHORT_NOTICE_MESSAGE,
   SHORT_NOTICE_TITLE,
+  TELEGRAM_HANDLE_REGEX,
   TYPE,
 } from "../../constants";
 import {
@@ -68,6 +70,16 @@ const SCHEMA = yup.object().shape({
     .trim()
     .matches(PHONE_NUM_REGEX, "Input must be a valid phone number")
     .notRequired(),
+  [IC_TELEGRAM_HANDLE]: yup
+    .string()
+    .trim()
+    // admins may type "@handle"; it is stored without the "@"
+    .transform((value?: string) => value?.replace(/^@/, ""))
+    .matches(TELEGRAM_HANDLE_REGEX, {
+      message: "Handle must be 5-32 letters, numbers or underscores",
+      excludeEmptyString: true,
+    })
+    .notRequired(),
   [BOOKING_FORM_FIELDS]: yup
     .array(
       yup
@@ -170,6 +182,7 @@ const DEFAULT_VALUES: VenueFormProps = {
   [IC_NAME]: "",
   [IC_EMAIL]: "",
   [IC_CONTACT_NUMBER]: "",
+  [IC_TELEGRAM_HANDLE]: "",
   [BOOKING_FORM_FIELDS]: [],
   ...DEFAULT_SHORT_NOTICE_WARNING,
 };
@@ -267,6 +280,12 @@ function VenueDetailsForm({
                 name={IC_CONTACT_NUMBER}
                 type="tel"
               />
+
+              <FormField
+                label="Venue IC Telegram Handle"
+                name={IC_TELEGRAM_HANDLE}
+                placeholder="@username"
+              />
             </Form.Group>
           </Segment>
 

frontend/src/constants/index.ts

@@ -34,6 +34,7 @@ export const FORM_RESPONSE_DATA = "formResponseData";
 export const IC_CONTACT_NUMBER = "icContactNumber";
 export const IC_EMAIL = "icEmail";
 export const IC_NAME = "icName";
+export const IC_TELEGRAM_HANDLE = "icTelegramHandle";
 export const ID = "id";
 export const IDS = "ids";
 export const IMAGE = "image";
@@ -47,6 +48,7 @@ export const ORGANIZED_BY = "organizedBy";
 export const PHONE_NUM_REGEX =
   /^(\s*|(\+?\d{0,4})?\s?-?\s?(\(?\d{3}\)?)\s?-?\s?(\(?\d{3}\)?)\s?-?\s?(\(?\d{4}\)?)?)$/;
 export const PLACEHOLDER = "placeholder";
+export const TELEGRAM_HANDLE_REGEX = /^[A-Za-z0-9_]{5,32}$/;
 export const POSITIVE_NUM_REGEX = /^(\s*|[1-9]\d*)$/;
 export const REFRESH = "refresh";
 export const REQUIRED = "required";

frontend/src/custom-hooks/api/venues-api.ts

@@ -38,6 +38,7 @@ function parseVenueFormProps(venueFormProps: VenueFormProps): VenuePostData {
     icName,
     icEmail,
     icContactNumber,
+    icTelegramHandle,
     bookingFormFields,
     shortNoticeEnabled,
     shortNoticeDays,
@@ -51,6 +52,7 @@ function parseVenueFormProps(venueFormProps: VenueFormProps): VenuePostData {
     icName,
     icEmail,
     icContactNumber,
+    icTelegramHandle,
     formFieldData: bookingFormFields ?? [],
     shortNoticeEnabled,
     shortNoticeDays,
@@ -72,6 +74,7 @@ function parseVenueData(venueData: VenueData): VenueViewProps {
     icName = "",
     icEmail = "",
     icContactNumber = "",
+    icTelegramHandle = "",
     formFieldData,
     organization = "",
     shortNoticeEnabled = DEFAULT_SHORT_NOTICE_WARNING.shortNoticeEnabled,
@@ -92,6 +95,7 @@ function parseVenueData(venueData: VenueData): VenueViewProps {
       icName,
       icEmail,
       icContactNumber,
+      icTelegramHandle,
       bookingFormFields: formFieldData,
       shortNoticeEnabled,
       shortNoticeDays,

frontend/src/types/venues.ts

@@ -8,6 +8,7 @@ import {
   IC_CONTACT_NUMBER,
   IC_EMAIL,
   IC_NAME,
+  IC_TELEGRAM_HANDLE,
   LABEL,
   NAME,
   ORGANIZATION,
@@ -34,6 +35,7 @@ export type VenuePostData = {
   [IC_NAME]: string;
   [IC_EMAIL]: string;
   [IC_CONTACT_NUMBER]: string;
+  [IC_TELEGRAM_HANDLE]: string;
   [FORM_FIELD_DATA]: BookingFormFieldProps[];
 } & ShortNoticeWarningProps;
 
@@ -74,6 +76,7 @@ export type VenueFormProps = {
   [IC_NAME]: string;
   [IC_EMAIL]: string;
   [IC_CONTACT_NUMBER]: string;
+  [IC_TELEGRAM_HANDLE]: string;
   [BOOKING_FORM_FIELDS]?: BookingFormFieldProps[];
 } & ShortNoticeWarningProps;