232 lines
9.1 KiB
TypeScript
232 lines
9.1 KiB
TypeScript
/**
|
|
* 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<ReturnType<typeof loader>>;
|
|
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<string, number> = {};
|
|
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 (
|
|
<div className="mx-auto mb-12 max-w-6xl space-y-6 px-4 py-4 sm:px-6 lg:px-8">
|
|
<header className="border-border flex items-end justify-between border-b pb-4">
|
|
<div>
|
|
<h1 className="text-lg font-medium">{t("admin.marketingFunnels.title")}</h1>
|
|
<p className="text-muted-foreground text-sm">
|
|
{t("admin.marketingFunnels.description", {
|
|
days: data.days,
|
|
formattedDays: formatters.number(data.days),
|
|
since: formatters.date(data.sinceIso, { dateStyle: "medium" }),
|
|
})}
|
|
</p>
|
|
</div>
|
|
<form method="get" className="flex items-center gap-2 text-sm">
|
|
<label htmlFor="marketing-funnel-days" className="text-muted-foreground">
|
|
{t("admin.marketingFunnels.filters.periodDays")}
|
|
</label>
|
|
<input
|
|
type="number"
|
|
id="marketing-funnel-days"
|
|
name="days"
|
|
min={1}
|
|
max={MAX_DAYS}
|
|
defaultValue={data.days}
|
|
className="border-border w-20 rounded-md border px-2 py-1 text-sm"
|
|
/>
|
|
<button type="submit" className="bg-primary text-primary-foreground rounded-md px-3 py-1 text-sm">
|
|
{t("admin.marketingFunnels.actions.apply")}
|
|
</button>
|
|
</form>
|
|
</header>
|
|
|
|
<section className="grid gap-3 sm:grid-cols-3">
|
|
<Card title={t("admin.marketingFunnels.metrics.leadsCaptured")} value={formatters.number(data.leadCount)} />
|
|
<Card title={t("admin.marketingFunnels.metrics.conversions")} value={formatters.number(data.conversionCount)} />
|
|
<Card title={t("admin.marketingFunnels.metrics.conversionRate")} value={formatPct(data.conversionRate, formatters)} />
|
|
</section>
|
|
|
|
<FunnelStages stages={data.stageCounts} t={t} formatters={formatters} />
|
|
|
|
<Breakdown title={t("admin.marketingFunnels.sections.byCampaign")} rows={data.byCampaign} totalLeads={data.leadCount} t={t} formatters={formatters} />
|
|
<Breakdown title={t("admin.marketingFunnels.sections.byUtmSource")} rows={data.bySource} totalLeads={data.leadCount} t={t} formatters={formatters} />
|
|
<Breakdown title={t("admin.marketingFunnels.sections.bySourceLabel")} rows={data.bySourceLabel} totalLeads={data.leadCount} t={t} formatters={formatters} />
|
|
<Breakdown
|
|
title={t("admin.marketingFunnels.sections.byConversionPath")}
|
|
rows={data.byPath}
|
|
totalLeads={data.leadCount}
|
|
t={t}
|
|
formatters={formatters}
|
|
labelForKey={(key) => t(`admin.marketingFunnels.conversionPaths.${key}`, { defaultValue: key })}
|
|
/>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function Card({ title, value }: { title: string; value: string }) {
|
|
return (
|
|
<div className="border-border rounded-md border p-4">
|
|
<div className="text-muted-foreground text-xs uppercase">{title}</div>
|
|
<div className="mt-1 text-2xl font-semibold tabular-nums">{value}</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function FunnelStages({ stages, t, formatters }: { stages: Record<string, number>; t: TFunction; formatters: LocaleFormatters }) {
|
|
const order = ["new", "contacted", "qualified", "trial", "customer"];
|
|
return (
|
|
<section className="rounded-md border p-4">
|
|
<h2 className="text-sm font-semibold uppercase tracking-wide">{t("admin.marketingFunnels.sections.stageDistribution")}</h2>
|
|
<div className="mt-3 grid gap-2 sm:grid-cols-5">
|
|
{order.map((s) => (
|
|
<div key={s} className="border-border rounded-md border p-2 text-center">
|
|
<div className="text-muted-foreground text-xs uppercase">{t(`admin.marketingFunnels.stages.${s}`)}</div>
|
|
<div className="text-lg font-medium">{formatters.number(stages[s] ?? 0)}</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
</section>
|
|
);
|
|
}
|
|
|
|
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 (
|
|
<section className="rounded-md border p-4">
|
|
<h2 className="text-sm font-semibold uppercase tracking-wide">{title}</h2>
|
|
{rows.length === 0 ? (
|
|
<p className="text-muted-foreground mt-2 text-sm">{t("admin.marketingFunnels.empty.noDataInPeriod")}</p>
|
|
) : (
|
|
<table className="mt-2 w-full text-sm">
|
|
<thead className="border-border border-b text-xs uppercase text-muted-foreground">
|
|
<tr>
|
|
<th className="py-1 text-left">{t("admin.marketingFunnels.table.key")}</th>
|
|
<th className="py-1 text-right">{t("admin.marketingFunnels.metrics.conversions")}</th>
|
|
<th className="py-1 text-right">{t("admin.marketingFunnels.table.rateVsAllLeads")}</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
{rows.map((r) => (
|
|
<tr key={r.key} className="border-border border-b last:border-b-0">
|
|
<td className="py-1">{r.key === "(none)" ? t("admin.marketingFunnels.empty.none") : labelForKey?.(r.key) ?? r.key}</td>
|
|
<td className="py-1 text-right tabular-nums">{formatters.number(r.count)}</td>
|
|
<td className="py-1 text-right tabular-nums">
|
|
{totalLeads > 0 ? formatPct(r.count / totalLeads, formatters) : "-"}
|
|
</td>
|
|
</tr>
|
|
))}
|
|
</tbody>
|
|
</table>
|
|
)}
|
|
</section>
|
|
);
|
|
}
|