Files
webmailserver/docs/prd2.md
2026-05-14 01:57:52 +03:00

49 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
📧 Ü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.