<?php

declare(strict_types=1);

namespace Kylin\Property\Models;

use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Kylin\Core\Models\BaseModel;

/**
 * 费用记录模型
 *
 * 依据《民法典》第九百四十四条：
 * 业主应当按照约定向物业服务人支付物业费。
 * 依据《价格法》第十三条：收费标准需明码标价。
 *
 * @property int    $id
 * @property int    $resident_id    住户 ID
 * @property string $bill_no        账单编号
 * @property string $fee_type       费用类型
 * @property int    $amount         金额（分）
 * @property string $due_at         缴费截止日期
 * @property string $paid_at        缴费日期
 * @property string $status         状态
 */
class FeeRecord extends BaseModel
{
    protected $table = 'kylin_property_fee_records';

    protected $fillable = [
        'resident_id', 'bill_no', 'fee_type',
        'amount', 'due_at', 'paid_at', 'status',
    ];

    protected $casts = [
        'amount' => 'integer',
        'due_at' => 'datetime',
        'paid_at' => 'datetime',
    ];

    public function resident(): BelongsTo
    {
        return $this->belongsTo(Resident::class, 'resident_id');
    }

    /**
     * 到期前 N 天内需提醒的账单
     */
    public function scopeExpiringInDays($query, int $days)
    {
        return $query->where('status', 'pending')
            ->where('due_at', '<=', now()->addDays($days))
            ->where('due_at', '>', now());
    }
}