Add weekly and monthly scheduled billing for offerings

Offerings can now bill weekly (a pending payment 24h before each lesson)
or monthly (one payment on the 1st for that month's lessons), alongside
one-time and full-term. Applies to both private lessons and group classes.

- Offering: new `weekly`/`monthly` billing modes + `isScheduledBilling()`
- Booking/enrolment defer payment for scheduled modes; a single lesson
  booked after its due date has passed (e.g. an add-on in an already-billed
  month) is charged at booking instead
- ScheduledBillingRunner: daily WP-Cron scan generates due payments across
  four cases (private/group × weekly/monthly), deduped via lesson.payment_id
  and payments.period_key
- PaymentDueMailer: one consolidated itemised email per student per scan
- Notice batch: payments emailed together share a reference; the admin
  Payments queue groups them with a lump-sum total for e-transfer reconciliation
- Cancellation never voids a scheduled payment (Payment::isScheduled())
- Schema: us_payments gains due_date, period_key, notice_batch; USC_VERSION 1.2.0

composer test, composer lint, composer cs all pass.

Co-Authored-By: Claude Opus 4.8 <[email protected]>

src/Payment/PaymentController.php

@@ -33,22 +33,59 @@ class PaymentController {
 			}
 		}
 
-		$rows = array_map(
-			static function ( Payment $payment ): array {
-				$student = get_userdata( $payment->studentId );
-
-				return [
-					'id'              => (int) $payment->id,
-					'student'         => $student ? $student->display_name : (string) $payment->studentId,
-					'amount'          => number_format( $payment->amount, 2 ) . ' ' . $payment->currency,
-					'method'          => $payment->method,
-					'for'             => $payment->registrationType . ' #' . $payment->registrationId,
-					'etransfer_email' => (string) $payment->etransferEmail,
-				];
-			},
-			$this->payments->findPending()
-		);
+		$groups = $this->groupPending( $this->payments->findPending() );
 
 		include USC_PLUGIN_DIR . 'templates/admin/payments.php';
 	}
+
+	/**
+	 * Group pending payments by their shared notice batch, so payments the daily
+	 * scan emailed a student together (and which a single lump-sum e-transfer
+	 * covers) are shown as one group with a combined total. Payments with no batch
+	 * — legacy at-registration e-transfers — are each their own single-item group.
+	 *
+	 * @param list<Payment> $pending
+	 * @return list<array{reference: string, is_group: bool, total: string, rows: list<array{id: int, student: string, amount: string, method: string, for: string, etransfer_email: string}>}>
+	 */
+	private function groupPending( array $pending ): array {
+		$groups = [];
+
+		foreach ( $pending as $payment ) {
+			$batch = (string) $payment->noticeBatch;
+			$key   = '' !== $batch ? 'b:' . $batch : 's:' . (string) $payment->id;
+
+			if ( ! isset( $groups[ $key ] ) ) {
+				$groups[ $key ] = [
+					'reference' => $batch,
+					'currency'  => $payment->currency,
+					'total_raw' => 0.0,
+					'rows'      => [],
+				];
+			}
+
+			$student = get_userdata( $payment->studentId );
+
+			$groups[ $key ]['total_raw'] += $payment->total();
+			$groups[ $key ]['rows'][]     = [
+				'id'              => (int) $payment->id,
+				'student'         => $student ? $student->display_name : (string) $payment->studentId,
+				'amount'          => number_format( $payment->amount, 2 ) . ' ' . $payment->currency,
+				'method'          => $payment->method,
+				'for'             => $payment->registrationType . ' #' . $payment->registrationId,
+				'etransfer_email' => (string) $payment->etransferEmail,
+			];
+		}
+
+		return array_values(
+			array_map(
+				static fn( array $group ): array => [
+					'reference' => $group['reference'],
+					'is_group'  => count( $group['rows'] ) > 1,
+					'total'     => number_format( $group['total_raw'], 2 ) . ' ' . $group['currency'],
+					'rows'      => $group['rows'],
+				],
+				$groups
+			)
+		);
+	}
 }