<?php

declare(strict_types=1);

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

namespace App\Services\Install;

/**
 * Web 安装向导：DBErp 宿主库中可由向导识别或清理的表名清单（不含业务前缀的 Laravel 框架表等）。
 */
final class InstallerHostedSchemaCatalog
{
    /**
     * 与 DBErp 宿主安装迁移相关的非 dberp_/core_ 前缀基表（用于「仅本系统对象」判断与重装清理）。
     *
     * @var list<string>
     */
    private const HOST_BASE_TABLE_ALLOWLIST = [
        'cache',
        'cache_locks',
        'failed_jobs',
        'job_batches',
        'jobs',
        'password_reset_tokens',
        'personal_access_tokens',
        'sessions',
        'telescope_entries',
        'telescope_entries_tags',
        'telescope_monitoring',
        'users',
    ];

    /**
     * @return list<string>
     */
    public static function hostAllowlistedBaseTables(): array
    {
        $migrations = (string) config('database.migrations.table', 'migrations');

        return array_values(array_unique(array_merge(self::HOST_BASE_TABLE_ALLOWLIST, [$migrations])));
    }

    public static function isErpPrefixed(string $name): bool
    {
        return str_starts_with($name, 'dberp_') || str_starts_with($name, 'core_');
    }

    public static function isHostOwnedView(string $name): bool
    {
        return self::isErpPrefixed($name);
    }

    public static function isHostOwnedBaseTable(string $name): bool
    {
        if (self::isErpPrefixed($name)) {
            return true;
        }

        return in_array($name, self::hostAllowlistedBaseTables(), true);
    }
}
