feat: add recurring bookings feature with related handlers and services

- Introduced recurring booking groups with the ability to create and cancel them.
- Added database migrations for recurring bookings, including new tables and relationships.
- Implemented handlers for creating and canceling recurring bookings in the admin booking module.
- Enhanced existing booking services to support recurring bookings logic.
- Updated API contract to include new schemas for recurring bookings.
- Refactored existing code for improved readability and maintainability.

apps/backend/prisma/court.prisma

@@ -15,6 +15,11 @@ enum CourtBookingStatus {
   NOSHOW
 }
 
+enum RecurringBookingGroupStatus {
+  ACTIVE
+  CANCELLED
+}
+
 model Sport {
   id        String   @id @db.Uuid
   name      String   @unique
@@ -44,6 +49,7 @@ model Court {
   priceRules          CourtPriceRule[]
   bookings            CourtBooking[]
   maintenances        CourtMaintenance[]
+  recurringGroups     RecurringBookingGroup[]
 
   @@index([complexId])
   @@index([sportId])
@@ -95,23 +101,26 @@ model CourtPriceRule {
 }
 
 model CourtBooking {
-  id            String              @id @db.Uuid
-  bookingCode   String              @unique @map("booking_code") @db.VarChar(8)
-  courtId       String              @map("court_id") @db.Uuid
-  bookingDate   DateTime            @map("booking_date") @db.Date
-  startTime     String              @map("start_time") @db.VarChar(5)
-  endTime       String              @map("end_time") @db.VarChar(5)
-  customerName  String              @map("customer_name") @db.VarChar(120)
-  customerPhone String              @map("customer_phone") @db.VarChar(30)
-  customerEmail String              @map("customer_email") @db.VarChar(254)
-  status        CourtBookingStatus  @default(CONFIRMED)
-  createdAt     DateTime            @default(now()) @map("created_at")
-  updatedAt     DateTime            @updatedAt @map("updated_at")
-  court         Court               @relation(fields: [courtId], references: [id], onDelete: Cascade)
+  id               String                       @id @db.Uuid
+  bookingCode      String                       @unique @map("booking_code") @db.VarChar(8)
+  courtId          String                       @map("court_id") @db.Uuid
+  bookingDate      DateTime                     @map("booking_date") @db.Date
+  startTime        String                       @map("start_time") @db.VarChar(5)
+  endTime          String                       @map("end_time") @db.VarChar(5)
+  customerName     String                       @map("customer_name") @db.VarChar(120)
+  customerPhone    String                       @map("customer_phone") @db.VarChar(30)
+  customerEmail    String                       @map("customer_email") @db.VarChar(254)
+  status           CourtBookingStatus           @default(CONFIRMED)
+  recurringGroupId String?                      @map("recurring_group_id") @db.Uuid
+  createdAt        DateTime                     @default(now()) @map("created_at")
+  updatedAt        DateTime                     @updatedAt @map("updated_at")
+  court            Court                        @relation(fields: [courtId], references: [id], onDelete: Cascade)
+  recurringGroup   RecurringBookingGroup?       @relation(fields: [recurringGroupId], references: [id])
 
   @@unique([courtId, bookingDate, startTime])
   @@index([courtId, bookingDate])
   @@index([bookingDate])
+  @@index([recurringGroupId])
   @@map("court_bookings")
 }
 
@@ -132,3 +141,28 @@ model CourtBookingLog {
   @@map("court_booking_logs")
   @@index([courtId, newStatus])
 }
+
+model RecurringBookingGroup {
+  id            String                         @id @db.Uuid
+  complexId     String                         @map("complex_id") @db.Uuid
+  courtId       String                         @map("court_id") @db.Uuid
+  startTime     String                         @map("start_time") @db.VarChar(5)
+  endTime       String                         @map("end_time") @db.VarChar(5)
+  dayOfWeek     DayOfWeek                      @map("day_of_week")
+  startDate     DateTime                       @map("start_date") @db.Date
+  endDate       DateTime?                      @map("end_date") @db.Date
+  status        RecurringBookingGroupStatus     @default(ACTIVE)
+  customerName  String                         @map("customer_name") @db.VarChar(120)
+  customerPhone String                         @map("customer_phone") @db.VarChar(30)
+  customerEmail String                         @map("customer_email") @db.VarChar(254)
+  createdAt     DateTime                       @default(now()) @map("created_at")
+  updatedAt     DateTime                       @updatedAt @map("updated_at")
+  court         Court                          @relation(fields: [courtId], references: [id], onDelete: Cascade)
+  complex       Complex                        @relation(fields: [complexId], references: [id], onDelete: Cascade)
+  bookings      CourtBooking[]
+
+  @@index([complexId])
+  @@index([courtId])
+  @@index([status])
+  @@map("recurring_booking_groups")
+}