Puls Next Mailing

Готовый стартовый проект для миграции legacy WinForms/DevExpress приложения на современный стек:

• backend: ASP.NET Core Web API на .NET 9;
• ORM: DevExpress XPO;
• frontend: React + Vite + DevExtreme React;
• фоновые процессы: отдельный Worker Service;
• рассылка: MailKit + персистентная очередь + статистика;
• legacy-интеграция: авторизация и чтение сотрудников / организаций / вкладки «Работа» из текущей БД.

Что взято из существующего кода

По исходному архиву были выделены и перенесены ключевые сущности:

• set_User → LegacyUser
• set_UserInfo → LegacyUserInfo
• set_Org → LegacyOrg
• set_OrgInfo → LegacyOrgInfo
• set_OrgInfoOther → LegacyOrgInfoOther
• set_Contact → LegacyContact
• set_Job → LegacyJob
• set_Task → LegacyTask
• set_SprEnumeration → LegacySprEnumeration

Совместимость по паролям сохранена: используется старый алгоритм MD5(Encoding.Unicode.GetBytes(password)).

Архитектура

Проект сознательно разделён на две БД:

1. LegacyDb — текущая рабочая БД существующего приложения. Из неё читаются:
   • пользователи;
   • организации;
   • контакты;
   • данные вкладки «Работа» (set_Job).
2. MailingDb — новая БД сервиса рассылки. В ней хранятся:
   • кампании;
   • вложения;
   • очереди отправки;
   • истории запусков;
   • статистика;
   • SMTP-профили.

Такой подход не ломает legacy-схему и упрощает внедрение.

Структура

backend/
  PulsNextMailing.sln
  src/
    PulsNext.Domain.Legacy/
    PulsNext.Domain.Mailing/
    PulsNext.Infrastructure/
    PulsNext.Api/
    PulsNext.Worker/
frontend/
  puls-next-web/
storage/

Запуск

1) Настройте строки подключения

Скопируйте example-конфиги и подставьте connection string legacy БД из старого settings/XpoSettingsDB.xml:

copy backend\src\PulsNext.Api\appsettings.Development.example.json backend\src\PulsNext.Api\appsettings.Development.json
copy backend\src\PulsNext.Worker\appsettings.Development.example.json backend\src\PulsNext.Worker\appsettings.Development.json

Далее отредактируйте:

• backend/src/PulsNext.Api/appsettings.Development.json
• backend/src/PulsNext.Worker/appsettings.Development.json

Пример:

{
  "ConnectionStrings": {
    "LegacyDb": "XpoProvider=MSSqlServer;data source=SERVER;integrated security=SSPI;initial catalog=DXPulsBase",
    "MailingDb": "XpoProvider=SQLite;Data Source=../../../../storage/mailing.db"
  }
}

2) Проверьте сборку backend

cd backend
dotnet build PulsNextMailing.sln

Если во время сборки появляется DX1001, см. docs/devexpress-license.md.

3) Поднимите backend

cd backend
dotnet run --project src/PulsNext.Api

В отдельной консоли:

cd backend
dotnet run --project src/PulsNext.Worker

4) Поднимите frontend

cd frontend/puls-next-web
npm install
npm run build
npm run dev

После этого будут доступны:

• frontend: http://localhost:5173
• backend api: http://localhost:5185
• swagger: http://localhost:5185/swagger

Что уже реализовано в коде

Backend API

• JWT-авторизация по legacy пользователям;
• список сотрудников;
• список организаций;
• данные вкладки «Работа»;
• CRUD кампаний рассылки;
• CRUD SMTP-профилей;
• загрузка файлов;
• предпросмотр расписания;
• статистика по отправкам;
• ручной запуск кампании.

Worker

• поиск кампаний, у которых наступило время запуска;
• расчёт следующего времени отправки;
• генерация очереди отправки по организациям и email-адресам;
• конкурентная обработка очереди;
• ретраи;
• запись статусов и ошибок.

Frontend

• современная shell-навигация;
• логин;
• страницы сотрудников, организаций и вкладки «Работа»;
• список кампаний;
• мастер редактирования кампании;
• загрузка вложений и картинок;
• просмотр статистики;
• управление SMTP-профилями.

Поддерживаемые сценарии расписания

• OneTime — отложенная разовая отправка;
• FixedInterval — каждые N минут;
• RandomInterval — случайный интервал от X до Y минут;
• Cron — произвольное расписание Quartz Cron (например, по понедельникам, по будням, в определённые часы и т.п.).

Важные замечания

1. Локальная сборка проверена командами dotnet build backend/PulsNextMailing.sln и npm run build в frontend/puls-next-web.
2. Frontend и backend настроены как production-ready scaffold: после подстановки актуальных connection strings проект должен быть близок к боевому запуску.
3. Для реального продакшена рекомендовано:
   • вынести файловое хранилище в S3/MinIO/Azure Blob;
   • подключить Redis/RabbitMQ для распределённой очереди;
   • добавить OpenTelemetry/Prometheus;
   • включить reverse proxy и TLS.

Следующий шаг

Если будете внедрять это в текущую БД, сначала поднимите проект на копии базы и прогоните сценарии:

• логин;
• чтение сотрудников;
• чтение организаций;
• чтение вкладки «Работа»;
• создание тестовой кампании;
• отправка на тестовый SMTP.