memind/docs/local-analytics.md

Local Memind + Umami analytics

The integration is local-only by default. Memind proxies /analytics/* to the local Umami service at http://127.0.0.1:3100; it does not contact 103/105.

1. Start /Users/john/Project/memind-analytics and verify:

   curl --fail http://127.0.0.1:3100/api/heartbeat
   

2. Create one Umami Website for the local generated-page host. Do not create a Website per page or per user.

3. Put the Website ID and a local-only pseudonymization secret in Memind's .env:

   MEMIND_ANALYTICS_ENABLED=true
   MEMIND_ANALYTICS_URL=http://127.0.0.1:3100
   MEMIND_ANALYTICS_WEBSITE_ID=<website-id>
   MEMIND_ANALYTICS_ID_SECRET=<random-local-secret>
   MEMIND_ANALYTICS_DOMAINS=127.0.0.1,localhost
   

4. Restart the local Memind server. Full generated HTML pages will receive a same-origin /analytics/script.js tracker and a page_view event with pseudonymous owner_id, page_id, and channel dimensions.

The integration is fail-open: missing configuration, disabled analytics, or a down Umami service leaves page generation and page delivery unchanged. User facing analytics must be queried through a future Memind API that filters by the authenticated owner; do not expose the Umami dashboard directly to users.