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/Billing/BalanceCalculationServiceTest.php
+238
View File
@@ -0,0 +1,238 @@
<?php
namespace Tests\Unit\Services\Billing;
use App\Services\Billing\BalanceCalculationService;
use App\Services\Billing\BillingTotalsService;
use App\Services\Fees\FeeConfigService;
use App\Services\Fees\FeeGradeService;
use App\Services\Fees\FeeStudentFeeService;
use App\Services\Fees\TuitionCalculationService;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Tests\TestCase;
class BalanceCalculationServiceTest extends TestCase
{
use RefreshDatabase;
public function test_calculate_family_account_applies_balance_formula(): void
{
$this->seedFeeConfig();
$this->seedClassSection(101, '2');
$this->seedClassSection(102, '5');
$parentId = 10;
$invoiceId = $this->seedInvoice($parentId, 1000.00);
DB::table('payments')->insert([
'parent_id' => $parentId,
'invoice_id' => $invoiceId,
'paid_amount' => 500.00,
'total_amount' => 500.00,
'balance' => 0.00,
'number_of_installments' => 1,
'payment_date' => '2025-01-10',
'school_year' => '2025-2026',
'status' => 'Paid',
]);
DB::table('discount_usages')->insert([
'voucher_id' => 1,
'invoice_id' => $invoiceId,
'parent_id' => $parentId,
'discount_amount' => 80.00,
'school_year' => '2025-2026',
'semester' => 'Fall',
]);
DB::table('additional_charges')->insert([
'parent_id' => $parentId,
'invoice_id' => $invoiceId,
'school_year' => '2025-2026',
'semester' => 'Fall',
'charge_type' => 'add',
'title' => 'Books',
'amount' => 100.00,
'status' => 'applied',
]);
DB::table('events')->insert([
'id' => 1,
'event_name' => 'Field Trip',
'amount' => 25.00,
'expiration_date' => '2025-06-01',
]);
DB::table('event_charges')->insert([
'event_id' => 1,
'parent_id' => $parentId,
'student_id' => 2,
'charged' => 50.00,
'school_year' => '2025-2026',
'semester' => 'Fall',
]);
DB::table('refunds')->insert([
'parent_id' => $parentId,
'school_year' => '2025-2026',
'invoice_id' => $invoiceId,
'refund_amount' => 30.00,
'refund_paid_amount' => 30.00,
'status' => 'Paid',
'semester' => 'Fall',
]);
$service = $this->makeService();
$result = $service->calculateFamilyAccount([
[
'student_id' => 1,
'class_section_id' => 101,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
[
'student_id' => 2,
'class_section_id' => 102,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
], $parentId);
$this->assertSame($parentId, $result['parent_id']);
$this->assertSame(550.0, $result['charges']['tuition']);
$this->assertSame(100.0, $result['charges']['extra_charges']);
$this->assertSame(50.0, $result['charges']['event_charges']);
$this->assertSame(700.0, $result['charges']['total']);
$this->assertSame(500.0, $result['payments']);
$this->assertSame(80.0, $result['credits']['total']);
$this->assertSame(30.0, $result['refunds_applied']);
$this->assertSame(90.0, $result['remaining_balance']);
$this->assertSame(0.0, $result['account_credit']);
$this->assertCount(2, $result['students']);
}
public function test_overpayment_records_account_credit(): void
{
$this->seedFeeConfig();
$this->seedClassSection(201, '3');
$parentId = 20;
$invoiceId = $this->seedInvoice($parentId, 500.00);
DB::table('payments')->insert([
'parent_id' => $parentId,
'invoice_id' => $invoiceId,
'paid_amount' => 500.00,
'total_amount' => 500.00,
'balance' => 0.00,
'number_of_installments' => 1,
'payment_date' => '2025-01-10',
'school_year' => '2025-2026',
'status' => 'Paid',
]);
$service = $this->makeService();
$result = $service->calculateFamilyAccount([
[
'student_id' => 5,
'class_section_id' => 201,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
], $parentId);
$this->assertSame(350.0, $result['charges']['tuition']);
$this->assertSame(0.0, $result['remaining_balance']);
$this->assertSame(150.0, $result['account_credit']);
}
public function test_student_rows_include_event_charges(): void
{
$this->seedFeeConfig();
$this->seedClassSection(301, '4');
$parentId = 30;
DB::table('events')->insert([
'id' => 2,
'event_name' => 'Camp',
'amount' => 40.00,
'expiration_date' => '2025-06-01',
]);
DB::table('event_charges')->insert([
'event_id' => 2,
'parent_id' => $parentId,
'student_id' => 7,
'charged' => 40.00,
'school_year' => '2025-2026',
]);
$service = $this->makeService();
$result = $service->calculateFamilyAccount([
[
'student_id' => 7,
'firstname' => 'Sam',
'lastname' => 'Lee',
'class_section_id' => 301,
'enrollment_status' => 'enrolled',
'admission_status' => 'accepted',
],
], $parentId);
$student = $result['students'][0];
$this->assertSame(7, $student['student_id']);
$this->assertSame(350.0, $student['tuition']);
$this->assertSame(40.0, $student['event_charges']);
$this->assertSame(390.0, $student['total_charges']);
}
private function makeService(): BalanceCalculationService
{
$config = new FeeConfigService();
$tuition = new TuitionCalculationService(
$config,
new FeeStudentFeeService(new FeeGradeService(), $config)
);
return new BalanceCalculationService($config, $tuition, new BillingTotalsService());
}
private function seedFeeConfig(): void
{
DB::table('configuration')->insert([
['config_key' => 'school_year', 'config_value' => '2025-2026'],
['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 seedInvoice(int $parentId, float $total): int
{
return (int) DB::table('invoices')->insertGetId([
'parent_id' => $parentId,
'invoice_number' => 'INV-' . $parentId,
'total_amount' => $total,
'balance' => 0.00,
'paid_amount' => 0.00,
'issue_date' => '2025-01-01',
'school_year' => '2025-2026',
'semester' => 'Fall',
]);
}
}