Facility booking-mode redesign, multi-plan subscriptions, and Classes

Implements the facility-classes-booking-dashboard plan (backend): - Facility.BookingMode (single Scheduled/AdHoc choice) replaced with independent SupportsClasses/SupportsBooking flags, so one facility can run a class and accept walk-in bookings; a running class now blocks walk-in booking for its window on both create and reschedule. - CustomerPlan.GrantsGymAccess + CustomerPlanClass join table let a customer hold one gym-access plan plus any number of class-only plans. Replaced the old single-subscription resolution (GetActiveSubscriptionByCustomerId/HasAnyActiveSubscriptionAsync) with gym-access-aware and class-aware resolvers across booking creation/cancellation, plan assignment, and customer self-service. Fixed ChangeMembershipPlan/renewal plan-changes, which resolved "the subscription to replace" by most-recent-created and would have deactivated a member's class subscription instead of their gym one. - New FacilityClass model: recurring class definitions (Daily/Weekly/ Monthly/Custom) with lazy occurrence generation (8-week horizon, race-safe via a unique index) and proper unlimited-capacity handling. "Mark not held" replaces the old bare-cancel: cascades to cancel and refund every confirmed booking on the occurrence through the same core CancelBooking uses, and frees the slot for walk-in booking. Scheduling conflicts (a walk-in booking now overlapping a class) are surfaced for staff to resolve via the existing Reschedule flow. - Renamed the pre-existing "AdHoc" booking-mode terminology to "WalkIn" throughout (routes, methods, DTOs, the stored BookingMode value) for a clearer, simpler name. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-10-09 14:26:59 +05:30
parent 1a502767ba
commit 5d711bd13e
38 changed files with 1437 additions and 226 deletions
@@ -0,0 +1,97 @@
+using Fitness_core_BE.DTOs.Facility;
+using Fitness_core_BE.Helpers;
+using Fitness_core_BE.Interfaces.Services;
+using Fitness_core_BE.Models.IOs;
+using Microsoft.AspNetCore.Mvc;
+using static Fitness_core_BE.Helpers.JwtMiddleware;
+using static Fitness_core_BE.Helpers.ApiResponseHelper;
+
+namespace Fitness_core_BE.Controllers
+{
+    // Recurring class definitions + their occurrences -- the Classes tab's entry point. Gated on
+    // "memberships" (same as FacilityController's own mutations) since class setup is staff/
+    // membership configuration, not a booking-time read. The existing GET api/client/facilities/
+    // sessions* ("bookings"-gated) stays separate for the Booking Dashboard calendar.
+    [ApiController]
+    [Route("api/client/facility-classes")]
+    public class FacilityClassController(IClassService classService, IFacilityService facilityService) : ControllerBase
+    {
+        private readonly IClassService _classService = classService;
+        private readonly IFacilityService _facilityService = facilityService;
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpGet("")]
+        public async Task<ActionResult<ApiResponse<object>>> GetFacilityClasses([FromQuery] bool includeInactive = false)
+            => Response(await _classService.GetFacilityClasses(new { includeInactive }, HttpContext));
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpPost("")]
+        public async Task<ActionResult<ApiResponse<object>>> CreateFacilityClass([FromBody] CreateFacilityClassRequest request)
+            => Response(await _classService.CreateFacilityClass(new
+            {
+                facilityId = request.FacilityId,
+                name = request.Name,
+                description = request.Description,
+                recurrenceType = request.RecurrenceType,
+                startTimeOfDay = request.StartTimeOfDay,
+                durationMinutes = request.DurationMinutes,
+                weekDaysMask = request.WeekDaysMask,
+                monthDays = request.MonthDays,
+                seriesStartDate = request.SeriesStartDate?.ToString("o"),
+                seriesEndDate = request.SeriesEndDate?.ToString("o"),
+                capacity = request.Capacity,
+                isUnlimitedCapacity = request.IsUnlimitedCapacity,
+                customOccurrences = request.CustomOccurrences?.Select(o => new { startTime = o.StartTime.ToString("o"), durationMinutes = o.DurationMinutes })
+            }, HttpContext));
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpPut("{id:guid}")]
+        public async Task<ActionResult<ApiResponse<object>>> UpdateFacilityClass(Guid id, [FromBody] UpdateFacilityClassRequest request)
+        {
+            var payload = new Dictionary<string, object?> { ["facilityClassId"] = id };
+            if (request.Name != null) payload["name"] = request.Name;
+            if (request.Description != null) payload["description"] = request.Description;
+            if (request.RecurrenceType != null) payload["recurrenceType"] = request.RecurrenceType;
+            if (request.StartTimeOfDay != null) payload["startTimeOfDay"] = request.StartTimeOfDay;
+            if (request.DurationMinutes.HasValue) payload["durationMinutes"] = request.DurationMinutes.Value;
+            if (request.WeekDaysMask.HasValue) payload["weekDaysMask"] = request.WeekDaysMask.Value;
+            if (request.MonthDays != null) payload["monthDays"] = request.MonthDays;
+            if (request.SeriesStartDate.HasValue) payload["seriesStartDate"] = request.SeriesStartDate.Value.ToString("o");
+            if (request.SeriesEndDate.HasValue) payload["seriesEndDate"] = request.SeriesEndDate.Value.ToString("o");
+            if (request.Capacity.HasValue) payload["capacity"] = request.Capacity.Value;
+            if (request.IsUnlimitedCapacity.HasValue) payload["isUnlimitedCapacity"] = request.IsUnlimitedCapacity.Value;
+            if (request.IsActive.HasValue) payload["isActive"] = request.IsActive.Value;
+            if (request.AddCustomOccurrences != null)
+                payload["addCustomOccurrences"] = request.AddCustomOccurrences.Select(o => new { startTime = o.StartTime.ToString("o"), durationMinutes = o.DurationMinutes });
+
+            return Response(await _classService.UpdateFacilityClass(payload, HttpContext));
+        }
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpGet("{id:guid}/occurrences")]
+        public async Task<ActionResult<ApiResponse<object>>> GetOccurrences(Guid id, [FromQuery] bool includeCancelled = false)
+            => Response(await _classService.GetOccurrences(new { facilityClassId = id, includeCancelled }, HttpContext));
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpPost("{id:guid}/occurrences/{occurrenceId:guid}/not-held")]
+        public async Task<ActionResult<ApiResponse<object>>> MarkOccurrenceNotHeld(Guid id, Guid occurrenceId, [FromBody] MarkNotHeldRequest? request)
+            => Response(await _facilityService.CancelFacilitySession(new { facilitySessionId = occurrenceId, reason = request?.Reason }, HttpContext));
+
+        [CustomMiddleware]
+        [TenantResolution]
+        [RequiresPermission("memberships")]
+        [HttpGet("scheduling-conflicts")]
+        public async Task<ActionResult<ApiResponse<object>>> GetSchedulingConflicts()
+            => Response(await _classService.GetSchedulingConflicts(new { }, HttpContext));
+    }
+}