Booking — Codebase flow

This page traces API → service → validation for normal booking. Key files:

• Controller: Tux/src/Tux.Api/Controllers/Consumer/ConsumerBookingController.cs
• Service: Tux/src/Services/Tux.Service/BookingService.cs
• Helper: Tux/src/Services/Tux.Service/Helpers/BookingHelper.cs

Overall

Flow 1 — Create order (cart)

• API: CreateBookingOrder.
• Creates TermBookingOrder + TermBookingOrderLine (status Created).
• Validates: valid attendee/term product, org settings, measurement (height/weight) if enabled, double-booking (unless IgnoreDoubleBooking).
• Does not create Billing yet.

Flow 2 — Submit

• API: SubmitBookingOrders → BookingService.SubmitBookingAsync.
• Accepts only order types Booking and TrialSession.
• Creates Billing (financial summary); validates Pay Later eligibility (via BookingHelper).
• May arm an auto-cancel timeout if the payment option requires one (PayNow/Deposit/Direct Debit).
• Final double-booking check. Status → Submitted. Does not create the Invoice yet.
• Returns the complete set of TermBookingOrderIds for the later confirm (full or attendance), so the UI does not have to guess.

Flow 3 — Confirm / Quote

• API: ConfirmBookingOrders → BookingService.ConfirmBookingAsync (or GenerateQuotesAsync/AcceptQuoteAsync).
• Creates TermBooking from TermBookingOrder; copies Line/Extra/Discount.
• Applies discounts, computes totals (see Discount rule).
• Creates TermAttendance per session; triggers billing to generate invoices.
• Status → Approved (or Attendance_Approved, or Quote).
• Action type Confirm_Attendance (1050) → confirms attendance only, status Attendance_Approved, no full confirm; used for admin Submit & Confirm Attendance, does not open Billing Difference.
• Edited booking: confirm builds a shared BookingConfirmationPlan from TermBookingOrderIds before applying real side effects (invariant INV-BOOK-23).
  • BookingConfirmationPlan is the projection source of truth from order → booking (header/line/extra/discount); preview code does not duplicate this projection algorithm.
  • Edit confirm recreates lines and replaces TermAttendance because price/discount changed → keeps the old roll call (status, times, sign-in/out, RollCallHistory) when the old attendance has RollCallStatusId > 0 (invariant INV-BOOK-27); a retry does not duplicate history.

Flow 4 — Cancel

• API: DeleteBookingOrdersAsync → BookingService.CancelBookingAsync.
• Status → Canceled; reverses invoices via credit note; deactivates TermAttendance (even if some lines previously left Approved).

Main validation

Type	Where
Capacity	TermProduct.Capacity, TermProgramSetCapacity; checked at create/submit/confirm.
Double-booking	Attendee × session overlap on date/time; bypass via IgnoreDoubleBooking.
Measurement	Height/weight vs course config; admin overrides each rule.
Lock & pending	Locked booking / conflicting pending order → edit blocked.
Discount eligibility	DiscountEligibilityService + BookingHelper.ApplyDiscount.

Next: Discount rule.