Cineverse Bilet Takip

About

# 🎬 Cineverse Bilet Takip - Chrome Eklentisi

Paribu Cineverse sinemalarında, ilgilendiğiniz bilet tarihleri veya özel gösterimler (örn: ön satışlar, özel etkinlikler) satışa çıktığında otomatik bildirim gönderen Chrome eklentisi.

**Tarih ve Sinema Linki Tamamen Özelleştirilebilir!**

## ✨ Özellikler

- ✅ **Tam Özelleştirme**: İstediğiniz sinema sayfasını ve istediğiniz tarihi/metni takip edebilirsiniz
- ✅ **Otomatik Kontrol**: Her 10 dakikada bir belirlediğiniz sayfayı kontrol eder
- ✅ **Anında Bildirim**: Biletler satışa açıldığında (aradığınız metin bulunduğunda) bildirim gönderir
- ✅ **Görsel Uyarı**: Tarayıcı ikonu yanıp sönerek dikkat çeker
- ✅ **Otomatik Yeniden Başlatma**: Bilgisayar veya tarayıcı yeniden başlatıldığında çalışmaya devam eder
- ✅ **Eşzamanlı Takip**: Başka işlerinize devam ederken arka planda çalışır
- ✅ **Düşük Kaynak**: Sisteminizi yormaz

## 🎯 Nasıl Çalışır?

Eklenti, ayarladığınız Paribu Cineverse sayfasında (örn: bir sinemanın seans sayfası) belirlediğiniz metni (örn: "25 Aralık", "Ön Satış", "IMAX" vb.) arar. Bu metin sayfada belirdiğinde size habel verir.

## 📱 Kullanım

### İlk Ayarlar

Eklenti varsayılan ayarlarla gelir ancak bunu kendi ihtiyacınıza göre düzenlemelisiniz:

1. Eklenti ikonuna tıklayın
2. Açılan pencerede **Ayarlar** kısmını bulun
3. **Site URL**: Takip etmek istediğiniz sinemanın sayfa linkini yapıştırın
4. **Aranacak Metin**: Sayfada görünmesini beklediğiniz tarihi veya ifadeyi yazın (örn: "15 Ocak")
5. **Kaydet** butonuna basın

Artık eklenti sizin belirlediğiniz kriterleri kontrol edecektir.

### Popup Arayüzü

- **Durum Göstergesi**: Yeşil = Aranan Metin Bulundu! / Kırmızı = Henüz Bulunamadı
- **Siteyi Aç**: Direkt ayarladığınız sayfaya gitmek için buton
- **Kontrol Et**: Anlık kontrol yapmak için buton
- **Ayarlar**: Aranacak tarihi ve URL'yi değiştirebilirsiniz

### Bilet Bulunduğunda

1. **Browser Bildirimi** gösterilir (Sesli)
2. **İkon yanıp söner** (Kırmızı-Yeşil)
3. İkon üzerinde yeşil ✓ işareti belirir
4. Bildirime tıklayarak bilet sayfasına gidebilirsiniz

## ⚙️ Özelleştirme
- **Aranacak Metin**: Sayfada hangi metnin çıkmasını bekliyorsunuz? (Örn: "25 Aralık", "Ön Satış", "IMAX")
- **URL**: Hangi sinema sayfasını kontrol etmek istiyorsunuz?

Ayarları değiştirdikten sonra "Kaydet" butonuna basmayı unutmayın.

## 🔧 Teknik Detaylar

### Dosya Yapısı

```
cineverse-bilet-takip/
├── manifest.json           # Eklenti tanımı (v3)
├── background.js           # Arka plan service worker (kontrol mantığı)
├── popup.html              # Popup arayüzü
├── popup.js                # Popup mantığı
├── icons/                  # İkon dosyaları
│   ├── icon16.png
│   ├── icon48.png
│   ├── icon128.png
├── README.md               # Bu dosya
└── .gitignore
```

### Nasıl Çalışır?

1. **Service Worker** (`background.js`):
   - Chrome Alarms API ile 10 dakikada bir alarm tetiklenir
   - Her aktif site için kontrol fonksiyonu çalıştırılır
   - Fetch API ile web sayfası indirilir
   - Site-specific mantıkla değişiklik kontrol edilir
   - Durum değişirse bildirim gönderilir

2. **Site Kontrol Fonksiyonları**:
   - **Paribucineverse**: HTML'de belirli class'ı bulur ve içeriğinde "25 Aralık" arar
   - Her site için özel kontrol mantığı uygulanabilir

3. **Popup** (`popup.html` + `popup.js`):
   - Chrome Storage API'den tüm sitelerin durumunu okur
   - Her site için dinamik kart oluşturur
   - Gerçek zamanlı güncelleme için storage change listener kullanır
   - Manuel kontrol ve site yönetimi için background script'e mesaj gönderir

4. **Bildirimler**:
   - Chrome Notifications API kullanılır
   - İkon badge'i Chrome Action API ile güncellenir
   - Yanıp sönme animasyonu setInterval ile yapılır

### Veri Yapısı

Her site için saklanan veriler:

```javascript
{
  id: 'siteId',              // Benzersiz tanımlayıcı
  name: 'Site Adı',          // Görünen ad
  url: 'https://...',        // Site URL'i
  enabled: true/false,       // Aktif/Pasif durumu
  status: 'Durum mesajı',    // Son durum mesajı
  lastCheck: '24.12.2024',   // Son kontrol zamanı
  checkCount: 0,             // Toplam kontrol sayısı
  isChecking: false,         // Şu an kontrol ediliyor mu
  hasChange: false,          // Değişiklik var mı
  isCustom: false            // Kullanıcı tarafından eklendi mi
}
```

## 🐛 Sorun Giderme

### Eklenti Çalışmıyor

1. `chrome://extensions/` sayfasında eklentinin aktif olduğundan emin olun
2. Eklentiye tıklayıp "Hataları görüntüle" linkine bakın
3. Eklentiyi kaldırıp tekrar yükleyin

### Bildirimler Gelmiyor

1. Chrome bildirim izinlerini kontrol edin:
   - `chrome://settings/content/notifications`
   - Chrome'un bildirimlere izin verdiğinden emin olun
2. Windows bildirim ayarlarını kontrol edin:
   - Windows Ayarlar > Sistem > Bildirimler
   - Chrome'un bildirim göndermesine izin verildiğinden emin olun

### Belirli Bir Site Kontrol Edilmiyor

1. Sitenin "Aktif" olduğundan emin olun
2. Site kontrolü sırasında hata mesajı var mı kontrol edin
3. Web sitesinin HTML yapısı değişmiş olabilir, kontrol fonksiyonunu güncelleyin

### Kontroller Yapılmıyor

1. Chrome'un arka planda çalıştığından emin olun
2. `chrome://extensions/` > Eklenti > "Servis çalışanı" bölümünde log kontrol edin
3. Bilgisayarınız uyku moduna geçerse kontroller durur (normal davranış)

## ⚠️ Önemli Notlar

- **Chrome Açık Olmalı**: Eklentinin çalışması için Chrome'un arka planda çalışıyor olması gerekir
- **İnternet Bağlantısı**: Kontroller için internet bağlantısı gereklidir
- **Kaynak Kullanımı**: Minimal kaynak kullanır, performansı etkilemez
- **Gizlilik**: Hiçbir veri toplanmaz veya dışarıya gönderilmez
- **Servis Gerekmez**: Tamamen tarayıcıda çalışır, harici servis gerektirmez
- **CORS**: Bazı siteler CORS politikası nedeniyle kontrol edilemeyebilir

## 🔄 Güncelleme

Eklentiyi güncellemek için:

1. Yeni dosyaları indirin
2. `chrome://extensions/` sayfasında eklentinin üzerindeki "Yenile" butonuna tıklayın

## 💡 İpuçları

- Chrome'u başlangıçta otomatik başlatmak için Windows görev zamanlayıcısını kullanabilirsiniz
- Popup'ı sık kullanıyorsanız, eklenti ikonunu toolbar'a sabitleyin
- Bildirimleri kaçırmamanız için Chrome bildirim sesini açık tutun
- Kullanmadığınız siteleri pasif yaparak kaynak tasarrufu yapabilirsiniz

## 📧 İletişim

Sorularınız, önerileriniz veya hata bildirimleri için:
- **E-posta**: [email protected]
- **GitHub Issues**: Bu repository'de issue açabilirsiniz

## 📄 Lisans

MIT License - İstediğiniz gibi kullanabilir, değiştirebilir ve paylaşabilirsiniz.

## 📝 Değişiklik Geçmişi

### v2.0 (24.12.2024)
- ✨ Birden fazla site kontrolü desteği eklendi
- ✨ Her site için ayrı ayrı aktif/pasif yapma özelliği
- ✨ Paribucineverse ANKAmall kontrol desteği
- ✨ Yeni modern popup tasarımı
- ✨ Site başına manuel kontrol butonu
- 🔧 Daha esnek ve genişletilebilir mimari


**Not**: Bu eklenti, kontrol ettiği sitelerle resmi bir bağlantısı olmayan bağımsız bir projedir.