如何打造健身應用程式：訓練、紀錄、進度與教練功能

健身應用程式讓人們能跟著訓練、記錄自己實際做過的內容，並看到長期的進步。核心包括動作資料庫、訓練計畫、可以在組與組之間快速使用的紀錄畫面，以及附圖表的歷史紀錄。教練類應用程式則增加另一面：由教練建立課表，學員依循執行。建議先以適合手機的網頁應用程式打造，保持紀錄畫面簡單，並誠實看待網頁應用程式能與不能從手機與穿戴裝置讀取哪些資料。

選擇健身應用程式的類型

最後一種其實是預約應用程式；請參閱如何打造健身房會員應用程式。本指南聚焦於前三種。

健身應用程式需要什麼

頁面

• 今日——今天排定的訓練，或快速的「開始空白訓練」。
• 訓練紀錄工具——每個動作與其組數；點選即可輸入重量與次數，完成後勾選，組與組之間有休息計時器。
• 動作資料庫——名稱、肌群、器材、說明，以及選用的影片或圖片。
• 計畫與範本——可重複使用的訓練與多週課表。
• 歷史紀錄——依日期列出過往的訓練。
• 進度——每個動作的圖表（最重組數、估計一次最大重量、總訓練量），以及使用者需要時的身體測量數據。
• 教練專區——學員清單、課表建立工具、學員回報與留言。

資料

• 動作——名稱、類型（力量、有氧、計時、徒手）、肌群、器材、說明。
• 訓練範本——名稱，以及依順序排列的動作，包含目標組數、次數與休息時間。
• 課表——週與日，每一天連結到一個範本。
• 訓練紀錄（Session）——使用者、日期、範本（如有）、備註、時長。
• 組數（Set）——訓練紀錄、動作、組序、重量、次數、距離或時間、RPE（自覺費力程度），以及是否完成。
• 身體數據——使用者、日期、體重與其他測量值。

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

權限

個人紀錄工具需要每人一個帳號，且資料完全私密。教練類應用程式則需要教練與學員兩種角色：教練只能看到自己的學員，學員只能看到自己的資料。測試時，應確認一位學員即使修改網址列中的 ID，也無法打開另一位學員的訓練紀錄。

決策與取捨

網頁應用程式還是原生應用程式。 原生應用程式可以讀取 Apple 健康、在背景執行，並顯示在鎖定畫面上。網頁應用程式完全無法讀取 Apple 健康，但它能在所有手機上運作，不需要應用程式商店審核，並可以以漸進式網頁應用程式（PWA）的形式安裝到主畫面。對於紀錄工具或教練應用程式，網頁應用程式已能很好地涵蓋核心功能。請參閱原生應用程式與漸進式網頁應用程式的比較。

穿戴裝置。 部分穿戴裝置與健身平台提供網頁 API，可在使用者授權後串接。在依賴任何一家之前，請先查看其開發者條款。跑步與心率的手動輸入，是很好的第一版。

預先建立的動作資料庫還是自行建立。 從一百個常見動作的清單開始，能為使用者節省時間。動作說明請自行撰寫，或使用授權允許的來源；不要複製其他應用程式的資料庫。

健身房的訊號。 健身房的網路訊號通常不佳。請要求紀錄工具在訓練中斷線時仍能繼續運作，並在連線恢復時儲存；至少，已輸入的組數絕不能遺失。

安全與隱私

健身應用程式不是醫療器材。不要提供醫療建議，並加入簡短說明，提醒使用者在開始課表前，尤其是有健康狀況時，先諮詢專業人員。體重、身體測量、傷病與健康備註都屬於個人資料；部分法律將與健康相關的資料列為特殊類別。請預設所有資料保持私密，只蒐集你會使用的資料，並讓使用者可以匯出與刪除自己的資料。

首次提示詞範例

為我的私人教練學員打造一個教練應用程式，優先為手機設計。兩種角色：教練與學員。作為教練，我可以從動作資料庫建立訓練範本（名稱、肌群、器材、說明、類型：重量、徒手、時間或距離），將其組合為多週課表，並將課表指派給學員。學員可以看到今日訓練，以重量與次數（或時間、距離）記錄每一組，勾選完成的組數，並在組與組之間啟動休息計時器。若連線中斷，已輸入的組數絕不能遺失。重量以公斤儲存，並讓每位使用者選擇以公斤或磅顯示。學員可以看到自己的歷史紀錄，以及每個動作的進度圖表（最重組數與估計一次最大重量）。我可以看到自己的學員清單、他們已完成的訓練紀錄，並可在任何一筆訓練紀錄上留言。每位學員只能看到自己的資料。使用電子郵件與密碼登入，並使用資料庫。預先植入 40 個常見動作與兩位示範學員。

建置步驟

1. 先做紀錄工具。 組數輸入畫面決定了是否有人會使用這個應用程式。輸入框要大，使用數字鍵盤，並支援一鍵複製上一組。
2. 動作資料庫與範本。 預先植入常見動作，並確認每種類型都顯示正確的欄位。
3. 歷史紀錄與進度圖表。 用幾週的假資料測試，讓圖表看起來真實。
4. 帳號與角色。 加入登入功能，然後建立教練與學員角色。嘗試打開另一位學員的資料，並確認會失敗。請參閱如何為應用程式加入登入功能。
5. 課表。 週、日，以及學員錯過一堂課時會發生什麼事。
6. 安裝到手機。 將應用程式加入手機主畫面，並真正用它完成一次訓練。請參閱如何打造適合手機的網頁應用程式。
7. 與三位學員進行測試版試用。 觀察他們在哪裡猶豫。

常見錯誤

• 輸入框太小。 人們在組與組之間手上流汗時記錄。目標按鈕要大。
• 所有動作使用同一組欄位。 平板支撐、跑步與深蹲需要不同的欄位。
• 儲存時混用單位。 只儲存一種單位，顯示時再轉換。
• 連線中斷時遺失組數。 先儲存在本機。
• 在網頁應用程式中承諾 Apple 健康同步。 沒有原生應用程式就無法做到。
• 上線時功能過多。 社交動態、徽章與 AI 生成的計畫，都可以等基本流程運作之後再加入。
• 聽起來像醫療建議的內容。 指引保持一般性，並加上明確的免責聲明。

何時現成的健身應用程式更好

如果只是追蹤自己的訓練，成熟的訓練應用程式已經擁有龐大的動作資料庫、穿戴裝置同步、離線使用與原生通知。許多私人教練也會使用專門的教練平台，其中已包含付款、訊息與品牌化應用程式。

當你的訓練方法不符合這些工具（例如特定的課表結構、特定運動的指標、有自己規則的俱樂部或團隊）、每位學員的平台費用累積成本過高，或你希望應用程式承載你的品牌與資料時，就應自行打造。如果你要圍繞它建立私人訓練事業，請參閱如何開設私人訓練事業。若只需要較簡單的每日追蹤工具，如何打造習慣追蹤應用程式是很好的起點。

使用 Mythex 打造

Mythex 會將這類應用程式打造為網頁應用程式：你在聊天中描述需求，在即時預覽的手機尺寸框架中檢查紀錄工具，然後發布到學員可以開啟並加入主畫面的公開網址。當應用程式需要時，它會加入專用的 Postgres 資料庫，並提供動作圖片或影片的檔案儲存。登入功能需要自行帶入（請參閱驗證功能的做法），如果你向學員收費，付款功能也需要自行帶入。在 Pro 方案中，Mythex 可以把應用程式包裝成 Android 與 iPhone 應用程式，但它的畫面仍是網頁畫面，因此目前無法實現需要原生程式碼的穿戴裝置與 Apple 健康整合。

常見問題