Phase 1 foundation: backend, web profile, and mobile app

Greenfield implementation of CardClaws Phase 1 across three surfaces. Backend (Rust/Axum workspace, 67 tests): - cardclaws-types/config/db/auth/api/wallet crates - Auth: register, login + lockout, magic link, refresh rotation, Apple verify - Cards: CRUD, tier-limited publish, duplicate, public handle lookup - Assets: R2 presigned uploads; vCard export - Apple Wallet .pkpass pipeline (PKCS#7 signer behind apple-signing feature) - Analytics ingest + summary with daily-salted IP hashing - Migrations 0001 (incl. cardclaws_sessions) + 0002 analytics Web profile (Astro SSR): cardclaws.com/[handle] hero + flip, contact actions, client-built vCard, visit attribution. Verified end-to-end. Mobile (Expo SDK 51): auth, card list/create, builder v1 (bg/text/logo, palette, undo/redo), Skia/Reanimated viewer (flip + ambient). 22 logic tests. CI: policy/backend/profile/mobile jobs; LOC + no-placeholder lint. Review fixes baked in: `back` (not `cardclaws`) key; strip image is a bundled manifest file (not a URL); sessions table added; NFC reframed; test doubles allowed for external services. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-06-04 10:17:26 -05:00
commit c30d3afeec
128 changed files with 36279 additions and 0 deletions
@@ -0,0 +1,50 @@
+//! Analytics event writes and summary aggregation (PRD §18).
+//!
+//! Phase 1 writes events directly to `analytics_events`. The Redis write-buffer
+//! + hourly rollup path (PRD §18.1/§18.2) is a Phase 2 optimization.
+
+use uuid::Uuid;
+
+use crate::models::analytics::AnalyticsSummary;
+use crate::Db;
+
+pub struct NewEvent<'a> {
+    pub card_id: Uuid,
+    pub event_type: &'a str,
+    pub ip_hash: Option<&'a str>,
+    pub user_agent: Option<&'a str>,
+}
+
+pub async fn insert_event(db: &Db, ev: NewEvent<'_>) -> Result<(), sqlx::Error> {
+    sqlx::query(
+        r#"INSERT INTO analytics_events (card_id, event_type, ip_hash, user_agent)
+           VALUES ($1, $2, $3, $4)"#,
+    )
+    .bind(ev.card_id)
+    .bind(ev.event_type)
+    .bind(ev.ip_hash)
+    .bind(ev.user_agent)
+    .execute(db)
+    .await?;
+    Ok(())
+}
+
+/// Aggregate metrics for one card across the standard windows.
+pub async fn summary(db: &Db, card_id: Uuid) -> Result<AnalyticsSummary, sqlx::Error> {
+    sqlx::query_as(
+        r#"
+        SELECT
+          COUNT(*) FILTER (WHERE event_type = 'profile_visit')                                              AS total_visits,
+          COUNT(*) FILTER (WHERE event_type = 'profile_visit' AND occurred_at > now() - interval '7 days')  AS visits_7d,
+          COUNT(*) FILTER (WHERE event_type = 'profile_visit' AND occurred_at > now() - interval '24 hours') AS visits_24h,
+          COUNT(*) FILTER (WHERE event_type = 'qr_scan')                                                     AS qr_scans,
+          COUNT(*) FILTER (WHERE event_type = 'contact_save')                                                AS contact_saves,
+          COUNT(*) FILTER (WHERE event_type = 'link_click')                                                  AS link_clicks
+        FROM analytics_events
+        WHERE card_id = $1
+        "#,
+    )
+    .bind(card_id)
+    .fetch_one(db)
+    .await
+}