📮 Postacı

Yıldırım hızında, yerel SQLite önbellekli, güvenli ve modern masaüstü e-posta istemcisi

A blazing fast, offline-first, modern and secure desktop email client for Windows

📥 İndir • ✨ Özellikler • 🏗️ Sistem Mimarisi • ⌨️ Kısayollar • 🛠️ Geliştirici Kılavuzu • 🔄 Dağıtım • 🔐 Güvenlik

---

📥 Hızlı İndirme (Windows x64)

Son sürüm olan v1.0.8 kurulum paketlerini tek tıkla indirebilirsiniz:

Paket Türü	Dosya	Boyut	Açıklama
🚀 Kurulum Sihirbazı (Önerilen)	Postaci.Setup.1.0.8.exe	~127 MB	Masaüstü ve Başlat menüsüne simgeli kısayol ekler, otomatik güncellenir.
💼 Taşınabilir Sürüm (Portable)	Postaci-1.0.8-portable.exe	~127 MB	Kurulum gerektirmez; USB bellekten veya istediğiniz klasörden doğrudan çalışır.
🔐 SHA-256 Doğrulama	checksums.txt	187 B	İndirilen dosyaların bütünlük ve güvenlik doğrulama özetleri.

Tip

Tüm geçmiş sürümler ve sürüm notları için GitHub Releases sayfasını ziyaret edebilirsiniz.

---

✨ Öne Çıkan Özellikler

⚡ Yerel SQLite ile Çevrimdışı Kullanım (Offline-First)

• Tüm e-postalarınız, klasör ağacınız ve mesaj meta verileri better-sqlite3 veritabanında yerel olarak saklanır.
• İnternet bağlantınız kopsa bile gelen kutunuzda sıfır gecikmeyle arama yapabilir, e-postalarınızı okuyabilir ve yanıt taslakları hazırlayabilirsiniz.
• İnternet tekrar geldiğinde arka plan eşitlemesi otomatik olarak devreye girer.

📬 Çoklu Hesap ve Birleşik Gelen Kutusu (Unified Inbox)

• Desteklenen Sağlayıcılar: Gmail, Outlook/Hotmail/Live, Yahoo, iCloud, Yandex ve özel kurumsal IMAP/SMTP sunucuları.
• Tek Merkez: Tüm hesaplarınızın gelen kutularını tek bir sayfada birleştiren Birleşik Gelen Kutusu sayesinde hesaplar arasında kaybolmazsınız.

🎨 Kusursuz Aydınlık ve Karanlık Tema

• Gözü yormayan modern cam efektleri (glassmorphism), özel renk kontrastları ve net tipografi.
• Koyu ve açık temalar arasında tek tıkla veya kısayolla akıcı geçiş.

⌨️ Superhuman Hızında Komut Paleti (Ctrl + K)

• Klavyeden elinizi kaldırmadan tüm uygulamayı yönetin:
  • Hesaplar ve klasörler arası anında atlama.
  • Hızlı e-posta arama ve filtreleme.
  • Tema değiştirme, hesap senkronizasyonu ve bildirim testi.

↩️ 5 Saniye Geri Alınabilir Gönderim (Undo Send)

• Bir e-postayı yanlışlıkla erken mi gönderdiniz?
• Gönderim butonuna basıldığında ekranın altında beliren 5 saniyelik geri sayım çubuğu ile gönderimi tek tuşla iptal edebilir ve düzenlemeye kaldığınız yerden devam edebilirsiniz.

✍️ Akıllı Taslak & Küçültülebilir Gönderi Penceresi (Dock Bar)

• E-posta hazırlarken gelen kutunuzdaki diğer iletileri incelemek için pencereyi sağ alt köşeye küçültebilirsiniz.
• Esc tuşuna veya dışarıya yanlışlıkla tıklanması durumunda verileriniz asla silinmez; akıllı taslak koruması devreye girer.

🔐 Donanım Seviyesinde Güvenlik (Windows DPAPI)

• Hesap parolalarınız ve OAuth2 erişim anahtarlarınız (Refresh Token) Windows safeStorage (DPAPI) ile donanım ve kullanıcı bazında şifrelenir.
• Verileriniz asla üçüncü şahıslarla veya bulut sunucularıyla paylaşılmaz.

🔔 Yerel Windows Masaüstü Bildirimleri

• Yeni bir e-posta geldiğinde Windows Bildirim Merkezi'nde Postacı simgesiyle zengin bildirim gösterilir.
• Bildirime tıklandığında Postacı penceresi öne gelir ve doğrudan ilgili e-postayı açar.

---

🏗️ Sistem Mimarisi

Postacı, yüksek performans ve güvenlik izolasyonunu bir arada sunan çok katmanlı modern bir masaüstü mimarisine sahiptir:

graph TD
    subgraph UI ["🖥️ Kullanıcı Arayüzü (Renderer)"]
        UI_A["React 19 + TypeScript"]
        UI_B["TailwindCSS v4 Modern Tema"]
        UI_C["Komut Paleti (Ctrl+K) & Kısayollar"]
        UI_D["Zengin Metin Editörü & Dock Bar"]
    end

    subgraph Bridge ["🛡️ Güvenlik Köprüsü (Preload)"]
        BR_A["contextBridge İzolasyonu"]
        BR_B["Güvenli IPC İletişim Kanalları"]
    end

    subgraph Core ["⚙️ Çekirdek Süreç (Electron Main)"]
        CR_A["Pencere & Bildirim Yöneticisi"]
        CR_B["Arka Plan Senkronizasyonu"]
        CR_C["OAuth2 & Windows safeStorage (DPAPI)"]
    end

    subgraph Storage ["💾 Veri ve İletişim Katmanı"]
        DB[("Yerel SQLite (better-sqlite3)")]
        IMAP["IMAP Motoru (imapflow)"]
        SMTP["SMTP Gönderici (nodemailer)"]
    end

    UI --> Bridge
    Bridge --> Core
    Core --> Storage

Loading

---

⌨️ Klavye Kısayolları

Postacı, tam klavye navigasyonunu destekler:

Kısayol	Kategori	İşlem
Ctrl + K	Genel	Komut Paletini Aç (Arama, geçişler, komutlar)
C	E-posta	Yeni E-posta Yaz (Compose)
R	E-posta	Seçili e-postayı Yanıtla
A	E-posta	Seçili e-postayı Tümünü Yanıtla
F	E-posta	Seçili e-postayı İlet (Forward)
Ctrl + Enter	E-posta	Hazırlanan e-postayı Gönder
E	Yönetim	Seçili e-postayı Arşive Taşı
# veya Del	Yönetim	Seçili e-postayı Çöp Kutusuna Gönder
S	Yönetim	E-postayı Yıldızla / Yıldızı Kaldır
U	Yönetim	E-postayı Okunmadı Olarak İşaretle
J / ↓	Gezinti	Sonraki e-postaya git
K / ↑	Gezinti	Önceki e-postaya git
Esc	Genel	Açık pencereleri kapat / Taslağı güvenle kaydet

---

🛠️ Geliştirici Kılavuzu

Ön Gereksinimler

• Node.js: v20.x veya üzeri
• npm: v10.x veya üzeri
• İşletim Sistemi: Windows 10 / 11 (64-bit)

1. Depoyu Klonlayın

git clone https://github.com/eekilinc/Postaci.git
cd Postaci

2. Bağımlılıkları Kurun

npm install

3. Geliştirme Modunda Çalıştırın

Vite HMR dev sunucusunu ve Electron masaüstü uygulamasını eşzamanlı olarak başlatır:

npm start

4. Kod Kalite ve Derleme Testi

# Ultra hızlı Oxlint statik analizi
npm run lint

# TypeScript tip denetimi ve Vite üretim paketi
npm run build

5. Kurulum Paketini (.exe) Yerel Olarak Üretin

npm run dist

Derlenen NSIS kurulum ve Portable dosyaları release/ klasöründe oluşur.

---

🔄 Otomatik Sürüm ve GitHub Dağıtımı

Postacı, GitHub Actions üzerinde tam otomatik bir dağıtım hattına sahiptir:

Yöntem 1: Komut Satırından Otomatik Sürüm Yükseltme

Terminalinizden tek bir komutla sürümü güncelleyebilir ve GitHub'da derlemeyi başlatabilirsiniz:

# Hata düzeltme sürümleri için (Örn: 1.0.0 -> 1.0.1)
npm run release:patch

# Yeni özellik sürümleri için (Örn: 1.0.0 -> 1.1.0)
npm run release:minor

# Büyük sürümler için (Örn: 1.0.0 -> 2.0.0)
npm run release:major

Bu işlem package.json dosyasını günceller, Git commit ve tag'ini oluşturup GitHub'a gönderir. GitHub Actions derlemeyi otomatik olarak başlatır ve yeni sürümü Releases sekmesine ekler.

Yöntem 2: GitHub Arayüzünden Tek Tıkla Release

1. Postacı GitHub sayfasında Actions sekmesine gidin.
2. Sol menüden Release Postacı iş akışını seçin.
3. Run workflow butonuna tıklayarak sürüm tipini (patch, minor veya major) seçip çalıştırın.

---

🔐 Güvenlik ve Gizlilik Prensipleri

• 🚫 Sıfır Bulut İletimi: E-postalarınız hiçbir harici bulut sunucusuna veya analitik servisine gitmez. Bilgisayarınız ile e-posta sağlayıcınız (IMAP/SMTP) arasında doğrudan ve şifreli (TLS/SSL) iletişim kurulur.
• 🛡️ Windows DPAPI Şifreleme: Parolalar ve erişim anahtarları diske açık yazılmaz; Windows safeStorage donanım/kullanıcı şifreleme anahtarları ile korunur.
• 🧼 DOMPurify HTML Sterilizasyonu: E-posta gövdelerindeki potansiyel zararlı script'ler, iframe ve XSS açıkları temizlenerek güvenle görüntülenir.

---

📄 Lisans

Bu proje MIT Lisansı kapsamında açık kaynaklı olarak geliştirilmektedir.

_{Geliştirici: Ekrem Eşref Kılınç • Mehmet Akif Ersoy Üniversitesi}