{
  "contract_id": "FAMILYCASE-ANALYTICS-ATTRIBUTION-001",
  "version": "2026-06-06",
  "owner": "FamilyCase.AI Growth, Data, Security, Platform, Product, and Engineering",
  "status": "pending_analytics_cutover",
  "objective": "Define analytics, attribution, event delivery, dashboard ownership, privacy, sensitive-field blocking, alerting, and success measurement requirements for FamilyCase.AI public website launch.",
  "required_event_fields": [
    "event_name",
    "timestamp",
    "session_id",
    "visitor_id",
    "campaign_id",
    "persona",
    "page",
    "source",
    "medium"
  ],
  "required_events": [
    "Hero CTA Click",
    "Watch Demo",
    "Try Sample Case",
    "Upload Evidence",
    "ROI Started",
    "ROI Completed",
    "Trial Started",
    "Demo Booked",
    "Pricing Viewed",
    "Migration Viewed",
    "Competitor Viewed",
    "Resource Downloaded",
    "Video Completed"
  ],
  "forbidden_analytics_fields": [
    "email",
    "client_name",
    "case_facts",
    "matter_number",
    "message",
    "document_text",
    "privileged_material",
    "court_record",
    "payment_card",
    "password",
    "api_key"
  ],
  "dashboard_requirements": [
    "Launch metrics dashboard has a named Growth and Data owner.",
    "Dashboard tracks demo requests, trial starts, ROI starts, ROI completions, pricing views, sample case starts, resource downloads, video completions, and migration views.",
    "Dashboard tracks funnel conversion without collecting confidential case facts.",
    "Dashboard separates preview traffic from production traffic.",
    "Dashboard records campaign, source, medium, page, persona, visitor, and session attribution where available.",
    "Dashboard includes GEO visibility, generated-answer accuracy, missing claims, incorrect claims, and recommended content fixes.",
    "Dashboard includes alert thresholds for event delivery failures and attribution gaps."
  ],
  "privacy_requirements": [
    "Analytics destination must be privacy reviewed before production activation.",
    "Analytics payloads must use taxonomy-only event fields.",
    "Do not send email, client names, matter numbers, case facts, messages, document text, privileged material, court records, payment data, passwords, API keys, or secrets.",
    "Do not enable analytics until Security and Legal approve the destination and retention rules.",
    "Do not use analytics to train public AI models.",
    "Do not reuse analytics across unrelated customers or matters.",
    "Honor deletion and retention requirements approved by Legal and Security."
  ],
  "delivery_requirements": [
    "Platform attribution API accepts all required events.",
    "Event payloads match /platform-api-contracts.json and /measurement-contract.json.",
    "Event delivery failure is logged without sensitive fields.",
    "Event delivery retries do not duplicate irreversible side effects.",
    "Correlation IDs are preserved where available.",
    "Analytics can be disabled without breaking primary user flows.",
    "Preview mode does not create production analytics side effects."
  ],
  "monitoring_requirements": [
    "Monitor event delivery success rate.",
    "Monitor event delivery failure rate.",
    "Monitor attribution API timeout rate.",
    "Monitor missing campaign, source, medium, visitor, and session values.",
    "Monitor dashboard freshness.",
    "Monitor privacy guardrail violations.",
    "Alert Growth, Data, Security, and Engineering on delivery, attribution, dashboard, or privacy failures."
  ],
  "production_launch_blockers": [
    "analytics destination evidence pending Growth, Data, Security, Legal, and Engineering review",
    "analytics privacy review evidence pending Security and Legal review",
    "Platform attribution API evidence pending Platform, Data, and Engineering review",
    "required event taxonomy evidence pending Growth, Data, Platform, and Product review",
    "required event field schema evidence pending Data, Security, and Engineering review",
    "analytics payload includes forbidden field",
    "dashboard ownership evidence pending Growth and Data review",
    "dashboard configuration evidence pending Growth, Data, and Engineering review",
    "event delivery smoke evidence pending Growth, Data, Platform, and Engineering review",
    "analytics retention evidence pending Legal, Security, and Data review",
    "privacy guardrail alert evidence pending Security, Data, and Engineering review"
  ],
  "required_evidence": [
    "analytics-attribution-contract.json reviewed",
    "measurement-contract.json reviewed",
    "platform-api-contracts.json reviewed",
    "growth-optimization-contract.json reviewed",
    "data-processing-contract.json reviewed",
    "event delivery smoke test completed",
    "analytics privacy review approved",
    "dashboard owner approved",
    "post-deploy smoke checklist includes analytics attribution",
    "npm run validate passes"
  ]
}