<?php

declare(strict_types=1);

namespace Kylin\Property\Models;

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

/**
 * 报修单模型
 *
 * 依据《物业管理条例》第三十六条：
 * 报修响应时限 24 小时（response_hours = 24）。
 *
 * @property int    $id
 * @property int    $resident_id    住户 ID
 * @property string $order_no       报修单号
 * @property string $repair_type    报修类型
 * @property string $description    问题描述
 * @property string $reported_at    报修时间
 * @property string $resolved_at    解决时间
 * @property string $status         状态
 */
class RepairOrder extends BaseModel
{
    protected $table = 'kylin_property_repair_orders';

    protected $fillable = [
        'resident_id', 'order_no', 'repair_type',
        'description', 'reported_at', 'resolved_at', 'status',
    ];

    protected $casts = [
        'reported_at' => 'datetime',
        'resolved_at' => 'datetime',
    ];

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

    /**
     * 超时未处理的报修单
     */
    public function scopeOverdue($query)
    {
        $responseHours = config('kylin-property.response_hours', 24);
        return $query->where('status', 'pending')
            ->where('reported_at', '<=', now()->subHours($responseHours));
    }
}