👵 ElderFriendlyApp (長者友善應用程式)

[!IMPORTANT] V1.0.0 穩定版本已發布。本版本針對 Flutter Web 相容性、後端模型設備偵測以及系統安全性進行了全方位優化。

ElderFriendlyApp 是一個專為長者設計的整合性回報系統。結合了 Flutter Web 跨平台前端技術與 Django 強大的模型處理後端，旨在提供簡單、直觀且安全的使用體驗。

✨ 核心特色 (Key Features)

• 🎨 現代化設計：全面切換至 Material Design 3，確保在所有 Web 瀏覽器上穩定運行並提供優質視覺感受。
• 🧠 人工智慧驅動：
  • 情緒偵測：使用 BERT 模型自動分析使用者回報問題時的情緒（正面、中立、負面）。
  • 語言輔助：整合語音辨識技術，讓長者可以更輕鬆地透過語音進行回報。
• 📍 精準室內定位：基於 WiFi 指紋技術（RSSI）提供室內定位輔助，精確鎖定回報位置。
• 🛡️ 安全架構：
  • 全面使用 .env 隔離敏感憑證與開發設定。
  • 採用 uv 高效能 Python 套件管理器，確保依附項目的精準性與穩定性。

🛠️ 技術棧 (Technology Stack)

🚀 快速啟動 (Getting Started)

1. 後端設定 (Django)

確保你的電腦已安裝 uv 套件管理器。

# 進入後端目錄
cd mysite

# 同步依附項目
uv sync

# 啟動開發伺服器
uv run python manage.py runserver 127.0.0.1:8000

[!NOTE] 請確保 mysite/.env 檔案內包含正確的 SECRET_KEY 與 Google OAuth 憑證。

2. 前端設定 (Flutter)

# 進入前端目錄
cd frontend/apitest

# 取得套件
flutter pub get

# 啟動 Web 服務 (建議指定 Port 8080)
flutter run -d chrome --web-port 8080

📂 專案結構 (Project structure)

.
├── frontend/apitest/      # Flutter 前端專案
│   └── lib/               # 核心開發功能
│       ├── pages/         # 頁面 UI
│       └── API.dart       # API 介面層
├── mysite/                # Django 後端專案
│   ├── main/              # 核心應用程式邏輯
│   ├── dl_model/          # AI 模型解析與前處理
│   ├── pyproject.toml     # uv 專案設定檔
│   └── .env               # 環境變數設定 (已略過)
├── task.md                # 任務紀錄
├── plan.md                # 實作計畫
└── rule.md                # 專案規範

⚠️ 故障排除 (Troubleshooting)

• SocketException (OS Error: 10048)：這通常是埠號 (8000 或 8080) 被佔用。請重啟終端機或手動殺死對應 PID。
• CUDA 報錯：後端已修復設備偵測邏輯，系統會判斷是否有 GPU 並自動切換至 CPU。
• 權限要求：在 Web 錄音時，請手動在瀏覽器網址列允許「麥克風」權限。

---

本專案遵循 Apache-2.0 授權協議。