架構隱喻與核心設計理念 (Architecture Metaphors)

這是一份寫給人類（而不僅僅是機器或其他開發者）的文件。我們利用生活中的比喻來解釋 Time Compass 背後的複雜技術。

1. 資料傳輸：三合一水管

學生平時最痛苦的是資訊散落在 Moodle (網頁)、Google Calendar (手機) 與紙本或數位 Tasks。 - 比喻：Time Compass 就像是一台「專用的強力抽水機」。它不要求你搬家，而是裝配了三條專屬吸管，同時深入這三個系統，將資料匯流後，經過過濾網（Data Cleaning），轉化為純淨的水（TOON 格式）供 AI 飲用。

2. 測試策略：Capture-First 拍立得

傳統測試像是「憑記憶畫畫」（手寫 Mock），畫出來的往往跟本人不太像。 - 比喻：Capture-First 就像是「拿拍立得拍照」。我們在遇到問題時，直接拿相機去 API 現場「卡嚓」拍一張原始 JSON 照片。之後的測試，我們都是看著這張照片寫 Code。這保證了我們的軟體對真實數據的反應是 100% 準確的。

3. 資料壓縮：TOON 壓縮包

JSON 格式就像是寫信時連信封、郵戳、地址長寬格式都寫在內容裡，非常浪費。 - 比喻：TOON 就像是一套「專屬速記代碼」。我們跟 AI 約定好：[T] 代表任務、日期用數字寫不用寫月日年。這讓郵費（Token 成本）便宜了 50%，且讀信的速度（推理速度）快了一倍。

4. 開發者哲學：反文件驅動 (Anti-SDD)

很多專案文件寫得比程式碼還慢，最後沒人看。 - 比喻：我們不寫「組裝傢俱的說明書」，我們直接給你「傢俱的設計圖與零件實物」。程式碼本身就是最準確的文檔，我們強迫自己把型別寫清楚，讓 IDE 直接告訴你怎麼組裝。

---

這些設計理念共同組成了一個「輕量但強韌」的系統，這就是為什麼 Time Compass 能在這麼短的時間內從一個笨重的原型進化為正式的 MCP 工具。