Sven (AAMOS AI)
77 lines
3.0 KiB
TypeScript
77 lines
3.0 KiB
TypeScript
/**
|
|
* Product analytics schema (spec §8).
|
|
* Pseudonymous events stored in Postgres, separated from AAMOS memory.
|
|
*/
|
|
import {
|
|
index,
|
|
integer,
|
|
jsonb,
|
|
pgTable,
|
|
text,
|
|
timestamp,
|
|
uuid,
|
|
varchar,
|
|
} from "drizzle-orm/pg-core";
|
|
import { createdAt } from "./_shared.js";
|
|
import { households } from "./households.js";
|
|
import { users } from "./users.js";
|
|
|
|
/** Event name stored as text so the taxonomy can grow without ALTER TYPE. */
|
|
const ANALYTICS_EVENT_NAME_LEN = 64;
|
|
|
|
/**
|
|
* Raw product analytics events.
|
|
* No PII, no raw ingredient names, no free text, no images.
|
|
*/
|
|
export const productAnalyticsEvents = pgTable(
|
|
"product_analytics_events",
|
|
{
|
|
id: uuid("id").primaryKey().defaultRandom(),
|
|
occurredAt: timestamp("occurred_at", { withTimezone: true }).notNull().defaultNow(),
|
|
receivedAt: timestamp("received_at", { withTimezone: true }).notNull().defaultNow(),
|
|
eventName: varchar("event_name", { length: ANALYTICS_EVENT_NAME_LEN }).notNull(),
|
|
/** Pseudonymous device/session identifiers. */
|
|
anonymousId: varchar("anonymous_id", { length: 64 }),
|
|
sessionId: varchar("session_id", { length: 64 }),
|
|
/** Foreign keys are nullable because events may arrive before login. */
|
|
userId: uuid("user_id").references(() => users.id, { onDelete: "set null" }),
|
|
householdId: uuid("household_id").references(() => households.id, { onDelete: "set null" }),
|
|
/** App version, platform, locale. */
|
|
appVersion: varchar("app_version", { length: 32 }),
|
|
platform: varchar("platform", { length: 16 }),
|
|
locale: varchar("locale", { length: 16 }),
|
|
/** Experiment / feature flag context. */
|
|
experimentVariant: varchar("experiment_variant", { length: 128 }),
|
|
/** Structured, safe properties only. */
|
|
properties: jsonb("properties").notNull().default({}),
|
|
},
|
|
(t) => [
|
|
index("pa_events_name_occurred_idx").on(t.eventName, t.occurredAt),
|
|
index("pa_events_household_occurred_idx").on(t.householdId, t.occurredAt),
|
|
index("pa_events_user_occurred_idx").on(t.userId, t.occurredAt),
|
|
index("pa_events_session_idx").on(t.sessionId),
|
|
index("pa_events_received_idx").on(t.receivedAt),
|
|
],
|
|
);
|
|
|
|
/**
|
|
* Materialized-like daily aggregates per household.
|
|
* Kept simple; dashboards can also query product_analytics_events directly.
|
|
*/
|
|
export const analyticsDailySnapshots = pgTable(
|
|
"analytics_daily_snapshots",
|
|
{
|
|
id: uuid("id").primaryKey().defaultRandom(),
|
|
date: varchar("date", { length: 10 }).notNull(), // YYYY-MM-DD UTC
|
|
householdId: uuid("household_id").references(() => households.id, { onDelete: "cascade" }),
|
|
eventName: varchar("event_name", { length: ANALYTICS_EVENT_NAME_LEN }).notNull(),
|
|
count: integer("count").notNull().default(0),
|
|
uniqueSessions: integer("unique_sessions").notNull().default(0),
|
|
propertiesFingerprint: varchar("properties_fingerprint", { length: 64 }),
|
|
},
|
|
(t) => [
|
|
index("pa_daily_household_date_idx").on(t.householdId, t.date),
|
|
index("pa_daily_date_event_idx").on(t.date, t.eventName),
|
|
],
|
|
);
|