PeakActivity - Akıllı Üretkenlik ve Dijital Sağlık Koçu

Son Güncelleme: 2025-07-09 03:10:34

PeakActivity, ActivityWatch projesini temel alarak geliştirilmiş yeni nesil bir SaaS ürünüdür. Ham veri yığınları sunmak yerine, yapay zeka aracılığıyla veriyi eyleme geçirilebilir, kişiselleştirilmiş ve bağlamsal bilgelere dönüştürür.

🎯 Proje Vizyonu

ActivityWatch'ın güçlü veri toplama altyapısını kullanarak, kullanıcıların sadece zamanlarını nereye harcadıklarını görmelerini değil, aynı zamanda üretkenliklerini, odaklanma kalitelerini ve dijital refahlarını proaktif olarak artırmalarını sağlayan kapsamlı bir çözüm.

🏗️ Teknik Mimari

Hibrit Mimari Yapısı

• Yerel Veri Toplama: ActivityWatch modifiye edilmiş izleyicileri
• Bulut Omurgası: Google Firebase ekosistemi
• Frontend Katmanları: Windows masaüstü (Tauri) + Web paneli (Vue.js)

Teknoloji Yığını

• Desktop App: Tauri + Vue.js 3 + TypeScript
• Web Panel: Vue.js 3 + Composition API + TypeScript
• Backend: Firebase Cloud Functions (Python)
• Database: Cloud Firestore
• Authentication: Firebase Auth
• Hosting: Firebase Hosting + Google Cloud Platform

📁 Proje Yapısı

awfork/
├── desktop-app/          # Tauri Windows uygulaması
├── web-panel/           # Vue.js web paneli
├── cloud-functions/     # Firebase Cloud Functions (Python)
├── shared/              # Ortak TypeScript tipleri
├── .cursor/rules/       # Cursor IDE geliştirme kuralları
├── docs/               # Proje dokümantasyonu
├── firebase.json       # Firebase yapılandırması
├── .firebaserc        # Firebase proje ayarları
└── README.md          # Bu dosya

🚀 Geliştirme Kuralları

Kodlama Standartları

• Dil: Tüm kod ve dosya isimleri İngilizce
• Açıklamalar: Kullanıcı arayüzü metinleri ve açıklamalar Türkçe
• Commit: İngilizce commit mesajları
• Çalışma Akışı: 3 prompt geliştirme döngüsü

Geliştirme Ortamı Kurulumu

Ön Gereksinimler

• Node.js 18+
• Python 3.9+
• Rust (Tauri için)
• Firebase CLI
• Git

Kurulum Adımları

1. Ön Gereksinimleri Kurun

   • Node.js: Eğer yüklü değilse, Node.js resmi web sitesi adresinden LTS sürümünü indirin ve kurun. Kurulumdan sonra node -v ve npm -v komutlarını çalıştırarak doğru şekilde kurulduğunu doğrulayın.
   • Diğer tüm ön gereksinimlerin (Python, Rust, Firebase CLI, Git) yüklü olduğundan emin olun.

2. Depoyu Klonlayın

   git clone <repository-url>
   cd PeakActivityMain

3. JavaScript Bağımlılıklarını Kurun

   npm install
   cd functions
   npm install
   cd ../aw-server/aw-webui
   npm install
   cd ../../..

4. Python Bağımlılıklarını Kurun

   cd aw-server
   pip install -r requirements.txt
   cd ..

5. Firebase Kurulumu

npm install -g firebase-tools
firebase login
firebase init

6. Desktop App Kurulumu

   cd desktop-app
   npm install
   npm run tauri dev

7. Web Panel Kurulumu

   cd web-panel
   npm install
   npm run dev

8. Cloud Functions Kurulumu

   cd cloud-functions
   pip install -r requirements.txt
   firebase emulators:start

🔧 Geliştirme Araçları

Git İş Akışı

# Özellik geliştirme
git checkout -b feature/yeni-ozellik
git commit -m "feat: add new feature"
git push origin feature/yeni-ozellik

# Güncellemeler
git checkout main
git pull origin main
git merge feature/yeni-ozellik

📊 Özellik Katmanları

Free Katman

• Temel aktivite takibi
• Basit raporlama
• 3 otomatik kural

Premium Katman

• AI destekli içgörüler
• Haftalık detaylı raporlar
• Sınırsız otomasyon kuralları
• Gelişmiş hedef takibi

Pro Katman

• Takım özellikleri
• Anonim benchmarking
• API erişimi
• Öncelikli destek

🔒 Güvenlik ve Gizlilik

• Veri Şifreleme: Uçtan uca şifreleme
• Gizlilik: Kullanıcı verilerinin anonim işlenmesi
• GDPR Uyumu: Avrupa veri koruma standardları
• Yerel İşleme: Hassas veriler yerel olarak işlenir

📚 Dokümantasyon

Detaylı dokümantasyon için docs/ dizinini inceleyin:

• Mimari tasarım dokümanları
• API referansları
• Kullanıcı kılavuzları
• Geliştirici rehberleri

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🔗 Bağlantılar

• ActivityWatch - Temel proje
• Firebase - Backend platform
• Tauri - Desktop uygulama framework'ü
• Vue.js - Frontend framework

---

Not: Bu proje aktif geliştirme aşamasındadır. Üretim ortamında kullanmadan önce dokümantasyonu dikkatlice okuyun.