okulcom-api — Okul Finansal ROI Hesaplama

Proje: Okul Platform · Hub: Okul Platform — Domain

SchoolFinancialOperationService

app/Services/SchoolFinancialOperationService.php

Okul sahiplerine yatırım getirisi (ROI) hesaplar. B2B portal istatistiklerinde kullanılır.

getAnnualReturnOnInvestmentValue()

getAnnualReturnOnInvestmentValue(
    array $schoolIds,
    int $customerId,
    int $registrationCount
): ?array  // [float roiValue1, float roiValue2] veya null

Hesap:

1. Okul ücretlerini al (SchoolFee)
2. Okulun okul.com’a ödediği toplam tutarı al (Payment)
3. Kayıt sayısı ile ilişkilendir
4. ROI değeri hesapla

İlgili Kavramlar

• SchoolFee::amount_yearly — Okulun yıllık ücret bilgisi
• Payment — Müşterinin okul.com’a ödediği tutar
• Kayıt sayısı (registrationCount) — Deal won sayısı

Kullanım Bağlamı

B2B portal’da müşteri, kendi okulları için “okul.com’a ödediğim için ne kadar kayıt aldım” gibi bir ROI değerini görebilir.

Related

• api-school-fee-system — SchoolFee modeli
• api-payment-model-b2b — Payment modeli
• api-b2b-monthly-report — Aylık istatistik raporu