Files
HiveGrid-Wireframes/hivegrid-cloud/apps/web/app/routes/admin/marketing-funnels.tsx
T

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