TaskyVenture 是一款親子任務管理應用，透過遊戲化設計和AI 智能輔助，幫助管理日常任務，增加學習動機。孩子在完成任務的過程中，可以培養責任感、時間管理能力和獨立性，同時透過遊戲學習世界地理、動物知識、成語文化等教育內容。
核心特色：
- 🗂️ 豐富的任務管理系統 - 主線、支線、限時任務，支援週期任務與排程管理
- 🎁 視覺化獎勵商店 - 星星經濟、道具收集、等級制度
- 📚 知識寶庫 - 收集與管理學習到的知識卡片，建立個人知識庫
- 🎮 教育小遊戲 - 環保、健康、文學、數學、語文等多領域學習
- 🗺️ 冒險地圖 - 3D 地球儀探索，認識不同國家/動物，拼圖解鎖機制
- 🌙 貼心輔助機制 - 睡前檢查清單、心情記錄抽卡、動物碎片蒐集、每日簽到
- React 19.1.0 + TypeScript 4.9.5 + Material UI 7.0.1
- Framer Motion - 動畫效果
- React Router 7.4.1 - 路由管理
- amCharts 5.12.1 - 3D 地球儀與統計圖表
- Recharts 2.15.4 - 數據分析圖表
- PWA + TWA - 多平台支援
- Firestore - NoSQL 即時數據庫
- Authentication - Email、Google 登入
- Cloud Functions - Node.js 20 後端邏輯
- AI 整合 - Google Gemini API
- Storage - 資源存儲
- Hosting - 靜態網站部署
- Analytics - 用戶行為追蹤
# 克隆專案
git clone https://github.com/NaveedTsai/TaskyVenture.git
cd TaskyVenture
# 安裝依賴
npm install
cd functions && npm install && cd ..
# 配置環境變數
cp .env.example .env
cp .firebaserc.example .firebaserc編輯 .env 文件：
REACT_APP_FIREBASE_API_KEY=your_api_key
REACT_APP_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
REACT_APP_FIREBASE_PROJECT_ID=your_project_id
REACT_APP_FIREBASE_STORAGE_BUCKET=your_project.appspot.com
REACT_APP_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
REACT_APP_FIREBASE_APP_ID=your_app_id
REACT_APP_FIREBASE_MEASUREMENT_ID=your_measurement_idnpm start # 前端開發伺服器# 設置 Cloud Functions 環境變數
firebase functions:secrets:set GEMINI_API_KEY
# 構建並部署
npm run build
firebase deploy
# 或分別部署
npm run deploy:app # 僅部署應用
npm run deploy:functions # 僅部署 Cloud Functions本專案採用 AGPL v3 + Non-Commercial Use 授權。這意味著您必須開源您的修改，且嚴格禁止商業使用。
✅ 開源 - 必須公開完整的源代碼 (AGPL v3) 🚫 非商業 - 嚴格禁止任何形式的商業用途 (Selling, SaaS, Commercial Products) 📝 署名 - 保留原作者版權聲明
詳見 LICENSE。
使用說明：本專案開源用於技術學習和教育用途，允許個人為自己家庭部署使用。若需商業使用，請聯繫我們獲取商業授權。
- 🌐 官方網站：www.taskyventure.com
- 📧 客服信箱：support@taskyventure.com
- 📱 粉絲專頁：Facebook 粉絲專頁
⭐ 如果你喜歡這個專案，請給我們一個 Star！
Made with ❤️ by TaskyVenture Team