[Psalmuel01]

What & why

Add Umami pageviews and explicit wallet, confirmed Testnet payment, payroll and disclosure events so onboarding can be measured without collecting private financial data.

Tracking runs only on the configured HTTPS production hostname. Payloads exclude wallet addresses, amounts, balances, transaction hashes, proofs, form input, raw errors and full URLs. Add /privacy with opt-out and internal-testing exclusion, honor DNT/GPC, and keep automatic tracking/replay disabled. Tracker failures cannot interrupt wallet actions.

ANALYTICS.md documents account configuration, recruitment checks and measurement limits for SCF evidence. The supplied public Website ID is recorded; visitor estimates and browser-reported events are explicitly distinguished from verified people or independently verified transactions.

Area

App, analytics tests/CI, and documentation. No contract or SDK implementation changes.

How was this tested?

• pnpm test:analytics: passed privacy filtering, configuration/hostname gates, preferences, DNT/GPC, pageview deduplication, queue limits, transport failure and submission-confirmation timing.
• pnpm --filter @lucent/app typecheck: passed.
• pnpm --filter @lucent/app build: passed with a dummy public Website ID.
• Isolated headless Chrome against the production build: navigation, opt-out/re-enable, internal exclusion across reload, privacy signals and preview-host exclusion passed. Analytics was stubbed and external services blocked; no live telemetry or payment transaction was sent.

Checklist

• App typecheck passes; SDK typecheck remains a CI check.
• SDK fast suite: awaiting PR CI; SDK implementation is unchanged.
• Contract tests not required: no contract changes.
• Added analytics behavior/privacy tests and a CI step.
• Updated README and added the setup/evidence guide and public privacy page.

Production activation

Configure the four NEXT_PUBLIC_ variables from packages/app/.env.example in Vercel Production, enable analytics, and deploy/rebuild the reviewed main. Do not install a second default Umami snippet. Confirm a pageview and a disposable Testnet action in the live dashboard before recruiting testers. Live dashboard collection and payment smoke testing are still pending.