perf(webapp): prune the webhook delivery detail lookup to its partition

The delivery detail point lookup queried WebhookDelivery by id and environment
only. The table is RANGE-partitioned on createdAt, so with no createdAt
predicate Postgres cannot prune and probes every daily partition. Thread the
row's createdAt (the list the user navigated from already has it) through to
the lookup as a narrow bounding window so it prunes to the row's partition.
Direct links with no timestamp fall back to the unbounded query.

Author: ericallam

apps/webapp/app/components/webhookDeliveries/v1/DeliveriesTable.tsx

@@ -113,7 +113,8 @@ export function DeliveriesTable({
               organization,
               project,
               environment,
-              delivery.friendlyId
+              delivery.friendlyId,
+              delivery.createdAt
             );
 
             return (

apps/webapp/app/presenters/v3/WebhookDeliveryDetailPresenter.server.ts

@@ -49,11 +49,13 @@ export class WebhookDeliveryDetailPresenter {
     projectId,
     environmentId,
     deliveryFriendlyId,
+    createdAt,
   }: {
     organizationId: string;
     projectId: string;
     environmentId: string;
     deliveryFriendlyId: string;
+    createdAt?: Date;
   }): Promise<WebhookDeliveryDetail | null> {
     const repository = webhookDeliveriesRepository({
       clickhouse: this.clickhouse,
@@ -65,6 +67,7 @@ export class WebhookDeliveryDetailPresenter {
       projectId,
       environmentId,
       friendlyId: deliveryFriendlyId,
+      createdAt,
     });
 
     if (!delivery) {

apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.webhooks.$webhookParam/route.tsx

@@ -647,7 +647,13 @@ function ConsoleFeedList({
       {visibleDeliveries.map((delivery) => (
         <Link
           key={delivery.id}
-          to={v3WebhookDeliveryPath(organization, project, environment, delivery.friendlyId)}
+          to={v3WebhookDeliveryPath(
+            organization,
+            project,
+            environment,
+            delivery.friendlyId,
+            delivery.createdAt
+          )}
           className="flex flex-col gap-1 border-b border-grid-dimmed px-3 py-2 hover:bg-charcoal-800"
         >
           <div className="flex items-center justify-between gap-2">

apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.webhooks.deliveries.$deliveryParam/route.tsx

@@ -97,12 +97,17 @@ export const loader = async ({ request, params }: LoaderFunctionArgs) => {
     "standard"
   );
 
+  const atParam = new URL(request.url).searchParams.get("at");
+  const atMs = atParam ? Number(atParam) : NaN;
+  const createdAt = Number.isFinite(atMs) ? new Date(atMs) : undefined;
+
   const presenter = new WebhookDeliveryDetailPresenter($replica, clickhouse);
   const delivery = await presenter.call({
     organizationId: project.organizationId,
     projectId: project.id,
     environmentId: environment.id,
     deliveryFriendlyId: deliveryParam,
+    createdAt,
   });
 
   const rawEventJson =

apps/webapp/app/services/webhookDeliveriesRepository/clickhouseWebhookDeliveriesRepository.server.ts

@@ -18,6 +18,13 @@ type DeliveryCursorRow = { deliveryId: string; createdAt: number };
 
 const WEBHOOK_DELIVERY_ID_PREFIX = "whd_";
 
+/**
+ * Half-width of the `createdAt` window used to partition-prune a delivery point lookup. Wide enough to
+ * absorb millisecond/microsecond rounding between the caller's timestamp and the stored value, narrow
+ * enough that the query still prunes to one (occasionally two, across a midnight boundary) daily partition.
+ */
+const PARTITION_PRUNE_SLOP_MS = 1_000;
+
 const DELIVERY_DETAIL_SELECT = {
   id: true,
   friendlyId: true,
@@ -281,14 +288,30 @@ export class ClickHouseWebhookDeliveriesRepository implements IWebhookDeliveries
    * A point lookup: pure Postgres, never ClickHouse. `friendlyId` is `whd_` + the row id, so we
    * strip the prefix and hit the composite-PK index (scoped by environment). ClickHouse is for
    * aggregations and for filtering/ordering a list into ids, never for selecting a row's columns.
+   *
+   * `WebhookDelivery` is RANGE-partitioned on `createdAt`, so a bare `id` predicate can't prune and
+   * probes every partition. When the caller supplies `createdAt` (the list row it came from has it),
+   * bound the query to a narrow window around it so Postgres prunes to the row's partition. The id is
+   * globally unique, so the window only prunes; it never changes which row is returned.
    */
   async getDelivery(options: GetWebhookDeliveryOptions): Promise<DetailedWebhookDelivery | null> {
     const id = options.friendlyId.startsWith(WEBHOOK_DELIVERY_ID_PREFIX)
       ? options.friendlyId.slice(WEBHOOK_DELIVERY_ID_PREFIX.length)
       : options.friendlyId;
 
     return this.options.prisma.webhookDelivery.findFirst({
-      where: { id, runtimeEnvironmentId: options.environmentId },
+      where: {
+        id,
+        runtimeEnvironmentId: options.environmentId,
+        ...(options.createdAt
+          ? {
+              createdAt: {
+                gte: new Date(options.createdAt.getTime() - PARTITION_PRUNE_SLOP_MS),
+                lte: new Date(options.createdAt.getTime() + PARTITION_PRUNE_SLOP_MS),
+              },
+            }
+          : {}),
+      },
       select: DELIVERY_DETAIL_SELECT,
     });
   }

apps/webapp/app/services/webhookDeliveriesRepository/webhookDeliveriesRepository.server.ts

@@ -83,6 +83,14 @@ export type GetWebhookDeliveryOptions = {
   projectId: string;
   environmentId: string;
   friendlyId: string;
+  /**
+   * The delivery's `createdAt`, when the caller already has it (e.g. from the
+   * list row it navigated from). `WebhookDelivery` is RANGE-partitioned on
+   * `createdAt`, so supplying it lets the point lookup prune to the row's
+   * partition instead of probing every partition. Omit for a direct link with
+   * no timestamp; the lookup still succeeds, it just cannot prune.
+   */
+  createdAt?: Date;
 };
 
 export type GetDeliveriesByFriendlyIdsOptions = {

apps/webapp/app/utils/pathBuilder.ts

@@ -426,13 +426,15 @@ export function v3WebhookDeliveryPath(
   organization: OrgForPath,
   project: ProjectForPath,
   environment: EnvironmentForPath,
-  deliveryFriendlyId: string
+  deliveryFriendlyId: string,
+  createdAt?: Date
 ) {
-  return `${v3EnvironmentPath(
+  const base = `${v3EnvironmentPath(
     organization,
     project,
     environment
   )}/webhooks/deliveries/${encodeURIComponent(deliveryFriendlyId)}`;
+  return createdAt ? `${base}?at=${createdAt.getTime()}` : base;
 }
 
 export function v3WebhookEndpointPath(