feat: 增强玩家端 API 鉴权中间件，支持多语言错误消息返回

app/Support/LotteryMessage.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Support;
+
+use Illuminate\Http\Request;
+
+/**
+ * 【业务文案翻译辅助类】
+ *
+ * 从 lang/{locale}/sso.php 等语言包取字符串，供 JSON 里「msg」字段使用。
+ * 当前实现：玩家 SSO / Bearer 鉴权相关错误码（8001–8004），见 docs/04 错误码段。
+ *
+ * 依赖 NegotiateLotteryLocale 已写入 lottery_locale；若未写则使用 fallback 语言包。
+ */
+final class LotteryMessage
+{
+    /**
+     * 取 SSO 鉴权类错误的用户可见文案（与 ApiResponse 的 msg 对应）。
+     *
+     * @param  int  $code  业务错误码，如 8001
+     */
+    public static function sso(Request $request, int $code): string
+    {
+        $fallback = (string) config('lottery.locales.fallback', 'en');
+        $locale = (string) ($request->attributes->get('lottery_locale') ?? $fallback);
+        $key = 'sso.'.$code; // 对应 lang/{locale}/sso.php 内键名，如 '8001'
+
+        $msg = trans($key, [], $locale);
+        // Laravel 无键时返回整条 key 字符串，此时改用 fallback 语言再试一次
+        if ($msg !== $key) {
+            return $msg;
+        }
+
+        return trans($key, [], $fallback);
+    }
+}