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]>
2026-07-24 12:06:37 -03:00
parent 36e7178158
commit 4328e8fb5f
29 changed files with 1514 additions and 48 deletions
@@ -0,0 +1,92 @@
+<?php
+declare(strict_types=1);
+
+namespace Unsupervised\Schedular\Tests\Unit\Payment;
+
+use Brain\Monkey\Functions;
+use Mockery;
+use Unsupervised\Schedular\Payment\PaymentDueMailer;
+use Unsupervised\Schedular\Tests\Unit\TestCase;
+
+class PaymentDueMailerTest extends TestCase
+{
+    private function student(string $email): \WP_User
+    {
+        $student             = Mockery::mock(\WP_User::class);
+        $student->user_email = $email;
+
+        return $student;
+    }
+
+    public function testReturnsFalseWithoutRecipient(): void
+    {
+        $items = [[ 'label' => 'x', 'amount' => 10.0, 'currency' => 'CAD', 'due_date' => '2026-07-14', 'etransfer_email' => null ]];
+
+        self::assertFalse((new PaymentDueMailer())->send($this->student(''), $items));
+    }
+
+    public function testReturnsFalseWithNoItems(): void
+    {
+        self::assertFalse((new PaymentDueMailer())->send($this->student('[email protected]'), []));
+    }
+
+    public function testConsolidatesItemsWithGrandTotal(): void
+    {
+        Functions\expect('wp_mail')
+            ->once()
+            ->with(
+                '[email protected]',
+                Mockery::type('string'),
+                Mockery::on(static function (string $body): bool {
+                    return str_contains($body, 'Piano')
+                        && str_contains($body, 'Jul 15, 2026')
+                        && str_contains($body, 'Guitar')
+                        && str_contains($body, 'Jul 22, 2026')
+                        && str_contains($body, '35.00')
+                        && str_contains($body, '40.00')
+                        // 35 + 40 grand total
+                        && str_contains($body, '75.00');
+                })
+            )
+            ->andReturn(true);
+
+        $items = [
+            [ 'label' => 'Piano', 'amount' => 35.0, 'currency' => 'CAD', 'due_date' => '2026-07-15', 'etransfer_email' => null ],
+            [ 'label' => 'Guitar', 'amount' => 40.0, 'currency' => 'CAD', 'due_date' => '2026-07-22', 'etransfer_email' => null ],
+        ];
+
+        self::assertTrue((new PaymentDueMailer())->send($this->student('[email protected]'), $items));
+    }
+
+    public function testIncludesReferenceWhenProvided(): void
+    {
+        Functions\expect('wp_mail')
+            ->once()
+            ->with(
+                '[email protected]',
+                Mockery::type('string'),
+                Mockery::on(static fn (string $body): bool => str_contains($body, 'REF12345'))
+            )
+            ->andReturn(true);
+
+        $items = [[ 'label' => 'Piano', 'amount' => 35.0, 'currency' => 'CAD', 'due_date' => '2026-07-15', 'etransfer_email' => null ]];
+
+        self::assertTrue((new PaymentDueMailer())->send($this->student('[email protected]'), $items, 'REF12345'));
+    }
+
+    public function testIncludesEtransferDestination(): void
+    {
+        Functions\expect('wp_mail')
+            ->once()
+            ->with(
+                '[email protected]',
+                Mockery::type('string'),
+                Mockery::on(static fn (string $body): bool => str_contains($body, '[email protected]'))
+            )
+            ->andReturn(true);
+
+        $items = [[ 'label' => 'Piano', 'amount' => 35.0, 'currency' => 'CAD', 'due_date' => '2026-07-15', 'etransfer_email' => '[email protected]' ]];
+
+        self::assertTrue((new PaymentDueMailer())->send($this->student('[email protected]'), $items));
+    }
+}