/** * Admin email-sequence stats dashboard (Phase 05 #80 follow-up). * * GET /admin/email-sequences/:id/stats — per-step open/click/bounce * counts + sequence-level enrollment + conversion summaries. * Aggregated via dbRead.groupBy on EmailSequenceStepDelivery so the * page is replica-friendly. Numbers are exact — no time-bucketing * (the follow-up statistics-aggregation cron from spec Step 9 is * the home for periodic snapshots). */ import { Link, type LoaderFunctionArgs, useLoaderData } from "react-router"; import { requestScopedT as i18nT } from "~/locale/request-scoped-t"; import { adminPath } from "~/utils/app/CanonicalUrlUtils"; import { dbRead } from "~/utils/db.server"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; import { useLocaleFormatters } from "~/locale/format"; type StepStat = { stepIndex: number; template: string; subject: string; scheduled: number; sent: number; opened: number; clicked: number; bounced: number; skipped: number; failed: number; }; type LoaderData = { sequence: { id: string; name: string; triggerEvent: string; isEnabled: boolean; }; totals: { enrolled: number; completed: number; active: number; unsubscribed: number; failed: number; }; stepStats: StepStat[]; }; function safePercent(numerator: number, denominator: number, formatPercent: (value: number, options?: Intl.NumberFormatOptions) => string): string { if (!denominator) return "—"; return formatPercent(numerator / denominator, { minimumFractionDigits: 1, maximumFractionDigits: 1 }); } export const loader = async ({ params, request }: LoaderFunctionArgs) => { await verifyUserHasPermission(request, "admin.marketing.leads.view"); const id = String(params["id"] ?? ""); const sequence = await dbRead.emailSequence.findFirst({ where: { id } }); if (!sequence) throw new Response(null, { status: 404 }); const runStats = await dbRead.emailSequenceRun.groupBy({ by: ["status"], where: { sequenceId: id }, _count: { _all: true }, }); const totals: LoaderData["totals"] = { enrolled: 0, completed: 0, active: 0, unsubscribed: 0, failed: 0, }; for (const row of runStats) { totals.enrolled += row._count._all; if (row.status === "completed") totals.completed = row._count._all; else if (row.status === "running" || row.status === "pending") totals.active += row._count._all; else if (row.status === "unsubscribed") totals.unsubscribed = row._count._all; else if (row.status === "failed" || row.status === "cancelled") totals.failed += row._count._all; } const deliveryStatusAgg = await dbRead.emailSequenceStepDelivery.groupBy({ by: ["stepIndex", "status"], where: { run: { sequenceId: id } }, _count: { _all: true }, }); const openedAgg = await dbRead.emailSequenceStepDelivery.groupBy({ by: ["stepIndex"], where: { run: { sequenceId: id }, openedAt: { not: null } }, _count: { _all: true }, }); const clickedAgg = await dbRead.emailSequenceStepDelivery.groupBy({ by: ["stepIndex"], where: { run: { sequenceId: id }, clickedAt: { not: null } }, _count: { _all: true }, }); const stepsRaw = sequence.stepsJson; const steps: Array<{ stepIndex: number; template: string; subject: string }> = Array.isArray(stepsRaw) ? (stepsRaw as Array>).map((s, idx) => ({ stepIndex: typeof s["stepIndex"] === "number" ? (s["stepIndex"] as number) : idx, template: typeof s["template"] === "string" ? (s["template"] as string) : "?", subject: typeof s["subject"] === "string" ? (s["subject"] as string) : "?", })) : []; const statusCountsByStep = new Map>(); for (const row of deliveryStatusAgg) { const counts = statusCountsByStep.get(row.stepIndex) ?? {}; counts[String(row.status)] = Number(row._count._all ?? 0); statusCountsByStep.set(row.stepIndex, counts); } const openedByStep = new Map(openedAgg.map((row) => [row.stepIndex, Number(row._count._all ?? 0)])); const clickedByStep = new Map(clickedAgg.map((row) => [row.stepIndex, Number(row._count._all ?? 0)])); const configuredStepIndexes = new Set(steps.map((step) => step.stepIndex)); const deliveryOnlySteps = Array.isArray(stepsRaw) ? Array.from(statusCountsByStep.keys()) .filter((stepIndex) => !configuredStepIndexes.has(stepIndex)) .sort((a, b) => a - b) .map((stepIndex) => ({ stepIndex, template: "?", subject: "?" })) : []; const stepStats: StepStat[] = [...steps, ...deliveryOnlySteps].map((s) => { const statusCounts = statusCountsByStep.get(s.stepIndex) ?? {}; return { stepIndex: s.stepIndex, template: s.template, subject: s.subject, scheduled: Object.values(statusCounts).reduce((total, count) => total + count, 0), sent: statusCounts.sent ?? 0, opened: openedByStep.get(s.stepIndex) ?? 0, clicked: clickedByStep.get(s.stepIndex) ?? 0, bounced: statusCounts.bounced ?? 0, skipped: statusCounts.skipped ?? 0, failed: statusCounts.failed ?? 0, }; }); const data: LoaderData = { sequence: { id: sequence.id, name: sequence.name, triggerEvent: sequence.triggerEvent, isEnabled: sequence.isEnabled }, totals, stepStats, }; return Response.json(data); }; export default function EmailSequenceStats() { const data = useLoaderData(); const formatters = useLocaleFormatters(); const editHref = `${adminPath("email-sequences", { mode: "host-aware" })}/${data.sequence.id}`; return (

{data.sequence.name}

{i18nT("admin.emailSequences.stats.trigger")}: {data.sequence.triggerEvent}

{i18nT("admin.emailSequences.stats.editSequence")}
{i18nT("admin.emailSequences.stats.enrolled")}
{formatters.number(data.totals.enrolled)}
{i18nT("admin.emailSequences.col.active")}
{formatters.number(data.totals.active)}
{i18nT("admin.emailSequences.col.completed")}
{formatters.number(data.totals.completed)}
{i18nT("admin.emailSequences.col.unsubscribed")}
{formatters.number(data.totals.unsubscribed)}
{i18nT("admin.emailSequences.stats.failed")}
{formatters.number(data.totals.failed)}
{data.stepStats.length === 0 ? ( ) : ( data.stepStats.map((s) => ( )) )}
{i18nT("admin.emailSequences.columns.step")} {i18nT("admin.emailSequences.columns.template")} {i18nT("admin.emailSequences.columns.subject")} {i18nT("admin.emailSequences.columns.scheduled")} {i18nT("admin.emailSequences.columns.sent")} {i18nT("admin.emailSequences.columns.opened")} {i18nT("admin.emailSequences.columns.openRate")} {i18nT("admin.emailSequences.columns.clicked")} {i18nT("admin.emailSequences.columns.clickRate")} {i18nT("admin.emailSequences.columns.bounced")} {i18nT("admin.emailSequences.columns.skipped")}
{i18nT("admin.emailSequences.stats.noSteps")}
{formatters.number(s.stepIndex)} {s.template} {s.subject} {formatters.number(s.scheduled)} {formatters.number(s.sent)} {formatters.number(s.opened)} {safePercent(s.opened, s.sent, formatters.percent)} {formatters.number(s.clicked)} {safePercent(s.clicked, s.sent, formatters.percent)} {formatters.number(s.bounced)} {formatters.number(s.skipped)}

{i18nT("admin.emailSequences.stats.ratesNote")}

); }