Module: Revenue Engine

The Logic of Fee Recovery

How automated "nudge" algorithms and results-blurring create a confrontation-free payment culture.

Schools often lose up to 30% of potential revenue to delayed payments and "goodwill" extensions that are never honored. EduFlow eliminates this utilizing a Zero-Confrontation Enforcement Protocol.

The "Pay-to-Unlock" Algorithm

Instead of relying on bursars to chase parents, the system automatically restricts access to high-value digital assets (Report Cards, LMS) based on real-time ledger status.

lib/revenue-engine.ts
async function checkAccess(studentId, resourceType) {
   // 1. Fetch real-time balance from Ledger
   const balance = await ledger.getBalance(studentId);

   // 2. Check Threshold (e.g., > ₦5,000 debt)
   if (balance.debt > 5000) {
     if (resourceType === 'REPORT_CARD') {
       // 3. Enforce Blur Logic
       return {
         status: 'RESTRICTED',
         action: 'BLUR_RESULTS',
         redirect: '/payment-gateway'
       };
     }
   }

   return { status: 'GRANTED' };
}

Workflow Visualization

  • 1
    T-Minus 3 Days (SMS Nudge)System sends a polite, automated reminder to parents via SMS/WhatsApp with a direct payment link.
  • 2
    Result Day (The Lock)If fees remain unpaid, the Report Card is accessible but heavily blurred. A "Pay Now to Unlock" button is prominent.
  • 3
    Instant RestorationUpon successful transaction (via Paystack/Transfer), the system instantly unblurs the results. Zero staff intervention required.