Реализация email-дайджестов (ежедневных/еженедельных) на сайте

Разработка системы email-дайджестов (ежедневных и еженедельных)

Email-дайджест — это агрегированное письмо с подборкой событий за период: новые комментарии, активность в проекте, новые статьи, изменения в задачах. В отличие от реального времени, дайджест позволяет пользователям управлять частотой получения уведомлений.

Архитектура

Events → Event Store (DB) → Digest Scheduler (Cron) → Digest Builder → ESP → User
                                     ↓
                             User Preferences
                         (daily/weekly, timezone)

Накопление событий для дайджеста

// Таблица событий для дайджестов
// CREATE TABLE digest_events (
//   id UUID PRIMARY KEY,
//   user_id UUID NOT NULL,
//   type VARCHAR(100) NOT NULL,
//   payload JSONB NOT NULL,
//   created_at TIMESTAMPTZ DEFAULT now(),
//   included_in_digest_at TIMESTAMPTZ
// );

async function trackDigestEvent(
  userId: string,
  type: string,
  payload: Record<string, unknown>
) {
  await db.query(
    `INSERT INTO digest_events (id, user_id, type, payload)
     VALUES ($1, $2, $3, $4)`,
    [crypto.randomUUID(), userId, type, JSON.stringify(payload)]
  );
}

// Использование из разных частей приложения
await trackDigestEvent(userId, 'new_comment', {
  postTitle: post.title,
  commenterName: commenter.name,
  commentPreview: comment.body.slice(0, 100),
  url: `https://app.example.com/posts/${post.id}#comment-${comment.id}`,
});

await trackDigestEvent(userId, 'task_assigned', {
  taskTitle: task.title,
  assignerName: assigner.name,
  dueDate: task.dueDate,
  url: `https://app.example.com/tasks/${task.id}`,
});

Планировщик дайджестов

import { CronJob } from 'cron';

// Ежедневный дайджест — каждый день в 8:00 UTC
new CronJob('0 8 * * *', async () => {
  await sendDailyDigests();
}).start();

// Еженедельный — каждый понедельник в 9:00 UTC
new CronJob('0 9 * * 1', async () => {
  await sendWeeklyDigests();
}).start();

async function sendDailyDigests() {
  // Получить пользователей с настройкой daily digest
  const users = await db.query<User[]>(`
    SELECT u.id, u.email, u.name, u.timezone, up.digest_time
    FROM users u
    JOIN user_preferences up ON u.id = up.user_id
    WHERE up.digest_frequency = 'daily'
      AND up.digest_enabled = true
  `);

  // Учесть timezone — отправлять в локальное утро
  const usersToSend = users.filter(user => {
    const localHour = new Date().toLocaleString('en-US', {
      timeZone: user.timezone,
      hour: 'numeric',
      hour12: false,
    });
    return localHour === String(user.digest_time ?? 8);
  });

  await Promise.allSettled(
    usersToSend.map(user => sendUserDigest(user, 'daily'))
  );
}

Сборка и отправка дайджеста

async function sendUserDigest(user: User, period: 'daily' | 'weekly') {
  const since = period === 'daily'
    ? new Date(Date.now() - 24 * 60 * 60 * 1000)
    : new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);

  // Получить события за период
  const events = await db.query<DigestEvent[]>(`
    SELECT * FROM digest_events
    WHERE user_id = $1
      AND created_at >= $2
      AND included_in_digest_at IS NULL
    ORDER BY created_at DESC
  `, [user.id, since]);

  if (events.length === 0) return;  // не отправлять пустой дайджест

  // Сгруппировать по типу
  const grouped = events.reduce((acc, event) => {
    acc[event.type] = (acc[event.type] ?? []).concat(event);
    return acc;
  }, {} as Record<string, DigestEvent[]>);

  // Рендер шаблона
  const html = renderDigestTemplate({
    user,
    period,
    groups: grouped,
    totalCount: events.length,
    unsubscribeUrl: generateUnsubscribeUrl(user.id),
  });

  await sendEmail({
    to: user.email,
    subject: period === 'daily'
      ? `Дайджест за сегодня — ${events.length} обновлений`
      : `Недельный дайджест — ${events.length} событий`,
    html,
  });

  // Пометить события как включённые в дайджест
  await db.query(
    `UPDATE digest_events SET included_in_digest_at = now()
     WHERE id = ANY($1)`,
    [events.map(e => e.id)]
  );
}

Настройки пользователя

// API для управления предпочтениями дайджеста
app.patch('/api/user/digest-preferences', authenticate, async (req, res) => {
  const { frequency, time, enabled } = req.body;
  // frequency: 'none' | 'daily' | 'weekly'
  // time: 0-23 (час для отправки в UTC+local)

  await db.query(
    `INSERT INTO user_preferences (user_id, digest_frequency, digest_time, digest_enabled)
     VALUES ($1, $2, $3, $4)
     ON CONFLICT (user_id) DO UPDATE
     SET digest_frequency = $2, digest_time = $3, digest_enabled = $4`,
    [req.user.id, frequency, time, enabled]
  );

  res.json({ ok: true });
});

Сроки

Система дайджестов с накоплением событий, планировщиком, учётом timezone и настройками пользователя — 4–6 дней.