feat(F9-2i): translate route 接課程 glossary 固定譯名

[dofliu]

做什麼

把 per-course glossary 的固定譯名接進在地化翻譯 route（F9-2 的最後一塊 offline slice，對應 docs/JOB_COURSE_ASSOCIATION_RFC.md §4.3）。

POST /localization/translate 的 TranslateRequest 新增選填 project_id：給了 → 以 ProjectStore.get_glossary(project_id) 現讀該課 glossary → to_translation_rules(target_lang) 產固定譯名規則文字塊，與呼叫端顯式 glossary 合併後送 translator.translate(glossary=...)，讓在地化翻譯術語前後一致（同一個「阻尼比」不會一下 damping ratio 一下 damping coefficient）。

為什麼

F9-2 前面已把 glossary 的 schema → 儲存 → API → 前端編輯 → 翻譯橋接（to_translation_rules）與 render 旁白讀音（F9-2h）全接好，唯獨翻譯 route 還沒用上那條橋。這刀把它接起來，固定譯名在實際翻譯時生效。

怎麼做（重點）

• TranslateRequest 加 project_id（optional，向後相容、既有 caller 零影響）。
• _glossary_lang_candidates：canonical 區域碼 ↔ glossary 短碼對齊（en-US→en；zh-CN/zh-TW 完整碼本就是 glossary key，完整碼優先命中、不誤退基底）。
• _course_glossary_rules / _merge_glossary：呼叫端顯式 glossary 在前、課程規則在後合併。
• fail-soft（RFC §5）：沒 project_id / 課不存在（ProjectNotFoundError）/ 無 glossary / 該語言無譯名 / 讀檔出錯 → 一律回空課程規則、沿用現行行為，絕不讓翻譯失敗。
• glossary 讀檔沿 R-3 走 asyncio.to_thread 不阻 event loop。
• 完全不碰 review gate / 狀態機 / reviewed（只影響「術語怎麼譯」，硬規則 Add pronunciation mapping for mathematical and Greek symbols in TTS #1）。

怎麼測

• 新增 tests/test_localization_glossary.py 9 測：注入固定譯名（含別名並排）／顯式+課程合併順序／完整區域碼命中／該語言無譯名不附／沒 pid·未知 pid·無 glossary·空白 pid 四種 fail-soft。
• 全程 mock translator.translate 攔截送進去的 glossary 字串、不打真 Gemini；ProjectStore 注入 tmp 隔離 = offline-first。
• 本機相關子集 68 passed、全套 2673 passed（3 個 QR/journal 字型像素為容器缺 Noto CJK 假象，CI 有字型為權威）。

Reviewer 決策點

• 無架構決策（Option A 關聯已於 F9-2g 拍板）。
• 前端 LocalizeMenu 傳 project_id 屬後續前端 slice（route 欄位選填、不破壞現況，故本 PR 不含）；若希望同 PR 一起接前端可提出。
• 自動建議術語（掃教材抽術語）碰 Gemini 額度 = GATE，不在本 PR。

https://claude.ai/code/session_01MaksgNhEj5whAHmmvTGqC1

---

Generated by Claude Code