論文進度看板

一句話說明：這是一個放在你 iPhone 主畫面上的小看板，用來追蹤「論文／研究計劃裡的每個部分，現在卡在哪個階段」——例如「撰寫中」「修改中」「已交給老師」「完成」，每個部分是一張卡片，用手指拖曳就能換階段。

如果你還沒安裝，請先看：

• docs/SETUP-GITHUB-PAGES.md —— 從零開始，把這個網頁放到網路上，並加到 iPhone 主畫面。這一步是必要的。
• docs/SETUP-GOOGLE-SHEETS.md —— 選配，如果你想在 Mac 上也能用 Google 試算表看到 / 編輯同一份資料。

---

為什麼是「加到主畫面的網頁」，而不是一個真正的 App？

這是這個專案最重要的設計決定，值得先講清楚。

如果找工程師朋友幫你用自己的 Apple 帳號把這個東西編譯成一個「真的 App」直接裝進 iPhone（業界說法叫「side-load」），那個 App 每 7 天就會自動失效，之後圖示會變灰、打不開，你得把手機接回那台電腦、重新簽署一次才能繼續用。如果要讓 App 永久不失效、也不用定期接電腦，唯一的辦法是加入 Apple 的「付費開發者方案」，一年要價 美金 99 元。

所以這個專案選擇了另一條路：做成一個網頁，讓你用 Safari 瀏覽器把它「加入主畫面」。加入主畫面之後，它的圖示、開啟方式、全螢幕顯示都跟真正的 App 幾乎一模一樣，但是：

• 永遠不會過期，不用每 7 天重簽。
• 完全免費，不需要 Apple 開發者帳號。
• 不需要接電腦，之後所有更新都是你自己改網頁內容、iPhone 上重新整理就會拿到新版。

代價是它拿不到「真正 App」才有的少數功能（見下方「限制」），但對「追蹤論文進度」這件事來說已經完全夠用。

---

功能一覽

• 自訂階段：階段（例如「撰寫中」「修改中」）的名稱、顏色、順序都可以自己改，也可以新增或刪除階段。
• 自訂欄位：可以幫每張卡片加上自己想記錄的欄位（例如「版本」「檔案路徑」），欄位型態有單行文字、多行文字、單選、日期、數字、檔案路徑、連結等。
• 多專案：可以同時管理好幾個看板（例如「碩士論文」和另一個研究計劃各開一個），互相切換。
• 拖曳換階段：手指按住卡片拖到別的欄位，就能改變它的階段。
• 停留時間提示：卡片上會顯示距離上次更新過了多久，讓你一眼看出哪張卡片已經放了很久沒動。
• 匯出／匯入：可以把全部資料匯出成一個檔案備份，也可以把備份檔匯入回來，或是重設回預設範本、清空全部重來。
• Google Sheets 同步（選配）：可以把資料同步到一份 Google 試算表，這樣在 Mac 上打開瀏覽器也看得到、甚至可以直接在試算表上編輯（細節見下方「限制」與 docs/SETUP-GOOGLE-SHEETS.md）。

資料放在哪？

預設情況下，所有資料只存在你這支 iPhone 的 Safari 裡（技術上是瀏覽器的本機儲存空間），不會自動上傳到任何地方，包括這個專案本身的網站。

正因為資料只在手機裡，請養成習慣：定期到「設定」裡按「匯出 JSON」，把資料存一份備份到雲端硬碟或其他地方（JSON 只是這份備份檔的格式名稱，你不需要看懂裡面的內容，需要救回資料時，用「設定」裡的「選擇檔案」把這個備份檔匯入回去就好）。因為如果你在 iPhone 的「設定」App 裡清除了 Safari 的「網站資料」（例如清快取、清空間、重灌手機），這份本機資料會一起被清掉，而且無法復原。

如果你另外設定了 Google Sheets 同步（選配功能），資料才會有第二個備份存在雲端的試算表裡。設定好之後，你每次改動資料，過幾秒就會自動備份到試算表，你不需要記得按任何按鈕。

不過有兩件事要知道：

• 只有「上傳」是自動的，「下載」永遠要你自己按。 因為上傳只是把手機的資料複製一份到試算表（安全），而下載會用試算表的內容整份覆蓋手機上的資料（可能蓋掉你比較新的修改），所以它是紅色按鈕而且要確認兩次。
• 打開 app 不會自動上傳，只有你真的改了東西才會。這是刻意的：否則哪天你在一台資料是舊的裝置上打開網頁，它就會立刻用舊資料蓋掉試算表。

你隨時可以在「設定」的「同步」區把自動備份關掉，那裡也會顯示最近一次自動備份的時間，讓你確認備份是不是真的有成功。

老實說的限制

這個工具刻意做得很簡單，以下是它做不到的事，先說清楚比較不會踩雷：

• 沒有主畫面小工具（Widget）：不能像天氣、行事曆那樣在主畫面上直接看到卡片內容，一定要點開來看。
• 沒有推播通知：不會提醒你「這張卡片放了三天沒動了」，全部要自己記得打開來看。
• 放程式碼的 GitHub 倉庫是公開的：任何人都看得到這個網頁的程式碼（HTML／CSS／JavaScript），但倉庫裡不會有你的論文內容或任何個人資料 —— 你的階段、卡片、筆記等實際資料，只存在你自己的手機和（如果你設定了同步）你自己的 Google 試算表裡，不會被放進這個公開倉庫。
• Google Sheets 同步不是嚴謹的帳號登入，而是「知道網址 + 知道一組你自訂的密碼（token）」就能存取，安全性遠不如正式的帳號驗證機制。只要你不把那組網址和密碼分享出去，風險就很低，但這不是銀行等級的保護，請自行評估要不要放敏感內容進去。
• 沒有自動合併：如果你同時在手機和 Mac 上編輯，兩邊資料不會自動合併成一份，只有「整份覆蓋」的同步方式（細節見 docs/SETUP-GOOGLE-SHEETS.md 的「上傳」與「下載」說明）。

接下來要做什麼

1. 先照 docs/SETUP-GITHUB-PAGES.md 把網頁架起來，加到 iPhone 主畫面。
2. 如果想要 Mac 也能看到資料，再照 docs/SETUP-GOOGLE-SHEETS.md 接上 Google 試算表同步（這一步可以晚點再做，也可以完全不做）。