Реалізація 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() {
  // Отримати користувачів з налаштуванням щоденного дайджесту
  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
  `);

  // Врахувати часовий пояс — відправити в локальний час ранку
  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+місцевий)

  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 });
});

Тривалість

Система дайджестів з накопиченням подій, планувальником, врахуванням часового поясу та налаштуваннями користувача займає 4–6 днів.