<?php

declare(strict_types=1);

/**
 * 本文件属于 DBErp 进销存系统。
 *
 * 版权所有 © 2026 北京珑大钜商科技有限公司。保留所有权利。
 *
 * 未经官方授权，不得删除、篡改或隐藏本文件中的版权声明、产品标识与来源信息。
 * 商业授权、官方更新与技术支持服务，请以珑大官方支持中心记录为准。
 *
 * @link https://support.loongdom.cn
 * @see  https://www.dberp.com.cn
 */

namespace App\Models;

use Database\Factories\DberpToolInvocationFactory;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Support\Carbon;

/**
 * Tool 能力调用审计。与业务变更审计（core_audit_logs）分离，不保存完整入参/出参。
 *
 * @property int $id
 * @property string $tool_name
 * @property int|null $tool_version
 * @property string|null $tool_owner
 * @property int|null $actor_user_id
 * @property string $source
 * @property string|null $client_id
 * @property string|null $session_id
 * @property string $correlation_id
 * @property string|null $request_id
 * @property string|null $permission_type
 * @property string|null $permission_value
 * @property string|null $risk
 * @property bool $success
 * @property string|null $error_code
 * @property int $duration_ms
 * @property int|null $page
 * @property int|null $per_page
 * @property int|null $result_count
 * @property string|null $filter_fingerprint
 * @property Carbon $created_at
 */
class DberpToolInvocation extends Model
{
    /** @use HasFactory<DberpToolInvocationFactory> */
    use HasFactory;

    public $timestamps = false;

    protected $table = 'dberp_tool_invocations';

    /**
     * @var list<string>
     */
    protected $fillable = [
        'tool_name',
        'tool_version',
        'tool_owner',
        'actor_user_id',
        'source',
        'client_id',
        'session_id',
        'correlation_id',
        'request_id',
        'permission_type',
        'permission_value',
        'risk',
        'success',
        'error_code',
        'duration_ms',
        'page',
        'per_page',
        'result_count',
        'filter_fingerprint',
        'created_at',
    ];

    protected function casts(): array
    {
        return [
            'tool_version' => 'integer',
            'actor_user_id' => 'integer',
            'success' => 'boolean',
            'duration_ms' => 'integer',
            'page' => 'integer',
            'per_page' => 'integer',
            'result_count' => 'integer',
            'created_at' => 'datetime',
        ];
    }

    public function actor(): BelongsTo
    {
        return $this->belongsTo(User::class, 'actor_user_id');
    }
}
