支持 Wikidata 格式的人物 ID 查詢並改進錯誤處理

為了兼容 Wikidata 的調用格式，修改 person API 以支持前置 0 的 7 位整數格式。

主要變更：

1. ID 驗證規則優化：
   - 從嚴格的整數驗證改為正則表達式：/^\d{1,7}$/
   - 現在支持：0001367、1367、0000001 等格式
   - 保持原有的最小值驗證（>= 1）

2. 錯誤處理改進：
   - HTML 模式：返回帶有錯誤列表的錯誤頁面，不再重定向到首頁
   - JSON 模式：返回結構化的 JSON 錯誤響應
   - 添加 .alert-danger 樣式用於顯示錯誤信息

3. 前端顯示優化：
   - 在頁面頂部顯示驗證錯誤信息（紅色警告框）
   - 錯誤信息清晰列出所有驗證失敗的原因

測試用例：
- ✅ /cbdbapi/person?id=0001367 → 正常顯示
- ✅ /cbdbapi/person?id=abc → 顯示錯誤頁面
- ✅ /cbdbapi/person?id=12345678 → 格式錯誤提示
- ✅ /cbdbapi/person?id=abc&o=json → JSON 錯誤響應

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: frankslin

app/Http/Controllers/CbdbApiController.php

@@ -14,7 +14,11 @@ public function person(Request $request)
         $mode = strtolower((string) $request->query('mode', $request->query('o', 'html')));
 
         $validator = Validator::make($request->all(), [
-            'id' => ['nullable', 'integer', 'min:1'],
+            'id' => ['nullable', 'regex:/^\d{1,7}$/', function ($attribute, $value, $fail) {
+                if ((int) $value < 1) {
+                    $fail('The id must be at least 1.');
+                }
+            }],
             'name' => ['nullable', 'string', 'max:255'],
         ]);
 
@@ -24,7 +28,26 @@ public function person(Request $request)
             }
         });
 
-        $validator->validate();
+        if ($validator->fails()) {
+            if (!in_array($mode, ['json', 'xml'], true)) {
+                // HTML mode: return error page
+                return response()->view('cbdbapi.person', [
+                    'personId' => '',
+                    'searchResults' => [],
+                    'searchTerm' => '',
+                    'validationErrors' => $validator->errors()->all(),
+                ], 400);
+            } else {
+                // JSON/XML mode: return JSON error
+                return response()->json([
+                    'error' => [
+                        'code' => 400,
+                        'message' => 'Validation failed.',
+                        'details' => $validator->errors()->all(),
+                    ],
+                ], 400);
+            }
+        }
 
         $idParam = $request->query('id');
         $nameParam = $request->query('name');

resources/views/cbdbapi/person.blade.php

@@ -179,9 +179,9 @@
         }
 
         .alert-danger {
-            background-color: #f5f5f5;
-            border-color: #999;
-            color: #333;
+            background-color: #ffebee;
+            border-color: #ef5350;
+            color: #c62828;
         }
 
         .api-info-box {
@@ -282,7 +282,16 @@
         <h1 class="site-title">中國歷代人物傳記資料庫</h1>
         <p class="site-subtitle">China Biographical Database Project (CBDB)</p>
 
-        @if(!empty($searchResults))
+        @if(!empty($validationErrors ?? []))
+        <div class="alert-box alert-danger">
+            <strong>錯誤：</strong>
+            <ul style="margin: 10px 0 0 20px; padding: 0;">
+                @foreach($validationErrors as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+        @elseif(!empty($searchResults))
         <div class="search-results-section">
             <div class="search-results-title">
                 搜尋結果@if($searchTerm)：「{{ e($searchTerm) }}」@endif