tocha/app/Models/DictSection.php

<?php

/*
 * DictSection — раздел справочника (например: "Марки и модели", "Типы кузова").
 *
 * Создана: 2026-05-06 | Таблица: dict_sections (миграция: 2026_05_06_151148_create_dict_sections_table.php)
 * $timestamps = false — у раздела нет created_at/updated_at (статичные данные)
 * is_system — системные разделы нельзя удалить (защита в ManualController::sectionDestroy)
 * is_hierarchical — если true, значения двухуровневые (марка → модели); если false — плоский список
 */

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class DictSection extends Model
{
    public $timestamps = false;

    protected $fillable = ['code', 'label', 'is_system', 'is_hierarchical', 'sort_order'];

    protected $casts = [
        'is_system' => 'boolean',
        'is_hierarchical' => 'boolean',
    ];

    // Только корневые значения (parent_id IS NULL), отсортированные — для плоских и иерархических разделов
    public function values(): HasMany
    {
        return $this->hasMany(DictValue::class, 'section_id')->whereNull('parent_id')->orderBy('sort_order');
    }

    // Все значения раздела включая дочерние (для иерархических разделов типа 'makes')
    public function allValues(): HasMany
    {
        return $this->hasMany(DictValue::class, 'section_id')->orderBy('sort_order');
    }
}