# 交接說明（給實驗室電腦上的 AI）

> 你沒參與這個案子的討論。**照本檔順序讀、照本檔規矩做**，不要憑猜測補內容。
> 主理人（使用者）：用繁體中文、白話、短句溝通；先講結論；專有名詞第一次出現要用括號解釋。

## 1. 這是什麼

一個多益（TOEIC）練習網站：每題是文法選擇題，附真人級錄音、翻譯、詳解、句子拆解。
這個案子把它改成「**照正確方法練聽力**」的版本，並且放在實驗室這台電腦當 server，主理人在任何地方用手機或電腦都能接著學。

## 2. 先讀這些（依序）

1. `00-resume.md` —— 現在做到哪（唯一真實來源，永遠以它為準）
2. `02-contract.locked.md` ＋ `02-contract-amend-1.md` —— 43 條「做完應該長什麼樣」。**唯讀，不准改。**
3. `05b-diff.md` —— 實作與合約不同的地方（D1–D6，2026-10-05 已由主理人追認或授權代決）
4. `00-parking.md` —— 曾經要問主理人的事（P1–P4 已全部裁決；新的問題往後追加）
5. `03-tech-spec.md` —— 程式怎麼組成
6. `app/DEPLOY.md` —— 怎麼在這台電腦架起來

學習方法（主理人怎麼練、為什麼）在 `app/guide.html`，想理解使用者再讀。

## 3. 你的工作

依 `00-resume.md` 的「下一步」做。預期是：
1. 照 `app/DEPLOY.md` 部署（密碼請主理人自己輸入，不要代設、不要寫進任何檔案或對話）。
2. 跑四組自動測試（DEPLOY.md 第 8 節：plan、sync、server、e2e），全過才算部署成功。
3. 幫主理人把舊紀錄搬過來（DEPLOY.md 第 6 節）。
4. 主理人實際用了之後回報的問題，照下面的規矩修。

## 4. 規矩

- **題目的題號、考點、答案、選項不准改**（合約 40）。句子情境不合理時，可以照 `02-contract-amend-2.md` 的方式改句子（含翻譯、拆解、錄音），並遵守「一題一個清楚的職場場景」。
- 之後新增題目要照文法課綱的出題規則（合約 41，已由增補 2 改成「場景優先」）。
- 修 bug：先重現、先寫會失敗的測試、再修；不准為了過關改測試。
- 合約沒涵蓋的決定，照主理人的裁決標準：**① 長期目標優先 ② 主理人方便持續用下去**（好但太難的方法等於沒用）。介面、文案、會影響主理人怎麼用的事，先問主理人。
- 試用與檢查只用**正常情境**（主理人本人、下班後、一次約 1.5 小時、有時電腦換手機），不用極端角色、不刻意測極端情況（主理人 2026-10-05 指示）。
- 改完在 `docs/changelog.md` 追加三行：改了什麼／為什麼／影響哪些檔案。
- 舊頁 `toeic-drill-01.html` 是內容來源，不要改它。

## 5. 主理人的使用情境（設計時一直記得）

- 程度：多益目標 700 分；聽力目前只能聽 70% 語速（約每分鐘 126 字）。
- 每次學習上限約 1.5 小時；常常是下班後、很累的時候用。
- 不想花任何精力規劃「今天要做什麼」，打開就照畫面做，做完按「這次完成」。
- 會換裝置：電腦學到一半，手機接著學。
- 討厭繁瑣的規則、計分、強制鎖定；喜歡知道「為什麼要這樣做」。

## 6. 案子怎麼結束的

- 工作報告：`docs/reports/2026-10-04-listening-mode.html`（做了什麼、合約逐條驗收、差異、還需要主理人決定的事）。
- 報告第 1 節的 4 題已在 2026-10-05 定案（報告裡有「已定案」框）。
- **主理人的長期授權**：這個網站的開放問題（含畫面文字）由 AI 照「① 長期目標 ② 方便持續用下去」自己決定，每個決定留一行理由；主理人實際用了有問題會說。不要把問題堆著等主理人。
- 重構候選（程式寫法可以更整齊的地方）記在 `04-implementation.md`，要做請當成獨立任務。

## 7. 已知限制（刻意先不做，理由在 04-implementation.md）

- **流水帳只會變長。** 現在存在瀏覽器的 IndexedDB，實測 3 萬筆時每點一下 0.1 毫秒、開頁 0.2 秒，夠用好幾年。哪天開頁明顯變慢，再開新案子做「快照」（把很舊的事件壓成一份進度）。
- **匯入舊進度檔時另一台正在學**：那台的複習會晚幾次才出現。修法會在兩台時鐘不準時出更大的錯，所以不修。
- **server 沒有密碼錯誤次數限制。** 靠 Tailscale（只有自己的裝置連得到）擋；不要把 port 直接開到網路上。
- 目前只認一冊題目（`window.BOOK`）。加第 2 冊要先開新案子設計「多冊」。舊頁面看到第 2 冊的題號會整筆不理，不會壞掉。
- 複習中到「看全部題目」，在上次點過的字上連點兩下，這句會變成「還是有沒聽出來的」（多複習一次）。很少發生，先不修（05k 低 1）。