Files
webmailserver/README.md
2026-05-14 19:38:55 +03:00

68 lines
2.8 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.
# 🚀 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