在完成使用者認證、復健任務管理之後，Day 10 的開發重點放在 Progress Service，也就是「復健進度追蹤系統」。這個服務主要負責病患的日常訓練紀錄、成效分析、任務完成度追蹤，並將結果提供給病患本人及醫療團隊（物理治療師、醫師）作為後續調整治療計畫的依據。

核心功能

1️⃣ 訓練紀錄（Session Recording）

• 功能：病患在每次完成復健任務後，可透過 recordSession API 建立新的進度紀錄。
• 驗證機制：
  • 確認任務 (RehabTask) 是否存在並且隸屬該病患。
  • 檢查必要欄位，例如：sessionDuration、completionStatus、assessments。
  • assessments 內包含多項必填指標：如訓練前後的疼痛與活動度、能量狀態等。
• 自動化處理：
  • 計算完成百分比（completed=100%、partial=50%、skipped=0%）。
  • 更新任務的已完成次數 (schedule.completedSessions)。
  • 儲存訓練評估與病患備註，供後續查詢。

2️⃣ 進度查詢（Progress History）

• 功能：透過 getProgressHistory，病患可查詢自己的歷史紀錄，支援：
  • 條件過濾：任務 ID、起迄日期、完成狀態。
  • 分頁與排序：預設依日期由新到舊。
• 使用情境：
  • 病患檢視自己的訓練紀錄。
  • 醫療團隊掌握近期完成度與疼痛變化。

3️⃣ 成效分析（Progress Analytics）

• 功能：getProgressAnalytics 提供統計與趨勢分析：
  • 整體統計：總訓練次數、平均完成度、疼痛改善幅度、平均努力程度與難度。
  • 疼痛趨勢：以日期分組，觀察疼痛前後變化與改善率。
  • 任務完成率：計算每個復健任務的完成場次、疼痛減少幅度與完成百分比。
• 應用價值：
  • 物理治療師可依據疼痛趨勢調整訓練強度。
  • 病患可透過數據了解進步幅度，提升動機。

4️⃣ 任務特定進度（Task Progress）

• 功能：getTaskProgress 用於查詢單一復健任務的所有紀錄與成效指標，包括：
  • 任務完成率：已完成場次 / 總場次。
  • 疼痛改善平均值。
  • 依從率（Adherence Rate）：實際訓練次數 / 預期次數。
  • 連續完成紀錄：計算當前與最長連續完成天數。

5️⃣ 進度維護

• 更新進度：updateProgress 允許病患修改自己的紀錄，但禁止更改關鍵欄位（如 patient、task ID）。
• 刪除進度：deleteProgress 可移除指定紀錄，並同步調整任務已完成次數。

6️⃣ 醫療端查詢

• 功能：getPatientProgressForProvider 允許醫療提供者（物理治療師、醫師）查看自己所負責病患的進度紀錄。
• 過濾條件：可依病患 ID、任務 ID、日期範圍過濾，並支援分頁。

🌐 API 路由表

📊 追蹤數據

• 疼痛評估：運動前 / 運動中 / 運動後 (0–10 分)
• 活動度變化：關節活動範圍改善
• 運動表現：努力程度、難度、動作品質、組數紀錄
• 自動指標：疼痛改善率、依從率、連續完成天數

✅ 測試亮點

• 完整紀錄運動數據並自動更新完成次數
• 即時產出疼痛與活動度的改善趨勢
• 醫療人員可跨病患查看進度，輕鬆調整治療方案