# 🚀 AyrisMail Unified System

[TR] Mailcow altyapısı için geliştirilmiş, gerçek zamanlı bildirim ve e-posta yönetim platformu.  
[EN] Real-time notification and email management platform developed for Mailcow infrastructure.

---

## 🌍 Language / Dil
- [Türkçe](#türkçe)
- [English](#english)

---

<a name="türkçe"></a>
## 🇹🇷 Türkçe

AyrisMail, Mailcow sunucularını akıllı bir bildirim merkezine dönüştüren kapsamlı bir çözümdür. Sunucu seviyesindeki mailleri anlık olarak izler, analiz eder ve kullanıcı bazlı Telegram bildirimleri fırlatır.

### ✨ Öne Çıkan Özellikler
- **Anlık Bildirimler:** Worker motoru sayesinde mail sunucuya düştüğü anda Telegram bildirimi.
- **Akıllı Kod Çözücü:** RFC 2047 (MIME) desteği ile Türkçe karakterli ve kodlanmış başlıkları otomatik çözer.
- **Gelişmiş Panel:** Mailbox-Kullanıcı eşleşmelerini ve bildirim loglarını yönetebileceğiniz modern arayüz.
- **Güvenli Mimari:** Docker tabanlı, PostgreSQL veritabanlı ve Webhook korumalı yapı.
- **Çoklu Kullanıcı:** Her kullanıcı sadece kendine atanan mail kutularının bildirimlerini alır.

### 🛠️ Teknoloji Yığını
- **Core:** Next.js 16 (App Router), TypeScript
- **Database:** PostgreSQL & Prisma ORM
- **Worker:** Node.js, Chokidar (File Watcher), Doveadm
- **Deployment:** Docker & Docker Compose

### 🚀 Hızlı Kurulum
1. `.env.example` dosyasını `.env` olarak kopyalayın ve bilgilerinizi girin.
2. Sistemi başlatın:
   ```bash
   docker compose -f docker-compose.unified.yml up -d --build
   ```

---

<a name="english"></a>
## 🇺🇸 English

AyrisMail is a comprehensive solution that transforms Mailcow servers into an intelligent notification hub. It monitors server-level emails in real-time, analyzes them, and triggers user-based Telegram alerts.

### ✨ Key Features
- **Instant Notifications:** Telegram alerts triggered the moment an email hits the server via our custom Worker engine.
- **Smart MIME Decoder:** Automatically decodes RFC 2047 encoded subjects (UTF-8, Base64, etc.) for readable notifications.
- **Advanced Dashboard:** Modern UI to manage Mailbox-to-User mappings and track notification logs.
- **Secure Architecture:** Docker-based setup with PostgreSQL and protected Webhook signals.
- **Multi-Tenant:** Each user receives notifications only for their assigned mailboxes.

### 🛠️ Tech Stack
- **Core:** Next.js 16 (App Router), TypeScript
- **Database:** PostgreSQL & Prisma ORM
- **Worker:** Node.js, Chokidar (File Watcher), Doveadm
- **Deployment:** Docker & Docker Compose

### 🚀 Quick Start
1. Copy `.env.example` to `.env` and fill in your credentials.
2. Start the system:
   ```bash
   docker compose -f docker-compose.unified.yml up -d --build
   ```

---
© 2026 AyrisTech - Advanced Agentic Coding Systems