/** * Marketing-funnel attribution reports (Phase 05 #79). * * Aggregates `Lead` + `TenantAcquisition` rows into conversion-rate * dashboards by source, campaign, utmSource, and conversionPath. Uses * `dbRead` for the heavy aggregation queries so the primary stays cool. * Period selector (default last 30 days). */ import { LoaderFunctionArgs, useLoaderData } from "react-router"; import type { TFunction } from "i18next"; import { useTranslation } from "react-i18next"; import { dbRead } from "~/utils/db.server"; import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService"; import { useLocaleFormatters, type LocaleFormatters } from "~/locale/format"; type Loader = Awaited>; type LoaderData = Loader extends Response ? never : Loader; const DEFAULT_DAYS = 30; const MAX_DAYS = 365; export const loader = async ({ request }: LoaderFunctionArgs) => { await verifyUserHasPermission(request, "admin.marketing.funnels.view"); const url = new URL(request.url); const days = clampDays(parseInt(url.searchParams.get("days") ?? "", 10)); const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000); const leadCountPromise = dbRead.lead.count({ where: { createdAt: { gte: since } } }); const conversionCountPromise = dbRead.tenantAcquisition.count({ where: { convertedAt: { gte: since } } }); const leadsByStatusPromise = dbRead.lead.groupBy({ by: ["status"], _count: { _all: true }, where: { createdAt: { gte: since } }, }); const byCampaignPromise = dbRead.tenantAcquisition.groupBy({ by: ["utmCampaign"], _count: { _all: true }, where: { convertedAt: { gte: since } }, orderBy: { _count: { tenantId: "desc" } }, take: 25, }); const bySourcePromise = dbRead.tenantAcquisition.groupBy({ by: ["utmSource"], _count: { _all: true }, where: { convertedAt: { gte: since } }, orderBy: { _count: { tenantId: "desc" } }, take: 25, }); const byPathPromise = dbRead.tenantAcquisition.groupBy({ by: ["conversionPath"], _count: { _all: true }, where: { convertedAt: { gte: since } }, }); const bySourceLabelPromise = dbRead.tenantAcquisition.groupBy({ by: ["source"], _count: { _all: true }, where: { convertedAt: { gte: since } }, orderBy: { _count: { tenantId: "desc" } }, take: 25, }); const [leadCount, conversionCount, leadsByStatus, byCampaign, bySource, byPath, bySourceLabel] = await Promise.all([ leadCountPromise, conversionCountPromise, leadsByStatusPromise, byCampaignPromise, bySourcePromise, byPathPromise, bySourceLabelPromise, ]); const stageCounts: Record = {}; for (const row of leadsByStatus) { stageCounts[row.status] = row._count._all; } const conversionRate = leadCount > 0 ? conversionCount / leadCount : 0; return { days, sinceIso: since.toISOString(), leadCount, conversionCount, conversionRate, stageCounts, byCampaign: byCampaign.map((r) => ({ key: r.utmCampaign ?? "(none)", count: r._count._all })), bySource: bySource.map((r) => ({ key: r.utmSource ?? "(none)", count: r._count._all })), bySourceLabel: bySourceLabel.map((r) => ({ key: r.source ?? "(none)", count: r._count._all })), byPath: byPath.map((r) => ({ key: r.conversionPath ?? "(none)", count: r._count._all })), }; }; function clampDays(input: number): number { if (!Number.isFinite(input) || input <= 0) return DEFAULT_DAYS; return Math.min(Math.floor(input), MAX_DAYS); } function formatPct(n: number, formatters: LocaleFormatters): string { return formatters.percent(n, { minimumFractionDigits: 1, maximumFractionDigits: 1 }); } export default function MarketingFunnels() { const { t } = useTranslation(); const formatters = useLocaleFormatters(); const data = useLoaderData() as LoaderData; return (

{t("admin.marketingFunnels.title")}

{t("admin.marketingFunnels.description", { days: data.days, formattedDays: formatters.number(data.days), since: formatters.date(data.sinceIso, { dateStyle: "medium" }), })}

t(`admin.marketingFunnels.conversionPaths.${key}`, { defaultValue: key })} />
); } function Card({ title, value }: { title: string; value: string }) { return (
{title}
{value}
); } function FunnelStages({ stages, t, formatters }: { stages: Record; t: TFunction; formatters: LocaleFormatters }) { const order = ["new", "contacted", "qualified", "trial", "customer"]; return (

{t("admin.marketingFunnels.sections.stageDistribution")}

{order.map((s) => (
{t(`admin.marketingFunnels.stages.${s}`)}
{formatters.number(stages[s] ?? 0)}
))}
); } function Breakdown({ title, rows, totalLeads, t, formatters, labelForKey, }: { title: string; rows: { key: string; count: number }[]; totalLeads: number; t: TFunction; formatters: LocaleFormatters; labelForKey?: (key: string) => string; }) { return (

{title}

{rows.length === 0 ? (

{t("admin.marketingFunnels.empty.noDataInPeriod")}

) : ( {rows.map((r) => ( ))}
{t("admin.marketingFunnels.table.key")} {t("admin.marketingFunnels.metrics.conversions")} {t("admin.marketingFunnels.table.rateVsAllLeads")}
{r.key === "(none)" ? t("admin.marketingFunnels.empty.none") : labelForKey?.(r.key) ?? r.key} {formatters.number(r.count)} {totalLeads > 0 ? formatPct(r.count / totalLeads, formatters) : "-"}
)}
); }