Improve social milestone sharing flow

2026-08-14 12:31:10 +02:00
parent e0c32542f9
commit 925540f3c6
11 changed files with 400 additions and 121 deletions
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -175,6 +175,14 @@ model SocialMilestone {
  consentText String?
  language    String   @default("en")
  cardData    Json?
+  brandStatus String   @default("pending")
+  brandApprovedAt DateTime?
+  brandPostedAt DateTime?
+  brandPostUrl String?
+  brandPostError String?
+  selfSharedAt DateTime?
+  shareToken String? @unique
+  publicShareApprovedAt DateTime?

  qr   QRCode @relation(fields: [qrId], references: [id], onDelete: Cascade)
  user User   @relation(fields: [userId], references: [id], onDelete: Cascade)
--- a/scripts/social-worker/worker.py
+++ b/scripts/social-worker/worker.py
@@ -1,4 +1,4 @@
-"""Always-on QRMaster X milestone worker. The web app never receives X keys."""
+"""Always-on QR Master X milestone worker. The web app never receives X keys."""
 import json
 import os
 import tempfile
@@ -23,20 +23,45 @@ def api(method, url, payload=None):
    return response.json()


+def font(name, size):
+    return ImageFont.truetype(f"/usr/share/fonts/truetype/dejavu/{name}", size)
+
+
 def render_card(card):
-    image = Image.new("RGB", (1200, 675), "#061b31")
+    """Render the consented immutable scan snapshot; never invent trend data."""
+    image = Image.new("RGB", (1200, 630), "#f8fafc")
    draw = ImageDraw.Draw(image)
-    fonts = Path("/usr/share/fonts/truetype/dejavu")
-    bold = ImageFont.truetype(str(fonts / "DejaVuSans-Bold.ttf"), 112)
-    regular = ImageFont.truetype(str(fonts / "DejaVuSans.ttf"), 34)
-    image_draw = draw
-    image_draw.rounded_rectangle((55, 55, 1145, 620), radius=28, outline="#304866", width=2)
-    image_draw.text((100, 105), "QR MASTER", font=regular, fill="#dce8f7")
-    image_draw.text((100, 210), f"{card['threshold']:,}", font=bold, fill="#ffffff")
-    scans = "eindeutige Scans" if card.get("language") == "de" else "unique scans"
-    image_draw.text((105, 350), scans, font=regular, fill="#b8c7da")
-    image_draw.line((100, 500, 1100, 500), fill="#304866", width=2)
-    image_draw.text((100, 535), f"{card['label']} · {card['title']}", font=regular, fill="#dce8f7")
+    navy, blue, slate, border, green = "#061b31", "#0256ff", "#64748b", "#e2e8f0", "#059669"
+    regular, medium, bold, display = font("DejaVuSans.ttf", 28), font("DejaVuSans-Bold.ttf", 28), font("DejaVuSans-Bold.ttf", 42), font("DejaVuSans-Bold.ttf", 116)
+    draw.rounded_rectangle((45, 42, 1155, 588), radius=24, fill="#ffffff", outline=border, width=2)
+    draw.rounded_rectangle((82, 79, 114, 111), radius=7, fill=blue)
+    draw.text((130, 81), "QR MASTER", font=medium, fill=navy)
+    draw.rounded_rectangle((932, 77, 1118, 114), radius=8, fill="#ecfdf5")
+    draw.text((954, 84), "Verified milestone", font=font("DejaVuSans-Bold.ttf", 17), fill=green)
+    draw.text((84, 158), "TOTAL UNIQUE SCANS", font=font("DejaVuSans-Bold.ttf", 18), fill="#94a3b8")
+    total = int(card.get("totalUniqueScans") or card.get("threshold") or 0)
+    draw.text((78, 184), f"{total:,}", font=display, fill=navy)
+    label = "eindeutige Scans" if card.get("language") == "de" else "unique scans"
+    draw.text((86, 325), label, font=regular, fill=slate)
+    trend = card.get("trend") or None
+    if trend and len(trend.get("series", [])) > 1:
+        series = trend["series"]
+        left, top, width, height = 84, 390, 1030, 88
+        max_value = max(series) or 1
+        points = [(left + round(index * width / (len(series) - 1)), top + height - round(value / max_value * height)) for index, value in enumerate(series)]
+        for y in (top, top + height // 2, top + height):
+            draw.line((left, y, left + width, y), fill="#edf2f7", width=2)
+        draw.line(points, fill=blue, width=6, joint="curve")
+        for x, y in (points[0], points[-1]):
+            draw.ellipse((x - 7, y - 7, x + 7, y + 7), fill=blue)
+        draw.text((84, 495), f"Last {trend.get('periodDays', 7)} days · {trend.get('recentTotal', 0)} unique scans", font=font("DejaVuSans.ttf", 18), fill=slate)
+    else:
+        draw.rounded_rectangle((84, 398, 357, 452), radius=10, fill="#eff6ff")
+        copy = "Erste Dynamik" if card.get("language") == "de" else "Early momentum"
+        draw.text((106, 411), copy, font=font("DejaVuSans-Bold.ttf", 20), fill=blue)
+        draw.text((84, 495), "Trend appears once enough real scan history exists." if card.get("language") != "de" else "Der Trend erscheint mit ausreichend echten Scan-Daten.", font=font("DejaVuSans.ttf", 18), fill=slate)
+    draw.line((84, 532, 1116, 532), fill=border, width=2)
+    draw.text((84, 549), card.get("qrTitle") or card.get("title") or "QR code", font=medium, fill=navy)
    path = Path(tempfile.mkstemp(suffix=".png")[1])
    image.save(path, "PNG", optimize=True)
    return path
@@ -70,10 +95,12 @@ def run_once():
        return
    try:
        result = post_x(milestone["text"], milestone.get("card"))
-        api("PATCH", base, {"id": milestone["id"], "result": "posted"})
+        tweet_id = result.get("data", {}).get("id")
+        post_url = f"https://x.com/i/web/status/{tweet_id}" if tweet_id else None
+        api("PATCH", base, {"id": milestone["id"], "result": "posted", "postUrl": post_url})
        print(json.dumps({"posted": milestone["id"], "x": result}), flush=True)
    except Exception as error:
-        api("PATCH", base, {"id": milestone["id"], "result": "failed"})
+        api("PATCH", base, {"id": milestone["id"], "result": "failed", "error": str(error)[:500]})
        print(f"Milestone post failed: {error}", flush=True)


--- a/sql/2026-08-13_social_milestones.sql
+++ b/sql/2026-08-13_social_milestones.sql
@@ -28,3 +28,16 @@ ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "language" TEXT NOT NULL
 ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "cardData" JSONB;
 CREATE INDEX IF NOT EXISTS "SocialMilestone_status_claimedAt_idx"
  ON "SocialMilestone" ("status", "claimedAt");
+
+-- Version 2: independent brand and self-share state plus a consent-gated
+-- unguessable URL for Open Graph previews. Execute manually once.
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "brandStatus" TEXT NOT NULL DEFAULT 'pending';
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "brandApprovedAt" TIMESTAMP(3);
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "brandPostedAt" TIMESTAMP(3);
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "brandPostUrl" TEXT;
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "brandPostError" TEXT;
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "selfSharedAt" TIMESTAMP(3);
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "shareToken" TEXT;
+ALTER TABLE "SocialMilestone" ADD COLUMN IF NOT EXISTS "publicShareApprovedAt" TIMESTAMP(3);
+CREATE UNIQUE INDEX IF NOT EXISTS "SocialMilestone_shareToken_key"
+  ON "SocialMilestone" ("shareToken") WHERE "shareToken" IS NOT NULL;
--- a/src/app/(main)/(marketing)/s/m/[token]/og/route.tsx
+++ b/src/app/(main)/(marketing)/s/m/[token]/og/route.tsx
@@ -0,0 +1,15 @@
+import { ImageResponse } from 'next/og';
+import { db } from '@/lib/db';
+
+export const runtime = 'nodejs';
+
+export async function GET(_request: Request, { params }: { params: { token: string } }) {
+  const share = await db.socialMilestone.findFirst({
+    where: { shareToken: params.token, publicShareApprovedAt: { not: null } },
+    select: { cardData: true, language: true },
+  });
+  if (!share) return new Response('Not found', { status: 404, headers: { 'Cache-Control': 'no-store' } });
+  const card = share.cardData as { qrTitle?: string; totalUniqueScans?: number; trend?: { periodDays: number; recentTotal: number } | null } | null;
+  const german = share.language === 'de';
+  return new ImageResponse(<div style={{ height: '100%', width: '100%', display: 'flex', background: '#f8fafc', padding: 46, color: '#061b31' }}><div style={{ display: 'flex', flexDirection: 'column', width: '100%', border: '2px solid #e2e8f0', borderRadius: 24, background: 'white', padding: 44 }}><div style={{ display: 'flex', justifyContent: 'space-between', fontSize: 23, fontWeight: 700 }}><span>QR MASTER</span><span style={{ color: '#059669', background: '#ecfdf5', padding: '8px 14px', borderRadius: 8 }}>Verified milestone</span></div><div style={{ display: 'flex', flexDirection: 'column', marginTop: 58 }}><span style={{ fontSize: 20, color: '#94a3b8', fontWeight: 700 }}>TOTAL UNIQUE SCANS</span><span style={{ fontSize: 116, fontWeight: 700, letterSpacing: -5 }}>{(card?.totalUniqueScans || 0).toLocaleString(german ? 'de-DE' : 'en-US')}</span><span style={{ fontSize: 29, color: '#64748b' }}>{german ? 'eindeutige Scans' : 'unique scans'}</span></div><div style={{ display: 'flex', marginTop: 'auto', paddingTop: 28, borderTop: '2px solid #e2e8f0', justifyContent: 'space-between', fontSize: 25 }}><span>{card?.qrTitle || 'QR code'}</span><span style={{ color: '#0256ff' }}>{card?.trend ? `${card.trend.recentTotal} in ${card.trend.periodDays} days` : (german ? 'Erste Dynamik' : 'Early momentum')}</span></div></div></div>, { width: 1200, height: 630, headers: { 'Cache-Control': 'no-store' } });
+}
--- a/src/app/(main)/(marketing)/s/m/[token]/page.tsx
+++ b/src/app/(main)/(marketing)/s/m/[token]/page.tsx
@@ -0,0 +1,38 @@
+import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+import { db } from '@/lib/db';
+import { getWwwOrigin } from '@/lib/hosts';
+
+type Props = { params: { token: string } };
+
+async function getShare(token: string) {
+  return db.socialMilestone.findFirst({
+    where: { shareToken: token, publicShareApprovedAt: { not: null } },
+    select: { cardData: true, language: true },
+  });
+}
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const share = await getShare(params.token);
+  if (!share) return { robots: { index: false, follow: false } };
+  const card = share.cardData as { qrTitle?: string; totalUniqueScans?: number } | null;
+  const count = card?.totalUniqueScans || 0;
+  const title = share.language === 'de'
+    ? `${count.toLocaleString('de-DE')} eindeutige QR-Scans erreicht`
+    : `${count.toLocaleString('en-US')} unique QR scans reached`;
+  const url = `${getWwwOrigin()}/s/m/${params.token}`;
+  return {
+    title,
+    description: card?.qrTitle || 'A verified QR Master scan milestone.',
+    robots: { index: false, follow: false },
+    openGraph: { type: 'website', title, description: card?.qrTitle, url, images: [`${url}/og`] },
+    twitter: { card: 'summary_large_image', title, description: card?.qrTitle, images: [`${url}/og`] },
+  };
+}
+
+export default async function SocialMilestoneSharePage({ params }: Props) {
+  const share = await getShare(params.token);
+  if (!share) notFound();
+  const card = share.cardData as { qrTitle?: string; totalUniqueScans?: number } | null;
+  return <main className="min-h-screen bg-slate-50 px-6 py-20 text-center text-[#061b31]"><div className="mx-auto max-w-xl rounded-xl border border-slate-200 bg-white p-10 shadow-[0_30px_45px_-30px_rgba(50,50,93,0.35)]"><p className="text-xs font-semibold tracking-[0.14em] text-[#0256ff]">QR MASTER · VERIFIED MILESTONE</p><h1 className="mt-5 text-5xl font-semibold tracking-[-0.05em] tabular-nums">{(card?.totalUniqueScans || 0).toLocaleString(share.language === 'de' ? 'de-DE' : 'en-US')}</h1><p className="mt-2 text-slate-500">{share.language === 'de' ? 'eindeutige Scans' : 'unique scans'}</p><p className="mt-8 text-lg font-medium">{card?.qrTitle}</p></div></main>;
+}
--- a/src/app/(main)/api/internal/social-milestones/route.ts
+++ b/src/app/(main)/api/internal/social-milestones/route.ts
@@ -20,14 +20,10 @@ export async function GET(request: NextRequest) {
  if (!isAuthorized(request)) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
  const dryRun = request.nextUrl.searchParams.get('dryRun') === 'true';
  const now = Date.now();
-  const dayAgo = new Date(now - 24 * 60 * 60 * 1000);
  const approvalNotBefore = new Date(now - approvalDelayHours() * 60 * 60 * 1000);
-  const postedToday = await db.socialMilestone.count({ where: { OR: [{ status: 'posted', postedAt: { gte: dayAgo } }, { status: 'processing', claimedAt: { gte: dayAgo } }] } });
-  if (postedToday > 0) return NextResponse.json({ milestone: null, reason: 'daily_limit' });
-
  const milestone = await db.socialMilestone.findFirst({
-    where: { status: 'approved', respondedAt: { lte: approvalNotBefore } },
-    orderBy: { respondedAt: 'asc' },
+    where: { brandStatus: 'approved', brandApprovedAt: { lte: approvalNotBefore } },
+    orderBy: { brandApprovedAt: 'asc' },
    include: { user: { select: { id: true } }, qr: { select: { id: true, status: true } } },
  });
  // Relations are required by the schema. This guard makes the intended
@@ -37,14 +33,10 @@ export async function GET(request: NextRequest) {
  }
  if (dryRun) return NextResponse.json({ milestone: { id: milestone.id, text: milestone.consentText }, dryRun: true });

-  // A claimed item also occupies the daily slot. This prevents two workers
-  // from each claiming a different milestone before either one posts.
  const claimed = await db.$transaction(async (tx) => {
    await tx.$queryRawUnsafe('SELECT pg_advisory_xact_lock(920241)');
-    const occupied = await tx.socialMilestone.count({ where: { OR: [{ status: 'posted', postedAt: { gte: dayAgo } }, { status: 'processing', claimedAt: { gte: dayAgo } }] } });
-    if (occupied) return 0;
    const result = await tx.socialMilestone.updateMany({
-      where: { id: milestone.id, status: 'approved' }, data: { status: 'processing', claimedAt: new Date() },
+      where: { id: milestone.id, brandStatus: 'approved' }, data: { brandStatus: 'processing', claimedAt: new Date() },
    });
    return result.count;
  });
@@ -54,11 +46,16 @@ export async function GET(request: NextRequest) {

 export async function PATCH(request: NextRequest) {
  if (!isAuthorized(request)) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
-  const body = await request.json().catch(() => null) as { id?: string; result?: 'posted' | 'failed' } | null;
+  const body = await request.json().catch(() => null) as { id?: string; result?: 'posted' | 'failed'; postUrl?: string; error?: string } | null;
  if (!body?.id || !['posted', 'failed'].includes(body.result || '')) return NextResponse.json({ error: 'Invalid payload' }, { status: 400 });
  const updated = await db.socialMilestone.updateMany({
-    where: { id: body.id, status: 'processing' },
-    data: { status: body.result!, postedAt: body.result === 'posted' ? new Date() : null },
+    where: { id: body.id, brandStatus: 'processing' },
+    data: {
+      brandStatus: body.result!,
+      brandPostedAt: body.result === 'posted' ? new Date() : null,
+      brandPostUrl: body.result === 'posted' ? body.postUrl || null : null,
+      brandPostError: body.result === 'failed' ? (body.error || 'The post could not be published.') : null,
+    },
  });
  if (!updated.count) return NextResponse.json({ error: 'Milestone is no longer available' }, { status: 409 });
  return NextResponse.json({ ok: true });
--- a/src/app/(main)/api/social-milestones/[id]/route.ts
+++ b/src/app/(main)/api/social-milestones/[id]/route.ts
@@ -1,11 +1,36 @@
+import { randomUUID } from 'crypto';
 import { NextRequest, NextResponse } from 'next/server';
 import { db } from '@/lib/db';
 import { csrfProtection } from '@/lib/csrf';
 import { getSessionUserId } from '@/lib/session';
-import { buildMilestoneCard, buildMilestonePost, milestoneThreshold, normalizeXHandle, socialLocale } from '@/lib/social-milestones';
+import { buildMilestoneCardSnapshot, buildMilestonePostForQr, milestoneThreshold, normalizeXHandle, socialLocale } from '@/lib/social-milestones';

 type Action = 'approve_brand' | 'self_share' | 'decline' | 'opt_out' | 'revoke';

+async function ownedMilestone(id: string, userId: string) {
+  return db.socialMilestone.findFirst({
+    where: { id, userId },
+    include: { user: { select: { primaryUseCase: true } }, qr: { select: { title: true } } },
+  });
+}
+
+function clientState(milestone: { brandStatus: string; brandPostUrl: string | null; brandPostError: string | null; selfSharedAt: Date | null }) {
+  return {
+    brandStatus: milestone.brandStatus,
+    brandPostUrl: milestone.brandPostUrl,
+    brandPostError: milestone.brandPostError,
+    selfSharedAt: milestone.selfSharedAt?.toISOString() || null,
+  };
+}
+
+export async function GET(_request: NextRequest, { params }: { params: { id: string } }) {
+  const userId = getSessionUserId();
+  if (!userId) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+  const milestone = await ownedMilestone(params.id, userId);
+  if (!milestone) return NextResponse.json({ error: 'Not found' }, { status: 404 });
+  return NextResponse.json({ milestone: clientState(milestone) });
+}
+
 export async function PATCH(request: NextRequest, { params }: { params: { id: string } }) {
  const csrf = csrfProtection(request);
  if (!csrf.valid) return NextResponse.json({ error: csrf.error }, { status: 403 });
@@ -16,33 +41,70 @@ export async function PATCH(request: NextRequest, { params }: { params: { id: st
  if (!body || !['approve_brand', 'self_share', 'decline', 'opt_out', 'revoke'].includes(body.action || '')) {
    return NextResponse.json({ error: 'Invalid action' }, { status: 400 });
  }
-  const milestone = await db.socialMilestone.findFirst({
-    where: { id: params.id, userId }, include: { user: { select: { primaryUseCase: true } } },
-  });
+  const milestone = await ownedMilestone(params.id, userId);
  if (!milestone) return NextResponse.json({ error: 'Not found' }, { status: 404 });
  const threshold = milestoneThreshold(milestone.kind);
  if (!threshold) return NextResponse.json({ error: 'Invalid milestone' }, { status: 400 });
+  const isDismissible = ['detected', 'shown'].includes(milestone.status);

  if (body.action === 'revoke') {
-    if (milestone.status !== 'approved') return NextResponse.json({ error: 'Only queued approvals can be revoked' }, { status: 409 });
-    await db.socialMilestone.update({ where: { id: milestone.id }, data: { status: 'revoked', respondedAt: new Date() } });
+    if (!['approved', 'failed'].includes(milestone.brandStatus)) return NextResponse.json({ error: 'Only queued approvals can be revoked' }, { status: 409 });
+    const updated = await db.socialMilestone.update({ where: { id: milestone.id }, data: { brandStatus: 'revoked', brandPostError: null } });
+    return NextResponse.json({ ok: true, milestone: clientState(updated) });
+  }
+  if (body.action === 'decline' || body.action === 'opt_out') {
+    if (!isDismissible) return NextResponse.json({ error: 'This milestone has already been dismissed' }, { status: 409 });
+    const now = new Date();
+    await db.$transaction([
+      db.socialMilestone.update({ where: { id: milestone.id }, data: { status: 'declined', respondedAt: now } }),
+      ...(body.action === 'opt_out' ? [db.user.update({ where: { id: userId }, data: { socialPromptOptOut: true } })] : []),
+    ]);
    return NextResponse.json({ ok: true });
  }
-  if (!['detected', 'shown'].includes(milestone.status)) return NextResponse.json({ error: 'This milestone has already been answered' }, { status: 409 });

-  const withName = body.action === 'approve_brand' && body.withName === true;
  const language = socialLocale(body.language);
+  const withName = body.action === 'approve_brand' && body.withName === true;
  const xHandle = withName ? normalizeXHandle(body.xHandle || '') : null;
  if (withName && !xHandle) return NextResponse.json({ error: 'Enter a valid X handle' }, { status: 400 });
-  const status = body.action === 'approve_brand' ? 'approved' : body.action === 'self_share' ? 'self_shared' : 'declined';
-  const consentText = body.action === 'approve_brand'
-    ? buildMilestonePost(milestone.user.primaryUseCase, threshold, xHandle, language)
-    : null;
+  const card = milestone.cardData || buildMilestoneCardSnapshot({
+    primaryUseCase: milestone.user.primaryUseCase,
+    qrTitle: milestone.qr.title,
+    totalUniqueScans: threshold,
+    milestoneThreshold: threshold,
+    reachedAt: milestone.detectedAt,
+    trend: null,
+    locale: language,
+  });
  const now = new Date();
-  await db.$transaction([
-    db.socialMilestone.update({ where: { id: milestone.id }, data: { status, withName, consentText, language, cardData: body.action === 'approve_brand' ? buildMilestoneCard(milestone.user.primaryUseCase, threshold, language) : undefined, respondedAt: now } }),
-    ...(body.action === 'opt_out' ? [db.user.update({ where: { id: userId }, data: { socialPromptOptOut: true } })] : []),
-    ...(withName ? [db.user.update({ where: { id: userId }, data: { xHandle } })] : []),
-  ]);
-  return NextResponse.json({ ok: true, consentText });
+
+  if (body.action === 'self_share') {
+    const token = milestone.shareToken || randomUUID().replace(/-/g, '');
+    const updated = await db.socialMilestone.update({
+      where: { id: milestone.id },
+      data: { selfSharedAt: now, publicShareApprovedAt: now, shareToken: token, cardData: card, language },
+    });
+    return NextResponse.json({ ok: true, shareToken: token, milestone: clientState(updated) });
+  }
+
+  if (!['pending', 'failed', 'revoked'].includes(milestone.brandStatus)) {
+    return NextResponse.json({ error: 'This brand post is already being processed' }, { status: 409 });
+  }
+  const consentText = buildMilestonePostForQr(
+    milestone.user.primaryUseCase,
+    (card as { totalUniqueScans?: number }).totalUniqueScans || threshold,
+    xHandle,
+    language,
+    milestone.qr.title,
+  );
+  const updated = await db.$transaction(async tx => {
+    if (withName) await tx.user.update({ where: { id: userId }, data: { xHandle } });
+    return tx.socialMilestone.update({
+      where: { id: milestone.id },
+      data: {
+        brandStatus: 'approved', brandApprovedAt: now, brandPostError: null,
+        withName, consentText, language, cardData: card, respondedAt: now,
+      },
+    });
+  });
+  return NextResponse.json({ ok: true, consentText, milestone: clientState(updated) });
 }
--- a/src/app/(main)/api/social-milestones/route.ts
+++ b/src/app/(main)/api/social-milestones/route.ts
@@ -1,7 +1,7 @@
 import { NextRequest, NextResponse } from 'next/server';
 import { db } from '@/lib/db';
 import { getSessionUserId } from '@/lib/session';
-import { buildMilestoneCard, buildMilestonePost, milestoneThreshold, socialLocale } from '@/lib/social-milestones';
+import { buildMilestoneCardSnapshot, buildMilestonePostForQr, milestoneThreshold, socialLocale } from '@/lib/social-milestones';

 export const dynamic = 'force-dynamic';

@@ -33,9 +33,26 @@ export async function GET(request: NextRequest) {
    milestone: {
      id: milestone.id, qrTitle: milestone.qr.title, threshold,
      defaultXHandle: user.xHandle,
+      brandStatus: milestone.brandStatus,
+      brandPostUrl: milestone.brandPostUrl,
+      brandPostError: milestone.brandPostError,
      language: locale,
-      preview: buildMilestonePost(user.primaryUseCase, threshold, null, locale),
-      card: buildMilestoneCard(user.primaryUseCase, threshold, locale),
+      preview: buildMilestonePostForQr(
+        user.primaryUseCase,
+        ((milestone.cardData as { totalUniqueScans?: number } | null)?.totalUniqueScans || threshold),
+        null,
+        locale,
+        milestone.qr.title,
+      ),
+      card: milestone.cardData || buildMilestoneCardSnapshot({
+        primaryUseCase: user.primaryUseCase,
+        qrTitle: milestone.qr.title,
+        totalUniqueScans: threshold,
+        milestoneThreshold: threshold,
+        reachedAt: milestone.detectedAt,
+        trend: null,
+        locale,
+      }),
    },
  });
 }
--- a/src/components/dashboard/SocialMilestoneDialog.tsx
+++ b/src/components/dashboard/SocialMilestoneDialog.tsx
@@ -1,22 +1,22 @@
 'use client';

 import { useEffect, useMemo, useState } from 'react';
-import { QrCode, Sparkles } from 'lucide-react';
+import { Check, ExternalLink, LineChart, Linkedin, Send, Sparkles, X } from 'lucide-react';
 import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from '@/components/ui/Dialog';
 import { Button } from '@/components/ui/Button';
 import { useCsrf } from '@/hooks/useCsrf';
 import { useTranslation } from '@/hooks/useTranslation';
 import { showToast } from '@/components/ui/Toast';

-type Milestone = {
-  id: string;
-  qrTitle: string;
-  threshold: number;
-  defaultXHandle: string | null;
-  preview: string;
-  language: 'en' | 'de';
-  card: { title: string; label: string };
-};
+type Card = { language: 'en' | 'de'; qrTitle: string; label: string; title: string; totalUniqueScans: number; milestoneThreshold: number; trend: { periodDays: number; series: number[]; recentTotal: number } | null };
+type Milestone = { id: string; qrTitle: string; threshold: number; defaultXHandle: string | null; preview: string; language: 'en' | 'de'; card: Card; brandStatus: string; brandPostUrl: string | null; brandPostError: string | null };
+type BrandState = { brandStatus: string; brandPostUrl: string | null; brandPostError: string | null; selfSharedAt: string | null };
+
+function Trend({ series }: { series: number[] }) {
+  const max = Math.max(...series, 1);
+  const points = series.map((value, index) => `${(index / Math.max(series.length - 1, 1)) * 100},${92 - (value / max) * 70}`).join(' ');
+  return <svg viewBox="0 0 100 100" preserveAspectRatio="none" className="h-20 w-full overflow-visible" aria-label="Real scan trend"><polyline points={points} fill="none" stroke="currentColor" strokeWidth="3" vectorEffect="non-scaling-stroke" /></svg>;
+}

 export function SocialMilestoneDialog() {
  const { fetchWithCsrf } = useCsrf();
@@ -24,81 +24,95 @@ export function SocialMilestoneDialog() {
  const [milestone, setMilestone] = useState<Milestone | null>(null);
  const [withName, setWithName] = useState(false);
  const [xHandle, setXHandle] = useState('');
-  const [saving, setSaving] = useState(false);
+  const [saving, setSaving] = useState<'brand' | 'self' | null>(null);
+  const [brand, setBrand] = useState<BrandState | null>(null);

  useEffect(() => {
-    fetch(`/api/social-milestones?locale=${locale}`)
-      .then(async (response) => response.ok && setMilestone((await response.json()).milestone))
-      .catch(() => undefined);
+    fetch(`/api/social-milestones?locale=${locale}`).then(async response => {
+      if (response.ok) {
+        const next = (await response.json()).milestone as Milestone | null;
+        setMilestone(next);
+        if (next) setBrand({ brandStatus: next.brandStatus, brandPostUrl: next.brandPostUrl, brandPostError: next.brandPostError, selfSharedAt: null });
+      }
+    }).catch(() => undefined);
  }, [locale]);
-
  useEffect(() => setXHandle(milestone?.defaultXHandle || ''), [milestone]);
+  useEffect(() => {
+    if (!milestone || !['approved', 'processing'].includes(brand?.brandStatus || '')) return;
+    const poll = async () => {
+      const response = await fetch(`/api/social-milestones/${milestone.id}`);
+      if (response.ok) setBrand((await response.json()).milestone);
+    };
+    const timer = window.setInterval(poll, 3000);
+    void poll();
+    return () => window.clearInterval(timer);
+  }, [milestone, brand?.brandStatus]);

  const copy = milestone?.language === 'de'
-    ? { heading: 'Ein echter Erfolg', subtitle: 'hat gerade einen Scan-Meilenstein erreicht.', consent: 'Darf QR Master diesen Erfolg mit der unten stehenden Karte auf dem eigenen X-Account teilen?', name: 'Meinen X-Handle nennen', decline: 'Nein, danke', optOut: 'Nicht mehr anzeigen', self: 'Selbst teilen', approve: 'Auf QR Master posten', published: 'Der Beitrag wird jetzt auf dem QR Master X-Account veroeffentlicht.' }
-    : { heading: 'A real milestone', subtitle: 'just reached a scan milestone.', consent: 'May QR Master share this success, including the card below, from our X account?', name: 'Mention my X handle', decline: 'No thanks', optOut: 'Do not show again', self: 'Share myself', approve: 'Post from QR Master', published: 'This will now be published from the QR Master X account.' };
-
+    ? { heading: 'Ein echter Erfolg', subtitle: 'hat einen Scan-Meilenstein erreicht.', consent: 'Darf QR Master diesen Erfolg auf dem eigenen X-Account veröffentlichen?', name: 'Meinen X-Handle nennen', decline: 'Nicht jetzt', self: 'Selbst teilen', approve: 'Auf QR Master posten', queued: 'Wird auf X veröffentlicht …', posted: 'Auf X veröffentlicht', failed: 'Veröffentlichung fehlgeschlagen' }
+    : { heading: 'A real milestone', subtitle: 'just reached a scan milestone.', consent: 'May QR Master publish this success from our X account?', name: 'Mention my X handle', decline: 'Not now', self: 'Share myself', approve: 'Post from QR Master', queued: 'Publishing to X …', posted: 'Published on X', failed: 'Publishing failed' };
  const preview = useMemo(() => {
    if (!milestone || !withName || !xHandle.trim()) return milestone?.preview || '';
    return `${milestone.preview} By @${xHandle.trim().replace(/^@/, '')}.`;
  }, [milestone, withName, xHandle]);
-
-  const respond = async (action: 'approve_brand' | 'self_share' | 'decline' | 'opt_out') => {
+  const update = async (action: 'approve_brand' | 'self_share' | 'decline' | 'opt_out') => {
+    if (!milestone) return null;
+    const response = await fetchWithCsrf(`/api/social-milestones/${milestone.id}`, { method: 'PATCH', body: JSON.stringify({ action, withName, xHandle, language: milestone.language }) });
+    const result = await response.json();
+    if (!response.ok) throw new Error(result.error || 'Could not save your choice');
+    return result;
+  };
+  const shareSelf = async (network: 'x' | 'linkedin') => {
    if (!milestone) return;
-    setSaving(true);
+    setSaving('self');
    try {
-      const response = await fetchWithCsrf(`/api/social-milestones/${milestone.id}`, {
-        method: 'PATCH', body: JSON.stringify({ action, withName, xHandle, language: milestone.language }),
-      });
-      const result = await response.json();
-      if (!response.ok) throw new Error(result.error || 'Could not save your choice');
-      if (action === 'self_share') {
-        await navigator.clipboard?.writeText(preview);
-        window.open(`https://x.com/intent/post?text=${encodeURIComponent(preview)}`, '_blank', 'noopener,noreferrer');
-        window.open('https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.qrmaster.net', '_blank', 'noopener,noreferrer');
-        showToast('Post text copied for LinkedIn.', 'success');
-      } else if (action === 'approve_brand') {
-        showToast(copy.published, 'success');
+      const result = await update('self_share');
+      const shareUrl = `${window.location.origin}/s/m/${result.shareToken}`;
+      const text = `${preview} ${shareUrl}`;
+      if (network === 'x') window.open(`https://x.com/intent/post?text=${encodeURIComponent(text)}`, '_blank', 'noopener,noreferrer');
+      else {
+        await navigator.clipboard?.writeText(text);
+        window.open(`https://www.linkedin.com/sharing/share-offsite/?url=${encodeURIComponent(shareUrl)}`, '_blank', 'noopener,noreferrer');
      }
-      setMilestone(null);
-    } catch (error) {
-      showToast(error instanceof Error ? error.message : 'Could not save your choice', 'error');
-    } finally {
-      setSaving(false);
-    }
+      setBrand(result.milestone);
+      showToast(network === 'linkedin' ? 'Share text copied and LinkedIn opened.' : 'X share composer opened.', 'success');
+    } catch (error) { showToast(error instanceof Error ? error.message : 'Could not prepare this share', 'error'); }
+    finally { setSaving(null); }
+  };
+  const approveBrand = async () => {
+    setSaving('brand');
+    try {
+      const result = await update('approve_brand');
+      setBrand(result.milestone);
+      showToast(copy.queued, 'success');
+    } catch (error) { showToast(error instanceof Error ? error.message : 'Could not save your choice', 'error'); }
+    finally { setSaving(null); }
+  };
+  const dismiss = async (action: 'decline' | 'opt_out') => {
+    try { await update(action); setMilestone(null); } catch (error) { showToast(error instanceof Error ? error.message : 'Could not save your choice', 'error'); }
  };

  if (!milestone) return null;
-
-  return <Dialog open onOpenChange={(open) => !open && setMilestone(null)}>
-    <DialogContent className="max-w-lg overflow-hidden border-slate-200 p-0 shadow-[0_30px_45px_-30px_rgba(50,50,93,0.4)]">
-      <div className="border-b border-slate-100 px-6 pb-5 pt-6">
-        <DialogHeader>
-          <div className="mb-4 flex h-10 w-10 items-center justify-center rounded-lg bg-violet-50 text-violet-700"><Sparkles className="h-5 w-5" /></div>
-          <DialogTitle className="text-2xl font-semibold tracking-[-0.03em] text-[#061b31]">{copy.heading}</DialogTitle>
-          <DialogDescription className="pt-1 text-sm leading-6 text-slate-600"><strong className="font-medium text-slate-900">{milestone.qrTitle}</strong> {copy.subtitle}</DialogDescription>
-        </DialogHeader>
+  const card = milestone.card;
+  const count = card.totalUniqueScans || milestone.threshold;
+  const status = brand?.brandStatus || milestone.brandStatus || 'pending';
+  return <Dialog open onOpenChange={open => !open && setMilestone(null)}>
+    <DialogContent className="max-w-xl overflow-hidden border-slate-200 p-0 shadow-[0_30px_45px_-30px_rgba(50,50,93,0.45)]">
+      <div className="px-7 pb-5 pt-7"><DialogHeader><div className="mb-4 flex h-10 w-10 items-center justify-center rounded-lg bg-[#eaf1ff] text-[#0256ff]"><Sparkles className="h-5 w-5" /></div><DialogTitle className="text-2xl font-semibold tracking-[-0.03em] text-[#061b31]">{copy.heading}</DialogTitle><DialogDescription className="pt-1 text-sm leading-6 text-[#4b5e76]"><strong className="font-medium text-[#061b31]">{milestone.qrTitle}</strong> {copy.subtitle}</DialogDescription></DialogHeader></div>
+      <div className="space-y-5 border-y border-slate-100 px-7 py-6">
+        <section className="rounded-xl border border-slate-200 bg-white p-5 shadow-[0_14px_28px_-22px_rgba(50,50,93,0.4)]">
+          <div className="flex items-center justify-between border-b border-slate-100 pb-4 text-xs"><span className="font-semibold tracking-wide text-[#061b31]">QR MASTER</span><span className="rounded bg-emerald-50 px-2 py-1 font-medium text-emerald-700"><Check className="mr-1 inline h-3 w-3" />Verified scan milestone</span></div>
+          <div className="mt-5 text-[11px] font-semibold tracking-[0.12em] text-slate-400">TOTAL UNIQUE SCANS</div><div className="mt-1 text-5xl font-semibold tracking-[-0.05em] tabular-nums text-[#061b31]">{count.toLocaleString(milestone.language === 'de' ? 'de-DE' : 'en-US')}</div><div className="mt-1 text-sm text-slate-500">{milestone.language === 'de' ? 'eindeutige Scans' : 'unique scans'}</div>
+          {card.trend ? <div className="mt-5 text-[#0256ff]"><Trend series={card.trend.series} /><div className="mt-2 flex items-center gap-2 text-xs text-[#45617f]"><LineChart className="h-3.5 w-3.5 text-[#0256ff]" />{card.trend.recentTotal} {milestone.language === 'de' ? 'eindeutige Scans in den letzten' : 'unique scans in the last'} {card.trend.periodDays} days</div></div> : <div className="mt-5 inline-flex items-center gap-2 rounded-md bg-blue-50 px-3 py-2 text-xs font-medium text-blue-700"><LineChart className="h-3.5 w-3.5" />{milestone.language === 'de' ? 'Erste Dynamik' : 'Early momentum'}</div>}
+          <div className="mt-5 border-t border-slate-100 pt-3 text-sm font-medium text-[#061b31]">{card.qrTitle}</div>
+        </section>
+        <div><p className="text-sm leading-6 text-[#4b5e76]">{copy.consent}</p><blockquote className="mt-3 border-l-2 border-[#0256ff] pl-3 text-sm leading-6 text-[#273951]">{preview}</blockquote></div>
+        <label className="flex cursor-pointer items-center gap-3 text-sm font-medium text-slate-700"><input type="checkbox" checked={withName} onChange={event => setWithName(event.target.checked)} disabled={status !== 'pending'} className="h-4 w-4 rounded border-slate-300 text-[#0256ff] focus:ring-[#0256ff]" />{copy.name}</label>
+        {withName && <input aria-label="X handle" value={xHandle} onChange={event => setXHandle(event.target.value)} disabled={status !== 'pending'} placeholder="@yourhandle" className="w-full rounded-md border border-slate-200 px-3 py-2 text-sm outline-none focus:border-[#0256ff] focus:ring-2 focus:ring-blue-100" />}
+        <div className="flex flex-wrap items-center gap-2"><span className="mr-1 text-xs font-medium text-slate-500">{copy.self}</span><Button variant="outline" size="sm" onClick={() => shareSelf('x')} disabled={saving !== null}><X className="mr-1.5 h-3.5 w-3.5" />X</Button><Button variant="outline" size="sm" onClick={() => shareSelf('linkedin')} disabled={saving !== null}><Linkedin className="mr-1.5 h-3.5 w-3.5" />LinkedIn</Button></div>
+        {status !== 'pending' && <div className={`flex items-center justify-between rounded-md px-3 py-2 text-sm ${status === 'posted' ? 'bg-emerald-50 text-emerald-800' : status === 'failed' ? 'bg-rose-50 text-rose-800' : 'bg-blue-50 text-blue-800'}`}><span>{status === 'posted' ? copy.posted : status === 'failed' ? copy.failed : copy.queued}</span>{brand?.brandPostUrl && <a href={brand.brandPostUrl} target="_blank" rel="noreferrer" className="inline-flex items-center gap-1 font-medium underline"><ExternalLink className="h-3.5 w-3.5" />View</a>}</div>}
      </div>
-      <div className="space-y-5 px-6 py-5">
-        <div className="rounded-xl bg-[#061b31] p-5 text-white shadow-[0_18px_36px_-20px_rgba(50,50,93,0.65)]">
-          <div className="flex items-center justify-between text-xs text-slate-300"><span className="flex items-center gap-2 font-medium tracking-wide"><QrCode className="h-4 w-4" />QR MASTER</span><span>Verified</span></div>
-          <div className="mt-7 text-5xl font-semibold tracking-[-0.04em] tabular-nums">{milestone.threshold.toLocaleString(milestone.language === 'de' ? 'de-DE' : 'en-US')}</div>
-          <div className="mt-1 text-sm text-slate-300">{milestone.language === 'de' ? 'eindeutige Scans' : 'unique scans'}</div>
-          <div className="mt-7 border-t border-white/15 pt-3 text-xs text-slate-300">{milestone.card.label} · {milestone.card.title}</div>
-        </div>
-        <p className="text-sm leading-6 text-slate-600">{copy.consent}</p>
-        <blockquote className="border-l-2 border-violet-500 pl-3 text-sm leading-6 text-slate-700">{preview}</blockquote>
-        <label className="flex cursor-pointer items-center gap-3 text-sm font-medium text-slate-700"><input type="checkbox" checked={withName} onChange={(event) => setWithName(event.target.checked)} className="h-4 w-4 rounded border-slate-300 text-violet-600 focus:ring-violet-500" />{copy.name}</label>
-        {withName && <input aria-label="X handle" value={xHandle} onChange={(event) => setXHandle(event.target.value)} placeholder="@yourhandle" className="w-full rounded-md border border-slate-200 px-3 py-2 text-sm outline-none focus:border-violet-500 focus:ring-2 focus:ring-violet-100" />}
-      </div>
-      <DialogFooter className="border-t border-slate-100 bg-slate-50 px-6 py-4">
-        <div className="flex w-full flex-wrap items-center justify-end gap-2">
-          <Button variant="outline" onClick={() => respond('decline')} disabled={saving}>{copy.decline}</Button>
-          <Button variant="outline" onClick={() => respond('self_share')} disabled={saving}>{copy.self}</Button>
-          <Button variant="primary" onClick={() => respond('approve_brand')} disabled={saving}>{copy.approve}</Button>
-          <button type="button" className="w-full pt-1 text-xs text-slate-500 underline underline-offset-2 hover:text-slate-700" onClick={() => respond('opt_out')} disabled={saving}>{copy.optOut}</button>
-        </div>
-      </DialogFooter>
+      <DialogFooter className="bg-slate-50 px-7 py-4"><div className="flex w-full flex-wrap items-center justify-end gap-2"><Button variant="outline" onClick={() => dismiss('decline')} disabled={saving !== null}>{copy.decline}</Button><Button variant="primary" onClick={approveBrand} disabled={saving !== null || status !== 'pending'}><Send className="mr-1.5 h-4 w-4" />{copy.approve}</Button><button type="button" className="w-full pt-1 text-xs text-slate-500 underline underline-offset-2 hover:text-slate-700" onClick={() => dismiss('opt_out')} disabled={saving !== null}>Do not show again</button></div></DialogFooter>
    </DialogContent>
  </Dialog>;
 }
--- a/src/lib/social-milestones-server.ts
+++ b/src/lib/social-milestones-server.ts
@@ -1,5 +1,5 @@
 import { db } from '@/lib/db';
-import { getSocialMilestoneThresholds, milestoneKind } from '@/lib/social-milestones';
+import { buildMilestoneCardSnapshot, getSocialMilestoneThresholds, milestoneKind, SocialLocale } from '@/lib/social-milestones';

 function excludedEmails() {
  return (process.env.SOCIAL_MILESTONE_EXCLUDED_EMAILS || '')
@@ -27,12 +27,57 @@ export async function detectSocialMilestones(qrId?: string) {

  const qrs = await db.qRCode.findMany({
    where: { id: { in: Array.from(new Set(records.map(record => record.qrId))) } },
-    select: { id: true, userId: true },
+    select: { id: true, userId: true, title: true, createdAt: true, user: { select: { primaryUseCase: true } } },
  });
+  const cardByQr = new Map<string, Awaited<ReturnType<typeof createCardSnapshot>>>();
+  await Promise.all(qrs.map(async qr => cardByQr.set(qr.id, await createCardSnapshot(qr))));
  const userIdByQr = new Map(qrs.map(qr => [qr.id, qr.userId]));
  const created = await db.socialMilestone.createMany({
-    data: records.filter(record => userIdByQr.has(record.qrId)).map(record => ({ ...record, userId: userIdByQr.get(record.qrId)! })),
+    data: records.filter(record => userIdByQr.has(record.qrId)).map(record => ({
+      ...record,
+      userId: userIdByQr.get(record.qrId)!,
+      cardData: cardByQr.get(record.qrId),
+    })),
    skipDuplicates: true,
  });
  return created.count;
 }
+
+async function createCardSnapshot(qr: { id: string; title: string; createdAt: Date; user: { primaryUseCase: string | null } }) {
+  const now = new Date();
+  const sevenDaysAgo = new Date(now);
+  sevenDaysAgo.setUTCHours(0, 0, 0, 0);
+  sevenDaysAgo.setUTCDate(sevenDaysAgo.getUTCDate() - 6);
+  const scans = await db.qRScan.findMany({
+    where: { qrId: qr.id, isUnique: true },
+    select: { ts: true },
+    orderBy: { ts: 'asc' },
+  });
+  const daily = new Map<string, number>();
+  for (const scan of scans) {
+    if (scan.ts >= sevenDaysAgo) {
+      const key = scan.ts.toISOString().slice(0, 10);
+      daily.set(key, (daily.get(key) || 0) + 1);
+    }
+  }
+  const series = Array.from({ length: 7 }, (_, index) => {
+    const date = new Date(sevenDaysAgo);
+    date.setUTCDate(date.getUTCDate() + index);
+    return daily.get(date.toISOString().slice(0, 10)) || 0;
+  });
+  const activeDays = series.filter(Boolean).length;
+  const trend = activeDays >= 2 && scans.length >= 5
+    ? { periodDays: 7, series, recentTotal: series.reduce((total, value) => total + value, 0) }
+    : null;
+
+  // The snapshot is made at detection time and never silently changes after consent.
+  return buildMilestoneCardSnapshot({
+    primaryUseCase: qr.user.primaryUseCase,
+    qrTitle: qr.title,
+    totalUniqueScans: scans.length,
+    milestoneThreshold: scans.length,
+    reachedAt: now,
+    trend,
+    locale: 'en' as SocialLocale,
+  });
+}
--- a/src/lib/social-milestones.ts
+++ b/src/lib/social-milestones.ts
@@ -39,6 +39,18 @@ export function milestoneThreshold(kind: string): number | null {

 export type SocialLocale = 'en' | 'de';

+export type SocialMilestoneCard = {
+  version: 'milestone-card-v2';
+  language: SocialLocale;
+  qrTitle: string;
+  label: string;
+  title: string;
+  totalUniqueScans: number;
+  milestoneThreshold: number;
+  reachedAt: string;
+  trend: { periodDays: number; series: number[]; recentTotal: number } | null;
+};
+
 export function socialLocale(value?: string | null): SocialLocale {
  return value === 'de' ? 'de' : 'en';
 }
@@ -63,6 +75,37 @@ export function buildMilestoneCard(primaryUseCase: string | null, threshold: num
  return { version: 'milestone-card-v1', language: locale, threshold, label: usageLabel(primaryUseCase, locale), title: locale === 'de' ? 'Erfolgsmeilenstein' : 'Success milestone' };
 }

+export function buildMilestonePostForQr(primaryUseCase: string | null, totalUniqueScans: number, xHandle: string | null | undefined, locale: SocialLocale, qrTitle: string): string {
+  const count = totalUniqueScans.toLocaleString(locale === 'de' ? 'de-DE' : 'en-US');
+  const subject = qrTitle.trim() || usageLabel(primaryUseCase, locale);
+  const base = locale === 'de'
+    ? `„${subject}“ hat ${count} eindeutige Scans erreicht.`
+    : `“${subject}” reached ${count} unique scans.`;
+  return xHandle ? `${base} By @${xHandle.replace(/^@/, '')}.` : base;
+}
+
+export function buildMilestoneCardSnapshot(input: {
+  primaryUseCase: string | null;
+  qrTitle: string;
+  totalUniqueScans: number;
+  milestoneThreshold: number;
+  reachedAt: Date;
+  trend: { periodDays: number; series: number[]; recentTotal: number } | null;
+  locale: SocialLocale;
+}): SocialMilestoneCard {
+  return {
+    version: 'milestone-card-v2',
+    language: input.locale,
+    qrTitle: input.qrTitle,
+    label: usageLabel(input.primaryUseCase, input.locale),
+    title: input.locale === 'de' ? 'Erfolgsmeilenstein' : 'Success milestone',
+    totalUniqueScans: input.totalUniqueScans,
+    milestoneThreshold: input.milestoneThreshold,
+    reachedAt: input.reachedAt.toISOString(),
+    trend: input.trend,
+  };
+}
+
 export function normalizeXHandle(value: string): string | null {
  const handle = value.trim().replace(/^@/, '');
  return /^[A-Za-z0-9_]{1,15}$/.test(handle) ? handle : null;