webstatement/app/Models/AccountBalance.php

<?php

namespace Modules\Webstatement\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Factories\HasFactory;

class AccountBalance extends Model
{
    use HasFactory;

    /**
     * The attributes that are mass assignable.
     */
    protected $fillable = [
        'account_number',
        'period',
        'actual_balance',
        'cleared_balance',
    ];

    /**
     * Get the account that owns the balance.
     */
    public function account()
    {
        return $this->belongsTo(Account::class, 'account_number', 'account_number');
    }

    /**
     * Scope a query to filter by account number.
     */
    public function scopeForAccount($query, $accountNumber)
    {
        return $query->where('account_number', $accountNumber);
    }

    /**
     * Scope a query to filter by period.
     */
    public function scopeForPeriod($query, $period)
    {
        return $query->where('period', $period);
    }

    /**
     * Get balance for a specific account and period.
     *
     * @param string $accountNumber
     * @param string $period Format: YYYY-MM
     * @return AccountBalance|null
     */
    public static function getBalance($accountNumber, $period)
    {
        return self::where('account_number', $accountNumber)
            ->where('period', $period)
            ->first();
    }
}