Skip to content

Email Sender. Гибридная платформа для транзакционных писем и массовых рассылок. UI (FastAPI + Jinja), REST API (Swagger/OpenAPI), модуль прогрева доменов, трекинг кликов/просмотров через /r, интеграция со SMTP/Listmonk.

Notifications You must be signed in to change notification settings

qXstay/email_sender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Email Sender Platform — demo

Email Sender — гибридная платформа для транзакционных писем и массовых рассылок с собственным UI, API и модулем прогрева доменов.

⚠️ Это демонстрационная версия репозитория: здесь показаны только безопасные фрагменты кода, шаблоны интерфейсов и скриншоты. Полная коммерческая реализация (бэкенд-логика, интеграции, служебные скрипты и т. п.) предоставляется по запросу.


🚀 Что умеет продукт (в проде)

  • UI: кампании, дашборд, модуль прогрева, выгрузка сегментов (CSV).
  • API (Swagger/OpenAPI): транзакционные письма, управление кампаниями.
  • Трекинг: собственный редиректор /r (просмотры/клики), экспорт реальных кликов по ссылкам.
  • Прогрев доменов: учёт отправок/открытий/кликов по тестовым ящикам, агрегаты по домену.
  • Безопасность: Basic-Auth для UI + X-API-Key для API.
  • Производственная эксплуатация: деплой как systemd-сервис, логирование, интеграция со SMTP (Listmonk).
  • Троттлинг/интервалы: в UI задаётся диапазон паузы (в секундах) между отправками — это снижает риск фильтров и распределяет нагрузку на SMTP.

🧰 Технологии

Python (FastAPI, Uvicorn), Jinja2, OpenAPI/Swagger-UI, Listmonk (SMTP/шаблоны/редиректор), APScheduler, HTML/CSS/Vanilla JS, Linux/systemd.


📂 Что внутри этого репозитория (демо)

  • templates/ — демо-шаблоны страниц (index.html, dashboard.html, campaigns.html, warmup.html, diagnostic.html).
  • static/auth.js — маленький пример клиентской логики (ввод API-ключа и т. п.).
  • main_app_demo.py — компактные фрагменты FastAPI-кода (эндпоинты-заглушки, структура роутов).
  • docs/screenshots/ — скриншоты рабочей системы (см. галерею ниже).
  • docs/architecture/containers.png — (опционально) схема архитектуры в формате C4.

Полный серверный код, SQL/интеграции, планировщик прогрева, редиректор /r и другая бизнесс-логика не публикуются в открытом доступе.


🧭 Архитектура (обзор)

C4: Container Diagram

  • Внешние системы (CRM/Bitrix) → FastAPI (UI + API)Listmonk (HTTP API/SMTP) → почтовые провайдеры.
  • Редиректор /r логирует клики (локальное JSON/операционное хранилище) и делает 302 Redirect на целевые URL.
  • Модуль прогрева работает по расписанию (APScheduler), а статистика в прогреве синхронизирована с реальными данными кампаний.

🖼️ Галерея скриншотов

Изображения находятся в docs/screenshots/

Главная

Главная

Basic Auth

Окно авторизации

Ввод API-ключа

Модальное окно API-ключа

Дашборд

Дашборд: сводные метрики

Кампании: запуск/скорость/клики

Кампании

Экспорт сегментов (CSV)

Экспорт сегментов

Прогрев доменов

Прогрев доменов

Swagger / API Docs

Swagger 1 Swagger 2 Swagger 3


🔒 Приватность и безопасность

  • В демо отсутствуют секреты, домены заказчика, реальные токены/ключи и исполняемая бизнес-логика.
  • Любые приватные данные (SMTP/шаблоны, системные артефакты, служебные JSON и т. п.) исключены из публикации.

📩 Контакты по полной версии

Нужна рабочая система «под ключ» (UI + API + прогрев + интеграции) или демонстрация на стенде?
Напишите в личные сообщения — покажу прод-возможности и обсудим внедрение.

Мой Telegram

About

Email Sender. Гибридная платформа для транзакционных писем и массовых рассылок. UI (FastAPI + Jinja), REST API (Swagger/OpenAPI), модуль прогрева доменов, трекинг кликов/просмотров через /r, интеграция со SMTP/Listmonk.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published