Skip to content

docs(analytics): plan for proxy + server-side business events#713

Draft
spashii wants to merge 1 commit into
mainfrom
sameer/analytics-instrumentation-plan
Draft

docs(analytics): plan for proxy + server-side business events#713
spashii wants to merge 1 commit into
mainfrom
sameer/analytics-instrumentation-plan

Conversation

@spashii

@spashii spashii commented Jun 23, 2026

Copy link
Copy Markdown
Member

What

Draft plan (docs only, no code) for instrumenting the analytics we currently can't see: where customers come from, the participant journey, and app health.

Two docs:

  • docs/plan.md — team-facing "what and why", non-technical. Meant to seed a discussion thread.
  • docs/analytics-implementation-plan.md — engineering companion: the "how", phased, with endpoints and the corrected proxy config.

Highlights for review

  • Reverse proxy to stop ad blockers eating client events. Open call on the home: managed CNAME (e.dembrane.com) vs self-host in our ams3 cluster vs a Vercel /i stopgap. Hinges on EU data residency tolerance.
  • Server-side capture for source-of-truth moments (reusing analytics.py), so they can't be blocked or lost. Naming: server_ prefix, with a source property for cross-client funnels like registration.
  • Portal journey + source attribution (QR vs link vs printed guide), our biggest blind spot today.
  • App-health events: explicit vs automatic conversation finish, finish to summary time, verify/explore usage + rate limiting, portal recording errors.
  • Buying intent: confirmed we have both self-serve checkout and a "book a call" contact-sales link today.

Status

Planning only. Nothing built. Open decisions are listed at the bottom of the implementation doc (proxy home, PostHog MCP connection, marketing-site PostHog project, dashboards in both EU projects).

🤖 Generated with Claude Code

Team-facing plan (docs/plan.md) and engineering companion
(docs/analytics-implementation-plan.md) covering the reverse-proxy
foundation, server-side event capture, portal journey + source
attribution, app-health events, and the open decisions (proxy home /
EU residency, PostHog MCP, marketing-site stitching).

Planning only; no code changes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant