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

2.5 KiB
Raw Blame History

🚀 Ü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.

  1. 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.

  1. 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).

  1. 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.

  1. 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.