generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  directUrl = env("DIRECT_URL")
}

// ─── User (synced from Clerk) ────────────────────────────────────────────────

model User {
  id         String   @id
  name       String?
  email      String   @unique
  image      String?
  // IANA timezone string (e.g. "America/Chicago"). Used by scheduled
  // reports + cron timing so runs fire at the user's local hour
  // rather than platform UTC. Falls back to "America/New_York" in
  // the email report generator when null.
  timezone   String?
  // Email notification preferences. JSON blob so new toggles can be
  // added without a migration. Shape:
  //   { signalAlerts: true, weeklyDigest: true, auditCompletion: true,
  //     reportReady: true, teamActivity: false }
  // Read by the alert / report senders before dispatch; a missing
  // key defaults to true for the core channels (signal/audit/report)
  // so new users don't go dark on important events by default.
  emailPrefs Json?
  createdAt  DateTime @default(now())
  updatedAt  DateTime @updatedAt

  memberships         OrgMembership[]
  brandAccess         BrandMembership[]
  assignedTasks       Task[]
  contentBriefs       ContentBrief[]
  avatarConversations AvatarConversation[]
}

// ─── Organization ────────────────────────────────────────────────────────────

model Organization {
  id        String   @id @default(cuid())
  name      String
  slug      String   @unique
  plan      String   @default("free")
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  memberships      OrgMembership[]
  brands           Brand[]
  trackedSites     TrackedSite[]
  subscription     Subscription?
  planUsage        OrgPlanUsage?
  whiteLabelConfig WhiteLabelConfig?
  customDomains    CustomDomain[]
}

model OrgMembership {
  id        String   @id @default(cuid())
  role      String   @default("member")
  createdAt DateTime @default(now())

  userId String
  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)

  orgId        String
  organization Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)

  @@unique([userId, orgId])
}

// Per-brand access control. OrgMembership says "this user is in
// the org" (and owners/admins can see every brand in the org by
// virtue of that). BrandMembership is the finer-grained cut:
// non-owner members only see brands they've been explicitly added
// to. Resolving access order:
//   1. Owner role on the org → sees every brand unconditionally
//   2. BrandMembership row   → sees that specific brand
//   3. neither               → no access (sidebar hides brand,
//                               API returns 403)
//
// Kept as a join table rather than a String[] on User so the
// per-brand role can diverge from the org role (e.g. Admin on the
// org but Member on one specific brand) without contortions.
model BrandMembership {
  id        String   @id @default(cuid())
  role      String   @default("member") // owner | admin | member | viewer
  createdAt DateTime @default(now())

  userId String
  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([userId, brandId])
  @@index([brandId])
  @@index([userId])
}

// ─── Brand / Website ─────────────────────────────────────────────────────────

model Brand {
  id                     String    @id @default(cuid())
  name                   String
  domain                 String
  industry               String?
  // Legacy single-string fields. Kept populated alongside the array
  // fields below (location = locations[0], serviceType =
  // primaryServices.join(", ")) so consumers that haven't migrated to
  // the helpers in @/lib/brand-helpers continue to read sensible
  // values during the rollout. Slated for removal once every consumer
  // reads via getBrandLocations() / getBrandServices() —
  // tracked as BACKLOG-002.
  serviceType            String?
  location               String?
  // Multi-location and categorized service support.
  // String[] @default([]) is non-destructive on `prisma db push`:
  // adds the columns with empty-array defaults so existing rows
  // backfill to {} automatically. The /api/admin/backfill-brand-arrays
  // endpoint (idempotent, dryRun-aware) populates these from the
  // legacy fields above for brands that pre-date the multi-array UX.
  locations              String[]  @default([])
  primaryServices        String[]  @default([])
  secondaryServices      String[]  @default([])
  servicesExtractedAt    DateTime?
  initials               String
  // ── Plan / billing ────────────────────────────────────────────
  // Plan the brand is currently on. "trial" grants Professional-
  // level access for 14 days (enforced via planExpiresAt); after
  // that it downgrades to Growth features but data is retained.
  // Stripe + webhook wiring for real billing lives outside this
  // model — this is purely the entitlement state feature gates
  // read from.
  plan                   String    @default("trial") // trial | growth | professional | agency | agency_pro | enterprise
  billingCycle           String    @default("monthly") // monthly | annual
  planStartedAt          DateTime  @default(now())
  planExpiresAt          DateTime?
  // AI credit bucket. Reset monthly by a cron (or on subscription
  // renewal). Feature handlers increment aiCreditsUsed; the
  // upgrade modal fires when usage >= 80% of the plan's quota.
  aiCreditsUsed          Int       @default(0)
  aiCreditsResetAt       DateTime?
  // ── Compliance & privacy ──────────────────────────────────────
  // When healthcareMode = true, the Site Tag strips query params,
  // form field names, and referrer search queries so PHI never
  // crosses the wire. Set per-brand by admin or auto-suggested
  // when industry detection flags healthcare.
  healthcareMode         Boolean   @default(false)
  // Per-brand data retention override in days. Null = use the
  // platform default (13 months / 395 days, matching GA4). The
  // data-retention cron honours both the platform default and
  // the per-brand override before purging.
  dataRetentionDays      Int?
  // DPA signed timestamp — null when not yet signed. Null doesn't
  // necessarily mean missing; the Compliance dashboard treats
  // brands flagged as "Not Required" separately.
  dpaSignedAt            DateTime?
  dpaStatus              String    @default("not_required") // not_required | pending | signed
  color                  String    @default("bg-brand-500")
  status                 String    @default("active") // active | inactive | suspended | deleted
  healthScore            Int       @default(0)
  deactivatedAt          DateTime?
  deactivatedBy          String?
  deactivationReason     String?
  statusChangedAt        DateTime?
  statusChangedBy        String?
  // ── Data quality verification ─────────────────────────────────
  verifiedAt             DateTime?
  lastVerificationScore  Float?
  lastVerificationIssues Json?
  // External converter domains registered per-brand. Stored as JSON array
  // of { domain, nickname, isActive, registeredAt } objects so no new
  // table is needed. Outbound clicks to registered domains fire an
  // additional external_conversion_initiated event server-side.
  externalConverters     Json      @default("[]")
  createdAt              DateTime  @default(now())
  updatedAt              DateTime  @updatedAt

  orgId        String
  organization Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)

  memberships               BrandMembership[]
  dashboardData             DashboardData?
  websites                  Website[]
  profile                   BrandProfile?
  integrations              BrandIntegration[]
  metricSnapshots           MetricSnapshot[]
  conversions               ConversionEvent[]
  channelMetrics            ChannelMetric[]
  tasks                     Task[]
  pageLaunches              PageLaunch[]
  contentBriefs             ContentBrief[]
  technicalAudits           TechnicalAudit[]
  deadPages                 DeadPage[]
  deadPageScans             DeadPageScan[]
  perfAudits                PerformanceAudit[]
  aiVisibility              AiVisibilitySnapshot[]
  competitors               Competitor[]
  competitorSnapshots       CompetitorSnapshot[]
  analysisJobs              AnalysisJob[]
  crmDeals                  CrmDeal[]
  attributionRecords        RevenueAttribution[]
  journeys                  UserJourney[]
  avatarConversations       AvatarConversation[]
  trackedSite               TrackedSite?
  gscQueries                GscQuery[]
  gscPages                  GscPage[]
  gbpLocations              GbpLocation[]
  gbpReviews                GbpReview[]
  gbpMetrics                GbpMetric[]
  pageRecords               PageRecord[]
  redirectRecords           RedirectRecord[]
  navSnapshots              NavSnapshot[]
  siteConversions           SiteConversion[]
  heatmapEvents             HeatmapEvent[]
  realUserMetrics           RealUserMetric[]
  siteEvents                SiteEvent[]
  siteTagDailyRollups       SiteTagDailyRollup[]
  pageSeoSnapshots          PageSEOSnapshot[]
  studioPages               StudioPage[]
  brandAssets               BrandAsset[]
  trackedKeywords           TrackedKeyword[]
  emailReportSchedules      EmailReportSchedule[]
  clientPortal              ClientPortal?
  keywordResearches         KeywordResearch[]
  savedKeywords             SavedKeyword[]
  savedLayouts              SavedLayout[]
  industryBriefings         IndustryBriefing[]
  backlinks                 Backlink[]
  backlinkSnapshots         BacklinkSnapshot[]
  alertRules                AlertRule[]
  notifications             Notification[]
  predictions               Prediction[]
  recommendationOutcomes    RecommendationOutcome[]
  clientMemories            ClientMemory[]
  schemaMarkups             SchemaMarkup[]
  writingDocuments          WritingDocument[]
  contentAuditResults       ContentAuditResult[]
  auditScoreHistory         AuditScoreHistory[]
  aiVisibilityChecks        AiVisibilityCheck[]
  aiVisibilityQueries       AiVisibilityQuery[]
  enrichmentFiles           EnrichmentFile[]
  strategistSessions        StrategistSession[]
  // ── Paid Media Attribution ─────────────────────────────────
  visitorProfiles           VisitorProfile[]
  householdClusters         HouseholdCluster[]
  ottImpressions            OttImpression[]
  aiAttributions            AiAttribution[]
  aiCitations               AiCitation[]
  aiRecommendations         AiRecommendation[]
  dashboardSnapshots        DashboardSnapshot[]
  adPlatformIntegrations    AdPlatformIntegration[]
  adCampaignData            AdCampaignData[]
  adClickEvents             AdClickEvent[]
  attributionPaths          AttributionPath[]
  discoveryJobs             CompetitorDiscoveryJob[]
  snippetDetectedAt         DateTime?
  snippetInstallationMethod String?
  snippetCheckedAt          DateTime?
  // Demo brands are created by admins for showcase/sales purposes.
  // Guards on cron jobs + aggregate admin queries exclude demo brands
  // so their synthetic data never skews platform metrics.
  isDemo                    Boolean                  @default(false)
  renderTier                String                   @default("base") // "base" | "js"
  healthAlerts              BrandHealthAlert[]
  audits                    Audit[]
  detectedIntegrations      DetectedIntegration[]
  conversionConfigs         BrandConversionConfig[]
  marketPositionSnapshots   MarketPositionSnapshot[]
  siteAuditRuns             SiteAuditRun[]
}

// ─── Detected Integrations ───────────────────────────────────────────────────

model DetectedIntegration {
  id               String   @id @default(cuid())
  brandId          String
  name             String
  category         String
  vendor           String?
  version          String?
  firstDetectedAt  DateTime @default(now())
  lastDetectedAt   DateTime @default(now())
  detectionSources String[] @default([])
  pageCount        Int      @default(1)
  samplePages      String[] @default([])
  evidence         Json?
  status           String   @default("active")
  isActive         Boolean  @default(true)
  createdAt        DateTime @default(now())
  updatedAt        DateTime @updatedAt
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([brandId, name])
  @@index([brandId, category])
  @@index([brandId, lastDetectedAt(sort: Desc)])
  @@index([brandId, status])
}

// ─── Per-brand conversion counting configuration ─────────────────────────────

model BrandConversionConfig {
  id             String   @id @default(cuid())
  brandId        String
  conversionType String
  isCounted      Boolean  @default(true)
  tierOverride   String?
  displayLabel   String?
  createdAt      DateTime @default(now())
  updatedAt      DateTime @updatedAt
  brand          Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([brandId, conversionType])
  @@index([brandId])
}

// ─── Competitor Discovery Queue ──────────────────────────────────────────────

model CompetitorDiscoveryJob {
  id      String @id @default(cuid())
  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  status    String @default("pending") // pending | running | completed | failed
  focus     String // local | national
  locations Json // string[] — location strings to iterate
  limit     Int    @default(20)

  totalLocations     Int @default(0)
  processedLocations Int @default(0)
  competitorsFound   Int @default(0)

  startedAt   DateTime?
  completedAt DateTime?
  error       String?

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([status, createdAt])
  @@index([brandId])
}

// ─── Brand Profile (AI Intake Data) ──────────────────────────────────────────

model BrandProfile {
  id               String    @id @default(cuid())
  companyName      String?
  logoUrl          String?
  brandColors      String[]  @default([])
  primaryColor     String? // hex: "#FF0000"
  secondaryColor   String?
  accentColor      String?
  fontFamily       String? // e.g. "Inter, sans-serif"
  services         String[]  @default([])
  locations        String[]  @default([])
  businessType     String?
  industry         String?
  targetAudience   String?
  description      String?
  shortDescription String? // AI-generated one-liner
  brandVoice       String? // "professional" | "medical" | "friendly" etc.
  toneHints        String? // longer description of brand communication style
  lightBackground  String? // derived: light theme bg hex
  darkBackground   String? // derived: dark theme bg hex
  textColor        String? // derived: preferred text color hex
  extractedAt      DateTime? // when auto-extraction last ran
  createdAt        DateTime  @default(now())
  updatedAt        DateTime  @updatedAt

  brandId String @unique
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)
}

// ─── Website / Domain ────────────────────────────────────────────────────────

model Website {
  id          String    @id @default(cuid())
  url         String
  isVerified  Boolean   @default(false)
  isPrimary   Boolean   @default(false)
  lastCrawled DateTime?
  pageCount   Int       @default(0)
  createdAt   DateTime  @default(now())
  updatedAt   DateTime  @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)
}

// ─── Brand Integrations ──────────────────────────────────────────────────────

model BrandIntegration {
  id             String    @id @default(cuid())
  integrationId  String // "gsc" | "ga4" | "gbp" | "bing"
  connected      Boolean   @default(false)
  status         String    @default("idle") // "idle"|"connected"|"syncing"|"error"|"expired"
  lastSynced     DateTime?
  syncError      String?
  syncRetryCount Int       @default(0) // how many consecutive failures
  nextRetryAt    DateTime? // when to retry after failure

  // Encrypted credentials (tokens, API keys, refresh tokens)
  // Encrypted with AES-256-GCM before storage — never stored in plain text.
  credentialsEnc   String? // encrypted JSON blob
  credentialsMeta  Json      @default("{}") // non-secret metadata: scopes, account name, expiry
  tokenExpiresAt   DateTime? // when the access token expires
  // Consecutive token-refresh failures. We tolerate 2 blips (network
  // hiccup, transient Google 5xx) before marking status="expired" — a
  // single refresh-endpoint outage shouldn't force the user to reconnect.
  refreshFailCount Int       @default(0)

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([brandId, integrationId])
}

// ─── Google Search Console Data ──────────────────────────────────────────────
// Granular GSC data stored per brand per sync.
// GscQuery: per-keyword performance (clicks, impressions, CTR, position)
// GscPage:  per-landing-page performance

model GscQuery {
  id          String   @id @default(cuid())
  query       String // the search keyword
  clicks      Int      @default(0)
  impressions Int      @default(0)
  ctr         Float    @default(0) // 0.0 to 1.0
  position    Float    @default(0) // average position
  date        DateTime // which day this row covers
  createdAt   DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@index([brandId, date])
  @@index([brandId, query])
}

model GscPage {
  id          String   @id @default(cuid())
  pageUrl     String // the landing page URL
  clicks      Int      @default(0)
  impressions Int      @default(0)
  ctr         Float    @default(0)
  position    Float    @default(0)
  date        DateTime
  createdAt   DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@index([brandId, date])
  @@index([brandId, pageUrl])
}

// ─── Google Business Profile Data ────────────────────────────────────────────
// GbpLocation: the business location linked to a brand
// GbpReview:   individual reviews from the GBP listing
// GbpMetric:   periodic performance metrics (views, searches, actions)

model GbpLocation {
  id               String   @id @default(cuid())
  brandId          String
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  googleLocationId String
  locationName     String
  address          String?
  city             String?
  state            String?
  zip              String?
  phone            String?
  website          String?
  category         String?
  placeId          String?
  latitude         Float?
  longitude        Float?
  isActive         Boolean  @default(true)
  groupName        String?
  tags             String[] @default([])
  avgRating        Float    @default(0)
  totalReviews     Int      @default(0)
  connectedAt      DateTime @default(now())
  updatedAt        DateTime @updatedAt

  metrics GbpMetric[]
  reviews GbpReview[]

  @@unique([brandId, googleLocationId])
  @@index([brandId, isActive])
  @@index([brandId, groupName])
}

model GbpReview {
  id             String      @id @default(cuid())
  locationId     String
  location       GbpLocation @relation(fields: [locationId], references: [id], onDelete: Cascade)
  googleReviewId String?
  reviewerName   String?
  rating         Int
  comment        String?
  replyText      String?
  repliedAt      DateTime?
  publishedAt    DateTime
  sentiment      String?
  topics         String[]    @default([])
  createdAt      DateTime    @default(now())

  // Legacy brand-level fields — kept for backward compat
  brandId String?
  brand   Brand?  @relation(fields: [brandId], references: [id])

  @@unique([locationId, googleReviewId])
  @@index([locationId, publishedAt])
  @@index([locationId, rating])
}

model GbpMetric {
  id                String      @id @default(cuid())
  locationId        String
  location          GbpLocation @relation(fields: [locationId], references: [id], onDelete: Cascade)
  date              DateTime
  searchesTotal     Int?
  searchesDirect    Int?
  searchesDiscovery Int?
  searchesBranded   Int?
  viewsTotal        Int?
  viewsMaps         Int?
  viewsSearch       Int?
  websiteClicks     Int?
  phoneClicks       Int?
  directionClicks   Int?
  messageCount      Int?
  bookingCount      Int?
  createdAt         DateTime    @default(now())

  // Legacy brand-level fields
  brandId String?
  brand   Brand?  @relation(fields: [brandId], references: [id])

  @@unique([locationId, date])
  @@index([locationId, date])
}

// ─── Dashboard Data ──────────────────────────────────────────────────────────

model DashboardData {
  id             String @id @default(cuid())
  seoScore       Int    @default(0)
  aiVisibility   Int    @default(0)
  crawlHealth    Int    @default(0)
  monthlyTraffic Int    @default(0)
  revenue        Int    @default(0)
  revenueChange  Float  @default(0)
  alertCount     Int    @default(0)

  brandId String @unique
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)
}

// ─── Daily Metric Snapshots ──────────────────────────────────────────────────
// One row per brand per day. Stores aggregated daily metrics.

model MetricSnapshot {
  id                    String   @id @default(cuid())
  date                  DateTime
  source                String   @default("manual") // "ga4" | "gsc" | "site_tag" | "daily" | "manual" | "seed"
  // GA4 metrics
  sessions              Int      @default(0)
  users                 Int      @default(0)
  pageviews             Int      @default(0)
  bounceRate            Float    @default(0)
  avgSessionSec         Int      @default(0)
  conversions           Int      @default(0)
  revenue               Int      @default(0)
  // GSC metrics
  organicClicks         Int      @default(0)
  impressions           Int      @default(0)
  avgPosition           Float    @default(0)
  ctr                   Float    @default(0)
  // Audit / AI
  seoScore              Int      @default(0)
  crawlHealth           Int      @default(0)
  aiMentions            Int      @default(0)
  // ── Site Tag metrics (added 2026-04) ──
  // Captured by the daily snapshot cron from TrackedSession +
  // SiteConversion + TrackedEvent. Preserved permanently so the
  // platform retains a historical record even after per-event rows
  // age out of the data-retention window.
  siteTagSessions       Int?
  siteTagPageViews      Int?
  siteTagConversions    Int?
  siteTagFormSubmits    Int?
  siteTagPhoneCalls     Int?
  siteTagBookings       Int?
  siteTagEvents         Int?
  siteTagOutboundClicks Int?
  // ── Platform metrics ──
  aiCalls               Int?
  aiCost                Float?
  // ── Paid media (when ad platform connected) ──
  adSpend               Float?
  adClicks              Int?
  adImpressions         Int?
  adConversions         Int?

  updatedAt DateTime @default(now()) @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([brandId, date, source])
  @@index([brandId, date])
}

// ─── Conversion Events ───────────────────────────────────────────────────────
// Individual conversion records. type: phone | form | order | booking

model ConversionEvent {
  id          String   @id @default(cuid())
  date        DateTime
  type        String
  channel     String
  value       Float    @default(0)
  source      String?
  landingPage String?
  keyword     String?
  createdAt   DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  crmDeals CrmDeal[]
  journeys UserJourney[]

  @@index([brandId, date])
  @@index([brandId, type])
  @@index([brandId, channel])
}

// ─── Channel Metrics ─────────────────────────────────────────────────────────
// Daily per-channel breakdown. channel: organic | ai_search | social | gbp | direct

model ChannelMetric {
  id          String   @id @default(cuid())
  date        DateTime
  channel     String
  source      String   @default("manual") // "ga4" | "gsc" | "manual" | "seed"
  sessions    Int      @default(0)
  users       Int      @default(0)
  conversions Int      @default(0)
  revenue     Int      @default(0)
  bounceRate  Float    @default(0)

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@unique([brandId, date, channel, source])
  @@index([brandId, date])
}

// ─── Execution Hub: Tasks ────────────────────────────────────────────────────
// category: seo | llmo | gbp | content | technical
// status: todo | in_progress | completed
// priority: low | medium | high | critical
// effort: low | medium | high

model Task {
  id             String    @id @default(cuid())
  title          String
  description    String?
  category       String
  status         String    @default("todo")
  priority       String    @default("medium")
  effort         String    @default("medium")
  pageUrl        String?
  recommendation String?
  source         String? // "technical_audit" | "dead_pages" | "performance_audit" | "signals" | "recommendations" | "manual"
  sourceId       String? // ID of the source record (issue ID, signal ID, etc.)
  sourceRunAt    DateTime? // timestamp of the source run that produced this task
  dueDate        DateTime?
  completedAt    DateTime?
  createdAt      DateTime  @default(now())
  updatedAt      DateTime  @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  assignedTo String?
  assignee   User?   @relation(fields: [assignedTo], references: [id], onDelete: SetNull)

  // Content pipeline fields
  contentType   String? // blog_post | landing_page | service_page | case_study | social_post
  pipelineStage String? // idea | brief_created | writing | editing | review | approved | published
  briefId       String? // ContentBrief reference
  studioPageId  String? // StudioPage reference
  publishedUrl  String?
  publishedAt   DateTime?
  wordCount     Int?
  targetKeyword String?

  pageLaunch PageLaunch?

  @@index([brandId, status])
  @@index([brandId, category])
  @@index([brandId, pipelineStage])
  @@index([assignedTo])
  @@index([brandId, dueDate])
}

// ─── Performance Since Launch: Page Tracking ─────────────────────────────────
// Tracks a page from launch through performance monitoring.
// Links to the task that triggered the launch.

model PageLaunch {
  id            String    @id @default(cuid())
  pageUrl       String
  pageType      String
  launchDate    DateTime
  optimizedDate DateTime?
  notes         String?
  createdAt     DateTime  @default(now())
  updatedAt     DateTime  @updatedAt

  // Baseline metrics at launch
  baselineSessions    Int   @default(0)
  baselineClicks      Int   @default(0)
  baselineImpressions Int   @default(0)
  baselinePosition    Float @default(0)
  baselineConversions Int   @default(0)
  baselineRevenue     Int   @default(0)

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  // Optional link to the task that triggered this launch
  taskId String? @unique
  task   Task?   @relation(fields: [taskId], references: [id], onDelete: SetNull)

  // Post-launch metric snapshots
  snapshots PageLaunchSnapshot[]

  @@index([brandId])
  @@index([brandId, launchDate])
}

// Post-launch performance snapshots (weekly or periodic)
model PageLaunchSnapshot {
  id          String   @id @default(cuid())
  date        DateTime
  sessions    Int      @default(0)
  clicks      Int      @default(0)
  impressions Int      @default(0)
  position    Float    @default(0)
  conversions Int      @default(0)
  revenue     Int      @default(0)

  pageLaunchId String
  pageLaunch   PageLaunch @relation(fields: [pageLaunchId], references: [id], onDelete: Cascade)

  @@unique([pageLaunchId, date])
  @@index([pageLaunchId, date])
}

// ─── Content Briefs (SEO + LLMO) ─────────────────────────────────────────────
// type: "seo" | "llmo"
// status: "draft" | "review" | "approved" | "published"

model ContentBrief {
  id     String @id @default(cuid())
  type   String
  status String @default("draft")
  title  String

  // ── Input fields (what the user provides) ──
  primaryKeyword      String?
  secondaryKeywords   String[] @default([])
  city                String?
  state               String?
  service             String?
  industry            String?
  brandName           String?
  ctaOffer            String?
  serviceAreaNotes    String?
  uniqueSellingPoints String[] @default([])

  // LLMO-specific inputs
  primaryTopic          String?
  longTailKeywords      String[] @default([])
  conversationalPhrases String[] @default([])
  relatedQuestions      String[] @default([])

  // ── Settings ──
  tone             String  @default("professional")
  humanizationMode Boolean @default(false)
  contentScore     Int     @default(0)

  // ── Sub-scores (JSON object) ──
  // SEO: { keywordCoverage, internalLinkingStrength, contentStructure }
  // LLMO: { conversationalDepth, longTailCoverage, answerReadyFormat }
  subScores Json @default("{}")

  // ── Generated output (stored as JSON) ──
  sections      Json    @default("[]")
  internalLinks Json    @default("[]")
  writerNotes   String?

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  createdById String?
  createdBy   User?   @relation(fields: [createdById], references: [id], onDelete: SetNull)

  @@index([brandId, type])
  @@index([brandId, status])
}

// ─── Technical Audit ─────────────────────────────────────────────────────────

model TechnicalAudit {
  id           String    @id @default(cuid())
  status       String    @default("pending") // "pending" | "running" | "completed" | "failed"
  crawlHealth  Int       @default(0)
  pagesScanned Int       @default(0)
  errorCount   Int       @default(0)
  warningCount Int       @default(0)
  noticeCount  Int       @default(0)
  passedCount  Int       @default(0)
  duration     Int       @default(0)
  errorMessage String?
  createdAt    DateTime  @default(now())
  completedAt  DateTime?

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  issues TechnicalIssue[]

  @@index([brandId])
}

model TechnicalIssue {
  id           String  @id @default(cuid())
  category     String
  severity     String
  title        String
  detail       String?
  pageUrl      String?
  affectedUrls Json    @default("[]") // JSON array of affected URL strings
  evidence     Json    @default("[]") // JSON array of structured evidence objects
  affected     Int     @default(1)
  status       String  @default("open")

  auditId String
  audit   TechnicalAudit @relation(fields: [auditId], references: [id], onDelete: Cascade)

  @@index([auditId, category])
  @@index([auditId, severity])
}

// ─── Dead 404 Pages ──────────────────────────────────────────────────────────

model DeadPageScan {
  id           String    @id @default(cuid())
  status       String    @default("pending") // "pending" | "running" | "completed" | "failed"
  pagesChecked Int       @default(0)
  deadFound    Int       @default(0)
  errorMessage String?
  completedAt  DateTime?
  createdAt    DateTime  @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@index([brandId])
}

model DeadPage {
  id           String   @id @default(cuid())
  deadUrl      String
  priority     String   @default("medium")
  suggestedFix String?
  status       String   @default("open")
  discoveredAt DateTime @default(now())
  createdAt    DateTime @default(now())
  updatedAt    DateTime @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  sources DeadPageSource[]

  @@index([brandId, status])
}

model DeadPageSource {
  id         String  @id @default(cuid())
  sourceUrl  String
  anchorText String?

  deadPageId String
  deadPage   DeadPage @relation(fields: [deadPageId], references: [id], onDelete: Cascade)

  @@index([deadPageId])
}

// ─── Performance Audit ───────────────────────────────────────────────────────

model PerformanceAudit {
  id           String    @id @default(cuid())
  device       String    @default("mobile")
  status       String    @default("pending") // "pending" | "running" | "completed" | "failed"
  errorMessage String?
  completedAt  DateTime?
  createdAt    DateTime  @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  pages PerformancePageScore[]

  @@index([brandId])
}

model PerformancePageScore {
  id            String @id @default(cuid())
  pageUrl       String
  device        String @default("mobile")
  performance   Int    @default(0)
  accessibility Int    @default(0)
  bestPractices Int    @default(0)
  seo           Int    @default(0)
  lcpMs         Int    @default(0)
  inpMs         Int    @default(0)
  clsVal        Float  @default(0)
  fcpMs         Int    @default(0)
  ttfbMs        Int    @default(0)
  status        String @default("average")

  auditId String
  audit   PerformanceAudit @relation(fields: [auditId], references: [id], onDelete: Cascade)

  @@index([auditId])
  @@index([auditId, pageUrl])
}

// ─── AI Visibility ───────────────────────────────────────────────────────────
// platform: chatgpt | claude | perplexity | gemini | google_aio

model AiVisibilitySnapshot {
  id              String   @id @default(cuid())
  date            DateTime
  platform        String
  topic           String
  mentions        Int      @default(0)
  citations       Int      @default(0)
  visibilityScore Int      @default(0)
  sourceUrl       String?
  change          Int      @default(0)
  createdAt       DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@index([brandId, date])
  @@index([brandId, platform])
  @@index([brandId, topic])
}

// ─── Competitors ─────────────────────────────────────────────────────────────
// type: national | local | emerging

model Competitor {
  id                     String    @id @default(cuid())
  name                   String
  domain                 String
  type                   String    @default("national")
  logoUrl                String?
  strongestPage          String?
  whyWinning             String?
  watchlist              Boolean   @default(false)
  isActive               Boolean   @default(true)
  // Cached sitemap URLs discovered during the last crawl so subsequent
  // crawls can skip the discovery phase and go direct.
  sitemapUrls            Json? // string[] of absolute sitemap URLs
  discoveredForLocations Json? // string[] — locations where this competitor was discovered. Null for manual adds and pre-migration rows.
  lastCrawledAt          DateTime?
  detectedCms            String? // wordpress | shopify | wix | squarespace | etc.
  createdAt              DateTime  @default(now())
  updatedAt              DateTime  @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  snapshots CompetitorSnapshot[]
  rankings  CompetitorRanking[]
  pages     CompetitorPage[]

  @@unique([brandId, domain])
  @@index([brandId, isActive])
}

model CompetitorSnapshot {
  id              String   @id @default(cuid())
  date            DateTime @default(now())
  movement        String?
  rankChange      Int      @default(0)
  aiMentions      Int      @default(0)
  aiMentionChange Int      @default(0)
  trafficEstimate Int      @default(0)
  topKeyword      String?
  threat          String   @default("medium")
  // Sitemap monitoring
  totalPages      Int?
  newPages        Json?
  removedPages    Json?
  changedPages    Json?
  sitemapUrls     Json?
  title           String?
  metaDescription String?
  techStack       Json?
  crawledAt       DateTime @default(now())
  createdAt       DateTime @default(now())

  competitorId String
  competitor   Competitor @relation(fields: [competitorId], references: [id], onDelete: Cascade)

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  @@index([competitorId, crawledAt])
  @@index([brandId, date])
}

model CompetitorRanking {
  id           String     @id @default(cuid())
  competitorId String
  competitor   Competitor @relation(fields: [competitorId], references: [id], onDelete: Cascade)
  keyword      String
  position     Int?
  url          String?
  checkedAt    DateTime   @default(now())

  @@index([competitorId, keyword, checkedAt])
}

// Per-page data from sitemap crawling. Each row = one URL found in a
// competitor's sitemap. Status is updated on every crawl to track new
// content, updates, and removals over time.
model CompetitorPage {
  id              String     @id @default(cuid())
  competitorId    String
  competitor      Competitor @relation(fields: [competitorId], references: [id], onDelete: Cascade)
  url             String
  title           String?
  metaDescription String?
  h1              String?
  wordCount       Int?
  lastmod         DateTime?
  changefreq      String? // always | hourly | daily | weekly | monthly | yearly | never
  priority        Float? // 0.0 – 1.0 from sitemap
  firstSeenAt     DateTime   @default(now())
  lastCheckedAt   DateTime   @default(now())
  status          String     @default("new") // new | updated | unchanged | removed

  @@unique([competitorId, url])
  @@index([competitorId, status])
  @@index([competitorId, firstSeenAt])
}

// ─── CRM Deals ───────────────────────────────────────────────────────────────
// source: hubspot | salesforce | highlevel | manual
// stage: lead | qualified | proposal | negotiation | closed_won | closed_lost

model CrmDeal {
  id           String    @id @default(cuid())
  externalId   String?
  source       String    @default("manual")
  contactName  String?
  contactEmail String?
  dealName     String
  value        Float     @default(0)
  stage        String    @default("lead")
  status       String    @default("open")
  closeDate    DateTime?
  createdAt    DateTime  @default(now())
  updatedAt    DateTime  @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  // Link to conversion that created this deal
  conversionId String?
  conversion   ConversionEvent? @relation(fields: [conversionId], references: [id], onDelete: SetNull)

  attributions RevenueAttribution[]
  journeys     UserJourney[]

  @@index([brandId, status])
  @@index([brandId, stage])
  @@index([source])
}

// ─── Revenue Attribution ─────────────────────────────────────────────────────
// model: first_touch | last_touch | assisted

model RevenueAttribution {
  id               String   @id @default(cuid())
  attributionModel String   @default("last_touch")
  channel          String
  landingPage      String?
  conversionType   String?
  revenue          Float    @default(0)
  creditPct        Float    @default(100)
  date             DateTime
  createdAt        DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  dealId String?
  deal   CrmDeal? @relation(fields: [dealId], references: [id], onDelete: SetNull)

  @@index([brandId, date])
  @@index([brandId, channel])
  @@index([brandId, attributionModel])
}

// ─── User Journeys (Closed-Loop Tracking) ────────────────────────────────────

model UserJourney {
  id             String   @id @default(cuid())
  entryChannel   String
  pagesVisited   String[] @default([])
  conversionType String?
  revenue        Float    @default(0)
  date           DateTime
  createdAt      DateTime @default(now())

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  conversionId String?
  conversion   ConversionEvent? @relation(fields: [conversionId], references: [id], onDelete: SetNull)

  dealId String?
  deal   CrmDeal? @relation(fields: [dealId], references: [id], onDelete: SetNull)

  @@index([brandId, date])
  @@index([brandId, entryChannel])
}

// ─── Notifications (System/Account Events) ───────────────────────────────────
// category: login | system | security | integration | task | billing | workspace
// status: unread | read | dismissed

model Notification {
  id          String     @id @default(cuid())
  brandId     String
  brand       Brand      @relation(fields: [brandId], references: [id], onDelete: Cascade)
  alertRuleId String?
  alertRule   AlertRule? @relation(fields: [alertRuleId], references: [id])
  userId      String?
  title       String
  message     String
  type        String     @default("info")
  severity    String     @default("medium")
  channel     String     @default("in_app")
  isRead      Boolean    @default(false)
  readAt      DateTime?
  emailSent   Boolean    @default(false)
  smsSent     Boolean    @default(false)
  smsError    String?
  metadata    Json?
  createdAt   DateTime   @default(now())

  @@index([brandId, isRead, createdAt])
  @@index([userId, isRead])
  @@index([brandId, channel])
}

// ─── AI Avatar Conversations ─────────────────────────────────────────────────
// Each conversation belongs to a user + brand and contains messages.

model AvatarConversation {
  id        String   @id @default(cuid())
  title     String   @default("New conversation")
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  userId String
  user   User   @relation(fields: [userId], references: [id], onDelete: Cascade)

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  messages AvatarMessage[]

  @@index([userId, brandId, updatedAt])
}

model AvatarMessage {
  id        String   @id @default(cuid())
  role      String // "user" or "assistant"
  content   String
  module    String? // which module was active (e.g. "Technical Audit")
  metadata  Json     @default("{}") // actions, followUps, context
  createdAt DateTime @default(now())

  conversationId String
  conversation   AvatarConversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)

  @@index([conversationId, createdAt])
}

// ─── meSEO Site Tag (Machine Enhancing Tracking ID) ─────────────────────────
//
// TrackedSite: one per brand — holds the unique site_id and tracking_key
// TrackedSession: one per visitor session (30-min inactivity timeout)
// TrackedEvent: each page view, click, or custom event
//
// How IDs work:
//   siteId      = "ms_" + cuid  (public, embedded in the snippet)
//   trackingKey = random 32-char hex string (secret, used to validate)

model TrackedSite {
  id                     String    @id @default(cuid())
  siteId                 String    @unique // public ID: "ms_clxyz..."
  trackingKey            String    @unique // secret key for validation
  status                 String    @default("active") // active | paused | disabled
  allowedDomains         String[]  @default([]) // e.g. ["acme.com", "www.acme.com"]
  lastEventAt            DateTime? // timestamp of most recent event
  // When the Site Tag actually started capturing data — the
  // timestamp of the *first* TrackedEvent or SiteEvent for this
  // site. Distinct from createdAt (which is just when the row
  // was inserted; the snippet may sit uninstalled for days or
  // weeks before the customer actually deploys it). Written
  // once, lazily — the first /api/collect hit after this column
  // is null backfills it via an idempotent updateMany. Null when
  // the site exists but has never phoned home.
  firstEventAt           DateTime?
  // Custom events configured via the /site-tag UI. Each entry:
  //   { id, name, triggerType, triggerConfig, properties, isActive }
  customEvents           Json      @default("[]")
  sitePlatform           String?
  sitePlatformVersion    String?
  sitePlatformConfidence String?
  sitePlatformCategory   String?
  sitePlatformDetectedAt DateTime?
  siteHosting            String?
  siteHostingDetectedAt  DateTime?
  // When true, "load_after_engage" iframe heuristic signals are promoted
  // to completed-tier form_submit for this brand. Default off -- the
  // heuristic is unreliable enough that it should only be enabled after
  // confirming in prod that load-after-engage correlates with real leads.
  countInferredIframeSubmits Boolean @default(false)
  // When true, only SiteConversion rows with successConfirmed=true count
  // toward this brand's conversion total. Default false -- all rows count,
  // preserving existing behaviour for every brand.
  requireSuccessConfirmed    Boolean @default(false)
  createdAt              DateTime  @default(now())
  updatedAt              DateTime  @updatedAt

  orgId String
  org   Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)

  brandId String @unique // one tracked site per brand
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  sessions        TrackedSession[]
  events          TrackedEvent[]
  canonicalEvents CanonicalEvent[]
  sourceEvents    SourceEvent[]

  @@index([siteId])
  @@index([orgId])
}

model TrackedSession {
  id                       String    @id @default(cuid())
  sessionId                String    @unique // random ID set by the tracker JS
  startedAt                DateTime  @default(now())
  lastSeenAt               DateTime  @default(now())
  pageCount                Int       @default(1)
  entryPage                String // first page URL in the session
  referrer                 String? // external referrer if any
  utmSource                String?
  utmMedium                String?
  utmCampaign              String?
  userAgent                String?
  country                  String?
  device                   String? // "mobile" | "desktop" | "tablet"
  // Additional client context captured on session_start / first
  // page_view. Populated from the incoming request's headers
  // (User-Agent parse + x-vercel-ip-* geo headers) — never from
  // the client payload, so a spoofed t.js can't pollute these
  // columns. All optional: historical sessions and non-Vercel
  // deploys keep rendering with nulls where values aren't
  // available.
  browser                  String?
  os                       String?
  city                     String?
  region                   String?
  ipAddress                String? // admin-only surface — never returned to brand users
  // ── Extended UTM + ad-click attribution (Phase 1, 2026-04) ──
  // utmSource / utmMedium / utmCampaign already exist above. The
  // three fields below complete the full UTM spec so the attribution
  // model can segment by keyword (utm_term) and creative variant
  // (utm_content) in addition to source/medium/campaign.
  utmTerm                  String?
  utmContent               String?
  // Ad-platform click IDs. Present when the visitor landed from a
  // paid ad. Matched against AdClickEvent rows server-side so the
  // attribution path can trace campaign → ad group → ad → session →
  // conversion. Only the ID is stored (no PII). Nullable: organic /
  // direct / referral sessions have no click ID.
  gclid                    String? // Google Ads
  fbclid                   String? // Meta (Facebook / Instagram)
  msclkid                  String? // Microsoft Ads (Bing)
  ttclid                   String? // TikTok Ads
  li_fat_id                String? // LinkedIn Ads
  dclid                    String? // Google Display & Video 360
  wbraid                   String? // Google Ads (iOS web-to-app)
  gbraid                   String? // Google Ads (iOS app-to-web)
  // Server-computed channel group. Derived from the combination of
  // referrer + UTM params + click IDs at session-start time. Values
  // follow GA4's Default Channel Group taxonomy so cross-source
  // comparisons read naturally.
  channelGroup             String? // Paid Search | Paid Social | Organic Search | Direct | Referral | Email | Display | OTT/CTV | Other
  // ── Predictive Conversion Scoring (Phase 9) ──
  predictedConversionScore Float?    @default(0)
  scoreLastComputedAt      DateTime?
  scoreContributingFactors Json?

  trackedSiteId String
  trackedSite   TrackedSite @relation(fields: [trackedSiteId], references: [id], onDelete: Cascade)

  events TrackedEvent[]

  @@index([trackedSiteId, startedAt])
  @@index([sessionId])
}

model TrackedEvent {
  id        String   @id @default(cuid())
  eventType String // "page_view" | "session_start" | custom
  pageUrl   String
  referrer  String?
  timestamp DateTime @default(now())
  metadata  Json     @default("{}") // custom key-value pairs
  synthetic Boolean  @default(false)

  trackedSiteId String
  trackedSite   TrackedSite @relation(fields: [trackedSiteId], references: [id], onDelete: Cascade)

  sessionId String?
  session   TrackedSession? @relation(fields: [sessionId], references: [id], onDelete: SetNull)

  @@index([trackedSiteId, timestamp])
  @@index([trackedSiteId, eventType])
  // Composite index for the common "this site + this event type + recent
  // window" query pattern (session_start counts, page_view groupBys, etc.)
  // — without it Postgres picks one of the two-column indexes and filters
  // the remaining predicate in-row, which gets expensive as TrackedEvent
  // grows into the millions.
  @@index([trackedSiteId, eventType, timestamp])
  // Supports domain-status queries: WHERE trackedSiteId = $1 AND pageUrl LIKE 'https://domain/%'
  // Sargable prefix scan after the contains->startsWith fix for M18.
  // Production deploy: run manually with CONCURRENTLY to avoid table lock.
  @@index([trackedSiteId, pageUrl, timestamp])
  @@index([sessionId])
  // Cross-brand timestamp range queries (admin overview groupBy, retention
  // cron) need this standalone index — without it the WHERE timestamp >= ?
  // query cannot use any index and does a full sequential scan.
  @@index([timestamp])
}

// ─── Data Reconciliation ─────────────────────────────────────────────────────
//
// How it works:
//   1. SourceEvent  — a raw event from ANY source (Site Tag, GA4, GTM, GSC, CRM)
//   2. CanonicalEvent — the deduplicated, reconciled "truth" event
//   3. Each CanonicalEvent links to 1+ SourceEvents that describe the same action
//
// Example:
//   A form_submit might arrive from both Site Tag and GA4.
//   → 2 SourceEvent rows (one per source)
//   → 1 CanonicalEvent row (the reconciled truth, confidence 94%)

model CanonicalEvent {
  id          String   @id @default(cuid())
  eventType   String // "page_view", "form_submit", etc.
  pageUrl     String
  timestamp   DateTime
  confidence  Int      @default(100) // 0-100, how sure we are this is correct
  status      String   @default("verified") // "verified" | "inferred" | "unmatched"
  journeyNote String? // e.g. "Session → Form → CRM lead"
  metadata    Json     @default("{}")
  createdAt   DateTime @default(now())

  trackedSiteId String
  trackedSite   TrackedSite @relation(fields: [trackedSiteId], references: [id], onDelete: Cascade)

  sourceEvents SourceEvent[]

  @@index([trackedSiteId, eventType])
  @@index([trackedSiteId, timestamp])
}

model SourceEvent {
  id          String   @id @default(cuid())
  source      String // "site_tag" | "ga4" | "gtm" | "gsc" | "crm"
  eventType   String
  pageUrl     String
  timestamp   DateTime
  isDuplicate Boolean  @default(false) // true if this was identified as a dupe
  rawData     Json     @default("{}") // original payload from the source
  createdAt   DateTime @default(now())

  trackedSiteId String
  trackedSite   TrackedSite @relation(fields: [trackedSiteId], references: [id], onDelete: Cascade)

  canonicalEventId String?
  canonicalEvent   CanonicalEvent? @relation(fields: [canonicalEventId], references: [id], onDelete: SetNull)

  @@index([trackedSiteId, source])
  @@index([trackedSiteId, isDuplicate])
  @@index([trackedSiteId, timestamp])
  @@index([trackedSiteId, createdAt])
  @@index([canonicalEventId])
}

// ─── Billing & Subscriptions ─────────────────────────────────────────────────
//
// Plan:          defines what a subscription includes (limits, features, price)
// Subscription:  links an Organization to a Plan with status and dates
// OrgPlanUsage:  tracks current usage against plan limits
//
// No Stripe integration yet — this is the internal billing model.

model Plan {
  id              String   @id @default(cuid())
  name            String   @unique // "Free", "Starter", "Pro", "Enterprise"
  slug            String   @unique // "free", "starter", "pro", "enterprise"
  priceMonthly    Int      @default(0) // cents (e.g. 4900 = $49.00)
  billingInterval String   @default("monthly") // "monthly" | "yearly"
  features        Json     @default("{}") // { "ai_avatar": true, "site_tag": true, ... }
  limitBrands     Int      @default(1) // max brands allowed
  limitWebsites   Int      @default(1) // max websites per brand
  limitEvents     Int      @default(1000) // max tracked events per month
  limitUsers      Int      @default(1) // max org members
  isActive        Boolean  @default(true) // false = plan no longer offered
  sortOrder       Int      @default(0) // display order on pricing page
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt

  subscriptions Subscription[]
}

model Subscription {
  id         String    @id @default(cuid())
  status     String    @default("trial") // "active" | "trial" | "canceled" | "past_due"
  startDate  DateTime  @default(now())
  endDate    DateTime? // null = ongoing
  trialEnd   DateTime? // when the trial expires
  canceledAt DateTime? // when the user canceled
  createdAt  DateTime  @default(now())
  updatedAt  DateTime  @updatedAt

  orgId String       @unique // one subscription per org
  org   Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)

  planId String
  plan   Plan   @relation(fields: [planId], references: [id])

  @@index([orgId])
  @@index([status])
}

model OrgPlanUsage {
  id               String    @id @default(cuid())
  brandsUsed       Int       @default(0)
  websitesUsed     Int       @default(0)
  eventsUsed       Int       @default(0) // tracked events this billing period
  usersUsed        Int       @default(0)
  periodStart      DateTime  @default(now()) // start of current billing period
  periodEnd        DateTime? // end of current billing period
  lastCalculatedAt DateTime  @default(now())
  createdAt        DateTime  @default(now())
  updatedAt        DateTime  @updatedAt

  orgId String       @unique // one usage record per org
  org   Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)

  @@index([orgId])
}

// ─── Application Logs ────────────────────────────────────────────────────────
// Simple log table for API requests, errors, and integration events.
// Kept small — auto-prune old entries periodically.

model AppLog {
  id        String   @id @default(cuid())
  level     String // "info" | "warn" | "error"
  source    String // "api" | "collect" | "integration" | "billing" | "avatar"
  message   String
  path      String? // API route path
  userId    String? // who triggered it (if known)
  metadata  Json     @default("{}") // extra context (request body, error stack, etc.)
  createdAt DateTime @default(now())

  @@index([level, createdAt])
  @@index([source, createdAt])
}

// ─── AI Strategist Analysis Jobs ────────────────────────────────────────────

model AnalysisJob {
  id              String    @id @default(cuid())
  type            String    @default("seasonal_performance")
  status          String    @default("queued") // "queued" | "running" | "completed" | "failed"
  prompt          String?
  manualCaveats   Json      @default("[]")
  uploadedNotes   Json      @default("[]")
  selectedSources Json      @default("[]")
  result          Json? // Full Analysis object
  branding        Json? // AnalysisBranding object
  errorMessage    String?
  shareToken      String?   @unique // for shareable links
  shareEnabled    Boolean   @default(false) // must be explicitly enabled
  clientVersion   Json? // polished client-facing snapshot
  clientVersionAt DateTime? // when client version was saved
  hiddenSections  Json      @default("[]") // sections hidden from client view
  createdAt       DateTime  @default(now())
  completedAt     DateTime?

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  userId String?

  @@index([brandId, status])
  @@index([shareToken])
  @@index([brandId, createdAt])
}

// ═══════════════════════════════════════════════════════════════════════════
// PAGE LIFECYCLE INTELLIGENCE
// Real-time page tracking driven by the Site Tag. Every URL a visitor lands
// on gets upserted into PageRecord, with status changes recorded in
// PageStatusChange, redirect chains in RedirectRecord, and day-over-day
// performance (joined from GSC data) in PageDailyMetric.
// ═══════════════════════════════════════════════════════════════════════════

model PageRecord {
  id      String @id @default(cuid())
  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  // Identity
  url     String // relative path: /about, /services/seo
  fullUrl String // absolute: https://example.com/about
  title   String?

  // Lifecycle
  firstSeenAt      DateTime  @default(now())
  lastSeenAt       DateTime  @default(now())
  currentStatus    Int       @default(200)
  isInNav          Boolean   @default(false)
  addedToNavAt     DateTime?
  removedFromNavAt DateTime?

  // Aggregated performance (denormalised from PageDailyMetric for speed)
  totalClicks      Int   @default(0)
  totalImpressions Int   @default(0)
  currentCtr       Float @default(0)
  currentPosition  Float @default(0)
  totalVisits      Int   @default(0) // from Site Tag page_view events

  // Metadata scraped by the Site Tag
  metaDescription String?
  h1              String?
  canonicalUrl    String?
  wordCount       Int?
  // Internal links discovered on this page (JSON array of { href, anchorText })
  internalLinks   Json?

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  statusHistory   PageStatusChange[]
  redirectsToThis RedirectRecord[]   @relation("redirectTarget")
  redirectsFrom   RedirectRecord[]   @relation("redirectSource")
  dailyMetrics    PageDailyMetric[]

  @@unique([brandId, url])
  @@index([brandId, currentStatus])
  @@index([brandId, firstSeenAt])
  @@index([brandId, isInNav])
}

model PageStatusChange {
  id         String     @id @default(cuid())
  pageId     String
  page       PageRecord @relation(fields: [pageId], references: [id], onDelete: Cascade)
  fromStatus Int
  toStatus   Int
  detectedAt DateTime   @default(now())
  note       String?

  @@index([pageId, detectedAt])
}

model RedirectRecord {
  id         String @id @default(cuid())
  brandId    String
  brand      Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)
  sourceUrl  String
  targetUrl  String
  statusCode Int    @default(301)

  sourcePageId String?
  sourcePage   PageRecord? @relation("redirectSource", fields: [sourcePageId], references: [id], onDelete: SetNull)
  targetPageId String?
  targetPage   PageRecord? @relation("redirectTarget", fields: [targetPageId], references: [id], onDelete: SetNull)

  firstSeenAt DateTime @default(now())
  lastSeenAt  DateTime @default(now())
  isActive    Boolean  @default(true)

  @@unique([brandId, sourceUrl, targetUrl])
  @@index([brandId, isActive])
  @@index([targetPageId])
}

model PageDailyMetric {
  id          String     @id @default(cuid())
  pageId      String
  page        PageRecord @relation(fields: [pageId], references: [id], onDelete: Cascade)
  date        DateTime
  clicks      Int        @default(0)
  impressions Int        @default(0)
  ctr         Float      @default(0)
  avgPosition Float      @default(0)
  sessions    Int?
  conversions Int?
  statusCode  Int        @default(200)

  @@unique([pageId, date])
  @@index([pageId, date])
}

// Snapshot of the site's main navigation at a point in time. Used to detect
// links being added to or removed from the nav. One row per ingest; the
// endpoint keeps only the most recent N snapshots per brand.
model NavSnapshot {
  id         String   @id @default(cuid())
  brandId    String
  brand      Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  capturedAt DateTime @default(now())
  // JSON array of { href, anchorText, section? }
  links      Json

  @@index([brandId, capturedAt])
}

// ─── Site Tag Intelligence ────────────────────────────────────────────────────
// Machine Enhancing analytics captured by public/t.js: attribution, form/call
// conversions, heatmaps, RUM/Core Web Vitals, UX signals, SEO snapshots.

// Conversions detected by the Site Tag: form submits (native, HubSpot,
// Typeform, Calendly, etc.), phone clicks (tel: links or phone-pattern
// elements), and bookings. Includes multi-touch attribution rolled up
// from the visitor's touchpoint cookie.
model SiteConversion {
  id                     String   @id @default(cuid())
  brandId                String
  brand                  Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  visitorId              String
  sessionId              String
  conversionType         String // form_submit | phone_call | phone_number_click | calendly | booking
  pageUrl                String
  formId                 String?
  formProvider           String? // native | hubspot | typeform | jotform | calendly | custom
  formFields             Json? // array of field names only (never values)
  detectionMethod        String? // submit_event | fetch_intercept | xhr_intercept | postmessage | mutation_observer | tel_link | phone_pattern
  phoneNumber            String?
  elementLocation        String? // header | footer | sidebar | nav | main_content
  firstTouchChannel      String?
  firstTouchSource       String?
  lastTouchChannel       String?
  lastTouchSource        String?
  touchpoints            Json? // ordered array of touchpoint objects
  assistedChannels       Json? // list of channels that appeared in the journey
  // Revenue attribution. Populated for e-commerce conversions
  // (purchase, purchase_completed, and any other type that carries
  // a money amount in metadata). SUM(conversionValue) drives the
  // ROI calculation on the Cost Center + attribution dashboards,
  // so these live in typed columns rather than the formFields JSON
  // for cheap aggregation. Nullable: non-money conversions
  // (form_submission, phone_call, etc.) leave these blank.
  conversionValue        Float?
  currency               String? // ISO 4217 code (USD, EUR, GBP, ...)
  orderId                String? // e-commerce order/transaction ID from purchase_completed
  // Shopify line items: [{title, quantity, price, variantId}]
  lineItems              Json?
  timestamp              DateTime @default(now())
  // Dedup architecture: when this row is identified as a duplicate
  // of another SiteConversion, this field is set to the id of the
  // surviving (canonical) row. Null = this row is canonical or has
  // not been processed yet. Analytics queries filter WHERE
  // isDuplicateOf IS NULL to get deduped counts.
  isDuplicateOf          String?
  // When a detection method is deprecated (e.g. phone_pattern), rows
  // are marked with the reason rather than deleted. Analytics queries
  // filter WHERE invalidatedReason IS NULL.
  invalidatedReason      String?
  // Channel classification from the rule-based classifier.
  // Populated on write + backfilled for historical rows.
  classifiedChannel      String?
  classificationReason   String?
  classificationEvidence Json?

  // Provider category — coarse grouping used by the Embedded Conversions
  // dashboard (booking, form, sms, chat, checkout, donation, civic, survey).
  // Derived from formProvider at write time; null for pre-categorisation rows.
  providerCategory String?

  // SMS-specific attribution fields. Never contain personal data — only
  // keyword text, shortcode, and consent method classification.
  smsKeyword                String? // e.g. 'JOIN', 'START', 'YES'
  smsShortcode              String? // e.g. '55555', '12345'
  smsConsentMethod          String? // 'explicit_checkbox' | 'keyword_optin' | 'two_step_followup' | 'implicit_form'
  smsFollowupOfConversionId String? // links two-step opt-in to the preceding email conversion
  detectionLatencyMs        Int? // ms from page load to detection — diagnostic
  synthetic                 Boolean @default(false) // true when fired by the test harness (_test=true)
  // Client-generated token tying every re-fire of the same real form
  // submission together. Set by getFormSubmissionId() in t.js using a 30s
  // fixed-from-first sessionStorage window. Nullable so old rows are
  // unaffected. No unique constraint -- dedup is handled in the resolver.
  submissionId              String?
  // Set to true when a framework-specific success signal (CF7 wpcf7mailsent,
  // gform_confirmation_loaded, WPForms confirmation container, Elementor
  // submit_success, etc.) corroborates the submit. Default false preserves
  // all historical rows as unchecked. Used by the requireSuccessConfirmed
  // per-brand gate to tighten which rows count.
  successConfirmed          Boolean @default(false)

  @@index([brandId, timestamp])
  @@index([brandId, conversionType])
  @@index([brandId, isDuplicateOf])
  @@index([brandId, submissionId])
  // Covers the server-side rapid-fire dedup query in /api/site-tag/conversion:
  // WHERE brandId = ? AND sessionId = ? AND pageUrl = ? AND conversionType = ? AND timestamp >= ?
  @@index([brandId, sessionId, pageUrl, conversionType, timestamp])
  // Embedded Conversions dashboard query patterns
  @@index([brandId, providerCategory, timestamp])
  @@index([brandId, pageUrl, providerCategory])
  @@index([brandId, firstTouchChannel, timestamp])
}

// Heatmap / engagement payloads from public/t.js. One row per flush
// (clicks batch, scroll summary, or attention summary).
model HeatmapEvent {
  id                String   @id @default(cuid())
  brandId           String
  brand             Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  visitorId         String?
  sessionId         String?
  pageUrl           String
  eventType         String // clicks | scroll | attention
  events            Json? // array of click points or section entries
  maxScrollPercent  Int?
  milestonesReached Json? // [25, 50, 75, 90, 100]
  timeOnPage        Int? // seconds
  sectionTimes      Json? // { selector → seconds visible }
  pageWidth         Int?
  pageHeight        Int?
  viewportWidth     Int?
  viewportHeight    Int?
  timestamp         DateTime @default(now())

  @@index([brandId, pageUrl, eventType])
  @@index([brandId, eventType, timestamp])
}

// Real-user Core Web Vitals sampled per page load.
model RealUserMetric {
  id         String  @id @default(cuid())
  brandId    String
  brand      Brand   @relation(fields: [brandId], references: [id], onDelete: Cascade)
  pageUrl    String
  lcp        Float?
  cls        Float?
  inp        Float?
  ttfb       Float?
  fcp        Float? // First Contentful Paint (ms) — lab parity with
  // the CrUX CWV bundle. Added so RUM vs lab-score
  // comparisons on the Core Web Intelligence page
  // can render the same five metrics side by side.
  device     String? // mobile | tablet | desktop
  connection String? // 4g | 3g | slow-2g | wifi

  deviceMemory Float? // navigator.deviceMemory (GB) when exposed
  viewportW    Int?
  viewportH    Int?
  timestamp    DateTime @default(now())

  @@index([brandId, pageUrl, timestamp])
  // Cross-brand timestamp range queries (admin overview count) need this
  // — the compound index starting with brandId can't serve a bare
  // WHERE timestamp >= ? predicate.
  @@index([timestamp])
}

// Generic UX / intelligence signal bucket: rage clicks, dead clicks,
// hesitation, exit intent, JS errors, SEO changes, outbound clicks,
// internal search queries, copy events, slow third-party resources.
model SiteEvent {
  id        String   @id @default(cuid())
  brandId   String
  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  visitorId String?
  sessionId String?
  pageUrl   String
  eventType String // rage_click | dead_click | hesitation | exit_intent | js_error | seo_change | outbound_click | search_query | copy_event | slow_resource | third_party_impact
  eventData Json
  timestamp DateTime @default(now())

  @@index([brandId, eventType, timestamp])
  @@index([eventType, timestamp])
  // Hot query in writeConversionSideEffect: WHERE sessionId = ? ORDER BY timestamp DESC.
  // This index went missing from schema (and was therefore dropped by db push), causing a
  // full scan of the ~22GB table. Declared here so future pushes treat it as already-present.
  // Name matches the production index exactly so db push is a no-op against it.
  @@index([sessionId, timestamp], map: "SiteEvent_sessionId_timestamp_idx")
}

// ─── Site Tag Daily Rollup ────────────────────────────────────────────────────
// Pre-aggregated daily totals per brand, written by the site-tag-rollup cron.
// Turns 30-day groupBy scans on TrackedEvent (1M+ rows) into 30-row lookups.

model SiteTagDailyRollup {
  id                 String   @id @default(cuid())
  brandId            String
  brand              Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  // Calendar date this row covers (UTC midnight, one row per brand per day)
  date               DateTime
  pageViews          Int      @default(0)
  sessions           Int      @default(0)
  conversions        Int      @default(0)
  // JSON blobs for top-N breakdowns; small enough to keep in the row
  topPages           Json     @default("[]") // [{ url, views }] top 10
  byReferrer         Json     @default("[]") // [{ source, views }] top 10
  // Extended columns added in Phase 19A.25 for fast sub-summary reads
  conversionsByType  Json? // { "form_submit": 142, "click_to_call": 89, ... }
  conversionsByTier  Json? // { "completed": 200, "intent": 47, "signal": 0 }
  eventCountsByType  Json? // { "page_view": 3520, "session_start": 164, ... }
  outboundClickCount Int      @default(0)
  updatedAt          DateTime @updatedAt

  @@unique([brandId, date])
  @@index([brandId, date])
}

// ─── Page Studio ──────────────────────────────────────────────────────────────
// AI-assisted landing page builder. Pages are stored as JSON section arrays
// so the editor can round-trip them and the renderer can hydrate from the
// section registry without any schema migrations when new block types ship.

model StudioPage {
  id        String   @id @default(cuid())
  brandId   String
  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  title     String
  slug      String
  purpose   String // lead_generation | service | product | event | coming_soon
  sections  Json // array of { id, type, content }
  branding  Json // { primaryColor, secondaryColor, accentColor, fontFamily, logoUrl }
  settings  Json // { metaTitle, metaDescription, ogImage, pageWidth, customScripts }
  status    String   @default("draft") // draft | published | archived
  thumbnail String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@unique([brandId, slug])
  @@index([brandId])
}

// Uploaded brand media (logos, photography, icons, backgrounds) that the
// Page Studio editor can insert into sections. Strictly PNG/JPEG — no SVG
// or other formats to keep the upload path simple and safe.
model BrandAsset {
  id         String   @id @default(cuid())
  brandId    String
  brand      Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  filename   String
  url        String
  type       String // logo | photo | icon | background
  mimeType   String // image/png | image/jpeg
  fileSize   Int
  width      Int?
  height     Int?
  altText    String?
  tags       String[] @default([])
  uploadedAt DateTime @default(now())

  @@index([brandId])
}

// Per-page SEO metadata snapshot from the Site Tag. Upserted on every
// page view — enables detection of accidental noindex, missing meta,
// schema changes, and mixed-content regressions.
model PageSEOSnapshot {
  id              String   @id @default(cuid())
  brandId         String
  brand           Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  pageUrl         String
  title           String?
  metaDescription String?
  canonical       String?
  robots          String?
  h1Count         Int?
  hasSchema       Boolean?
  schemaTypes     Json?
  noindexed       Boolean?
  mixedContent    Boolean?
  detectedAt      DateTime @default(now())

  @@unique([brandId, pageUrl])
}

// ─── Rank Tracking ──────────────────────────────────────────────────────────
// Daily keyword position monitoring. TrackedKeyword holds the target;
// KeywordRanking stores each check result so the UI can chart position
// over time and alert on significant changes.

model TrackedKeyword {
  id        String   @id @default(cuid())
  brandId   String
  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  keyword   String
  location  String   @default("United States")
  device    String   @default("desktop") // desktop | mobile
  targetUrl String?
  tags      String[] @default([])
  isActive  Boolean  @default(true)
  createdAt DateTime @default(now())

  rankings KeywordRanking[]

  @@unique([brandId, keyword, location, device])
  @@index([brandId, isActive])
}

model KeywordRanking {
  id               String         @id @default(cuid())
  trackedKeywordId String
  trackedKeyword   TrackedKeyword @relation(fields: [trackedKeywordId], references: [id], onDelete: Cascade)
  position         Int? // null → not found in top results
  previousPosition Int?
  url              String? // actual URL that ranks
  snippet          String? // SERP snippet text
  searchVolume     Int?
  // SERP features detected on the result page for this query, e.g.
  // ["local_pack","reviews","people_also_ask"]. Populated by DataForSEO
  // checks; empty for GSC backfill rows (GSC doesn't expose features).
  serpFeatures     String[]       @default([])
  // Top 5 organic competitors on the same SERP — captured at check time
  // so the UI can render "who outranks you" without a second API call.
  // Stored as JSON: [{ domain, position, url, title }].
  competitors      Json           @default("[]")
  // Where the row came from:
  //   "dataforseo"    — live daily rank check (default for new rows)
  //   "google_cse"    — Google Custom Search fallback when DataForSEO isn't configured
  //   "gsc_backfill"  — inferred from GscQuery historical data on keyword add
  // UI renders backfill rows with a dashed line to signal they're from a
  // different source with different accuracy characteristics (GSC's
  // avgPosition is impression-weighted; DataForSEO is a raw SERP lookup).
  source           String         @default("dataforseo")
  checkedAt        DateTime       @default(now())

  @@index([trackedKeywordId, checkedAt])
  @@index([trackedKeywordId, position])
}

// ─── Automated Email Reports ────────────────────────────────────────────────
// Schedule-driven intelligence reports assembled from all platform data
// sources, optionally enriched with Claude AI analysis + competitor scans.

model EmailReportSchedule {
  id                    String    @id @default(cuid())
  brandId               String
  brand                 Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  name                  String
  frequency             String // daily | weekly | biweekly | monthly
  dayOfWeek             Int? // 0-6 (0=Sunday) for weekly/biweekly
  dayOfMonth            Int? // 1-28 for monthly
  timeOfDay             String    @default("08:00") // HH:mm UTC
  recipients            String[]
  sections              String[]
  includeAiAnalysis     Boolean   @default(true)
  includeCompetitorScan Boolean   @default(false)
  includeMarketInsights Boolean   @default(false)
  isActive              Boolean   @default(true)
  lastSentAt            DateTime?
  nextSendAt            DateTime?
  createdAt             DateTime  @default(now())
  updatedAt             DateTime  @updatedAt

  sentReports SentEmailReport[]

  @@index([brandId])
  @@index([nextSendAt, isActive])
}

model SentEmailReport {
  id          String              @id @default(cuid())
  scheduleId  String
  schedule    EmailReportSchedule @relation(fields: [scheduleId], references: [id], onDelete: Cascade)
  brandId     String
  recipients  String[]
  subject     String
  htmlContent String // @db.Text — large content
  reportData  Json
  status      String // sent | failed | bounced
  error       String?
  sentAt      DateTime            @default(now())

  @@index([scheduleId, sentAt])
  @@index([brandId, sentAt])
}

// ─── White-Label Client Portal ──────────────────────────────────────────────
// Per-brand portal that exposes a limited, agency-branded view of
// the platform to clients. Authenticated via magic links, not Clerk.

model ClientPortal {
  id                     String    @id @default(cuid())
  brandId                String    @unique
  brand                  Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  isEnabled              Boolean   @default(false)
  agencyName             String?
  agencyLogo             String?
  agencyFavicon          String?
  primaryColor           String?
  accentColor            String?
  customDomain           String?
  // Custom-domain verification state. Populated when the agency
  // starts the custom-domain add flow; middleware host-routing only
  // activates once customDomainStatus === "verified". DnsTarget is
  // the CNAME the agency points their domain at.
  customDomainStatus     String? // pending | verified | failed | null
  customDomainVerifiedAt DateTime?
  customDomainDnsTarget  String?
  // White-label outgoing email. When replyToEmail is set, invite and
  // scheduled-report emails use the agency name as From and route
  // replies to this inbox. supportEmail is shown in email footers.
  replyToEmail           String?
  supportEmail           String?
  allowedPages           String[]  @default(["dashboard", "report", "rankings", "conversions", "audit_summary"])
  portalConfig           Json? // granular { pages: { dashboard: { enabled, sections }, ... } }
  hideSourceBranding     Boolean   @default(true)
  createdAt              DateTime  @default(now())
  updatedAt              DateTime  @updatedAt

  clientUsers ClientUser[]
}

model ClientUser {
  id             String       @id @default(cuid())
  portalId       String
  portal         ClientPortal @relation(fields: [portalId], references: [id], onDelete: Cascade)
  email          String
  name           String?
  role           String       @default("viewer") // viewer | editor | admin
  permissions    Json? // granular overrides: { canExportReports: true, ... }
  // Per-client page-visibility overrides. When null, the portal's
  // portalConfig (default for all clients) applies. When set, the
  // shape is the same as ClientPortal.portalConfig and fully
  // replaces the default for this user.
  pageOverrides  Json?
  // Lifecycle status beyond isActive. "pending" means invited but
  // hasn't signed in yet; flips to "active" on first magic-link
  // verification. "disabled" / "revoked" hide the user from the
  // portal without deleting the row (preserves audit log FKs).
  status         String       @default("pending") // pending | active | disabled | revoked
  invitedAt      DateTime? // when the first invite was sent
  lastLoginAt    DateTime?
  isActive       Boolean      @default(true)
  accessToken    String?      @unique
  tokenExpiresAt DateTime?
  createdAt      DateTime     @default(now())

  @@unique([portalId, email])
  @@index([accessToken])
  @@index([portalId, status])
}

model PortalAuditLog {
  id           String   @id @default(cuid())
  portalId     String
  clientUserId String
  action       String // login | view_dashboard | export_report | reply_review | share_report | request_analysis
  details      Json?
  ipAddress    String?
  timestamp    DateTime @default(now())

  @@index([portalId, timestamp])
  @@index([clientUserId, timestamp])
}

// ─── Platform Admin ─────────────────────────────────────────────────────────

model PlatformLog {
  id         String   @id @default(cuid())
  level      String // error | warn | info | debug
  source     String // api_route | cron | sync | ai_call | site_tag
  message    String
  details    Json?
  userId     String?
  brandId    String?
  endpoint   String?
  duration   Int?
  statusCode Int?
  timestamp  DateTime @default(now())

  @@index([level, timestamp])
  @@index([source, timestamp])
  @@index([brandId, timestamp])
}

model AiUsageLog {
  id            String   @id @default(cuid())
  brandId       String?
  userId        String?
  provider      String // anthropic | openai
  model         String
  feature       String // ai_strategist | content_brief | keyword_research | email_report | page_studio | competitor_analysis | industry_intel | humanization | rewrite
  inputTokens   Int
  outputTokens  Int
  estimatedCost Float
  duration      Int?
  timestamp     DateTime @default(now())

  @@index([brandId, timestamp])
  @@index([feature, timestamp])
  @@index([timestamp])
}

// ─── Compliance Event Log ────────────────────────────────────────────────────
// Immutable audit trail for every compliance-relevant action:
// data deletions (right-to-deletion / GDPR Article 17), data
// exports (Article 15), retention-policy changes, healthcare-mode
// toggles, DPA sign events, scheduled-purge runs.
//
// Rows are append-only — no UI delete button, no admin
// "edit" path. Exportable as CSV for regulator review.

model ComplianceEvent {
  id          String   @id @default(cuid())
  // Action key. Stable string — the Compliance dashboard groups by
  // this. Examples:
  //   right_to_deletion | data_export | data_purge_run |
  //   retention_policy_change | healthcare_mode_change |
  //   dpa_signed | dpa_revoked | consent_mode_change
  action      String
  // Optional brand scope. Platform-wide actions (e.g. retention
  // policy default change) leave this null.
  brandId     String?
  // Optional user identifier in the action (email or sessionId for
  // right-to-deletion / data-export). Stored verbatim — already PII
  // by definition; this is the audit trail FOR PII handling.
  identifier  String?
  // Counts produced by the action: { events, sessions, conversions,
  // siteEvents, ... }. Free-form so new action types can include
  // their own breakdowns without a schema change.
  details     Json?
  // Who triggered it (admin Clerk userId, or "cron" / "system").
  requestedBy String
  ipAddress   String?
  timestamp   DateTime @default(now())

  @@index([brandId, timestamp])
  @@index([action, timestamp])
  @@index([timestamp])
}

// ─── Platform Telemetry ─────────────────────────────────────────────────────
// Every significant user action across the platform lands here. Admin
// analytics (engagement, stickiness, feature adoption) and the real-
// time activity feed read from this table. trackEvent() in
// src/lib/services/platform-telemetry.ts is the fire-and-forget write
// path; it's non-blocking so it never slows a user request.

model PlatformEvent {
  id        String   @id @default(cuid())
  userId    String? // Clerk user id, null for anonymous/system events
  brandId   String? // brand context when applicable
  // Dotted action key, e.g. "audit_started", "report_generated",
  // "page_view". Stable over time — analytics key off this.
  action    String
  // High-level bucket for grouping in the admin UI:
  // navigation | search | audit | report | integration | content |
  // ai | export | settings | auth | admin
  category  String
  // Arbitrary JSON payload: { path, status, elapsedMs, ... }
  metadata  Json?
  ipAddress String?
  userAgent String?
  timestamp DateTime @default(now())

  @@index([userId, timestamp])
  @@index([brandId, timestamp])
  @@index([category, timestamp])
  @@index([action, timestamp])
  @@index([timestamp])
}

// ─── AI Interaction Log (guardrail monitoring) ──────────────────────────────
// Richer than AiUsageLog: stores the full prompt + response + any
// guardrail flags so the /admin/ai-monitor surface can audit what
// the models said, flag risky outputs, and enforce per-user /
// per-brand usage caps. AiUsageLog stays the source of truth for
// token/cost accounting; this table is the audit surface.

model AiInteraction {
  id             String   @id @default(cuid())
  userId         String? // Clerk user id, null for system calls (crons)
  brandId        String?
  // Feature dotted key: ai_strategist | content_brief | llmo_brief |
  // schema_gen | industry_intel | competitor_discovery |
  // content_recommendations | report_studio | email_report | topic_map
  feature        String
  // User's typed prompt (or composed system+user for non-chat
  // features like content brief generation). Truncated at 4KB.
  userPrompt     String   @db.Text
  // Full system prompt sent to the model. Stored for audit.
  systemPrompt   String?  @db.Text
  // Full model response text. Truncated at 16KB.
  aiResponse     String   @db.Text
  model          String // claude-opus-4-6 | gpt-4o | etc.
  tokensUsed     Int?
  costEstimate   Float?
  // Flat list of guardrail flag keys that matched:
  // ["pii_detected", "medical_advice", "prompt_injection"].
  guardrailFlags String[] @default([])
  // Worst-severity of the above: none | warning | critical | blocked.
  flagSeverity   String   @default("none")
  timestamp      DateTime @default(now())

  @@index([userId, timestamp])
  @@index([brandId, timestamp])
  @@index([feature, timestamp])
  @@index([flagSeverity, timestamp])
  @@index([timestamp])
}

// ─── Platform Snapshot (monthly metrics archive) ────────────────────────────
// Monthly snapshot of platform-wide metrics, written by a cron on
// the 1st of each month. Powers the exit-ready metrics dashboard +
// month-over-month comparisons in /admin/analytics.

model PlatformSnapshot {
  id           String   @id @default(cuid())
  // YYYY-MM-01 UTC — the first day of the snapshotted month.
  snapshotDate DateTime @unique
  // Full metric payload: DAU, WAU, MAU, churn, feature adoption,
  // total events, API spend, DB size, etc. Shape documented in
  // src/lib/services/platform-snapshot.ts.
  metrics      Json
  createdAt    DateTime @default(now())

  @@index([snapshotDate])
}

// ─── Keyword Research ───────────────────────────────────────────────────────
// Cached keyword research results from DataForSEO or AI fallback.

model KeywordResearch {
  id          String   @id @default(cuid())
  brandId     String
  brand       Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  seedKeyword String
  location    String   @default("United States")
  language    String   @default("en")
  results     Json
  aiAnalysis  Json?
  createdAt   DateTime @default(now())

  @@index([brandId, seedKeyword])
  @@index([brandId, createdAt])
}

model SavedKeyword {
  id           String   @id @default(cuid())
  brandId      String
  brand        Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  keyword      String
  searchVolume Int?
  difficulty   Int?
  cpc          Float?
  competition  String?
  trend        Json?
  intent       String?
  source       String // dataforseo | ai_estimated
  tags         String[] @default([])
  group        String? // AI-assigned topic cluster
  priority     String? // high | medium | low — AI-assigned
  savedAt      DateTime @default(now())

  @@unique([brandId, keyword])
  @@index([brandId])
}

// ─── Customizable Layouts ───────────────────────────────────────────────────
// Per-brand, per-page saved widget configurations. Users can create
// named layouts ("CEO View", "Client Review") that persist the widget
// order, visibility, and sizing.

model SavedLayout {
  id        String   @id @default(cuid())
  brandId   String
  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  page      String // dashboard | report_studio | conversion_intelligence
  name      String
  widgets   Json // WidgetConfig[]
  isDefault Boolean  @default(false)
  createdBy String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([brandId, page])
}

// ─── Industry Intelligence ─────────────────────────────────────────���────────
// AI-generated daily market briefings correlating external events
// (weather, regulations, seasonal patterns, competitor moves, algorithm
// updates) with the brand's actual performance data.

model IndustryBriefing {
  id                     String   @id @default(cuid())
  brandId                String
  brand                  Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  industry               String
  locations              Json
  period                 String // daily | weekly
  summary                String?
  marketTrends           Json?
  externalEvents         Json?
  seasonalInsights       Json?
  competitorActivity     Json?
  searchTrends           Json?
  performanceCorrelation Json?
  predictions            Json?
  sources                Json?
  generatedAt            DateTime @default(now())

  @@index([brandId, generatedAt])
  @@index([industry, generatedAt])
}

model IndustryBenchmark {
  id         String   @id @default(cuid())
  industry   String
  location   String?
  metric     String
  value      Float
  sampleSize Int
  period     String
  computedAt DateTime @default(now())

  @@unique([industry, location, metric, period])
  @@index([industry, metric])
}

// ─── Backlink Monitoring ────────────────────────────────────────────────────

model Backlink {
  id              String    @id @default(cuid())
  brandId         String
  brand           Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  sourceDomain    String
  sourceUrl       String
  targetUrl       String
  anchorText      String?
  linkType        String? // dofollow | nofollow | ugc | sponsored
  context         String?
  position        String? // header | footer | content | sidebar | navigation
  domainAuthority Int?
  relevanceScore  Int?
  toxicityScore   Int?
  // Bucket label mirroring calculateToxicityScore's 5-tier output:
  // "Healthy" | "Low Risk" | "Moderate Risk" | "High Risk" | "Toxic".
  // Legacy AI-scored rows may still carry excellent/good/neutral/poor/toxic —
  // the UI normalises both shapes via toxicityBadge().
  qualityTier     String?
  // Human-readable heuristics that fired for this link — surfaced in the
  // Toxic Panel's expandable "Why is this toxic?" section and embedded
  // as comments in the generated Google disavow file.
  toxicityReasons String[]  @default([])
  status          String    @default("active") // active | lost | new | disavowed
  firstSeenAt     DateTime  @default(now())
  lastSeenAt      DateTime
  lostAt          DateTime?

  @@unique([brandId, sourceUrl, targetUrl])
  @@index([brandId, status])
  @@index([brandId, sourceDomain])
  @@index([brandId, toxicityScore])
}

model BacklinkSnapshot {
  id                 String   @id @default(cuid())
  brandId            String
  brand              Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  totalBacklinks     Int
  totalDomains       Int
  newBacklinks       Int
  lostBacklinks      Int
  avgDomainAuthority Float?
  toxicCount         Int?
  snapshotDate       DateTime @default(now())

  @@index([brandId, snapshotDate])
}

// ─── Automated Alerts + Notifications ───────────────────────────────────────

model AlertRule {
  id              String    @id @default(cuid())
  brandId         String
  brand           Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  name            String
  type            String // traffic_drop | rank_change | new_review | site_error | competitor_change | conversion_drop | page_404 | audit_health | backlink_alert | custom
  condition       Json
  channels        String[] // email | in_app | sms
  recipients      String[]
  smsRecipients   String[]  @default([])
  severity        String    @default("medium")
  isActive        Boolean   @default(true)
  cooldownMinutes Int       @default(60)
  lastFiredAt     DateTime?
  createdAt       DateTime  @default(now())

  notifications Notification[]

  @@index([brandId, isActive])
  @@index([type])
}

model SmsOptIn {
  id            String    @id @default(cuid())
  userId        String    @unique
  phone         String
  isVerified    Boolean   @default(false)
  verifyCode    String?
  codeExpiresAt DateTime?
  optedInAt     DateTime?
  optedOutAt    DateTime?
  isActive      Boolean   @default(false)
  createdAt     DateTime  @default(now())

  @@index([phone])
}

// ─── Predictive Modeling ────────────────────────────────────────────────────

model Prediction {
  id             String   @id @default(cuid())
  brandId        String
  brand          Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  type           String // traffic_forecast | conversion_forecast | rank_forecast | scenario
  metric         String // clicks | sessions | conversions | position
  currentValue   Float
  predictedValue Float
  confidence     String // high | medium | low
  timeframe      Int // days forward
  assumptions    Json
  scenarioName   String?
  createdAt      DateTime @default(now())

  @@index([brandId, type])
}

model EmailUnsubscribe {
  id        String   @id @default(cuid())
  brandId   String
  email     String
  reason    String?
  createdAt DateTime @default(now())

  @@unique([brandId, email])
}

// ─── First-Party Data Engine ────────────────────────────────────────────────

model RecommendationOutcome {
  id                 String    @id @default(cuid())
  brandId            String
  brand              Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  recommendationId   String?
  recommendationType String
  industry           String
  description        String
  targetMetric       String
  metricBefore       Float?
  measuredAt         DateTime
  metricAfter        Float?
  measuredAfterAt    DateTime?
  implemented        Boolean   @default(false)
  implementedAt      DateTime?
  outcome            String? // improved | declined | unchanged | unknown
  impactPercent      Float?
  createdAt          DateTime  @default(now())

  @@index([industry, recommendationType, outcome])
  @@index([brandId])
}

model ClientMemory {
  id        String   @id @default(cuid())
  brandId   String
  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  userId    String?
  category  String // analysis | chat | report | content_brief | audit | rank_check | page_build | keyword_research | competitor_analysis | settings_change
  action    String // generated | viewed | exported | created | deleted | updated
  summary   String
  details   Json?
  aiContext String?
  timestamp DateTime @default(now())

  @@index([brandId, category, timestamp])
  @@index([brandId, timestamp])
}

// ─── Schema Markup Generator ────────────────────────────────────────────────

model SchemaMarkup {
  id         String   @id @default(cuid())
  brandId    String
  brand      Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  pageUrl    String
  schemaType String
  jsonLd     Json
  status     String   @default("draft") // draft | deployed | verified
  autoInject Boolean  @default(false)
  createdAt  DateTime @default(now())
  updatedAt  DateTime @updatedAt

  @@index([brandId, pageUrl])
  @@index([brandId, schemaType])
}

// ─── Writing Assistant ──────────────────────────────────────────────────────

model WritingDocument {
  id                String   @id @default(cuid())
  brandId           String
  brand             Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  title             String
  content           String   @db.Text
  plainText         String?  @db.Text
  targetKeyword     String?
  secondaryKeywords String[]
  briefId           String?
  seoScore          Int?
  llmoScore         Int?
  humanScore        Int?
  grade             String?
  wordCount         Int?
  status            String   @default("draft")
  createdAt         DateTime @default(now())
  updatedAt         DateTime @updatedAt

  @@index([brandId, updatedAt])
}

// ─── Content Audit ──────────────────────────────────────────────────────────

model ContentAuditResult {
  id         String   @id @default(cuid())
  brandId    String
  brand      Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  totalPages Int
  results    Json
  aiSummary  String?  @db.Text
  createdAt  DateTime @default(now())

  @@index([brandId, createdAt])
}

// ─── Audit Score History ────────────────────────────────────────────────────

model AuditScoreHistory {
  id           String   @id @default(cuid())
  brandId      String
  brand        Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  healthScore  Int
  errorCount   Int
  warningCount Int
  infoCount    Int
  totalIssues  Int
  auditedAt    DateTime @default(now())

  @@index([brandId, auditedAt])
}

// ─── AI Visibility (LLMO / AEO Monitoring) ──────────────────────────────────

model AiVisibilityCheck {
  id           String   @id @default(cuid())
  brandId      String
  brand        Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  query        String
  platform     String // chatgpt, perplexity, gemini, claude
  mentioned    Boolean  @default(false)
  position     Int?
  context      String?  @db.Text
  fullResponse String?  @db.Text
  sentiment    String? // positive, neutral, negative
  competitors  Json?
  checkedAt    DateTime @default(now())

  @@index([brandId, query, platform])
  @@index([brandId, checkedAt])
}

model AiVisibilityQuery {
  id             String   @id @default(cuid())
  brandId        String
  brand          Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  query          String
  category       String? // service, comparison, location, general
  intent         String? // informational, commercial, local, transactional
  targetLocation String? // city, neighborhood, or state anchor used in the query
  isActive       Boolean  @default(true)
  createdAt      DateTime @default(now())

  @@unique([brandId, query])
  @@index([brandId, isActive])
}

// ─── Enrichment Files (uploaded brand documents) ────────────────────────────

model EnrichmentFile {
  id               String   @id @default(cuid())
  brandId          String
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  fileName         String
  fileType         String // document, whitepaper, pdf
  mimeType         String
  fileSize         Int
  fileUrl          String
  extractedText    String?  @db.Text
  processingStatus String   @default("pending") // pending, processing, ready, failed
  processingError  String?
  uploadedAt       DateTime @default(now())

  @@index([brandId, processingStatus])
}

// ─── AI Strategist Chat Sessions ───────────────────────────────────────────

model StrategistSession {
  id        String              @id @default(cuid())
  brandId   String
  brand     Brand               @relation(fields: [brandId], references: [id], onDelete: Cascade)
  userId    String
  title     String              @default("New Chat")
  createdAt DateTime            @default(now())
  updatedAt DateTime            @updatedAt
  messages  StrategistMessage[]

  @@index([brandId, userId, updatedAt])
}

model StrategistMessage {
  id        String            @id @default(cuid())
  sessionId String
  session   StrategistSession @relation(fields: [sessionId], references: [id], onDelete: Cascade)
  role      String // "user" | "assistant"
  content   String
  artifacts Json? // Array of { title, type, code } — null for user messages
  createdAt DateTime          @default(now())

  @@index([sessionId, createdAt])
}

// ═══════════════════════════════════════════════════════════════════
// PAID MEDIA ATTRIBUTION — Phase 1 (2026-04)
// ═══════════════════════════════════════════════════════════════════
//
// Visitor identity graph, household clustering, ad-platform
// integration, campaign data sync, click matching, and multi-touch
// attribution paths. Together these let the platform correlate paid
// media spend → Site Tag behavioural events → conversions at a level
// of detail that dedicated attribution vendors (AiTRK, LiveRamp,
// TripleWhale) can't match because they don't see what happens on
// the site.

// ─── Visitor Profile ────────────────────────────────────────────
// Aggregated per-visitor record built from TrackedSession +
// SiteConversion data. The visitorId is the localStorage UUID that
// t.js sets on first visit — it persists across sessions (legal,
// first-party, no cookies). This model is a READ CACHE: a cron or
// on-demand rebuild re-aggregates from the source tables. The raw
// data in TrackedSession + SiteConversion stays the source of truth.

model VisitorProfile {
  id                String   @id @default(cuid())
  brandId           String
  brand             Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  visitorId         String // localStorage UUID from t.js
  firstSeenAt       DateTime
  lastSeenAt        DateTime
  totalSessions     Int      @default(0)
  totalPageViews    Int      @default(0)
  totalConversions  Int      @default(0)
  devices           Json     @default("[]") // array of { device, browser, os } combos
  ipAddresses       Json     @default("[]") // array of IPs seen (for household inference)
  channelHistory    Json     @default("[]") // array of { channel, source, medium, date }
  conversionHistory Json     @default("[]") // array of { type, pageUrl, date, value? }
  topPages          Json     @default("[]") // most-visited pages
  updatedAt         DateTime @updatedAt

  @@unique([brandId, visitorId])
  @@index([brandId, lastSeenAt])
  @@index([brandId, totalConversions])
}

// ─── Household Cluster ──────────────────────────────────────────
// Probabilistic household grouping using IP subnet (/24 network) +
// city. NOT an address lookup — the same inference every DSP and
// LiveRamp use. Legal under CCPA with disclosure. Used to answer
// "how many unique households convert?" and "what's the cross-device
// journey within a household?"

model HouseholdCluster {
  id              String   @id @default(cuid())
  brandId         String
  brand           Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  ipSubnet        String // first 3 octets, e.g. "192.168.1"
  city            String?
  region          String?
  visitorIds      Json     @default("[]") // array of visitorId strings
  deviceCount     Int      @default(0)
  sessionCount    Int      @default(0)
  conversionCount Int      @default(0)
  confidence      String   @default("low") // low | medium | high
  firstSeenAt     DateTime @default(now())
  lastSeenAt      DateTime @default(now())
  updatedAt       DateTime @updatedAt

  @@unique([brandId, ipSubnet, city])
  @@index([brandId, confidence])
  @@index([brandId, conversionCount])
}

// ─── Ad Platform Integration ────────────────────────────────────
// OAuth credentials + sync state for each connected ad platform.
// One row per (brand, platform). Credentials are encrypted at rest
// via the same vault pattern BrandIntegration uses for GA4/GSC.

model AdPlatformIntegration {
  id          String    @id @default(cuid())
  brandId     String
  brand       Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  platform    String // google_ads | meta | linkedin | tiktok | microsoft_ads | the_trade_desk
  credentials Json? // encrypted OAuth tokens (access, refresh, expiry)
  accountId   String? // platform-specific account/customer ID
  status      String    @default("pending") // pending | connected | error | expired
  lastSyncAt  DateTime?
  syncError   String?
  createdAt   DateTime  @default(now())
  updatedAt   DateTime  @updatedAt

  @@unique([brandId, platform])
  @@index([brandId, status])
}

// ─── Ad Campaign Data ───────────────────────────────────────────
// Daily campaign-level performance pulled from connected ad
// platforms. One row per (brand, platform, campaign, adGroup, ad,
// date). Drives the "Campaign Performance" tab and the spend-side
// of ROAS calculations.

model AdCampaignData {
  id                  String   @id @default(cuid())
  brandId             String
  brand               Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  platform            String // google_ads | meta | linkedin | tiktok | microsoft_ads | the_trade_desk
  campaignId          String
  campaignName        String
  adGroupId           String?
  adGroupName         String?
  adId                String?
  adName              String?
  date                DateTime @db.Date
  impressions         Int      @default(0)
  clicks              Int      @default(0)
  spend               Float    @default(0) // in the brand's billing currency
  platformConversions Int      @default(0) // what the ad platform claims
  currency            String   @default("USD")
  createdAt           DateTime @default(now())

  @@unique([brandId, platform, campaignId, date])
  @@index([brandId, platform, date])
  @@index([brandId, date])
}

// ─── Ad Click Event ─────────────────────────────────────────────
// One row per ad-click landing. Created when t.js fires a
// paid_click_landing event (gclid/fbclid/etc present in the URL).
// The server-side matcher runs async to link the click to the
// TrackedSession + VisitorProfile.

model AdClickEvent {
  id               String   @id @default(cuid())
  brandId          String
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  clickId          String // gclid | fbclid | msclkid | ttclid | li_fat_id | dclid | wbraid | gbraid
  platform         String // google_ads | meta | linkedin | tiktok | microsoft_ads | google_dv360
  campaignId       String? // populated when campaign data is synced
  adGroupId        String?
  adId             String?
  landingPage      String
  timestamp        DateTime @default(now())
  matched          Boolean  @default(false)
  matchedSessionId String? // TrackedSession.sessionId when matched
  matchedVisitorId String? // VisitorProfile.visitorId when matched

  @@unique([brandId, clickId])
  @@index([brandId, platform, timestamp])
  @@index([brandId, matched])
}

// ─── Attribution Path ───────────────────────────────────────────
// One row per conversion. Records the full multi-touch journey
// from first interaction to conversion. Built by the attribution
// service from TrackedSession + SiteConversion + AdClickEvent data.
// Powers the Attribution tab's path analysis, assisted-conversion
// counts, and channel-comparison visualisations.

model AttributionPath {
  id                            String   @id @default(cuid())
  brandId                       String
  brand                         Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  conversionId                  String // SiteConversion.id
  visitorId                     String // VisitorProfile.visitorId
  conversionType                String // canonical conversion type
  conversionValue               Float? // revenue if available
  touchpoints                   Json // ordered array of { sessionId, channel, source, medium, campaign, adClickId?, timestamp, eventsInSession[] }
  touchpointCount               Int      @default(1)
  firstTouchChannel             String?
  lastTouchChannel              String?
  convertingChannel             String? // channel of the session where the conversion happened
  daysBetweenFirstAndConversion Int      @default(0)
  createdAt                     DateTime @default(now())

  @@unique([brandId, conversionId])
  @@index([brandId, createdAt])
  @@index([brandId, firstTouchChannel])
  @@index([brandId, convertingChannel])
}

// ─── OTT / CTV Impressions ──────────────────────────────────────
// Fed from ad platform integrations (The Trade Desk, Roku, etc.).
// Each row is one OTT ad impression delivered to a smart TV.
// The matching service connects the impression to a web visit via
// IP subnet (/24) + city — the same probabilistic household
// inference the HouseholdCluster model uses.

model OttImpression {
  id               String   @id @default(cuid())
  brandId          String
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  campaignId       String?
  campaignName     String?
  platform         String // roku | hulu | samsung_tv | peacock | tubi | the_trade_desk
  deviceId         String? // OTT device identifier from the platform
  ipAddress        String? // household IP at time of impression
  ipSubnet         String? // /24 subnet for matching
  city             String?
  region           String?
  impressionAt     DateTime
  matched          Boolean  @default(false)
  matchedVisitorId String?
  matchedSessionId String?

  @@index([brandId, ipSubnet, impressionAt])
  @@index([brandId, matched])
  @@index([brandId, platform, impressionAt])
}

// ─── LLMO / GEO / AEO Attribution ────────────────────────────────────────────
// Patent-pending AI attribution system. Tracks the full journey from AI
// platform citation → click → engagement → conversion → outcome.

model AiAttribution {
  id                  String    @id @default(cuid())
  brandId             String
  brand               Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  sessionId           String
  channel             String // "llmo" | "geo" | "aeo"
  aiPlatform          String? // "chatgpt" | "perplexity" | "gemini" | "copilot" | "claude" | "google_ai_overview" | etc.
  referrerUrl         String?
  queryContext        String?
  landingPage         String
  pagesViewed         Int       @default(1)
  sessionDuration     Int?
  maxScrollDepth      Float?
  engagementScore     Float?
  converted           Boolean   @default(false)
  conversionType      String?
  conversionPage      String?
  conversionId        String?
  conversionTimestamp DateTime?
  leadType            String?
  dealValue           Float?
  dealStatus          String?
  outcomeUpdatedAt    DateTime?
  timestamp           DateTime  @default(now())
  updatedAt           DateTime  @updatedAt

  @@index([brandId, timestamp])
  @@index([brandId, channel])
  @@index([brandId, aiPlatform])
  @@index([brandId, converted])
  @@index([sessionId])
}

model AiCitation {
  id               String   @id @default(cuid())
  brandId          String
  brand            Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  keyword          String
  searchEngine     String   @default("google")
  citationType     String // "ai_overview" | "featured_snippet" | "people_also_ask" | "llm_citation"
  channel          String // "llmo" | "geo" | "aeo"
  brandCited       Boolean  @default(false)
  citedUrl         String?
  citedPosition    Int?
  citedSnippet     String?
  competitorsCited Json?
  checkedAt        DateTime

  @@unique([brandId, keyword, searchEngine, checkedAt])
  @@index([brandId, keyword])
  @@index([brandId, checkedAt])
  @@index([brandId, channel])
}

// ─── AI Recommendations (Phase 4) ──────────────────────────────────────────
// Stores prioritised, data-backed recommendations generated by the
// AI Strategy Engine. Each recommendation is auditable — the raw data
// that produced it is captured in dataPoints.

model AiRecommendation {
  id              String    @id @default(cuid())
  brandId         String
  brand           Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  type            String // format_replication | citation_gap | competitive_alert | conversion_optimization | content_expansion | schema_fix | query_expansion | content_brief_trigger
  priority        String // critical | high | medium | low
  status          String    @default("pending") // pending | in_progress | completed | dismissed
  title           String
  insight         String
  action          String
  impact          String?
  dataPoints      Json
  relatedPages    Json?
  relatedKeywords Json?
  contentBriefId  String?
  completedAt     DateTime?
  dismissedAt     DateTime?
  createdAt       DateTime  @default(now())
  updatedAt       DateTime  @updatedAt

  @@index([brandId, status])
  @@index([brandId, type])
  @@index([brandId, priority, createdAt])
}

// ─── Admin: Cron + Error Logs ──────────────────────────────────────────────

model CronLog {
  id        String   @id @default(cuid())
  route     String
  status    String // success | error
  duration  Int // ms
  details   String?
  startedAt DateTime @default(now())

  @@index([route, startedAt])
}

model ErrorLog {
  id        String   @id @default(cuid())
  route     String
  method    String
  status    Int
  message   String
  stack     String?
  brandId   String?
  userId    String?
  createdAt DateTime @default(now())

  @@index([createdAt])
  @@index([route])
}

// ─── Dashboard Snapshot ────────────────────────────────────────────────────
// Precomputed dashboard KPI payloads. The cron writes one row per
// brand per range every 30 minutes so the dashboard page can load
// instantly from the snapshot and refresh in the background.

model DashboardSnapshot {
  id         String   @id @default(cuid())
  brandId    String
  brand      Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
  range      String // "today" | "7d" | "28d" | "90d"
  payload    Json
  computedAt DateTime @default(now())

  @@unique([brandId, range])
  @@index([brandId, range])
}

// ─── Brand Health Alerting ────────────────────────────────────────────────────

model BrandHealthAlert {
  id                       String    @id @default(cuid())
  brandId                  String
  brand                    Brand     @relation(fields: [brandId], references: [id], onDelete: Cascade)
  status                   String // "degraded" | "down" | "resolved"
  firstDetectedAt          DateTime  @default(now())
  alertSentAt              DateTime?
  resolvedAt               DateTime?
  expectedRate             Float
  actualRate               Float
  dropPct                  Float
  consecutiveHoursDegraded Int       @default(1)
  lastCheckedAt            DateTime  @default(now())
  createdAt                DateTime  @default(now())
  updatedAt                DateTime  @updatedAt

  @@index([brandId, status])
  @@index([status, firstDetectedAt])
}

// ─── Audit Engine ─────────────────────────────────────────────────────────────
// Powers both 3rd-party lead-gen audits and 1st-party onboarding audits.
// A single record tracks the full lifecycle from trigger to report.

model Audit {
  id      String  @id @default(cuid())
  brandId String?
  brand   Brand?  @relation(fields: [brandId], references: [id])

  // Requester context (for 3rd-party / anonymous audits)
  requesterEmail       String?
  requestedBrandName   String?
  requestedWebsite     String?
  requestedCompetitors String[] @default([])
  requestedLocations   String[] @default([])
  requestedServices    String[] @default([])
  isLocal              Boolean  @default(false)

  auditType String // "third-party" | "first-party"
  source    String @default("admin") // "admin" | "public" | "embed"
  auditMode String @default("auto") // "auto" | "first-party" | "third-party"
  status    String // "queued" | "running" | "completed" | "failed"

  // Tiered progress
  currentTier               Int     @default(0)
  totalTiers                Int     @default(7)
  currentTierLabel          String?
  tiersCompleted            Json?
  estimatedSecondsRemaining Int?

  // Granular progress (step-level, written by runner)
  progressStep    Int      @default(0)
  progressLabel   String?
  progressDetail  String?
  siteTagDetected Boolean?

  // Report sections (populated as they complete)
  seoSection    Json?
  llmoSection   Json?
  geoSection    Json?
  aeoSection    Json?
  socialSection Json?
  brandSection  Json?

  rawData         Json?
  errorLog        String?
  userFacingError String?
  errorReason     String?
  errorDetail     String?
  degradedMode    Boolean @default(false)

  startedAt   DateTime?
  completedAt DateTime?
  publicSlug  String?   @unique

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@index([brandId])
  @@index([requesterEmail])
  @@index([status])
  @@index([createdAt])
}

// ─── Lead Capture ─────────────────────────────────────────────────────────────
// Stores lead data captured from public audit forms before an audit runs.

model Lead {
  id              String  @id @default(cuid())
  firstName       String
  lastName        String
  email           String
  companyName     String
  phoneNumber     String
  websiteUrl      String
  source          String  @default("public-audit")
  auditId         String?
  ipAddress       String?
  userAgent       String?
  normalizedEmail String  @default("")
  normalizedPhone String  @default("")
  emailVerified   Boolean @default(false)

  createdAt DateTime @default(now())

  @@index([email])
  @@index([createdAt])
  @@index([normalizedEmail])
  @@index([normalizedPhone])
}

// ─── Email Verification (OTP) ─────────────────────────────────────────────────

model EmailVerification {
  id         String    @id @default(cuid())
  email      String
  codeHash   String
  attempts   Int       @default(0)
  expiresAt  DateTime
  verifiedAt DateTime?
  ipAddress  String?
  createdAt  DateTime  @default(now())

  @@index([email])
  @@index([expiresAt])
}

// ─── Cron Cursor (keyset pagination state) ────────────────────────────────────

model CronCursor {
  name      String   @id
  brandId   String?
  updatedAt DateTime @updatedAt
}

// ─── White-Label (Phase 20A) ──────────────────────────────────────────────────

enum DomainStatus {
  PENDING
  VERIFYING
  ACTIVE
  FAILED
}

// One white-label config per organization. Controls branding overrides applied
// to client-facing surfaces when the agency has the feature enabled.
model WhiteLabelConfig {
  id                  String   @id @default(cuid())
  enabled             Boolean  @default(false)
  agencyName          String?
  logoUrl             String?
  logoDarkUrl         String?
  faviconUrl          String?
  primaryColor        String?
  secondaryColor      String?
  accentColor         String?
  fontFamily          String?
  supportEmail        String?
  removeMeseoBranding Boolean  @default(false)
  createdAt           DateTime @default(now())
  updatedAt           DateTime @updatedAt

  organizationId String       @unique
  organization   Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
}

// Custom domains an organization has registered for white-label delivery.
// One org may have multiple domains (e.g. client1.agency.com, client2.agency.com).
model CustomDomain {
  id                String       @id @default(cuid())
  hostname          String       @unique
  status            DomainStatus @default(PENDING)
  verificationToken String?
  sslStatus         String?
  vercelDomainId    String?
  createdAt         DateTime     @default(now())
  verifiedAt        DateTime?
  updatedAt         DateTime     @updatedAt

  organizationId String
  organization   Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)

  @@index([organizationId])
}

// ─── AI Market Position (Block 1) ────────────────────────────────────────────
//
// These models support the AI Market Position feature: population-level
// probing of LLM engines across a query corpus, competitor-panel construction,
// calibration against first-party attribution data, and per-brand scored output.
//
// Conceptual layering:
//   ProbeRun + VisibilityObservation  -- raw collection (Block 2)
//   CompetitorPanel + QueryCorpusEntry -- corpus and panel management (Block 3)
//   CalibrationRun                    -- vertical-level model coefficients (Block 4)
//   MarketPositionSnapshot            -- scored, ranked output per brand (Block 4/5)

enum ProbeRunStatus {
  PENDING
  RUNNING
  COMPLETED
  FAILED
}

enum QuerySource {
  FRAGMENT_SEEDED // seeded from real captured AI-referral text fragments
  CATEGORY_COVERAGE // synthetic coverage queries for the vertical category
  CURATED // manually added by an agency user
}

// A single scheduled probing run for one (vertical, locale, engine) cell.
// Not scoped to a brand; probes the entire vertical query corpus and records
// raw observations for all competitor-panel entities simultaneously.
model ProbeRun {
  id          String         @id @default(cuid())
  vertical    String
  locale      String
  engine      String
  status      ProbeRunStatus @default(PENDING)
  sampleCount Int
  startedAt   DateTime?
  completedAt DateTime?
  createdAt   DateTime       @default(now())

  observations VisibilityObservation[]

  @@index([vertical, locale, engine, createdAt])
}

// One parsed engine response for a single (query, entity, sample) tuple.
// brandKey is a freeform entity identifier (brand name, competitor slug, etc.)
// and is intentionally not a FK to Brand because competitor entities may not
// have Brand records in the database.
model VisibilityObservation {
  id          String   @id @default(cuid())
  probeRunId  String
  probeRun    ProbeRun @relation(fields: [probeRunId], references: [id], onDelete: Cascade)
  query       String
  engine      String
  brandKey    String
  mentioned   Boolean  @default(false)
  position    Int?
  cited       Boolean  @default(false)
  sentiment   String?
  sourceUrls  String[]
  sampleIndex Int

  @@index([probeRunId])
  @@index([query, brandKey])
}

// The set of named competitors for a (vertical, locale) market cell.
// members holds freeform entity keys matching the brandKey values in
// VisibilityObservation rows for this cell. One panel per cell (unique).
model CompetitorPanel {
  id              String   @id @default(cuid())
  vertical        String
  locale          String
  members         String[]
  curatedByUserId String?
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt

  @@unique([vertical, locale])
}

// One query in the probing corpus for a (vertical, locale) cell.
// FRAGMENT_SEEDED rows come from real captured AI-referral text fragments
// (AiAttribution.queryContext) so conversion weighting reflects actual demand.
// A unique constraint on (vertical, locale, query) makes Block 2 upserts
// idempotent: seeding and probing can re-run without duplicating rows.
model QueryCorpusEntry {
  id               String      @id @default(cuid())
  vertical         String
  locale           String
  query            String
  source           QuerySource
  conversionWeight Float       @default(0)
  lastProbedAt     DateTime?
  createdAt        DateTime    @default(now())

  @@unique([vertical, locale, query])
  @@index([vertical, locale])
}

// Fitted calibration coefficients for one vertical, versioned so that
// Block 4 can roll back to an earlier fit if a new one degrades coverage.
// Scoped to vertical only (not to a brand or org) because calibration
// transfers cross-tenant within a vertical.
model CalibrationRun {
  id           String   @id @default(cuid())
  vertical     String
  version      Int
  coefficients Json
  fittedAt     DateTime
  sampleSize   Int
  createdAt    DateTime @default(now())

  snapshots MarketPositionSnapshot[]

  @@index([vertical, version])
}

// Calibrated, conversion-weighted, ranked market position for one brand
// within a (vertical, locale) cell. Written by the Block 4 cron and read
// by the Block 5 UI. Never computed on demand.
model MarketPositionSnapshot {
  id                    String          @id @default(cuid())
  brandId               String
  brand                 Brand           @relation(fields: [brandId], references: [id], onDelete: Cascade)
  vertical              String
  locale                String
  calibratedScore       Float
  conversionWeightedSov Float
  rawSov                Float
  rankInPanel           Int
  panelSize             Int
  divergence            Float
  stabilityBand         Float?
  calibrationRunId      String?
  calibrationRun        CalibrationRun? @relation(fields: [calibrationRunId], references: [id], onDelete: SetNull)
  computedAt            DateTime
  updatedAt             DateTime        @updatedAt

  @@index([brandId, locale, computedAt])
}

// -- Site Audit ----------------------------------------------------------
// On-demand crawl audit: SiteAuditRun (header) -> SiteAuditPage[] (inventory)
// -> SiteAuditIssue[] (findings). Resumable: taskId + pagesProcessed cursor.

model SiteAuditRun {
  id             String    @id @default(cuid())
  status         String    @default("pending")
  // status: pending | crawling | processing | completed | failed
  taskId         String? // DataForSEO OnPage task ID, stored on submit
  pagesProcessed Int       @default(0) // cursor for resumable page writes
  score          Int? // 0-100 composite meSEO Site Health Score
  subScores      Json? // { technical: Int, aiReadiness: Int, aeoFaq: Int }
  categoryCounts Json? // { error: Int, warning: Int, notice: Int, passed: Int }
  pagesScanned   Int       @default(0)
  issueCount     Int       @default(0)
  errorMessage   String?
  crawlError     String? // crawl_blocked | crawl_timeout | site_unreachable | ...
  llmsTxt        Boolean?
  robotsTxt      Boolean?
  robotsAiBlocks Json? // { gptbot: Boolean, claudebot: Boolean, perplexitybot: Boolean, googleExtended: Boolean, ccbot: Boolean }
  sitemapFound   Boolean?
  sitemapUrl     String?
  startedAt      DateTime?
  completedAt    DateTime?
  createdAt      DateTime  @default(now())
  updatedAt      DateTime  @updatedAt

  brandId String
  brand   Brand  @relation(fields: [brandId], references: [id], onDelete: Cascade)

  issues SiteAuditIssue[]
  pages  SiteAuditPage[]

  @@index([brandId, createdAt])
  @@index([status, updatedAt])
}

model SiteAuditIssue {
  id           String  @id @default(cuid())
  // category: technical | ai_readiness | aeo_faq
  category     String
  // severity: error | warning | notice | passed
  severity     String
  // stable token, e.g. missing_title | duplicate_meta | noindex_page | redirect_chain | ...
  issueType    String
  title        String
  detail       String?
  affectedUrls Json    @default("[]") // String[]
  affected     Int     @default(1)

  runId String
  run   SiteAuditRun @relation(fields: [runId], references: [id], onDelete: Cascade)

  @@index([runId, severity])
  @@index([runId, category])
  @@index([runId, issueType])
}

model SiteAuditPage {
  id              String   @id @default(cuid())
  url             String
  // page type from URL rules or Haiku classification
  pageType        String? // homepage | service | product | blog | location | category | contact | legacy-slug | other
  pageTypeSource  String? // rule | ai
  statusCode      Int
  title           String?
  h1              String?
  metaDescription String?
  wordCount       Int?
  thinContent     Boolean  @default(false) // wordCount < 150 or empty body (JS-required signal)
  isIndexable     Boolean  @default(true)
  inSitemap       Boolean  @default(false)
  isOrphan        Boolean  @default(false) // no inbound internal links from non-orphan pages
  canonical       String?
  redirectTarget  String?
  hasSchema       Boolean  @default(false)
  schemaTypes     String[] @default([])
  hasFaq          Boolean  @default(false)
  hasHowTo        Boolean  @default(false)
  severity        String? // worst severity on this page
  issueTypes      String[] @default([]) // issueType tokens affecting this URL
  // GSC 30-day aggregates (set-based join, populated post-crawl)
  gscClicks       Int?
  gscImpressions  Int?
  gscPosition     Float?
  // Site Tag 30-day aggregates (set-based join)
  stSessions      Int?
  stConversions   Int?

  runId String
  run   SiteAuditRun @relation(fields: [runId], references: [id], onDelete: Cascade)

  @@index([runId, statusCode])
  @@index([runId, pageType])
  @@index([runId, severity])
  @@index([runId, isIndexable])
  @@index([runId, isOrphan])
}