Behavior Monitor 是一個全功能的行為監控和管理系統，使用現代化技術棧構建。通過獎懲機制來鼓勵積極行為和改正不良行為，提供實時分數追蹤、統計分析和自動化管理功能。

• 📊 實時分數顯示 - 大字體顯示目前表現分數，動態背景色彩
• 🔐 管理員介面 - 密碼保護的管理面板，完整的分數管理功能
• 📈 統計分析 - 多種圖表類型，靈活的時間範圍分析
• 📝 歷史記錄 - 完整的操作日誌和原因追蹤
• ⚡ 自動化功能 - 每日自動增加分數的排程任務（Lazy Update）
• 🔔 通知系統 - 門檻設定和通知框架
• 📱 響應式設計 - 支援所有設備尺寸

• Frontend: React 19 + TypeScript + Vite
• UI Library: Ant Design 5 + @ant-design/charts
• Backend: Firebase Firestore + Cloud Functions
• Deployment: GitHub Pages + GitHub Actions CI/CD
• State Management: React Context + useReducer

• Node.js 18+
• npm 或 yarn
• Git

# 克隆專案
git clone https://github.com/DF-wu/BehaviorMonitor.git
cd BehaviorMonitor

# 安裝依賴
npm install

# 開發模式
npm run dev

# 生產構建
npm run build

# 預覽生產版本
npm run preview

# 一鍵部署到 GitHub Pages
npm run deploy:gh-pages

# 或使用自定義腳本
./docs/scripts/deploy.sh

BehaviorMonitor/
├── 📁 src/                    # 源代碼
│   ├── components/            # React 組件
│   ├── context/              # 狀態管理
│   ├── services/             # Firebase 服務
│   ├── types/                # TypeScript 類型
│   └── config/               # 配置文件
├── 📁 functions/             # Firebase Functions
├── 📁 docs/                  # 文檔目錄
│   ├── fixes/                # 修復記錄
│   ├── features/             # 功能文檔
│   ├── guides/               # 指南文檔
│   └── scripts/              # 腳本文件
├── 📁 tools/                 # 工具文件
├── 📁 public/                # 靜態資源
└── 📁 .github/workflows/     # CI/CD 配置

npm run dev          # 開發服務器
npm run build        # 生產構建
npm run lint         # 代碼檢查
npm run preview      # 預覽構建結果
npm run deploy       # 部署到 GitHub Pages

./docs/scripts/test-app.sh        # 運行完整測試套件
./docs/scripts/check-deployment.sh # 檢查部署狀態

• 🎨 動態背景色彩（綠色：優秀，藍色：普通，紅色：需改進）
• 📊 大字體分數顯示
• 📈 統計圖表分析（趨勢、每日統計、熱力圖、統計摘要）
• 📝 歷史記錄列表
• 🔘 管理員入口浮動按鈕

• 🏠 儀表板概覽
• ⚡ 快速操作面板（無分數限制）
• 📈 統計圖表分析
• ⚙️ 系統設定管理

• 🔄 Lazy Update: 自動補齊錯過的每日分數
• 🚫 無限制操作: 移除分數和訊息長度限制
• 📊 豐富圖表: 趨勢分析、每日統計、活動熱力圖
• 🎯 智能管理: 密碼保護、操作記錄、自動化功能

1. Fork 專案
2. 創建功能分支：git checkout -b feature/new-feature
3. 提交變更：git commit -m 'Add new feature'
4. 推送分支：git push origin feature/new-feature
5. 創建 Pull Request

• 使用 TypeScript 進行類型檢查
• 遵循 ESLint 規則
• 添加適當的註解和文檔
• 確保所有測試通過

MIT License - 詳見 LICENSE 文件

• 📖 查看 文檔
• 🐛 提交 Issue
• 💬 參與 Discussions

• 🌐 Website: 專案主頁