<?php

namespace app\common\service;

use app\common\validate\VehDictI18nValidate;
use app\common\traits\crud\CrudServiceTrait;
use app\common\model\VehDictI18n;

class VehDictI18nService
{

    use CrudServiceTrait;

    /**
     * 指定当前要操作的模型
     */
    protected string $modelClass = VehDictI18n::class;

    /**
     * 验证器
     */
    protected $validator = VehDictI18nValidate::class;

    /**
     * 获取验证器
     */
    public function getValidator()
    {
        return  new $this->validator;
    }


    /** 本进程缓存：[dict][code] => labels array */
    protected static array $labelsCache = [];

    public static function label(string $dict=null, ?string $code=null, string $locale='zh-CN', ?string $fallbackZh=null): ?string
    {
        if (!$dict || !$code) return $fallbackZh;

        $labels = self::labels($dict, $code);
        if (!$labels) return $fallbackZh ?? $code;

        return $labels[$locale] ?? $labels['zh-CN'] ?? $code;
    }

    /** 返回 labels 数组，命中缓存 */
    public static function labels(string $dict, string $code): ?array
    {
        $dict = strtoupper($dict);
        $code = (string)$code;

        if (isset(self::$labelsCache[$dict][$code])) {
            return self::$labelsCache[$dict][$code];
        }

        $term = DictTerm::where('dict',$dict)->where('code',$code)->first(['labels']);
        if (!$term) return null;

        $labels = $term->labels ?? null;
        if (!is_array($labels)) return null;

        self::$labelsCache[$dict][$code] = $labels;
        return $labels;
    }

    /** 校验 code 是否存在于字典（用于必填维度） */
    public static function ensureExists(string $dict, ?string $code, string $fieldNameForError): void
    {
        if ($code === null || $code === '') {
            throw new \InvalidArgumentException("缺少必填字段：{$fieldNameForError}");
        }
        $ok = VehDictI18n::where('dict',$dict)->where('code',$code)->where('status', 1)->exists();
        if (!$ok) throw new \InvalidArgumentException("字典不存在或未启用：{$dict}.{$code}");
    }
}