School-management ERP — a 54-module monolith made fast without a rewrite

// app/Support/ModuleRegistry.php
// moduleStatusCheck() ran 2,236+ times per request — each call hit the
// session, the DB, and the filesystem. Compute every status ONCE per request.
class ModuleRegistry
{
    // Per-request, populated on first access, never re-queried.
    private static ?array $statuses = null;

    public static function isActive(string $module): bool
    {
        if (self::$statuses === null) {
            self::boot();                          // first call only
        }
        return self::$statuses[$module] ?? false;  // pure memory lookup
    }

    private static function boot(): void
    {
        self::$statuses = [];
        try {
            foreach (self::getAllModuleNames() as $name) {
                self::$statuses[$name] = self::computeStatus($name);
            }
        } catch (\Throwable $e) {
            self::$statuses = [];   // never crash the app over a status check
        }
    }
    // Legacy moduleStatusCheck() now delegates here — zero caller changes.
}

// app/Scopes/StatusAcademicSchoolScope.php — runs on EVERY query of a scoped model.
public function apply(Builder $builder, Model $model): void
{
    $table = $model->getTable();
    $academicCol = $table.'.academic_id';

    // University mode swaps the academic column — registry lookup, not a DB hit.
    if (ModuleRegistry::isActive('University')
        && in_array('un_academic_id', Schema::getColumnListing($table), true)) {
        $academicCol = $table.'.un_academic_id';
    }

    if (! Auth::check()) {
        $builder->where($table.'.active_status', 1);
        return;
    }

    $user = Auth::user();
    $isSuperAdmin = ModuleRegistry::isActive('Saas')
        && $user->is_administrator === 'yes' && $user->role_id === 1;

    // Tenant isolation: every read is pinned to the user's school_id.
    $builder->where($table.'.active_status', 1)
        ->where($academicCol, getAcademicId())
        ->when(! $isSuperAdmin, fn ($q) => $q->where($table.'.school_id', $user->school_id));
}

// config/paymentGateway.php — method name → gateway class.
return [
    'Stripe'      => App\PaymentGateway\StripePayment::class,
    'PayPal'      => App\PaymentGateway\PaypalPayment::class,
    'Paystack'    => App\PaymentGateway\PaystackPayment::class,
    'RazorPay'    => App\PaymentGateway\RazorPayPayment::class,
    'MercadoPago' => App\PaymentGateway\MercadoPagoPayment::class,
    'SslCommerz'  => App\PaymentGateway\SslCommerz::class,
    // …Xendit, CcAvenue, PhonePe (+ Khalti, MomoPay, ToyyibPay, Raudhah modules)
];

// app/Http/Controllers/GatewayPaymentController.php
$data['method'] = SmPaymentMethhod::find($request->payment_method)->method;
$classMap     = config('paymentGateway.'.$data['method']); // one resolve point
$make_payment = new $classMap();
// Every gateway honours the same contract — callers never branch per provider.
return $make_payment->handle($data);

// app/Helpers/SmsHelper.php — one entry point, five providers behind a runtime switch.
function send_sms(?string $receiver, $purpose, $data): void
{
    if (! $receiver) { return; }

    $schoolId = Auth::check() && saasSettings('sms_settings') ? Auth::user()->school_id : 1;
    $gateway  = SmSmsGateway::where('school_id', $schoolId)->where('active_status', 1)->first();
    if (! $gateway) { return; }   // no gateway configured → caller is never blocked

    $body = SmsTemplate::smsTempleteToBody(getTempleteDetails($purpose, 'sms')->body, $data);

    try {
        if ($gateway->gateway_name === 'Twilio') {
            (new Client($gateway->twilio_account_sid, $gateway->twilio_authentication_token))
                ->messages->create($receiver, [
                'from' => $gateway->twilio_registered_no, 
                'body' => $body
                ]);
        } elseif ($gateway->gateway_name === 'Msg91')         { /* HTTP GET to msg91 */ }
          elseif ($gateway->gateway_name === 'TextLocal')      { /* .in / .com per type */ }
          elseif ($gateway->gateway_name === 'AfricaTalking')  { /* SDK call */ }
          elseif ($gateway->gateway_name === 'Himalayasms')    { /* HTTP call */ }
    } catch (\Throwable $e) {
        // Swallow provider errors: an SMS outage must never break the calling flow.
    }
}