Taskiz

Firebase Veritabanı Rehberi (Kullanıcı Dostu)

Taskiz botunu SQLite yerine Firebase ile daha hızlı, ölçeklenebilir ve güvenli hale getirebilirsiniz. Firestore (önerilen) veya Realtime Database kullanılabilir. Aşağıdaki adımlar sade ve uygulaması kolay olacak şekilde hazırlanmıştır.

1) Firebase Projesi Oluştur

1. https://console.firebase.google.com/ adresine gir
2. Yeni proje oluştur
3. Firestore veya Realtime Database’i etkinleştir

2) Service Account (JSON) Al

1. Project Settings → Service accounts
2. Generate new private key butonuyla JSON indir
3. JSON’u güvenli bir yerde sakla

3) Ortam Değişkenlerini Tanımla

Sunucunda şu değişkenleri ayarla:

• FIREBASE_CREDENTIALS_JSON → JSON içeriği (tek satır halde)
• FIREBASE_PROJECT_ID → Firebase proje ID (Firestore için)
• FIREBASE_DATABASE_URL → Realtime DB URL (Realtime kullanacaksan)

4) Kurulum

pip install firebase-admin

5) Hızlı Bağlantı Örneği (Firestore)

import os
import json
import firebase_admin
from firebase_admin import credentials, firestore

cred = credentials.Certificate(json.loads(os.environ["FIREBASE_CREDENTIALS_JSON"]))
firebase_admin.initialize_app(cred, {
    "projectId": os.environ["FIREBASE_PROJECT_ID"]
})
db = firestore.client()

5B) Realtime Database Bağlantısı (Opsiyonel)

import firebase_admin
from firebase_admin import credentials, db
import json

cred = credentials.Certificate(json.loads(os.environ["FIREBASE_CREDENTIALS_JSON"]))
firebase_admin.initialize_app(cred, {
    "databaseURL": os.environ["FIREBASE_DATABASE_URL"]
})
ref = db.reference("/")

6) Önerilen Koleksiyon Yapısı

• users → Kullanıcı profilleri
• tasks → Görevler
• task_participations → Görev katılımları
• withdrawals → Çekim talepleri
• stats → Günlük istatistikler

7) Sonraki Adım (Daha da Gelişmiş)

SQLite verilerini Firestore’a taşımak için otomatik bir taşıma scripti ekleyebiliriz. Ayrıca güvenlik kuralları ve gerçek zamanlı güncellemeler için ayrıntılı bir yapı kurabiliriz.