melabidi/alrahma_sunday_school_api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update api and add more features

Browse Source
This commit is contained in:
root
2026-06-04 02:24:41 -04:00
parent fa6c9519a0
commit 4e33882ac7
131 changed files with 34596 additions and 340 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/Unit/Services/Fees/FeeRefundCalculatorServiceTest.php
+248 -46
View File
@@ -16,54 +16,12 @@ class FeeRefundCalculatorServiceTest extends TestCase
public function test_calculate_refund_caps_at_total_paid(): void
{
DB::table('configuration')->insert([
['config_key' => 'school_year', 'config_value' => '2025-2026'],
['config_key' => 'refund_deadline', 'config_value' => '2025-02-01'],
['config_key' => 'weeks_study', 'config_value' => '8'],
['config_key' => 'last_school_day', 'config_value' => '2025-06-01'],
['config_key' => 'first_student_fee', 'config_value' => '350'],
['config_key' => 'second_student_fee', 'config_value' => '200'],
['config_key' => 'youth_fee', 'config_value' => '180'],
]);
$this->seedFeeConfig();
$this->seedClassSection(101, '3');
DB::table('classSection')->insert([
'id' => 1,
'class_id' => 1,
'class_section_id' => 101,
'class_section_name' => '3',
'semester' => 'Fall',
'school_year' => '2025-2026',
]);
$this->seedInvoiceAndPayment(99, 100.00);
DB::table('invoices')->insert([
'id' => 1,
'parent_id' => 99,
'invoice_number' => 'INV-1',
'total_amount' => 100.00,
'balance' => 0.00,
'paid_amount' => 100.00,
'issue_date' => '2025-01-01',
'school_year' => '2025-2026',
'semester' => 'Fall',
]);
DB::table('payments')->insert([
'id' => 1,
'parent_id' => 99,
'invoice_id' => 1,
'paid_amount' => 100.00,
'total_amount' => 100.00,
'balance' => 0.00,
'number_of_installments' => 1,
'payment_date' => '2025-01-10',
'school_year' => '2025-2026',
'status' => 'Paid',
]);
$service = new FeeRefundCalculatorService(
new FeeConfigService(),
new FeeStudentFeeService(new FeeGradeService(), new FeeConfigService())
);
$service = $this->makeService();
$result = $service->calculateRefund([
[
@@ -76,5 +34,249 @@ class FeeRefundCalculatorServiceTest extends TestCase
], 99);
$this->assertSame(100.0, $result['refund_amount']);
$this->assertSame(1, $result['withdrawn_students']);
$this->assertCount(1, $result['students']);
$this->assertTrue($result['students'][0]['eligible']);
$this->assertSame(350.0, $result['students'][0]['tuition_fee']);
}
public function test_returns_zero_when_parent_has_no_payments(): void
{
$this->seedFeeConfig();
$this->seedClassSection(101, '3');
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 1,
'class_section_id' => 101,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
'withdrawal_date' => '2025-01-15',
],
], 12345);
$this->assertSame(0.0, $result['refund_amount']);
$this->assertSame(0, $result['withdrawn_students']);
$this->assertSame([], $result['students']);
}
public function test_returns_zero_when_no_withdrawn_students(): void
{
$this->seedFeeConfig();
$this->seedClassSection(101, '3');
$this->seedInvoiceAndPayment(50, 500.00);
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 1,
'class_section_id' => 101,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
], 50);
$this->assertSame(0.0, $result['refund_amount']);
$this->assertSame(0, $result['withdrawn_students']);
}
/**
* Plan section 8 regression: each withdrawn student must carry the
* tuition fee that was assigned during fee calculation, otherwise the
* refund loop silently produces $0 for any student whose id does not
* round-trip through the lookup map.
*/
public function test_withdrawn_student_breakdown_carries_assigned_tuition_fee(): void
{
$this->seedFeeConfig();
$this->seedClassSection(201, '4');
$this->seedClassSection(202, '5');
$this->seedInvoiceAndPayment(77, 1000.00);
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 10,
'class_section_id' => 201,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
[
'student_id' => 11,
'class_section_id' => 202,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
'withdrawal_date' => '2025-01-15',
],
], 77);
$this->assertCount(1, $result['students']);
$withdrawn = $result['students'][0];
$this->assertSame(11, $withdrawn['student_id']);
// First regular = $350 (grade 4), additional = $200 (grade 5) -> the
// withdrawn 5th-grader is the additional regular student and must
// refund using $200, not $0 or a stale lookup value.
$this->assertSame(200.0, $withdrawn['tuition_fee']);
$this->assertSame('additional_regular', $withdrawn['fee_category']);
$this->assertGreaterThan(0, $withdrawn['refund_amount']);
$this->assertTrue($withdrawn['eligible']);
}
public function test_multi_student_family_only_refunds_withdrawn_students(): void
{
$this->seedFeeConfig();
$this->seedClassSection(301, '2');
$this->seedClassSection(302, '6');
$this->seedClassSection(303, '10');
$this->seedInvoiceAndPayment(88, 1000.00);
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 21,
'class_section_id' => 301,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
[
'student_id' => 22,
'class_section_id' => 302,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
'withdrawal_date' => '2025-01-15',
],
[
'student_id' => 23,
'class_section_id' => 303,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
'withdrawal_date' => '2025-01-15',
],
], 88);
$this->assertCount(2, $result['students']);
$this->assertSame(2, $result['withdrawn_students']);
$byStudent = [];
foreach ($result['students'] as $row) {
$byStudent[$row['student_id']] = $row;
}
$this->assertSame('additional_regular', $byStudent[22]['fee_category']);
$this->assertSame(200.0, $byStudent[22]['tuition_fee']);
$this->assertSame('youth', $byStudent[23]['fee_category']);
$this->assertSame(180.0, $byStudent[23]['tuition_fee']);
$sumPerStudent = round(array_sum(array_column($result['students'], 'refund_amount')), 2);
$this->assertSame($result['refund_amount'], $sumPerStudent);
}
public function test_withdrawal_after_deadline_is_not_eligible(): void
{
$this->seedFeeConfig();
$this->seedClassSection(401, '3');
$this->seedInvoiceAndPayment(33, 500.00);
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 1,
'class_section_id' => 401,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
'withdrawal_date' => '2025-03-01',
],
], 33);
$this->assertSame(0.0, $result['refund_amount']);
$this->assertCount(1, $result['students']);
$this->assertFalse($result['students'][0]['eligible']);
$this->assertSame('after_refund_deadline', $result['students'][0]['reason']);
}
public function test_missing_withdrawal_date_is_skipped_with_reason(): void
{
$this->seedFeeConfig();
$this->seedClassSection(501, '3');
$this->seedInvoiceAndPayment(44, 500.00);
$service = $this->makeService();
$result = $service->calculateRefund([
[
'student_id' => 1,
'class_section_id' => 501,
'enrollment_status' => 'withdrawn',
'admission_status' => 'accepted',
],
], 44);
$this->assertSame(0.0, $result['refund_amount']);
$this->assertSame('missing_withdrawal_date', $result['students'][0]['reason']);
}
private function makeService(): FeeRefundCalculatorService
{
return new FeeRefundCalculatorService(
new FeeConfigService(),
new FeeStudentFeeService(new FeeGradeService(), new FeeConfigService())
);
}
private function seedFeeConfig(): void
{
DB::table('configuration')->insert([
['config_key' => 'school_year', 'config_value' => '2025-2026'],
['config_key' => 'refund_deadline', 'config_value' => '2025-02-01'],
['config_key' => 'weeks_study', 'config_value' => '8'],
['config_key' => 'last_school_day', 'config_value' => '2025-06-01'],
['config_key' => 'first_student_fee', 'config_value' => '350'],
['config_key' => 'second_student_fee', 'config_value' => '200'],
['config_key' => 'youth_fee', 'config_value' => '180'],
]);
}
private function seedClassSection(int $sectionId, string $gradeName): void
{
DB::table('classSection')->insert([
'class_id' => $sectionId,
'class_section_id' => $sectionId,
'class_section_name' => $gradeName,
'semester' => 'Fall',
'school_year' => '2025-2026',
]);
}
private function seedInvoiceAndPayment(int $parentId, float $amount): void
{
$invoiceId = DB::table('invoices')->insertGetId([
'parent_id' => $parentId,
'invoice_number' => 'INV-' . $parentId,
'total_amount' => $amount,
'balance' => 0.00,
'paid_amount' => $amount,
'issue_date' => '2025-01-01',
'school_year' => '2025-2026',
'semester' => 'Fall',
]);
DB::table('payments')->insert([
'parent_id' => $parentId,
'invoice_id' => $invoiceId,
'paid_amount' => $amount,
'total_amount' => $amount,
'balance' => 0.00,
'number_of_installments' => 1,
'payment_date' => '2025-01-10',
'school_year' => '2025-2026',
'status' => 'Paid',
]);
}
}