class Firestore {
///YERLEŞİKLER:
///Firestore işlemlerini gerçekleştirmeyi sağlayan static get metodu, Firestore nesnesini(instance) yani kendisini döndürür.
 static Firestore get instance => Firestore();

 /// FirebaseApp :  Firebase e bağlı uygulamayı FirebaseApp cinsinden döndürür.
  FirebaseApp get app;

  //settings : ayarlar
  Future settings({bool persistenceEnabled, String host,  bool sslEnabled, int cacheSizeBytes});


///REFERANSLAR :
    ///1. kolleksiyon referansı: CollectionReference,
    /// 2. grup kolleksiyonu referansı:Query,
    /// 3. döküman referansı: DocumentReference

        // CollectionReference : path ver geriye collecsiyon refenası al
        CollectionReference collection(String path);

        //  // Query : path ver geriye collecsiyonGrup refenası Query al
        Query collectionGroup(String path);

        //DocumentReference :  path ver DocumentReference al
        DocumentReference document(String path);


///TOPLU OPERASYONLAR: batch,Transaction

  ///Atomic işlemler:Bir dizi atomik işlemde, ya tüm bir dizi toplu işlemler başarılı olur uygulanır ya da biri başarısız olduğunda tümü başarısız olur hiçbiri gerçekleştrilmez!.
  ///İki tip atomik işlem vardır.
  ///1. Batched Writes:bir veya daha fazla dökümana  update, delete ve set işlemlerini tek seferde-atomic olarak yapma işlemidir.Okuma-read Hariç!( update, delete ve set yazma işlemi olarak kabul edilir!)
  ///2. Transactions: bir veya daha fazla döküman üzerinde read, update, delete ve set işlemlerini tek seferde-atomic olarak yapma işlemidir. Okuma-Read dahil!

///1.batch(...):
  ///bir okuma (yani read olarak kabul edilen) işlemi içermeyen!! ama bir dizi update, delete ve set gibi (ki hepsi write-yazma olarak kabul edilen) toplu işlemleri
  /// tek bir işlemde gerçekleştiren metod.
  /// İşlemler commit işlemi çağrılana kadar icra edilmez!!!
  /// Bu işlemler: delete, setData, updateData dır. en son commit çağrılır.
              WriteBatch batch(); ///WriteBatch nesnesi döndürür bu nesne;
                  /// A [WriteBatch], tek bir birim olarak bir den çok işlemi gerçekleştirecek bir dizi yazma işlemi sağlar.
                  /// [WriteBatch] üzerinde yapılan işlemler siz [commmit] yapana kadar geçerli olmaz.
                  /// [WriteBatch] tamamlandığında üzerinde başka işlem yapılamaz ve tekrar gerçekleştirilemez.
                  void delete(DocumentReference document); // silme
                  void setData( DocumentReference document, Map<String, dynamic> data, {bool merge = false} ); // ekleme
                  void updateData(DocumentReference document, Map<String, dynamic> data); //güncelleme işlemi
                  Future commit(); //tüm işlemlerin tek seferde gerçekleştirilme işelemini uygular.En son çağrılır.


///2.runTransaction(..)
          ///runTransaction yöntemi içerisine transactionHandler(bir fonksiyon tanımı tipi) ve gecikme zamanı(varsayılanı 5 saniyedir) alır.
         ///transactionHandler bu Firestore nesnesinin içerisindeki bir metod tanımının referansını alır!!! (calback fonksiyonlar),
         /// Kısaca bu fonksiyon şöyle tanımlanmalıdır:fonksiyonun baş kısmı parametre olarak bir Transaction tipinden paramerte almak zorundadır.Şöyle (Transaction transaction){ ...}
         /// gövde kısmında, transaction nesnesi halihazırda oluşturulmuş olacağı için bu transaction nesnesini kullanarak istenen read da dahil atomic toplu işlemeler gerşekleştitilebilir.
              Future<Map<String, dynamic>> runTransaction(TransactionHandler transactionHandler, {Duration timeout = const Duration(seconds: 5)});

                ///Transaction sınıfının gerçekleştirebildiği işler: Firestore.instance.runTransaction((Transaction transaction){ transaction.get,set,update,delete });
                  Future get(DocumentReference documentReference);//READ!!!
                  Future set( DocumentReference documentReference, Map<String, dynamic> data)://insert ekleme
                  Future update( DocumentReference documentReference, Map<String, dynamic> data) ;//güncelleme
                  Future delete(DocumentReference documentReference) ;//silme



}