fix: feat: basic analytics funnel tracking for launch readiness (#1101)

Add self-hosted Umami analytics to replace the third-party cloud.umami.is
tracker. Creates @harb/analytics package with typed event helpers and
instruments the conversion funnel: CTA clicks (landing), wallet connect,
swap initiated, and stake created (web-app).

- Add Umami Docker service sharing existing postgres (separate DB)
- Add Caddy /analytics route to proxy Umami dashboard
- Configure via VITE_UMAMI_URL and VITE_UMAMI_WEBSITE_ID env vars
- Document setup and funnel events in docs/ENVIRONMENT.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

containers/Caddyfile

@@ -18,5 +18,9 @@
     uri strip_prefix /api/txn
     reverse_proxy txn-bot:43069
   }
+  route /analytics* {
+    uri strip_prefix /analytics
+    reverse_proxy umami:3000
+  }
   reverse_proxy landing:5174
 }

containers/init-umami-db.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Creates the umami database and user if they don't already exist.
+# Mounted as a postgres init script via docker-compose volumes.
+set -e
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+    DO \$\$
+    BEGIN
+        IF NOT EXISTS (SELECT FROM pg_catalog.pg_roles WHERE rolname = 'umami') THEN
+            CREATE ROLE umami WITH LOGIN PASSWORD 'umami_local';
+        END IF;
+    END
+    \$\$;
+    SELECT 'CREATE DATABASE umami OWNER umami'
+    WHERE NOT EXISTS (SELECT FROM pg_database WHERE datname = 'umami')\gexec
+EOSQL

containers/landing-entrypoint.sh

@@ -26,4 +26,7 @@ if [[ -f "$CONTRACTS_ENV" ]]; then
   echo "[landing-entrypoint] Contract addresses loaded: KRK=${KRAIKEN:-unset} STAKE=${STAKE:-unset}"
 fi
 
+export VITE_UMAMI_URL="${VITE_UMAMI_URL:-}"
+export VITE_UMAMI_WEBSITE_ID="${VITE_UMAMI_WEBSITE_ID:-}"
+
 exec npm run dev -- --host 0.0.0.0 --port 5174

containers/webapp-entrypoint.sh

@@ -34,6 +34,8 @@ if [[ "${CI:-}" == "true" ]]; then
   export VITE_SWAP_ROUTER=${VITE_SWAP_ROUTER:-0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4}
   export VITE_PONDER_BASE_SEPOLIA_LOCAL_FORK=${VITE_PONDER_BASE_SEPOLIA_LOCAL_FORK:-/api/graphql}
   export VITE_TXNBOT_BASE_SEPOLIA_LOCAL_FORK=${VITE_TXNBOT_BASE_SEPOLIA_LOCAL_FORK:-/api/txn}
+  export VITE_UMAMI_URL="${VITE_UMAMI_URL:-}"
+  export VITE_UMAMI_WEBSITE_ID="${VITE_UMAMI_WEBSITE_ID:-}"
 
   echo "[webapp-ci] Environment configured:"
   echo "  VITE_KRAIKEN_ADDRESS: ${VITE_KRAIKEN_ADDRESS}"
@@ -81,5 +83,7 @@ export VITE_SWAP_ROUTER=$SWAP_ROUTER
 export VITE_PONDER_BASE_SEPOLIA_LOCAL_FORK=${VITE_PONDER_BASE_SEPOLIA_LOCAL_FORK:-/api/graphql}
 export VITE_TXNBOT_BASE_SEPOLIA_LOCAL_FORK=${VITE_TXNBOT_BASE_SEPOLIA_LOCAL_FORK:-/api/txn}
 export CHOKIDAR_USEPOLLING=${CHOKIDAR_USEPOLLING:-1}
+export VITE_UMAMI_URL="${VITE_UMAMI_URL:-}"
+export VITE_UMAMI_WEBSITE_ID="${VITE_UMAMI_WEBSITE_ID:-}"
 
 exec npm run dev -- --host 0.0.0.0 --port 5173 --base /app/