如何建立健身應用程式：訓練、紀錄、進度同教練功能

健身應用程式讓人跟隨訓練、紀錄實際做咗咩，並睇到一段時間內嘅進度。核心係一個動作庫、訓練計劃、一個喺組與組之間都夠快可以用嘅紀錄畫面，以及附有圖表嘅歷史紀錄。教練類應用程式會再加一個方向：由教練設計課程、學員跟隨課程。先以手機友好嘅網頁應用程式開始，紀錄畫面保持簡單，並老實講明網頁應用程式可以同唔可以讀取手機同穿戴裝置嘅數據。

揀選健身應用程式嘅類型

最後一種其實係預約應用程式；請參閱如何建立健身會籍應用程式。本指南主要集中於首三種。

健身應用程式需要具備嘅內容

頁面

• 今日：今日排定嘅訓練，或者一個「開始空白訓練」快捷按鈕。
• 訓練紀錄工具：每個動作連同其組數；點擊輸入重量同次數，完成後打勾，組與組之間有休息計時器。
• 動作庫：名稱、肌肉群、器材、指引，以及可選嘅影片或圖片。
• 計劃同範本：可以重用嘅訓練，以及多星期課程。
• 歷史：按日期排列嘅過往訓練。
• 進度：每個動作嘅圖表（最重一組、估計一次最大重量，以及總訓練量），如果用戶想要，亦可以包括身體量度紀錄。
• 教練專用：學員名單、課程建立工具、學員進度檢查同留言。

資料

• 動作：名稱、類型（力量、有氧、計時、徒手）、肌肉群、器材、指引。
• 訓練範本：名稱，以及按次序排列嘅動作，附目標組數、次數同休息時間。
• 課程：以週同日為單位，每日連結到一個範本。
• 訓練記錄：用戶、日期、範本（如有）、備註、時長。
• 組：訓練記錄、動作、第幾組、重量、次數、距離或時間、RPE（自覺用力程度），以及是否完成。
• 身體數據：用戶、日期、體重、其他量度。

將重量統一以一種單位儲存（例如公斤），顯示時再換算，咁切換單位就唔會損壞歷史紀錄。不同類型嘅動作需要唔同欄位：平板支撐需要時間，跑步需要距離同時間，深蹲需要重量同次數。

權限

個人紀錄工具需要每人一個帳戶，而數據要完全私人。教練類應用程式則需要教練同學員角色：教練只可以睇到自己嘅學員，學員只可以睇到自己嘅數據。要測試一位學員唔可以打開另一位學員嘅訓練紀錄，例如改動網址列入面嘅 ID，睇吓會唔會失敗。

決定同取捨

**網頁應用程式定係原生應用程式。**原生應用程式可以讀取 Apple Health、喺背景運行，亦可以喺鎖定畫面顯示內容。網頁應用程式完全讀取唔到 Apple Health，但可以喺所有手機運作，唔需要應用程式商店審核，亦可以作為漸進式網頁應用程式安裝到主畫面。對紀錄工具或教練類應用程式而言，網頁應用程式已經足夠處理核心功能。請參閱原生與漸進式網頁應用程式。

**穿戴裝置。**部分穿戴裝置同健身平台提供網頁 API，可以在用戶許可之下連接。規劃依賴呢啲功能之前，請先查閱各供應商嘅開發者條款。對第一個版本而言，手動輸入跑步同心率已經好好。

**預設動作庫，定係自己建立。**一開始就提供一百個常見動作，可以節省用戶時間。指引要自己撰寫，或使用授權容許嘅來源；唔好複製其他應用程式嘅動作庫。

**健身室訊號。**健身室經常收訊差。要求紀錄工具即使喺訓練途中斷線都可以繼續運作，並喺重新連線後儲存；至少要確保已輸入嘅組數永遠唔會遺失。

安全同私隱

健身應用程式唔係醫療器材。唔好畀醫療建議，並加入簡短提示，說明用戶開始任何課程之前，尤其是有健康狀況嘅人，應該先諮詢專業人士。體重、身體量度、受傷同健康備註都屬於個人資料；部分法例將健康相關資料列為特殊類別。預設將一切保持私人，只收集你會用到嘅資料，並讓人可以匯出同刪除自己嘅數據。

範例首個提示

為我嘅私人教練學員建立一個教練應用程式，以手機優先設計。兩個角色：教練同學員。作為教練，我可以由動作庫（名稱、肌肉群、器材、指引、類型：重量、徒手、時間或距離）建立訓練範本，將其組合成多星期課程，並將課程指派畀學員。學員每日可以看到今日訓練，並為每組紀錄重量同次數（或時間或距離），勾選已完成組數，並在組與組之間啟動休息計時器。如果連線中斷，已輸入嘅組數絕對不可以遺失。重量以公斤儲存，並讓每位用戶選擇以公斤或磅顯示。學員可以看到自己嘅歷史紀錄，以及每個動作嘅進度圖表（最重一組同估計一次最大重量）。我可以看到我嘅學員名單、佢哋已完成嘅訓練，並可以喺任何訓練上留言。每位學員只可以看到自己嘅數據。電郵同密碼登入，加上資料庫。加入 40 個常見動作同兩位示範學員。

建立步驟

1. **先做紀錄工具。**組數輸入畫面決定大家會唔會用呢個應用程式。輸入框要大，用數字鍵盤，並可以一按就複製上一組。
2. **動作庫同範本。**加入常見動作，並檢查每種類型是否顯示正確欄位。
3. **歷史同進度圖表。**用幾星期嘅假數據測試，令圖表睇落真實。
4. **帳戶同角色。**加入登入，然後教練同學員角色。嘗試打開另一位學員嘅數據，並確保會失敗。請參閱如何為應用程式加入登入功能。
5. **課程。**週、日嘅結構，以及學員錯過一節時會發生咩事。
6. **安裝到手機。**將應用程式加到手機主畫面，並真正用佢做一次訓練。請參閱如何建立手機友好嘅網頁應用程式。
7. **同三位學員試用。**觀察佢哋喺邊度猶豫。

常見錯誤

• **輸入框太細。**人哋喺組與組之間用汗濕嘅手紀錄。目標數值要做得大。
• **所有動作都用同一套欄位。**平板支撐、跑步同深蹲需要唔同欄位。
• **儲存時混合單位。**儲存一種單位，顯示時再換算。
• **連線中斷就遺失組數。**先儲存到本機。
• **喺網頁應用程式承諾 Apple Health 同步。**冇原生應用程式就做唔到。
• **推出時功能太多。**社交動態、徽章同 AI 生成計劃，都可以等基本循環運作之後再加。
• **聽起嚟似醫療建議嘅內容。**指引保持一般性，並加入清晰嘅免責聲明。

幾時現成嘅健身應用程式更好

如果你只係想追蹤自己嘅訓練，成熟嘅訓練應用程式已經有龐大嘅動作庫、穿戴裝置同步、離線使用同原生通知。好多私人教練都會用專門嘅教練平台，裡面包括付款、訊息同品牌應用程式。

以下情況就應該自行建立：你嘅訓練方法唔符合呢啲工具（例如特定嘅課程結構、運動專用指標、有自己規則嘅球會或團隊）、每位學員嘅平台費用累積起嚟好貴，或者你希望應用程式帶有你自己嘅品牌同數據。如果你正準備圍繞佢建立健身業務，請參閱如何開展私人健身訓練業務。如果只需要一個較簡單嘅日常追蹤器，如何建立習慣追蹤應用程式 係一個好嘅起點。

用 Mythex 建立

Mythex 將呢個建立為網頁應用程式：你喺對話入面描述，喺即時預覽嘅手機尺寸框架中檢查紀錄工具，然後發佈到學員可以開啟並加到主畫面嘅公開地址。應用程式需要時，佢會加入專用嘅 Postgres 資料庫，並為動作圖片或影片提供檔案儲存。登入需要你自備，請參閱認證範例；如果你向學員收費，付款亦需要自備。喺 Pro 計劃，Mythex 可以將應用程式包裝成 Android 同 iPhone 應用程式，但佢嘅畫面係網頁畫面，所以目前暫時做唔到需要原生程式碼嘅穿戴裝置同 Apple Health 整合。

常見問題