TimeTrack ⏱️

PM 項目時間追蹤工具 — 輕鬆記錄工作時間，分析效率，方便 billing！

✨ 功能

⏱️ 時間記錄

• 一鍵開始/停止計時
• 快速手動輸入時間
• 項目 + 任務分類
• 備註說明

📊 Dashboard

• 今日/本周/本月時間統計
• 按項目分類圖表
• 按客戶分類統計
• 效率趨勢分析

📁 項目管理

• 建立項目 + 客戶關聯
• 預算時數設定
• 進度追蹤
• Billable / Non-billable 分類

📋 報告

• 每周時間報告
• 客戶 billing 報告
• 導出 CSV/PDF

📸 Screenshots

Dashboard 總覽

時間記錄

報告

🚀 快速開始

前置要求

• Docker & Docker Compose

一鍵啟動

git clone https://github.com/erictong514/timetrack.git
cd timetrack
docker-compose up -d

訪問

• Frontend: http://localhost:3010
• API: http://localhost:3011
• Adminer: http://localhost:8091

🛠️ 技術 Stack

• Frontend: NUXT UI Pro
• Backend: PostgREST
• Database: PostgreSQL 15
• Deploy: Docker Compose

📝 Database Schema

Tables

• clients - 客戶資料
• projects - 項目資料
• tasks - 任務分類
• time_entries - 時間記錄

Views

• daily_summary - 每日統計
• weekly_summary - 每周統計
• project_hours - 項目時數
• billing_report - Billing 報告

🎯 Use Cases

PM 工作

• 追蹤每個項目花咗幾多時間
• 分析時間分配係咪合理
• 識別效率瓶頸

Area2 客戶 Billing

• 按客戶計算 billable hours
• 生成專業時間報告
• 追蹤預算使用情況

個人效率

• 了解時間去咗邊
• 設定專注目標
• 減少時間浪費

📄 License

MIT

---

Built with ❤️ for Eric's productivity!