first commit

This commit is contained in:
AyrisAI
2026-05-14 01:57:52 +03:00
parent 863a32cd35
commit 4a9196f483
47 changed files with 12043 additions and 102 deletions

49
docs/prd2.md Normal file
View File

@@ -0,0 +1,49 @@
📧 Ürün Gereksinim Dokümanı (PRD): AyrisMail Web Client Modülü
1. Ürün Özeti
AyrisMail Web Client, AyrisMail Central ekosisteminin içine entegre edilmiş, modern, hızlı ve minimalist bir e-posta okuma/yazma modülüdür. Kullanıcıların Mailcow sunucusu üzerindeki e-postalarına IMAP/SMTP protokolleri üzerinden tarayıcı tabanlı erişimini sağlar.
2. Kullanıcı Deneyimi (UX) Hedefleri
Gmail Tarzı Akış: Hızlı geçişler, klavye kısayolları ve temiz bir okuma alanı.
Zero-Refresh: Next.js ve TanStack Query kullanarak sayfa yenilenmeden mail okuma ve klasörler arası geçiş.
Responsive: Masaüstünde üç sütunlu (Klasörler - Liste - Detay), mobilde ise liste odaklı tasarım.
3. Temel Özellikler (MVP)
A. Gelen Kutusu ve Klasör Yönetimi
Liste Görünümü: Okunmamış maillerin kalın fontla vurgulandığı, gönderen adı, konu ve tarihin görüldüğü liste alanı.
Klasör Desteği: Gelen Kutusu (Inbox), Taslaklar (Drafts), Gönderilenler (Sent), Çöp Kutusu (Trash) ve Arşiv arasında geçiş.
Arama: Gönderen adına veya konu başlığına göre hızlı filtreleme.
B. Okuma ve Yanıtlama
Rich Text Okuma: HTML formatındaki maillerin güvenli bir şekilde (XSS korumalı) görüntülenmesi.
Ekleri Görüntüleme: Gelen eklerin (PDF, Görsel) tarayıcı içinde önizlenmesi veya indirilmesi.
Yanıtla/İlet: Mailleri yanıtlama veya başkasına iletme fonksiyonları.
C. Mail Yazma (Compose)
Zengin Metin Editörü: Bold, Italic, Liste gibi temel formatlama özelliklerine sahip editör.
Dosya Eki: Drag-and-drop (sürükle-bırak) yöntemiyle dosya ekleme.
4. Teknik Mimari ve Protokoller
IMAP Entegrasyonu: Sunucu tarafında imapflow kütüphanesi ile mail içeriklerinin çekilmesi.
SMTP Entegrasyonu: nodemailer ile güvenli mail gönderimi.
Frontend UI: shadcn/ui'ın Mail component şablonu (Bu şablon doğrudan Gmail arayüzünü referans alır).
Güvenlik: Kullanıcı şifreleri veritabanında saklanmaz; oturum bazlı (session) olarak IMAP bağlantısı için kullanılır.
5. Yol Haritası (Gelecek Özellikler)
Push Notifications: Yeni mail geldiğinde tarayıcı veya mobil bildirimi.
Otomatik İmza: Kullanıcı bazlı zengin metin imzalar.
Spam Yönetimi: Mailcow API ile entegre "Spam olarak işaretle" butonu.