[tannerlinsley]

Adds /admin/live with a live company grid, company trend, library and industry breakdowns, and expandable anonymous sessions and activity. Company rows support sorting and search; individual visitors stay hidden until expansion, and unmatched traffic stays collapsed at the bottom.

Adds bounded first-party presence collection and server-side Scarf company lookup. DNT/GPC and private routes are excluded, IPs are not stored, and session records are deleted after 24 hours. Includes migration 0042_live_visitors and enables collection in the production Worker configuration.

Already deployed and verified in production, including company matches, page activity, departures, filtering, and expansion. The migration and server secret are already configured. The overview reports its 500-tab limit, and trend history builds from polling while the dashboard is open.

Validation: production build, TypeScript, lint, 626 unit tests, 2,270 chat tests, and 20 desktop tests passed before deployment. Production site and documentation smoke checks passed.

Summary by CodeRabbit

• New Features
  • Added an admin dashboard for live company activity, with visitor counts over time, library and industry breakdowns, and searchable, sortable company details.
  • Dashboard data refreshes automatically and includes recently departed companies as an optional view.
  • Live presence tracking supports public-page activity and respects Do Not Track and Global Privacy Control settings.
• Documentation
  • Added guidance on dashboard access, setup, tracking behavior, data boundaries, and validation.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 09fa215

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Adds browser presence collection and server-side processing, including company lookup and retention cleanup. Adds an admin dashboard that groups and displays live visitor data, plus its route, navigation link, and setup documentation.

Changes: Live Visitors

Layer / File(s)	Summary
Data contracts and company lookup src/utils/analytics/live.ts, src/db/schema.ts, drizzle/migrations/0042_live_visitors.sql, drizzle/migrations/meta/_journal.json, src/utils/analytics/scarf-lookup.server.ts, src/instrument.server.mjs, wrangler.jsonc, tests/scarf-lookup.test.ts, docs/live-visitors.md	Adds event and company schemas, session and tab tables, migration registration, feature configuration, and Scarf company lookup. The lookup tests cover request options and response handling.
Browser collection and event processing src/utils/analytics/live-browser.ts, src/utils/analytics.ts, src/utils/analytics/scarf.ts, src/routes/__root.tsx, src/server.ts, src/utils/analytics/live.server.ts, src/server/scheduled.server.ts, tests/live-presence.test.ts, tests/live-intake.test.ts, docs/live-visitors.md	Starts browser presence when enabled and reports allowlisted actions. The collector validates and records events, and scheduled work prunes old sessions. Tests and documentation cover collection behavior, validation, privacy signals, and retention.
Dashboard data and display src/utils/analytics/live.functions.ts, src/utils/analytics/live.server.ts, src/utils/analytics/live-dashboard.ts, src/components/admin/LiveCompanyCharts.tsx, src/components/admin/LiveVisitors.tsx, tests/live-dashboard.test.ts, docs/live-visitors.md	Adds admin data retrieval, grouping and breakdown calculations, trend and breakdown charts, and expandable company and session views. Tests cover grouping, departed sessions, and recent activity.
Admin route and navigation src/routes/admin/live.tsx, src/routes/admin/route.tsx, src/routeTree.gen.ts	Adds the guarded /admin/live page with three-second polling, loading and error states, a navigation link, and generated route entries.

Priority: Not assessed

Estimated code review effort: 4 (Complex) | ~45 minutes

Change: Feature

Sequence Diagram(s)

sequenceDiagram
  participant Browser as Browser presence
  participant Collector as receiveLiveEvent
  participant Recorder as recordLiveEvent
  participant Database as live_sessions and live_tabs
  participant Scarf as Scarf lookup
  participant Admin as LiveVisitorsPage
  participant Query as getLiveVisitors
  Browser->>Collector: Send presence event
  Collector->>Recorder: Validate and record event
  Recorder->>Database: Create or update session and tab
  Recorder->>Scarf: Look up company for a new session
  Scarf-->>Recorder: Return lookup result
  Admin->>Query: Poll for live visitor data
  Query->>Database: Read recent sessions and tabs
  Database-->>Query: Return session and tab data
  Query-->>Admin: Return live data

Loading

Suggested reviewers: ladybluenotes, tkdodo

Merge Risk: Moderate · up to 09fa2

Exclude private showcase paths and protect the live intake before merging. A collector cleanup failure should also not interrupt scheduled workflow work.

Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}