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

62 lines
2.5 KiB
Markdown
Raw 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 Central
1. Ürün Özeti
AyrisMail Central, Mailcow APIsini kullanarak birden fazla domaini ve bu domainlere bağlı mail hesaplarını yönetmeye yarayan, Next.js tabanlı bir "Multi-Tenant" (Çoklu Kiracılı) yönetim panelidir. Kullanıcılar, teknik bilgiye ihtiyaç duymadan kendi domainleri altında mail hesabııp kapatabilirler.
2. Kullanıcı Rolleri ve Yetkiler
Süper Admin (Mustafa): * Tüm domainleri ekler/siler.
Domain Adminleri oluşturur.
Sunucu genel kotasını ve API anahtarlarını yönetir.
Domain Admin (Örn: Emina Hanım):
Sadece kendisine atanmış olan domaini (örn: aveminakarabudak.com) görür.
Yeni mail kutusu oluşturabilir, mevcut olanları silebilir.
Kullanıcıların şifrelerini sıfırlayabilir ve kotalarını güncelleyebilir.
3. Temel Özellikler (MVP)
A. Dashboard & Auth
Güvenli Giriş: NextAuth.js ile e-posta ve şifre tabanlı giriş sistemi.
Hızlı Özet: Aktif mail kutusu sayısı, kullanılan toplam disk alanı ve domain sağlık durumu (SPF/DKIM/MX) göstergeleri.
B. Domain Yönetimi (Süper Admin)
Domain Listesi: Tüm kayıtlı domainlerin tablosu.
Domain Atama: Hangi domainin hangi kullanıcı tarafından yönetileceğinin belirlenmesi.
C. Mail Hesabı Yönetimi (Domain Admin)
Hesap Oluşturma Formu: * local_part (isim), name (Ad Soyad), password ve quota (MB) girişleri.
Hesap Listeleme: Mevcut mail hesaplarının (örn: info@domain.com) tablo halinde gösterimi.
Hızlı İşlemler: Tek tıkla şifre güncelleme veya hesabı pasife alma.
4. Teknik Altyapı (Tech Stack)
Framework: Next.js 14+ (App Router)
Stil: Tailwind CSS + Shadcn/UI (Karanlık Mod desteği dahil)
State Management: TanStack Query (API verilerini anlık çekmek için)
API Entegrasyonu: Mailcow API (Server-side fetch işlemleri)
Veritabanı (Küçük bir DB): Kullanıcı rolleri ve domain atamalarını tutmak için (Supabase veya Prisma/Postgres).
5. UI/UX Tasarım Konsepti
Temiz Arayüz: Mailcowun binlerce ayarı yerine sadece "Mail Ekle", "Şifre Değiştir", "Sil" butonlarının olduğu minimalist bir tasarım.
White-Label: Giriş ekranında AyrisTech logosu, içeride ise ilgili domainin başlığı.
Mobil Uyum: Telefon üzerinden kolayca yeni mail açabilme yeteneği.
6. Başarı Kriterleri
Bir domain admininin sisteme girip yeni bir mail hesabı oluşturma süresinin 15 saniyenin altında olması.
Süper adminin sunucu terminaline veya ana Mailcow paneline girmeden tüm günlük işlerini Next.js üzerinden yapabilmesi.