# 多國語系作業規則(所有代理人共用,必讀)

## 架構
- 原始語言是**繁體中文(zh_TW)**。程式與畫面裡的中文原文就是翻譯的「鍵」:`__('登入')`。zh_TW 不需要翻譯檔,找不到翻譯就顯示原文。
- 目標語言:`en`(English)、`zh_CN`(简体中文)、`ja`(日本語)、`ko`(한국어)。最終檔案是 lang/en.json、lang/zh_CN.json、lang/ja.json、lang/ko.json(由我合併,**你不要直接改**)。
- 你的產出:① 把你負責的檔案裡的中文介面文字改成 `__()`;② 把每一句的四種翻譯寫進 `lang/_work/<你的代號>.json`,格式 `{ "繁體中文原文": { "en": "...", "zh_CN": "...", "ja": "...", "ko": "..." } }`(UTF-8、JSON 合法、鍵不要重複)。

## 改寫規則
1. Blade:純文字節點 `登入` → `{{ __('登入') }}`;屬性 `placeholder="搜尋"` → `placeholder="{{ __('搜尋') }}"`;已在 `{{ }}` 內的字串 → 包 `__()`;JS/Alpine 內 → `@js(__('已複製'))` 或 `{{ __('...') }}`(注意引號與跳脫,單引號用 `\'` 或改用雙引號包屬性)。
2. 含變數的句子**一律用佔位符**,不要拆句:`本月 {{ $n }} 場挑戰` → `{{ __('本月 :n 場挑戰', ['n' => $n]) }}`。鍵本身就用 `:n` 寫在原文裡。複數問題用中文原文就不分單複數,翻譯時英文寫成 "…:n challenge(s)" 即可。
3. 含 HTML 的句子(`<b>`、`<a>`)用 `{!! __('...') !!}` 時要確定變數已跳脫(`e($var)`),能避免就避免:把標籤留在句外,只翻譯純文字片段。
4. **不要翻譯**:路由名稱、CSS class、資料庫欄位值當作程式邏輯比對的字串(例如 `'入門'` 在 `=== '入門'`、`in_array`、`@selected` 的比較中必須維持原樣;只在**顯示**時 `__($course->level)`)、使用者輸入的內容、課程/章節/單元/題目的內容(教材本身這次不翻譯)、程式碼註解、emoji、數字格式。
5. 資料庫裡的學院名稱、分類名稱、徽章名稱等「系統預設資料」要在顯示處 `__($x->name)`,並把這些字串也納入翻譯 JSON(查看 database/seeders/DatabaseSeeder.php 與 ChallengeSeeder 取得清單)。
6. 不要改變任何版面、class、邏輯、路由。只動文字。不要重新排版整個檔案。
7. 每改完一個 Blade 檔,執行 `php tools/check-blade.php <檔>` 確認語法;PHP 檔用 `php -l`。**不要跑 artisan test(其他人同時在改檔案)**。
8. 已經是 `__()` 的字串不用重包,但要把它的翻譯補進 JSON。Laravel 內建驗證訊息(lang/zh_TW/validation.php 等)不在你的範圍。

## 翻譯規則
- 語氣:友善、簡潔、專業的教育平台介面。按鈕與選單用短語。不要直譯成怪句子,要像母語者寫的介面。
- 佔位符 `:n`、`:name` 等必須原樣保留在每個翻譯中。
- 品牌與專有名詞:
  - 滿金學院:en "Manco Academy"、zh_CN "满金学院"、ja "満金アカデミー"、ko "만금 아카데미"(英文大寫標誌 MANCO ACADEMY 保持原樣不翻)
  - 小柚(AI 助理):en "Pomelo"、zh_CN "小柚"、ja "ポメロ"、ko "포멜로"
  - Linux、Docker、Kubernetes、AI、XP、LV 等維持原文。
- 術語表(請一致使用):
  | 繁中 | en | zh_CN | ja | ko |
  |---|---|---|---|---|
  | 學院(學科分院) | College | 学院 | カレッジ | 칼리지 |
  | 課程 | Course | 课程 | コース | 강좌 |
  | 章節 | Chapter | 章节 | チャプター | 챕터 |
  | 單元 | Lesson | 单元 | レッスン | 레슨 |
  | 測驗 | Quiz | 测验 | クイズ | 퀴즈 |
  | 挑戰賽 | Challenge | 挑战赛 | チャレンジ | 챌린지 |
  | 學員 / 學生 | Learner / Student | 学员 / 学生 | 受講生 / 学生 | 수강생 / 학생 |
  | 講師 | Instructor | 讲师 | 講師 | 강사 |
  | 報名 | Enroll | 报名 | 受講登録 | 수강 신청 |
  | 學習中心 | My Learning | 学习中心 | 学習センター | 학습 센터 |
  | 管理後台 | Admin | 管理后台 | 管理画面 | 관리자 |
  | 排行榜 | Leaderboard | 排行榜 | ランキング | 랭킹 |
  | 錯題本 | Mistake Notebook | 错题本 | 間違いノート | 오답 노트 |
  | 徽章 | Badge | 徽章 | バッジ | 배지 |
  | 入門/初級/中級/進階 | Beginner/Elementary/Intermediate/Advanced | 入门/初级/中级/进阶 | 入門/初級/中級/上級 | 입문/초급/중급/고급 |
  | 免費 | Free | 免费 | 無料 | 무료 |
- zh_CN 要用簡體字與中國大陸慣用詞(例如 軟體→软件、資料→数据、網路→网络、預設→默认、登入→登录、帳號→账号)。ja/ko 用自然敬體(です・ます/합니다·해요 體,按鈕用名詞形)。
- NT$ 價格格式保持原樣(貨幣不換算)。

## 回報
完成後回報:處理了哪些檔案、翻譯了幾句、哪些字串你**刻意沒包**及原因、不確定的地方。
