SolidFocus App 技術設計文件

章節目錄

1. 系統概要 - 系統簡介、目標、系統架構圖

2. 系統架構 - 元件圖、部署架構、高階流程圖

3. App 設計

   • App 架構 - iOS 架構、核心服務
   • 藍牙裝置整合 - 藍牙連線、FTMS 整合
   • 流程與同步策略 - App 與 API 互動流程

4. API

   • API 規格 - 完整 API 規格
   • 資料模型 - 資料庫 Schema

---

相關文件

外部規格文件

• 後端平台設計規格書 v3.0 - SolidFocus 提供的完整後端 API 規格
• Bluetooth FTMS v1.0.1 Specification - 官方藍牙 FTMS 規範

PDF 參考文件

• SolidFocus FTMS 整合規範 - 裝置整合技術文件
• 城紹 App 與藍牙整合文件 - 藍牙串接實作說明

---

文件變更記錄

日期	章節	變更內容	理由	影響範圍
2025-12-17	全部	初版建立	建立完整技術設計文件	所有章節 (01-07, 99)
2025-12-24	04-API Contract	與 Client Backend Specification v3.0 對齊	SolidFocus 提供正式 API 規格 (Notion, 2025-12-19)，需更新 API 文件以匹配實際後端實作	API Contract 所有章節 (4.1-4.4, README)
2026-01-20	03-App 設計、04-API	新增 GDPR 合規設計	App 將在歐盟上架，必須符合 GDPR 合規要求（首次使用明確同意、帳號刪除功能、刪除稽核日誌）	03.3 Data Flow (新增 Flow 9、更新 Flow 1/2)、04.1 API Specification (新增 GDPR API)、04.2 Data Models (新增 UserConsent、DeletionRequest 資料表)

---

本文件為動態演進中（Work in Progress），將隨專案進展持續更新。