GÜNCE 5.0 — CPANEL KURULUMU VE WEB PUSH

Giriş adresi: https://alanadiniz.com/gunce/
Bu sürüm OneSignal, e-posta, SMS veya harici API hesabı kullanmaz. Bildirimler
tarayıcının yerel Web Push sistemiyle doğrudan kayıtlı cihazlara gönderilir.

GÜNCELLEME (MEVCUT KURULUM)
1. Veritabanı, config.php ve web kökü dışındaki veri klasörünün tam yedeğini alın.
2. ZIP içindeki gunce klasörünün içeriğini mevcut public_html/gunce klasörüne
   birleştirin. Klasörü silmeyin, gunce/gunce şeklinde iç içe kopyalamayın.
3. Sunucudaki config.php dosyasını koruyun; pakette bilerek config.php yoktur.
   data_dir yolu değişmemelidir. vendor/ klasörünün tamamını yükleyin.
4. /gunce/ adresini açıp Ctrl+F5 yapın. İlk açılış yeni bildirim tablolarını
   oluşturur; mevcut planlar, döngüler, ayarlar ve kayıtlar silinmez.
5. Stüdyo → Bildirimler bölümünde “Bağlantıyı hazırla”, ardından “Bildirim izni
   ver” düğmesine basın. Her telefon/tarayıcı için izin ayrı verilir.

WEB PUSH NASIL ÇALIŞIR?
Etkinlikte tarih, saat ve hatırlatma süresi (15 dakika, 1 saat, 1 gün vb.)
seçilir. Her dakika çalışan görev, zamanı gelen etkinlik için tüm izinli
cihazlara şifreli Web Push gönderir. İptal edilen veya tamamlanan etkinliklerin
bekleyen işleri iptal edilir. “Şimdi test gönder” cron beklemeden yalnızca
seçili cihaza test yollar; ileri tarihli test için cron gereklidir.

CPANEL CRON (TEK GÖREV, HER DAKİKA)
* * * * * /usr/local/bin/php /home/HESAP/public_html/gunce/cron-notifications.php /home/HESAP/public_html

HESAP, public_html yolu ve PHP ikilisini kendi sunucunuza göre değiştirin.
Mevcut cron görevi varsa ikinci görev eklemeyin. PHP 8.2+ gerekir; openssl,
curl, mbstring ve PDO (SQLite veya MySQL) etkin olmalıdır. vendor klasörü ZIP’te
hazırdır; cPanel’de Composer çalıştırmanız gerekmez. Site HTTPS olmalıdır.

MOBİL
iPhone/iPad için iOS/iPadOS 16.4 veya üzeri gerekir. Safari’de Paylaş → Ana
Ekrana Ekle ile Günce’yi simgesinden açın; sonra bildirim ekranındaki iki adımı
uygulayın. Ana ekrana eklemek tek başına izin vermez. Android ve masaüstünde
HTTPS açık tarayıcı yeterlidir. İşletim sistemi Rahatsız Etmeyin ayarı teslimi
engelleyebilir.

VERİ GÜVENLİĞİ
Canlı veritabanı bu ZIP’in içinde değildir. config.php, veri klasörü, mevcut
planlar ve ayarlar korunur. Yeni VAPID özel anahtarı veri klasöründe
native-push-vapid.json olarak saklanır; bunu silmeyin veya yedeksiz
yenilemeyin. Web Push yalnızca açıkça izin veren cihazlara gider.
Yedek almadan güncelleme yapmayın.

EKLENENLER
Analitik raporlar, gelişmiş arama/filtre, hashtag yöneticisi, şablon sistemi,
iş panosu, haftalık döngüler, YouTube kategorisi, iptal açıklaması, mobil PWA,
yerel bildirim geçmişi ve etkinlikten açılan bildirim bağlantıları korunmuş ve
birlikte çalışır. İptal durumunda açıklama zorunludur.

SINIRLAR
Bu paket gerçek cihaz bildirimi ve cPanel/Apache üzerinde canlı gönderim
yapmadan kontrollü testlerle doğrulanmıştır. Web Push “tarayıcı servisi kabul
etti” sonucunu gösterebilir; işletim sistemi teslimi garanti etmez. Uygulama
ve cron logları Stüdyo → Bildirimler ekranından izlenir.
