Credit students for cancelled paid lessons

Cancelling a lesson that was already paid for now credits the student that money instead of leaving it as a manual refund, and the daily scheduled-billing scan applies any available credit against their due charges before emailing the notice. - New us_credits ledger + us_payments.credit_applied column (Payment::netDue). - PaymentService::creditForCancelledLesson issues a per-lesson share of the covering payment's total; wired into all three cancel paths (student self-cancel, instructor status update, admin student-detail cancel). - PaymentService::applyCredits draws credit down FIFO across a run's charges, marking a fully-covered charge paid-by-credit; the notice shows the credit applied and reduced total, and the admin queue shows net due. - Student detail page shows a student's credit balance and history. Ships as part of the unreleased 1.2.0 (same release as scheduled billing). Tests: composer test (585), composer lint, composer cs all pass. Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-07-24 15:32:20 -03:00
parent 3f9aef7746
commit e8e66eef3c
30 changed files with 1210 additions and 80 deletions
@@ -73,6 +73,28 @@ class PaymentTest extends TestCase
        self::assertSame(100.00, $payment->total());
    }

+    public function testNetDueSubtractsAppliedCredit(): void
+    {
+        $payment = new Payment(5, 3, Payment::REG_LESSON, 12, 100.00, taxRate: 13.0, taxAmount: 13.00, creditApplied: 40.00);
+
+        self::assertSame(113.00, $payment->total());
+        self::assertSame(73.00, $payment->netDue());
+    }
+
+    public function testNetDueFloorsAtZeroWhenCreditExceedsTotal(): void
+    {
+        $payment = new Payment(5, 3, Payment::REG_LESSON, 12, 30.00, creditApplied: 50.00);
+
+        self::assertSame(0.0, $payment->netDue());
+    }
+
+    public function testNetDueEqualsTotalWithoutCredit(): void
+    {
+        $payment = new Payment(5, 3, Payment::REG_LESSON, 12, 30.00);
+
+        self::assertSame(30.00, $payment->netDue());
+    }
+
    public function testToSummaryArrayContainsOnlyClientFacingFields(): void
    {
        $summary = (new Payment(5, 3, Payment::REG_LESSON, 12, 35.00, id: 7))->toSummaryArray();