<?php

declare(strict_types=1);

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

namespace App\Business\MasterData;

use App\Models\DberpRegion;

/**
 * 地区主数据 {@see DberpRegion} 的 source 字段约定值。
 *
 * 来源类型仅依据数据库中的 source 值判断，不使用 region_code 形态推断。
 */
final class DberpRegionSource
{
    public const string Manual = 'manual';

    /**
     * 系统预置节点（如国家根等），与官方导入数据区分。
     */
    public const string System = 'system';

    public static function isManual(?string $source): bool
    {
        return $source === self::Manual;
    }

    public static function isSystem(?string $source): bool
    {
        return $source === self::System;
    }

    /**
     * 官方或第三方导入渠道维护的地区（例如中国民政导入源），非手工、非系统预置。
     */
    public static function isOfficialImported(?string $source): bool
    {
        if ($source === null || $source === '') {
            return false;
        }

        return ! self::isManual($source) && ! self::isSystem($source);
    }

    /**
     * Filament 等界面展示用：不返回原始 source 字符串含义，仅返回业务可读文案。
     */
    public static function labelForStoredSource(?string $source): string
    {
        if ($source === null || $source === '') {
            return __('dberp.options.region_source.unknown');
        }

        if (self::isManual($source)) {
            return __('dberp.options.region_source.manual');
        }

        if (self::isSystem($source)) {
            return __('dberp.options.region_source.system');
        }

        $configuredImportSource = (string) config('dberp.regions.china_import.source', 'china_bundled');

        if (in_array($source, [$configuredImportSource, 'china_bundled', 'china_mca'], true)) {
            return __('dberp.options.region_source.china_divisions');
        }

        return __('dberp.options.region_source.other');
    }
}
