Kullanım kılavuzu

Kurulumdan ilk salon evrakınıza kadar

Hangi paketi seçmeliyim?

Windows kurulumu

1. İndirdiğiniz win64-setup.exe dosyasına çift tıklayın.
2. Windows koruma uyarısı gösterirse dosyayı bu sitenin indirme alanından (indir.okulapp.org) veya resmî GitHub sürümünden indirdiğinizi doğrulayın; paketler imzasızdır, aşağıdaki SHA-256 adımıyla kontrol edebilirsiniz.
3. Kurulum sihirbazında ilerleyin ve Başlat menüsünden uygulamayı açın.

Pardus / Linux kurulumu

.deb dosyasına çift tıklayıp yazılım yükleyicisinde Kur seçeneğini kullanın. Yönetici erişiminiz yoksa Linux taşınabilir arşivini indirip içindeki açıklamaları izleyin.

İlk açılış

Program ilk açıldığında kurulum sihirbazı çalışır:

1. Okul adı, il/ilçe ve okul müdürünün adını girin; bu bilgiler bütün resmî evrakın antedinde kullanılır.
2. Okul türünü ve hazırlık sınıfı olup olmadığını seçin. Bu seçim, ders havuzunun hangi Talim ve Terbiye Kurulu haftalık ders çizelgesinden türetileceğini belirler.
3. Günlük ders saati sayısını ve sınav yapılabilecek ders saatlerini işaretleyin. Genel liselerde gün sekiz ders saatidir; mesleki ve teknik programlarda atölye günleriyle değişebilir.
4. Ders yılını ve iki dönemin tarihlerini girin, ders yılını aktif yapın.
5. Öğrenci ve personel listesini e-Okul raporundan (Excel) veya panodan aktarın.

İlk sınavınız

1. Salonları tanımlayın. Her salon için sıra düzenini (kaç sütun, kaç sıra, tekli/ikili) girin. Varsayılan şablon dört sütun × beş ikili sıradır; numaralandırma öğretmen masasının önünden başlar.
2. Ders havuzunu gözden geçirin. Liste okul türünüzün çizelgesinden gelir. Okulunuzda okutulmayan dersi pasifleştirin; seçmeli derslerde "Şubeler" sütunundan o dersi hangi şubelerin aldığını işaretleyin.
3. Sınav takvimini kurun. "Ön tanımlı takvimleri üret" dediğinizde mevzuattaki dört sınav penceresi için dört takvim açılır ve havuzları dolar. Yerleştirme sekmesinde "Otomatik yerleştir" sınavları günlere dağıtır; elle koyduklarınız sabit kalır. Takvimi onaylayın.
4. Oturum üretin. Onaylı takvimde her sınav slotu için "Oturum Üret" düğmesi çıkar. Oturum sihirbazında dersleri, şubeleri ve salonları seçip dağıtımı çalıştırın; program planı üretir ve bağımsız doğrulayıcıdan geçirir.
5. Evrakı basın. Salon evrakı (kroki + yoklama + sayım + teslim), şube duyurusu, ihlal tutanağı ve varsa görevlendirme yazısı PDF olarak çıkar; hepsini tek ZIP hâlinde de alabilirsiniz.
6. Sınavdan sonra yoklamayı ve mazeretleri işleyin. Oturum onaylandıktan sonra Yoklama sekmesi açılır; sınava girmeyen öğrencinin kartına basarsınız. Mazeret Takibi ekranı dönemin bütün girmeyenlerini tek listede toplar: mazeret durumunu ve belge notunu işlersiniz, mazereti kabul edilenleri seçip mazeret sınavı oluşturursunuz, takip çizelgesini PDF ve Excel olarak alırsınız.

Yedekleme

Ayarlar → Güvenlik ekranından uygulama parolası kurabilir ve şifreli .ksbak yedeği oluşturabilirsiniz. Parola kurulduğunda öğrenci ve personel adları diskte şifreli tutulur. Yedek cihazda şifrelenir ve herhangi bir bulut hesabına otomatik gönderilmez; disk arızasına karşı kurumunuzun onayladığı güvenli bir ortama ayrıca kopyalayın. Kurtarma anahtarını mutlaka not edin.

İndirilen dosyayı doğrulama

Sürümle birlikte yayımlanan SHA256SUMS-<sürüm>.txt dosyasındaki değer ile indirdiğiniz dosyanın özetini karşılaştırın.

Windows PowerShell

Get-FileHash .\kelebek-sinav-<sürüm>-win64-setup.exe -Algorithm SHA256

Pardus / Linux

sha256sum -c SHA256SUMS-<sürüm>.txt

Sık karşılaşılan sorunlar

WebView2 bulunamadı

Windows 10 kullanılan bazı bilgisayarlarda Microsoft Edge WebView2 bileşeninin kurum bilişim sorumlusu tarafından kurulması gerekebilir.

Program zaten çalışıyor

Aynı anda yalnızca bir kopya çalışır. Görev çubuğundaki açık pencereyi bulun veya bilgisayarı yeniden başlatın.

Ders havuzu boş geldi

Okul türünüz için çizelge verisi henüz gelmemiş olabilir; bu durumda havuz boş başlar ve dersleri elle ekleyebilirsiniz. Ayrıca ders havuzu yalnızca öğrencisi olan sınıf düzeyleri için dolar — öğrenci listesini aktardığınızdan emin olun.

Oturum onaylanmıyor

Dağıtım doğrulayıcısı bir kural ihlali bulduysa oturum onaylanmaz. Salon sayısı ya da koltuk düzeni, aynı sınava giren öğrencileri ayırmaya yetmiyor olabilir; salon ekleyin veya sınavı ikiye bölün.

Veritabanı bozuk uyarısı

Programı kapatın ve en son sağlam şifreli yedekten dönün. Bozuk veritabanını veya yedeği destek talebine eklemeyin.

Ayrıntılı teknik kılavuz için depodaki güncel kurulum belgesine bakabilirsiniz.