📖 Git 練功房 (Git Practice Tracker) 使用說明 🎯

DEMO: https://liwenchiou.github.io/git-practice-tracker/

應用程式目的

本工具旨在透過分析您 GitHub 專案中特定分支的 Commit 歷史，自動計算您在各項課程練習上所投入的總時長，協助您追蹤學習進度和效率。

---

1. 核心工作流程約定：如何讓程式讀懂時間

您的 Git 操作必須遵循以下 3 個規範，否則程式無法識別哪些分支要計算，以及計算的起點和終點。

步驟 1: 分支命名規範 (篩選)

只有符合此約定的分支會被程式追蹤和統計。
約定模式： 分支名稱必須以 pra 開頭（程式碼中設定）。

範例：

• ✅ pra-week3-hooks
• ✅ practice/redux-module
• ❌ feature/login-fix (會被忽略)

步驟 2: Commit 標籤規範 (計時)

您必須在練習的 第一個 和 最後一個 Commit 中使用特定的標籤：

標籤	時機	程式碼識別關鍵字	意義
START	開始一個練習時的第一個 Commit	START:	標記 T_start (起始時間)
DONE	完成該練習時的最後一個 Commit	DONE:	標記 T_end (結束時間)

步驟 3: Git 實際操作範例

開始一個新練習的標準流程如下：

---

2. 應用程式操作指南

2.1 設定與追蹤

• 輸入 GitHub Username： 在「GitHub Username」欄位輸入您的帳號。
• 點擊「驗證」： 系統會檢查帳號是否正確，驗證成功後才會顯示您的使用者頭像以及專案列表。
• 選擇專案： 從下拉選單中選擇您要追蹤的包含練習分支的專案。
• 點擊「開始追蹤」：
  • 若尚未驗證，系統會跳出「請先驗證」的提示訊息。
  • 驗證成功後，系統將執行以下操作：
    • 獲取該專案所有分支
    • 篩選出所有以 pra 開頭的分支
    • 並行查詢每個分支的 Commit 歷史，尋找 START: 和 DONE: 標籤
    • 計算每次練習的開始、結束、完成時間
    • 顯示最佳成績

2.2 結果解讀

在「追蹤結果」區塊，您將看到一份詳盡的表格：

• 練習分支： 符合 pra 命名約定的分支名稱
• 開始時間： 該分支中最舊的 START: Commit 時間
• 結束時間： 該分支中最新的 DONE: Commit 時間
• 完成時長： 兩個時間戳記之間的總經過時長（格式：HH 小時 MM 分鐘）
• 最佳成績： 所有練習中耗時最短的一次結果