案例技術說明｜FireHealth
FireHealth 智慧健康管理平台技術說明
這是陽明交大消防員健康促進研究計畫所用平台的開發與維運紀錄：2024 年 10 月啟動、2025 年 5 月完成主要功能、2026 年起補齊部署與備份機制，一套後端同時支撐 Web 版與 iOS、Android 測試版外殼。
專案概覽
| 項目 | 內容 |
|---|---|
| 專案名稱 | FireHealth 智慧健康管理平台 |
| 狀態 | 研究用平台，持續維運中；目前沒有進行中的試驗場次。iOS 為 TestFlight 測試版、Android 為測試版 APK，均未上架商店 |
| 開發期間 | 2024 年 10 月至 2025 年 5 月（主要功能）；2026 年 4 月起陸續補 CI/CD、備份、監控與資安加固 |
| 程式庫 | 6 個，統一用 GitLab Group 管理 |
| 平台 | Web；iOS 與 Android 以原生外殼載入同一套 Web 應用（測試版） |
系統由哪些部分組成？
平台拆成六個程式庫，各自負責一塊：
| 程式庫 | 角色 | 主要技術 | 開發期提交數（至 2025-05） |
|---|---|---|---|
| firehealth-webapp | 主要的 Web 應用 | Vue 3、TypeScript、Vite、Pinia、Element Plus、Tailwind CSS、ECharts | 127 |
| firehealth-api | 後端 API | Node.js、TypeScript、Express、MongoDB、Redis、JWT、Socket.io、Swagger（OpenAPI 3.0）文件、Jest | 22 |
| firehealth-website | 對外展示網站（研究文章、地中海飲食指南） | HTML、Express | 29 |
| ReleaseWeb | 發佈與展示網站 | Vue 3、TypeScript、Vue I18n、Google Cloud Vision | 14 |
| FirehealthiOSwebapp | iOS 外殼 | Swift、WKWebView 載入 Web 應用；以 TestFlight 發行測試版 | 14 |
| HLS_Android | Android 外殼 | Kotlin、WebView 載入 Web 應用；提供測試版 APK | 1（2025-06） |
Web 應用與兩個行動外殼共用同一個 firehealth-api，健康問卷、數據與帳號權限都集中在後端處理。API 以 OpenAPI 3.0 撰寫文件。
開發時間線
| 階段 | 期間 | 重點 |
|---|---|---|
| 一、專案啟動 | 2024 年 10 月 | firehealth-website 啟動，建立專案官網與展示頁 |
| 二、基礎架構 | 2024 年 11 月 | 後端 firehealth-api 與前端 firehealth-webapp 啟動 |
| 三、課程內容上架 | 2025 年 1 月底至 2 月 | 睡眠、營養、體能、韌性四模組三個等級的課程頁集中上架；iOS 外殼開工 |
| 四、功能擴充 | 2025 年 3 月至 5 月 | 習慣養成、社群任務；iOS 外殼進 TestFlight |
| 五、行動版與官網改版 | 2025 年 6 月 | Android 外殼；官網改寫為 Vue 3 |
| 六、維運補強 | 2026 年 4 月起 | 搬遷主機、CI/CD、每日備份與告警、監控、寄信改道、AI 教練示範頁（/ai-demo，腳本式示意、未接模型） |
健康研究平台要特別注意什麼？
- 個人健康資料：問卷與健康數據屬於敏感個資，帳號採 JWT 驗證，後端集中管理存取。
- 角色分級：受試者、醫護人員與管理員看到的功能不同，權限依角色切開。
- 三端一致：Web、iOS 與 Android 共用同一套 API 與資料，避免各版本資料不一致。
- 可維護：TypeScript 前後端與 API 文件，讓後續研究階段可以接著改；測試覆蓋目前仍少，列在下一階段補齊。
常見問題
FireHealth 平台花了多久開發？
2024 年 10 月啟動，2025 年 5 月完成主要功能；之後在 2026 年陸續補上部署自動化、備份與監控。上面的時間線分成六個階段。
iOS 與 Android 版是怎麼做的？
兩個行動版都是原生外殼載入同一套 Web 應用，共用同一個後端 API，所以不用重寫功能。iOS 以 TestFlight 發行測試版、Android 提供測試版 APK，兩者都還沒上架商店；上架需要補 Apple 登入等商店規範，列在下一階段。
平台用了哪些主要技術？
前端是 Vue 3、TypeScript、Vite、Pinia 與 Element Plus，圖表用 ECharts；後端是 Node.js、Express、MongoDB 與 Redis，搭配 JWT 驗證、Socket.io 即時通訊，API 用 OpenAPI 3.0 寫文件、Jest 做測試（覆蓋率仍在補）。
我們也有研究計畫要做平台，可以找你們嗎？
可以。請到聯絡頁簡單描述研究目的、需要的平台（Web 或手機）與預計時程，我們再一起評估。
最後更新：