別名分頁補上出處／頁碼／備註欄

PersonBrowserService::tabAltNames() 原本就把 c_source／c_pages／c_notes 撈出來
送到前端，AltNamesTab 卻只渲染 序號／別名(拼音)／別名(中)／類型 四欄，等於是
送到前端就被丟掉的死負載。這三個欄位都在 AltnameMutationHandler 的 allowedFields
裡、可經提案修改，列表看不到會讓使用者誤以為沒存進去。

- tabAltNames() leftJoin TEXT_CODES 補出處書名（source_title_chn／source_title），
  與 AltnameEditor 的 c_source label 同源；c_source 的哨兵 0 在 TEXT_CODES 沒有
  對應列，leftJoin 自然落空、不需另外過濾
- AltNamesTab 加三欄；出處優先顯示書名（中／英）、查不到退回 #id，備註限寬 360px
  並保留換行（SubresourceTable 外層已有橫向捲動）。表頭沿用編輯器同一組 i18n key
  （biogmains.source_field／pages_entries／notes_field），列表欄名與編輯器欄位標籤一致

已執行 ./vendor/bin/phpunit（2994 tests 全綠）與 npm run build

Author: frankslin

app/Services/PersonBrowserService.php

@@ -649,8 +649,13 @@ private function tabAltNames(int $personId): array {
                 'ALTNAME_DATA.c_source',
                 'ALTNAME_DATA.c_pages',
                 'ALTNAME_DATA.c_notes',
+                // 出處以書名顯示（與 AltnameEditor 的 c_source label 同源）；c_source 的哨兵 0
+                // 在 TEXT_CODES 沒有對應列，leftJoin 自然落空、不需另外過濾。
+                'TC.c_title_chn AS source_title_chn',
+                'TC.c_title AS source_title',
             ])
             ->leftJoin('ALTNAME_CODES AS ATC', 'ATC.c_name_type_code', '=', 'ALTNAME_DATA.c_alt_name_type_code')
+            ->leftJoin('TEXT_CODES AS TC', 'TC.c_textid', '=', 'ALTNAME_DATA.c_source')
             ->where('ALTNAME_DATA.c_personid', $personId)
             ->orderBy('ALTNAME_DATA.c_alt_name_type_code')
             ->get();
@@ -670,6 +675,8 @@ private function tabAltNames(int $personId): array {
                 'type_label_chn' => $r->c_name_type_desc_chn,
                 'type_label' => $r->c_name_type_desc,
                 'source_id' => $r->c_source,
+                'source_title_chn' => $r->source_title_chn,
+                'source_title' => $r->source_title,
                 'pages' => $r->c_pages,
                 'notes' => $r->c_notes,
             ])->values()->all(),

resources/js/inertia/components/PersonBrowser/tabs/AltNamesTab.tsx

@@ -14,6 +14,16 @@ import { useTranslation } from '../../../hooks/useTranslation';
 import { Button } from '../../ui/Button';
 import { ConfirmDialog } from '../../ui/ConfirmDialog';
 
+/**
+ * 出處顯示：優先書名（中／英），沒有對應 TEXT_CODES 列時退回 `#id`，
+ * 哨兵 0 與 null 一律視為「未填」。
+ */
+function formatSourceLabel(item: AltNameItem): string | null {
+    const label = formatBilingualLabel(item.source_title_chn, item.source_title);
+    if (label) return label;
+    return item.source_id ? `#${item.source_id}` : null;
+}
+
 interface AltNameItem {
     pk: {
         c_personid: number;
@@ -27,6 +37,8 @@ interface AltNameItem {
     type_label_chn: string | null;
     type_label: string | null;
     source_id: number | null;
+    source_title_chn: string | null;
+    source_title: string | null;
     pages: string | null;
     notes: string | null;
 }
@@ -131,6 +143,11 @@ export default function AltNamesTab({
                     { header: tb('altname_pinyin_label'), render: (item) => item.name },
                     { header: tb('altname_chinese'), render: (item) => item.name_chn },
                     { header: t('alt_name_type'), render: (item) => formatBilingualLabel(item.type_label_chn, item.type_label) },
+                    // 出處／頁碼／備註：AltnameMutationHandler 的 allowedFields 允許提案修改，
+                    // 卻只在編輯器裡看得到——列表不顯示會讓使用者以為沒存進去。
+                    { header: tb('source_field'), render: (item) => formatSourceLabel(item) },
+                    { header: tb('pages_entries'), render: (item) => item.pages },
+                    { header: tb('notes_field'), render: (item) => (item.notes ? <div style={notesCellStyle}>{item.notes}</div> : null) },
                 ]}
                 actions={(canEdit || canPropose) ? (item) => (useReactEditor ? (
                     <span style={actionCellStyle}>
@@ -165,6 +182,13 @@ export default function AltNamesTab({
     );
 }
 
+// 備註可能很長：限寬並保留換行，避免把整張表撐爆（外層 SubresourceTable 已有橫向捲動）。
+const notesCellStyle: React.CSSProperties = {
+    maxWidth: 360,
+    whiteSpace: 'pre-wrap',
+    wordBreak: 'break-word',
+};
+
 const containerStyle: React.CSSProperties = {
     display: 'flex',
     flexDirection: 'column',

tests/Feature/PersonBrowserTest.php

@@ -654,7 +654,8 @@ protected function seedTestData(): void {
 
         DB::table('ALTNAME_DATA')->insert([
             ['c_personid' => 1, 'c_sequence' => 1, 'c_alt_name_chn' => '太白', 'c_alt_name' => 'Taibai', 'c_alt_name_type_code' => 4, 'c_source' => null, 'c_pages' => null, 'c_notes' => null],
-            ['c_personid' => 1, 'c_sequence' => 2, 'c_alt_name_chn' => '青蓮居士', 'c_alt_name' => 'Qinglian Jushi', 'c_alt_name_type_code' => 5, 'c_source' => null, 'c_pages' => null, 'c_notes' => null],
+            // 出處／頁碼／備註在這一列填滿，釘住 alt_names 分頁確實把「提案可改欄位」送到前端。
+            ['c_personid' => 1, 'c_sequence' => 2, 'c_alt_name_chn' => '青蓮居士', 'c_alt_name' => 'Qinglian Jushi', 'c_alt_name_type_code' => 5, 'c_source' => 1, 'c_pages' => '卷一', 'c_notes' => '測試備註'],
             ['c_personid' => 3, 'c_sequence' => 1, 'c_alt_name_chn' => '子瞻', 'c_alt_name' => 'Zizhan', 'c_alt_name_type_code' => 4, 'c_source' => null, 'c_pages' => null, 'c_notes' => null],
             ['c_personid' => 3, 'c_sequence' => 2, 'c_alt_name_chn' => '東坡居士', 'c_alt_name' => 'Dongpo Jushi', 'c_alt_name_type_code' => 5, 'c_source' => null, 'c_pages' => null, 'c_notes' => null],
         ]);
@@ -1151,6 +1152,28 @@ public function test_tab_alt_names_returns_typed_items(): void {
         $response->assertJsonPath('items.0.type_label', 'Zi');
     }
 
+    /**
+     * 出處／頁碼／備註同樣是 AltnameMutationHandler 允許提案修改的欄位，必須送到前端
+     * （以前撈了卻沒進 UI，看起來像「沒存進去」）。出處以 TEXT_CODES 書名顯示。
+     */
+    #[Test]
+    public function test_tab_alt_names_exposes_source_pages_and_notes(): void {
+        $response = $this->actingAs($this->user)
+            ->getJson(route('app.person-browser.tab', ['personId' => 1, 'tabKey' => 'alt_names']));
+
+        $response->assertOk();
+        $response->assertJsonPath('items.1.name_chn', '青蓮居士');
+        $response->assertJsonPath('items.1.source_id', 1);
+        $response->assertJsonPath('items.1.source_title_chn', '新唐書');
+        $response->assertJsonPath('items.1.source_title', 'New Tang Book');
+        $response->assertJsonPath('items.1.pages', '卷一');
+        $response->assertJsonPath('items.1.notes', '測試備註');
+
+        // 沒有出處的列不可因 leftJoin 落空而多出／少掉欄位。
+        $response->assertJsonPath('items.0.source_title_chn', null);
+        $response->assertJsonPath('items.0.notes', null);
+    }
+
     #[Test]
     public function test_tab_texts_returns_role_labels(): void {
         $response = $this->actingAs($this->user)