adserver-dashboard 1.0.0

package/Influence-MW-AdServer-12-02-2026/shared/schema.ts

@@ -0,0 +1,1595 @@
+import { sql } from "drizzle-orm";
+import { pgTable, text, varchar, integer, boolean, timestamp, decimal, jsonb } from "drizzle-orm/pg-core";
+import { createInsertSchema } from "drizzle-zod";
+import { z } from "zod";
+
+// Users table
+export const users = pgTable("users", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  username: text("username").notNull().unique(),
+  password: text("password").notNull(),
+  role: text("role").notNull().default("user"),
+});
+
+export const insertUserSchema = createInsertSchema(users).pick({
+  username: true,
+  password: true,
+});
+
+export type InsertUser = z.infer<typeof insertUserSchema>;
+export type User = typeof users.$inferSelect;
+
+// Advertisers/Clients
+export const advertisers = pgTable("advertisers", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  contactEmail: text("contact_email"),
+  contactPhone: text("contact_phone"),
+  status: text("status").notNull().default("active"),
+});
+
+export const insertAdvertiserSchema = createInsertSchema(advertisers).omit({ id: true });
+export type InsertAdvertiser = z.infer<typeof insertAdvertiserSchema>;
+export type Advertiser = typeof advertisers.$inferSelect;
+
+// Agencies
+export const agencies = pgTable("agencies", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  contactEmail: text("contact_email"),
+  country: text("country"),
+  status: text("status").notNull().default("active"),
+});
+
+export const insertAgencySchema = createInsertSchema(agencies).omit({ id: true });
+export type InsertAgency = z.infer<typeof insertAgencySchema>;
+export type Agency = typeof agencies.$inferSelect;
+
+// Brands
+export const brands = pgTable("brands", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  iabCategory: text("iab_category"),
+  website: text("website"),
+  logoUrl: text("logo_url"),
+  status: text("status").notNull().default("active"),
+});
+
+export const insertBrandSchema = createInsertSchema(brands).omit({ id: true });
+export type InsertBrand = z.infer<typeof insertBrandSchema>;
+export type Brand = typeof brands.$inferSelect;
+
+// Media Owner Business Types
+export const MEDIA_OWNER_BUSINESS_TYPES = ["Media Owner", "Reseller"] as const;
+export type MediaOwnerBusinessType = typeof MEDIA_OWNER_BUSINESS_TYPES[number];
+
+// Media Owners (Companies)
+// Media owners can have a parent-child hierarchy where parent companies
+// can have child companies. This is managed through Admin Console.
+export const mediaOwners = pgTable("media_owners", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  country: text("country"),
+  status: text("status").notNull().default("active"),
+  // Company hierarchy fields (populated from Admin Console)
+  parentId: varchar("parent_id"), // References parent media owner for child companies
+  companyType: text("company_type").default("media_owner"), // 'media_owner' or 'child_company'
+  // User association - if this company has a user account that can log in
+  userId: varchar("user_id"),
+  // Business type for filtering
+  businessType: text("business_type").default("Media Owner"), // 'Media Owner' or 'Reseller'
+});
+
+export const insertMediaOwnerSchema = createInsertSchema(mediaOwners).omit({ id: true });
+export type InsertMediaOwner = z.infer<typeof insertMediaOwnerSchema>;
+export type MediaOwner = typeof mediaOwners.$inferSelect;
+
+// Venues (physical locations)
+export const venues = pgTable("venues", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  address: text("address"),
+  city: text("city"),
+  country: text("country"),
+  venueType: text("venue_type").notNull(),
+  status: text("status").notNull().default("active"),
+});
+
+export const insertVenueSchema = createInsertSchema(venues).omit({ id: true });
+export type InsertVenue = z.infer<typeof insertVenueSchema>;
+export type Venue = typeof venues.$inferSelect;
+
+// Screens (inventory)
+export const screens = pgTable("screens", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  venueId: varchar("venue_id").references(() => venues.id),
+  screenType: text("screen_type").notNull(),
+  width: integer("width").notNull(),
+  height: integer("height").notNull(),
+  orientation: text("orientation").notNull().default("landscape"),
+  status: text("status").notNull().default("active"),
+  dailyImpressions: integer("daily_impressions").default(0),
+  cpm: decimal("cpm", { precision: 10, scale: 2 }).default("10.00"),
+  country: text("country"),
+  city: text("city"),
+  mediaOwnerId: varchar("media_owner_id").references(() => mediaOwners.id),
+  sspId: varchar("ssp_id").references(() => sspPartners.id),
+  latitude: decimal("latitude", { precision: 10, scale: 7 }),
+  longitude: decimal("longitude", { precision: 10, scale: 7 }),
+  format: text("format"),
+  classification: text("classification").default("Digital"),
+  inventoryType: text("inventory_type"),
+  sizeCategory: text("size_category"),
+  webcamUrl: text("webcam_url"),
+  webcamStatus: text("webcam_status").default("inactive"),
+});
+
+export const insertScreenSchema = createInsertSchema(screens).omit({ id: true });
+export type InsertScreen = z.infer<typeof insertScreenSchema>;
+export type Screen = typeof screens.$inferSelect;
+
+// Deals - 4-level hierarchy: Advertiser → Deal → Line Item → Creative Assignment
+// Deal now contains all fields previously in Insertion Orders
+export const deals = pgTable("deals", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  advertiserId: varchar("advertiser_id").references(() => advertisers.id),
+  brandId: varchar("brand_id").references(() => brands.id),
+  agencyId: varchar("agency_id").references(() => agencies.id),
+  // Deal status: active or paused
+  status: text("status").notNull().default("active"),
+  // External Deal ID for integration with external systems
+  externalDealId: text("external_deal_id"),
+  // Billable flag
+  billable: boolean("billable").default(true),
+  // Media type (DOOH only for now)
+  mediaType: text("media_type").notNull().default("dooh"),
+  // Client type: direct or agency
+  clientType: text("client_type").default("direct"),
+  // SSP Partner - defaults to Influence (built-in SSP). SSP list comes from Admin Console based on logged-in user's company
+  sspId: varchar("ssp_id"),
+  // Deal Type: traditional, pg, preferred_deal, pmp, always_on, open_auction
+  dealType: text("deal_type").notNull().default("traditional"),
+  // DSP configuration (for programmatic deals when agency or brand selected)
+  // DSP list comes from Admin Console based on company's DSP Access
+  dspId: varchar("dsp_id"),
+  // Seat name selected from Admin Console for the chosen agency/brand
+  seatName: text("seat_name"),
+  // Seat ID fetched from Admin Console (view-only, verified before save)
+  seatId: text("seat_id"),
+  // Legacy fields for backward compatibility
+  seatNames: text("seat_names").array(),
+  seatIds: text("seat_ids").array(),
+  // Geography - default to user's home country, options from Admin Console based on user's country access
+  countries: text("countries").array(),
+  currency: text("currency").default("USD"),
+  timezone: text("timezone"),
+  // Budget and Goals
+  budget: decimal("budget", { precision: 12, scale: 2 }),
+  spent: decimal("spent", { precision: 12, scale: 2 }).default("0.00"),
+  goalType: text("goal_type"),
+  goalValue: integer("goal_value"),
+  targetType: text("target_type"),
+  targetValue: integer("target_value"),
+  // Minimum Target Threshold - only applicable for PG deals
+  minimumTargetThreshold: integer("minimum_target_threshold"),
+  // Hard Stop - only applicable for PG deals
+  hardStop: boolean("hard_stop").default(false),
+  // Flight dates
+  startDate: text("start_date"),
+  endDate: text("end_date"),
+  // Verification
+  adPlayVerificationEnabled: boolean("adplay_verification_enabled").default(false),
+  adPlayVerificationProvider: text("adplay_verification_provider"),
+  // Source of the deal
+  source: text("source").notNull().default("influence"),
+  // Acceptance sent flag - when true, deal has been sent to DSP/stakeholders
+  acceptanceSent: boolean("acceptance_sent").default(false),
+  // Reopened flag - when true, deal has been reopened for editing after being sent
+  reopened: boolean("reopened").default(false),
+  // RFP flag - for Activate deals, indicates deal is pending RFP review
+  isRfp: boolean("is_rfp").default(false),
+  // Audit fields
+  createdBy: text("created_by"),
+  createdAt: text("created_at"),
+  updatedAt: text("updated_at"),
+});
+
+export const insertDealSchema = createInsertSchema(deals).omit({ id: true });
+export type InsertDeal = z.infer<typeof insertDealSchema>;
+export type Deal = typeof deals.$inferSelect;
+
+// Line Items - now directly under Deal (no Insertion Order layer)
+export const lineItems = pgTable("line_items", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  // Line items now reference deals directly (4-level hierarchy)
+  dealId: varchar("deal_id").references(() => deals.id),
+  // Media owner for this line item (for Planner integration - one line item per media owner)
+  mediaOwnerId: varchar("media_owner_id"),
+  status: text("status").notNull().default("draft"),
+  copiedFromId: varchar("copied_from_id"),
+  creativeType: text("creative_type").default("display"),
+  priority: integer("priority").default(5),
+  targeting: jsonb("targeting"),
+  inventoryFilters: jsonb("inventory_filters"),
+  startDate: text("start_date"),
+  endDate: text("end_date"),
+  schedules: jsonb("schedules"),
+  floorRateType: text("floor_rate_type").default("cpm"),
+  floorRate: decimal("floor_rate", { precision: 10, scale: 2 }),
+  maxBid: decimal("max_bid", { precision: 10, scale: 2 }),
+  bidType: text("bid_type").default("cpm"),
+  automatedBidding: boolean("automated_bidding").default(false),
+  budgetAllocation: jsonb("budget_allocation"),
+  pacing: text("pacing").default("even"),
+  customFees: jsonb("custom_fees"),
+  frequencyCap: jsonb("frequency_cap"),
+  trafficAllocation: integer("traffic_allocation").default(100),
+  targetImpressions: integer("target_impressions"),
+  deliveredImpressions: integer("delivered_impressions").default(0),
+  budget: decimal("budget", { precision: 12, scale: 2 }),
+  spent: decimal("spent", { precision: 12, scale: 2 }).default("0.00"),
+  cpm: decimal("cpm", { precision: 10, scale: 2 }),
+  creativeUrl: text("creative_url"),
+  creativeDuration: integer("creative_duration").default(10),
+  dspId: varchar("dsp_id").references(() => dspPartners.id),
+  dspSeatId: text("dsp_seat_id"),
+  pushToDsp: boolean("push_to_dsp").default(false),
+  triggerId: varchar("trigger_id"),
+  triggerEnabled: boolean("trigger_enabled").default(false),
+  resolution: text("resolution"),
+  createdBy: text("created_by"),
+  createdAt: text("created_at"),
+  updatedAt: text("updated_at"),
+});
+
+export const insertLineItemSchema = createInsertSchema(lineItems).omit({ id: true });
+export type InsertLineItem = z.infer<typeof insertLineItemSchema>;
+export type LineItem = typeof lineItems.$inferSelect;
+
+// SSP Partners
+export const sspPartners = pgTable("ssp_partners", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  endpoint: text("endpoint"),
+  apiKey: text("api_key"),
+  status: text("status").notNull().default("active"),
+  partnerType: text("partner_type").notNull().default("ssp"),
+});
+
+export const insertSspPartnerSchema = createInsertSchema(sspPartners).omit({ id: true });
+export type InsertSspPartner = z.infer<typeof insertSspPartnerSchema>;
+export type SspPartner = typeof sspPartners.$inferSelect;
+
+// DSP Partners
+export const dspPartners = pgTable("dsp_partners", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  endpoint: text("endpoint"),
+  apiKey: text("api_key"),
+  status: text("status").notNull().default("active"),
+});
+
+export const insertDspPartnerSchema = createInsertSchema(dspPartners).omit({ id: true });
+export type InsertDspPartner = z.infer<typeof insertDspPartnerSchema>;
+export type DspPartner = typeof dspPartners.$inferSelect;
+
+// Creative Folders
+export const creativeFolders = pgTable("creative_folders", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  createdAt: text("created_at"),
+});
+
+export const insertCreativeFolderSchema = createInsertSchema(creativeFolders).omit({ id: true });
+export type InsertCreativeFolder = z.infer<typeof insertCreativeFolderSchema>;
+export type CreativeFolder = typeof creativeFolders.$inferSelect;
+
+// Creatives
+export const creatives = pgTable("creatives", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  type: text("type").notNull().default("display"),
+  format: text("format").notNull(),
+  width: integer("width").notNull(),
+  height: integer("height").notNull(),
+  fileSize: integer("file_size").notNull(),
+  duration: integer("duration"),
+  status: text("status").notNull().default("new"),
+  folderId: varchar("folder_id").references(() => creativeFolders.id),
+  tags: text("tags").array(),
+  uploadedAt: text("uploaded_at"),
+  uploadedBy: text("uploaded_by"),
+  thumbnailUrl: text("thumbnail_url"),
+  fileUrl: text("file_url"),
+  inadequateReason: text("inadequate_reason"),
+  // Creative source - where the creative originated from
+  creativeSource: text("creative_source").default("uploaded"), // uploaded, bid_stream_vast, api, media_owner
+  // Source platform - which platform the creative came from
+  sourcePlatform: text("source_platform"), // planner, activate, influence, media_owner
+  // Transcoding options
+  transcodingEnabled: boolean("transcoding_enabled").default(false),
+  transcodingStatus: text("transcoding_status"), // pending, processing, completed, failed
+  transcodedUrl: text("transcoded_url"),
+});
+
+export const insertCreativeSchema = createInsertSchema(creatives).omit({ id: true });
+export type InsertCreative = z.infer<typeof insertCreativeSchema>;
+export type Creative = typeof creatives.$inferSelect;
+
+// Creative types and statuses
+export type CreativeAssetType = "display" | "video" | "html" | "native";
+export type CreativeAssetStatus = "new" | "processing" | "accepted" | "inadequate" | "archived";
+
+export const CREATIVE_ASSET_TYPES: { value: CreativeAssetType; label: string }[] = [
+  { value: "display", label: "Display" },
+  { value: "video", label: "Video" },
+  { value: "html", label: "HTML" },
+  { value: "native", label: "Native" },
+];
+
+export const CREATIVE_ASSET_STATUSES: { value: CreativeAssetStatus; label: string }[] = [
+  { value: "new", label: "New" },
+  { value: "processing", label: "Processing" },
+  { value: "accepted", label: "Accepted" },
+  { value: "inadequate", label: "Inadequate" },
+  { value: "archived", label: "Archived" },
+];
+
+// Creative source types - where the creative originated from
+export type CreativeSource = "uploaded" | "bid_stream_vast" | "api" | "media_owner";
+
+export const CREATIVE_SOURCES: { value: CreativeSource; label: string }[] = [
+  { value: "uploaded", label: "Uploaded" },
+  { value: "bid_stream_vast", label: "Bid Stream (VAST)" },
+  { value: "api", label: "API" },
+  { value: "media_owner", label: "Media Owner" },
+];
+
+// Transcoding status types
+export type TranscodingStatus = "pending" | "processing" | "completed" | "failed";
+
+export const TRANSCODING_STATUSES: { value: TranscodingStatus; label: string }[] = [
+  { value: "pending", label: "Pending" },
+  { value: "processing", label: "Processing" },
+  { value: "completed", label: "Completed" },
+  { value: "failed", label: "Failed" },
+];
+
+// Line Item Creative Assignments (Junction table for Tier 2 approval)
+export const lineItemCreatives = pgTable("line_item_creatives", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  lineItemId: varchar("line_item_id").references(() => lineItems.id).notNull(),
+  creativeId: varchar("creative_id").references(() => creatives.id).notNull(),
+  tier2Status: text("tier2_status").notNull().default("pending"),
+  tier2ReviewedBy: text("tier2_reviewed_by"),
+  tier2ReviewedAt: text("tier2_reviewed_at"),
+  tier2RejectionReason: text("tier2_rejection_reason"),
+  assignedBy: text("assigned_by"),
+  assignedAt: text("assigned_at"),
+  displayOrder: integer("display_order").default(0),
+  weight: integer("weight").default(100),
+  startTime: text("start_time"),
+  endTime: text("end_time"),
+  schedule: jsonb("schedule"),
+  rule: text("rule").default("default"),
+  adPlayCount: integer("ad_play_count").default(0),
+});
+
+export const insertLineItemCreativeSchema = createInsertSchema(lineItemCreatives).omit({ id: true });
+export type InsertLineItemCreative = z.infer<typeof insertLineItemCreativeSchema>;
+export type LineItemCreative = typeof lineItemCreatives.$inferSelect;
+
+// Signals - conditional signals for line item automation
+export const signals = pgTable("signals", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  description: text("description"),
+  signalType: text("signal_type").notNull().default("weather"),
+  status: text("status").notNull().default("active"),
+  createdBy: text("created_by"),
+  createdAt: text("created_at"),
+  updatedAt: text("updated_at"),
+});
+
+export const insertSignalSchema = createInsertSchema(signals).omit({ id: true });
+export type InsertSignal = z.infer<typeof insertSignalSchema>;
+export type Signal = typeof signals.$inferSelect;
+
+// Signal Rules - conditions within a signal
+export const signalRules = pgTable("signal_rules", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  signalId: varchar("signal_id").references(() => signals.id).notNull(),
+  name: text("name").notNull(),
+  conditionType: text("condition_type").notNull(),
+  parameters: jsonb("parameters"),
+  status: text("status").notNull().default("active"),
+  createdAt: text("created_at"),
+  updatedAt: text("updated_at"),
+});
+
+export const insertSignalRuleSchema = createInsertSchema(signalRules).omit({ id: true });
+export type InsertSignalRule = z.infer<typeof insertSignalRuleSchema>;
+export type SignalRule = typeof signalRules.$inferSelect;
+
+// Signal types
+export type SignalType = "audiences" | "footfall" | "search" | "weather";
+
+export const SIGNAL_TYPES: { value: SignalType; label: string; description: string }[] = [
+  { value: "audiences", label: "Audiences", description: "Signal based on audience segments" },
+  { value: "footfall", label: "Footfall", description: "Signal based on store foot traffic" },
+  { value: "search", label: "Search", description: "Signal based on search keyword trends" },
+  { value: "weather", label: "Weather", description: "Signal based on weather conditions" },
+];
+
+// Change Logs (Audit Trail)
+export const changeLogs = pgTable("change_logs", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  entityType: text("entity_type").notNull(), // 'deal' | 'order' | 'line_item' | 'creative'
+  entityId: varchar("entity_id").notNull(),
+  action: text("action").notNull(), // 'created' | 'updated' | 'deleted' | 'status_changed'
+  changedBy: text("changed_by").notNull(),
+  changedAt: text("changed_at").notNull(),
+  changes: jsonb("changes"), // JSON object with field changes: { field: { old: value, new: value } }
+  description: text("description"), // Human-readable summary
+});
+
+export const insertChangeLogSchema = createInsertSchema(changeLogs).omit({ id: true });
+export type InsertChangeLog = z.infer<typeof insertChangeLogSchema>;
+export type ChangeLog = typeof changeLogs.$inferSelect;
+
+// Change Log entity types (order removed in 4-level hierarchy)
+export type ChangeLogEntityType = "deal" | "line_item" | "creative";
+export type ChangeLogAction = "created" | "updated" | "deleted" | "status_changed";
+
+// Tier 2 approval statuses for assigned creatives
+export type Tier2Status = "pending" | "approved" | "rejected" | "changes_requested";
+
+export const TIER2_STATUSES: { value: Tier2Status; label: string; color: string }[] = [
+  { value: "pending", label: "Pending Review", color: "yellow" },
+  { value: "approved", label: "Approved", color: "green" },
+  { value: "rejected", label: "Rejected", color: "red" },
+  { value: "changes_requested", label: "Changes Requested", color: "orange" },
+];
+
+// Creative Schedule structure for hour/day matrix
+export interface CreativeSchedule {
+  allHours: boolean;
+  selectedHours: Record<string, number[]>; // date string -> array of selected hours (0-23)
+}
+
+// Creative Assignment Rule types
+export type CreativeRule = "default" | "custom";
+
+export const CREATIVE_RULES: { value: CreativeRule; label: string }[] = [
+  { value: "default", label: "Default" },
+  { value: "custom", label: "Custom" },
+];
+
+// Transcoded asset for creatives
+export interface TranscodedAsset {
+  id: string;
+  name: string;
+  active: boolean;
+  scaling: string;
+  duration: string;
+  bitrate: string;
+  dimensions: string;
+  type: string;
+  delivery: string;
+  codecs: string;
+}
+
+// Analytics/Reporting
+export const impressionLogs = pgTable("impression_logs", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  lineItemId: varchar("line_item_id").references(() => lineItems.id),
+  screenId: varchar("screen_id").references(() => screens.id),
+  timestamp: text("timestamp").notNull(),
+  cost: decimal("cost", { precision: 10, scale: 4 }),
+  source: text("source").default("direct"),
+});
+
+export const insertImpressionLogSchema = createInsertSchema(impressionLogs).omit({ id: true });
+export type InsertImpressionLog = z.infer<typeof insertImpressionLogSchema>;
+export type ImpressionLog = typeof impressionLogs.$inferSelect;
+
+// Type definitions for frontend state
+export type DealStatus = "active" | "paused";
+export type LineItemStatus = "active" | "paused" | "draft";
+export type ScreenStatus = "active" | "inactive" | "maintenance";
+export type VenueType = "mall" | "airport" | "transit" | "street" | "retail" | "office" | "entertainment";
+export type DealCategory = "traditional" | "programmatic" | "hybrid";
+export type MediaType = "dooh" | "mobile" | "youtube" | "ctv";
+export type DealType = "traditional" | "pg" | "preferred_deal" | "pmp" | "always_on" | "open_auction";
+export type ClientType = "direct" | "agency";
+export type CreativeType = "display" | "video" | "audio";
+export type FloorRateType = "cpm" | "cps";
+export type Pacing = "asap" | "even" | "front_loaded";
+export type IncomeBracket = "low" | "lower_middle" | "medium" | "upper_middle" | "high";
+export type PartnerStatus = "active" | "inactive" | "pending";
+
+// Reference data for dropdowns
+export const MEDIA_TYPES: { value: MediaType; label: string; disabled?: boolean }[] = [
+  { value: "dooh", label: "DOOH" },
+  { value: "mobile", label: "Mobile", disabled: true },
+  { value: "youtube", label: "YouTube", disabled: true },
+  { value: "ctv", label: "Connected TV", disabled: true },
+];
+
+export const ADPLAY_VERIFICATION_PROVIDERS = ["MAV", "IAS", "OIS", "Veridooh"];
+
+export const DEAL_TYPES: { value: DealType; label: string }[] = [
+  { value: "traditional", label: "Traditional" },
+  { value: "pg", label: "Programmatic Guaranteed" },
+  { value: "preferred_deal", label: "Preferred Deal" },
+  { value: "pmp", label: "Private Marketplace (PMP)" },
+  { value: "always_on", label: "Always On" },
+  { value: "open_auction", label: "Open Auction" },
+];
+
+export type GoalType = "impressions" | "reach" | "share_of_voice" | "carbon_emission" | "ad_plays";
+export type TargetType = "impressions" | "ad_plays";
+
+export const GOAL_TYPES: { value: GoalType; label: string; description: string }[] = [
+  { value: "impressions", label: "Impressions", description: "Total number of ad views/exposures to your target audience" },
+  { value: "reach", label: "Reach", description: "Unique individuals exposed to your campaign" },
+  { value: "share_of_voice", label: "Share of Voice", description: "Your brand's presence as a percentage of total market activity" },
+  { value: "carbon_emission", label: "Carbon Emission", description: "Minimize or cap your campaign's environmental footprint" },
+  { value: "ad_plays", label: "Ad Plays", description: "Total number of times your ad content is played on screens" },
+];
+
+export const TARGET_TYPES: { value: TargetType; label: string }[] = [
+  { value: "impressions", label: "Impressions" },
+  { value: "ad_plays", label: "Ad Plays" },
+];
+
+export const CLIENT_TYPES: { value: ClientType; label: string }[] = [
+  { value: "direct", label: "Direct Advertiser" },
+  { value: "agency", label: "Agency" },
+];
+
+export const CREATIVE_TYPES: { value: CreativeType; label: string }[] = [
+  { value: "display", label: "Display" },
+  { value: "video", label: "Video" },
+  { value: "audio", label: "Audio" },
+];
+
+export const PACING_OPTIONS: { value: Pacing; label: string }[] = [
+  { value: "asap", label: "ASAP" },
+  { value: "even", label: "Even" },
+  { value: "front_loaded", label: "Front Loaded" },
+];
+
+export const INCOME_BRACKETS: { value: IncomeBracket; label: string }[] = [
+  { value: "low", label: "Low income (<RM 128,000)" },
+  { value: "lower_middle", label: "Lower-middle income (RM 128,000-RM 213,000)" },
+  { value: "medium", label: "Middle income (RM 213,000-RM 426,000)" },
+  { value: "upper_middle", label: "Upper-middle income (RM 426,000-RM 639,000)" },
+  { value: "high", label: "High income (>RM 639,000)" },
+];
+
+// Targeting options
+export interface TargetingCriteria {
+  demographics?: string[];
+  geography?: string[];
+  venueTypes?: string[];
+  incomeBrackets?: IncomeBracket[];
+  behaviors?: string[];
+  interests?: string[];
+}
+
+// Inventory filter options
+export interface InventoryFilters {
+  classification?: string[];
+  type?: string[];
+  format?: string[];
+  resolution?: string[];
+  duration?: number[];
+}
+
+// Custom fee structure
+export interface CustomFee {
+  name: string;
+  amount: number;
+  type: "fixed" | "percentage";
+  hidden?: boolean;
+}
+
+// Frequency cap structure
+export interface FrequencyCap {
+  impressions: number;
+  period: "hour" | "day" | "week" | "month" | "lifetime";
+}
+
+// Budget allocation by inventory type
+export interface BudgetAllocation {
+  inventoryType: string;
+  percentage: number;
+  amount?: number;
+}
+
+// Dashboard metrics type - 4-level hierarchy (no orders)
+export interface DashboardMetrics {
+  totalDeals: number;
+  activeDeals: number;
+  totalImpressions: number;
+  totalRevenue: number;
+  totalScreens: number;
+  activeScreens: number;
+  fillRate: number;
+  avgCPM: number;
+  // Line Item metrics
+  totalLineItems: number;
+  activeLineItems: number;
+  // Creative metrics
+  totalCreatives: number;
+  pendingApprovalCreatives: number;
+  acceptedCreatives: number;
+  assignedCreatives: number;
+}
+
+// Traffic allocation type
+export interface TrafficAllocation {
+  id: string;
+  name: string;
+  allocation: number;
+  delivered: number;
+  remaining: number;
+}
+
+// Countries and their currencies/timezones
+export interface Country {
+  code: string;
+  name: string;
+  currency: string;
+  timezones: string[];
+}
+
+export const COUNTRIES: Country[] = [
+  { code: "US", name: "United States", currency: "USD", timezones: ["America/New_York", "America/Chicago", "America/Denver", "America/Los_Angeles"] },
+  { code: "MY", name: "Malaysia", currency: "MYR", timezones: ["Asia/Kuala_Lumpur"] },
+  { code: "SG", name: "Singapore", currency: "SGD", timezones: ["Asia/Singapore"] },
+  { code: "TH", name: "Thailand", currency: "THB", timezones: ["Asia/Bangkok"] },
+  { code: "ID", name: "Indonesia", currency: "IDR", timezones: ["Asia/Jakarta", "Asia/Makassar", "Asia/Jayapura"] },
+  { code: "PH", name: "Philippines", currency: "PHP", timezones: ["Asia/Manila"] },
+  { code: "AU", name: "Australia", currency: "AUD", timezones: ["Australia/Sydney", "Australia/Melbourne", "Australia/Brisbane", "Australia/Perth"] },
+  { code: "GB", name: "United Kingdom", currency: "GBP", timezones: ["Europe/London"] },
+  { code: "DE", name: "Germany", currency: "EUR", timezones: ["Europe/Berlin"] },
+  { code: "FR", name: "France", currency: "EUR", timezones: ["Europe/Paris"] },
+  { code: "JP", name: "Japan", currency: "JPY", timezones: ["Asia/Tokyo"] },
+  { code: "KR", name: "South Korea", currency: "KRW", timezones: ["Asia/Seoul"] },
+  { code: "IN", name: "India", currency: "INR", timezones: ["Asia/Kolkata"] },
+  { code: "AE", name: "United Arab Emirates", currency: "AED", timezones: ["Asia/Dubai"] },
+  { code: "SA", name: "Saudi Arabia", currency: "SAR", timezones: ["Asia/Riyadh"] },
+];
+
+export const CURRENCIES = ["USD", "MYR", "SGD", "THB", "IDR", "PHP", "AUD", "GBP", "EUR", "JPY", "KRW", "INR", "AED", "SAR"];
+
+// Inventory classification from Google Sheet
+export const INVENTORY_CLASSIFICATIONS = ["Digital"];
+
+export const INVENTORY_TYPES = ["OOH", "Transit", "Retail", "Cinema"];
+
+export const INVENTORY_FORMATS_BY_TYPE: Record<string, string[]> = {
+  OOH: [
+    "Digital Large Format",
+    "Digital Billboard",
+    "Digital Bus Shelter Screen",
+    "Smart City Panel",
+    "Digital Video Walls",
+    "Digital Kiosk",
+  ],
+  Transit: [
+    "Taxi Top Digital",
+    "Platform Digital Screen",
+    "Airport Terminal Screens",
+    "Train Digital Display",
+    "Bus Interior Screen",
+    "Metro Station Screen",
+  ],
+  Retail: [
+    "Mall / Retail Screens",
+    "Elevator / Lobby Screens",
+    "Retail Window Screen",
+    "Point of Sale Screen",
+    "Shelf-edge Digital",
+  ],
+  Cinema: [
+    "Cinema Pre-Show",
+    "Cinema Lobby Screen",
+    "Cinema Concession Display",
+    "Cinema Auditorium Entry",
+  ],
+};
+
+export const INVENTORY_FORMATS = [
+  ...INVENTORY_FORMATS_BY_TYPE.OOH,
+  ...INVENTORY_FORMATS_BY_TYPE.Transit,
+  ...INVENTORY_FORMATS_BY_TYPE.Retail,
+  ...INVENTORY_FORMATS_BY_TYPE.Cinema,
+];
+
+export const INVENTORY_SIZE_CATEGORIES = ["XS", "S", "M", "L", "XL"];
+
+export const SCREEN_RESOLUTIONS = [
+  "1920x1080",
+  "1080x1920",
+  "3840x2160",
+  "2160x3840",
+  "1280x720",
+  "720x1280",
+  "1024x768",
+  "768x1024",
+  "800x600",
+  "600x800",
+] as const;
+
+// Age Groups
+export const AGE_GROUPS = [
+  "18-24", "25-34", "35-44", "45-54", "55-64", "65+"
+];
+
+// Gender options
+export const GENDERS = ["Male", "Female"];
+
+// Demographics (combined age + gender for backward compatibility)
+export const DEMOGRAPHICS = [
+  ...AGE_GROUPS,
+  ...GENDERS
+];
+
+// POI Categories for custom POI targeting
+export const POI_CATEGORIES = [
+  "Shopping",
+  "Office",
+  "Sports",
+  "Entertainment", 
+  "Restaurant",
+  "Hotel",
+  "Hospital",
+  "Education",
+  "Transit",
+  "Retail",
+  "Custom",
+] as const;
+
+export type POICategory = typeof POI_CATEGORIES[number];
+
+// POI Source types
+export const POI_SOURCES = ["google_places", "custom"] as const;
+export type POISource = typeof POI_SOURCES[number];
+
+// OpenOOH Venue Taxonomy - Hierarchical Structure
+export interface VenueTypeNode {
+  id: string;
+  label: string;
+  description?: string;
+  level: "category" | "sub" | "product";
+  color: "blue" | "green" | "pink";
+  children?: VenueTypeNode[];
+}
+
+export const VENUE_TAXONOMY: VenueTypeNode[] = [
+  {
+    id: "transit",
+    label: "Transit",
+    description: "Transportation & mobility venues",
+    level: "category",
+    color: "blue",
+    children: [
+      {
+        id: "transit.airports",
+        label: "Airports",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "transit.airports.terminal", label: "Terminal", level: "product", color: "pink" },
+          { id: "transit.airports.gate", label: "Gate Area", level: "product", color: "pink" },
+          { id: "transit.airports.baggage", label: "Baggage Claim", level: "product", color: "pink" },
+          { id: "transit.airports.lounge", label: "Lounge", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "transit.train_stations",
+        label: "Train Stations",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "transit.train_stations.platform", label: "Platform", level: "product", color: "pink" },
+          { id: "transit.train_stations.concourse", label: "Concourse", level: "product", color: "pink" },
+          { id: "transit.train_stations.ticketing", label: "Ticketing Area", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "transit.bus_stations",
+        label: "Bus Stations",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "transit.bus_stations.waiting_area", label: "Waiting Area", level: "product", color: "pink" },
+          { id: "transit.bus_stations.shelter", label: "Bus Shelter", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "transit.subway",
+        label: "Subway/Metro",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "transit.subway.platform", label: "Platform", level: "product", color: "pink" },
+          { id: "transit.subway.entrance", label: "Station Entrance", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "retail",
+    label: "Retail",
+    description: "Shopping & commercial venues",
+    level: "category",
+    color: "green",
+    children: [
+      {
+        id: "retail.shopping_mall",
+        label: "Shopping Mall",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "retail.shopping_mall.atrium", label: "Mall Atrium", level: "product", color: "pink" },
+          { id: "retail.shopping_mall.corridor", label: "Mall Corridor", level: "product", color: "pink" },
+          { id: "retail.shopping_mall.food_court", label: "Food Court", level: "product", color: "pink" },
+          { id: "retail.shopping_mall.entrance", label: "Mall Entrance", level: "product", color: "pink" },
+          { id: "retail.shopping_mall.anchor_store", label: "Anchor Store", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "retail.retail_store",
+        label: "Retail Store",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "retail.retail_store.checkout", label: "Checkout Area", level: "product", color: "pink" },
+          { id: "retail.retail_store.entrance", label: "Store Entrance", level: "product", color: "pink" },
+          { id: "retail.retail_store.aisle", label: "Aisle Display", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "retail.market_plaza",
+        label: "Market & Plaza",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "retail.market_plaza.outdoor", label: "Outdoor Market", level: "product", color: "pink" },
+          { id: "retail.market_plaza.food_hall", label: "Food Hall", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "retail.convenience",
+        label: "Convenience Store",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "retail.convenience.counter", label: "Counter Display", level: "product", color: "pink" },
+          { id: "retail.convenience.window", label: "Window Display", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "outdoor",
+    label: "Outdoor",
+    description: "Street level & outdoor advertising",
+    level: "category",
+    color: "pink",
+    children: [
+      {
+        id: "outdoor.roadside",
+        label: "Roadside",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "outdoor.roadside.billboard", label: "Billboard", level: "product", color: "pink" },
+          { id: "outdoor.roadside.digital_billboard", label: "Digital Billboard", level: "product", color: "pink" },
+          { id: "outdoor.roadside.poster", label: "Roadside Poster", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "outdoor.street_furniture",
+        label: "Street Furniture",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "outdoor.street_furniture.bus_shelter", label: "Bus Shelter", level: "product", color: "pink" },
+          { id: "outdoor.street_furniture.kiosk", label: "Street Kiosk", level: "product", color: "pink" },
+          { id: "outdoor.street_furniture.bench", label: "Bench Advertising", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "outdoor.urban_panels",
+        label: "Urban Panels",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "outdoor.urban_panels.wall_mounted", label: "Wall Mounted", level: "product", color: "pink" },
+          { id: "outdoor.urban_panels.freestanding", label: "Freestanding Panel", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "entertainment",
+    label: "Entertainment",
+    description: "Leisure & entertainment venues",
+    level: "category",
+    color: "blue",
+    children: [
+      {
+        id: "entertainment.cinema",
+        label: "Cinema",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "entertainment.cinema.lobby", label: "Cinema Lobby", level: "product", color: "pink" },
+          { id: "entertainment.cinema.screen", label: "On-Screen", level: "product", color: "pink" },
+          { id: "entertainment.cinema.concession", label: "Concession Area", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "entertainment.sports_venue",
+        label: "Sports Venue",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "entertainment.sports_venue.stadium", label: "Stadium", level: "product", color: "pink" },
+          { id: "entertainment.sports_venue.arena", label: "Arena", level: "product", color: "pink" },
+          { id: "entertainment.sports_venue.concourse", label: "Venue Concourse", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "entertainment.theme_park",
+        label: "Theme Park",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "entertainment.theme_park.entrance", label: "Park Entrance", level: "product", color: "pink" },
+          { id: "entertainment.theme_park.queue", label: "Queue Line", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "health_beauty",
+    label: "Health & Beauty",
+    description: "Healthcare & wellness venues",
+    level: "category",
+    color: "blue",
+    children: [
+      {
+        id: "health_beauty.gym",
+        label: "Gym & Fitness",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "health_beauty.gym.lobby", label: "Gym Lobby", level: "product", color: "pink" },
+          { id: "health_beauty.gym.locker_room", label: "Locker Room", level: "product", color: "pink" },
+          { id: "health_beauty.gym.workout_area", label: "Workout Area", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "health_beauty.salon",
+        label: "Salon & Spa",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "health_beauty.salon.waiting", label: "Waiting Area", level: "product", color: "pink" },
+          { id: "health_beauty.salon.treatment", label: "Treatment Room", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "health_beauty.pharmacy",
+        label: "Pharmacy",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "health_beauty.pharmacy.counter", label: "Pharmacy Counter", level: "product", color: "pink" },
+          { id: "health_beauty.pharmacy.waiting", label: "Pharmacy Waiting", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "point_of_care",
+    label: "Point of Care",
+    description: "Medical & healthcare facilities",
+    level: "category",
+    color: "blue",
+    children: [
+      {
+        id: "point_of_care.hospital",
+        label: "Hospital",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "point_of_care.hospital.lobby", label: "Hospital Lobby", level: "product", color: "pink" },
+          { id: "point_of_care.hospital.waiting_room", label: "Waiting Room", level: "product", color: "pink" },
+          { id: "point_of_care.hospital.cafeteria", label: "Cafeteria", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "point_of_care.clinic",
+        label: "Medical Clinic",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "point_of_care.clinic.reception", label: "Reception", level: "product", color: "pink" },
+          { id: "point_of_care.clinic.exam_room", label: "Exam Room", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "office",
+    label: "Office Buildings",
+    description: "Corporate & business venues",
+    level: "category",
+    color: "blue",
+    children: [
+      {
+        id: "office.corporate",
+        label: "Corporate Office",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "office.corporate.lobby", label: "Office Lobby", level: "product", color: "pink" },
+          { id: "office.corporate.elevator", label: "Elevator Bank", level: "product", color: "pink" },
+          { id: "office.corporate.cafeteria", label: "Office Cafeteria", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "office.coworking",
+        label: "Co-working Space",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "office.coworking.common_area", label: "Common Area", level: "product", color: "pink" },
+          { id: "office.coworking.meeting_room", label: "Meeting Room", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+  {
+    id: "education",
+    label: "Education",
+    description: "Educational institutions",
+    level: "category",
+    color: "green",
+    children: [
+      {
+        id: "education.university",
+        label: "University",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "education.university.campus", label: "Campus Common", level: "product", color: "pink" },
+          { id: "education.university.library", label: "Library", level: "product", color: "pink" },
+          { id: "education.university.student_center", label: "Student Center", level: "product", color: "pink" },
+        ]
+      },
+      {
+        id: "education.school",
+        label: "School",
+        level: "sub",
+        color: "green",
+        children: [
+          { id: "education.school.cafeteria", label: "School Cafeteria", level: "product", color: "pink" },
+          { id: "education.school.gymnasium", label: "Gymnasium", level: "product", color: "pink" },
+        ]
+      },
+    ]
+  },
+];
+
+// Legacy flat VENUE_TYPES for backward compatibility
+export const VENUE_TYPES = [
+  { value: "transit", label: "Transit", description: "Transportation hubs, stations, airports, bus stops" },
+  { value: "retail", label: "Retail", description: "Shopping centers, malls, stores, marketplaces" },
+  { value: "outdoor", label: "Outdoor", description: "Roadside billboards, street furniture, digital displays" },
+  { value: "health_beauty", label: "Health & Beauty", description: "Hospitals, clinics, pharmacies, wellness centers" },
+  { value: "point_of_care", label: "Point of Care", description: "Medical facilities, diagnostic centers, treatment rooms" },
+  { value: "education", label: "Education", description: "Schools, universities, libraries, training centers" },
+  { value: "office", label: "Office Buildings", description: "Corporate offices, business centers, co-working spaces" },
+  { value: "entertainment", label: "Entertainment", description: "Cinemas, theaters, sports venues, entertainment complexes" },
+  { value: "government", label: "Government", description: "Government buildings, public offices, civic centers" },
+  { value: "financial", label: "Financial", description: "Banks, ATMs, financial institutions, trading centers" },
+  { value: "residential", label: "Residential", description: "Apartment complexes, residential communities, housing areas" },
+];
+
+// Audience Behavior categories
+export const BEHAVIORS = [
+  { value: "commuters", label: "Commuters", description: "People traveling to/from work during peak hours" },
+  { value: "shoppers", label: "Shoppers", description: "Active shoppers in retail environments" },
+  { value: "tourists", label: "Tourists", description: "Visitors and tourists in key destinations" },
+  { value: "business_travelers", label: "Business Travelers", description: "Professional travelers in airports, hotels, business districts" },
+  { value: "students", label: "Students", description: "University and college students in educational areas" },
+  { value: "families", label: "Families", description: "Family groups in entertainment and recreational venues" },
+  { value: "health_seekers", label: "Health Seekers", description: "People visiting medical facilities and wellness centers" },
+  { value: "fitness_enthusiasts", label: "Fitness Enthusiasts", description: "Active individuals near gyms, sports facilities" },
+];
+
+// Interest & Activities categories
+export const INTERESTS = [
+  "Sports & Fitness",
+  "Technology",
+  "Fashion & Style",
+  "Food & Dining",
+  "Travel",
+  "Music",
+  "Automotive",
+  "Entertainment",
+  "Home & Garden",
+  "Health & Wellness"
+];
+
+// Triggers (for Triggers tab)
+export const TRIGGERS = [
+  { value: "weather", label: "Weather Triggers", description: "Show ads based on specific weather conditions" },
+  { value: "search_behavior", label: "Search Behavior", description: "Target based on recent search interests" },
+  { value: "footfall", label: "Footfall Patterns", description: "Adjust based on real-time traffic patterns" },
+  { value: "time_based", label: "Time-Based", description: "Show different content based on time of day" },
+  { value: "local_events", label: "Local Events", description: "Target during specific local events or activities" },
+];
+
+// Points of Interest (POI)
+export interface POI {
+  id: string;
+  name: string;
+  category: string;
+  latitude: number;
+  longitude: number;
+  country: string;
+  city?: string;
+  address?: string;
+}
+
+
+// CMS Platform Types
+export type CMSPlatformType = "studio" | "broadsign" | "navori" | "signagelive" | "scala" | "yodeck" | "screencloud" | "other";
+
+export const CMS_PLATFORMS: { value: CMSPlatformType; label: string; isInternal: boolean }[] = [
+  { value: "studio", label: "Studio (Internal)", isInternal: true },
+  { value: "broadsign", label: "Broadsign", isInternal: false },
+  { value: "navori", label: "Navori QL", isInternal: false },
+  { value: "signagelive", label: "signageOS", isInternal: false },
+  { value: "scala", label: "Scala", isInternal: false },
+  { value: "yodeck", label: "Yodeck", isInternal: false },
+  { value: "screencloud", label: "ScreenCloud", isInternal: false },
+  { value: "other", label: "Other", isInternal: false },
+];
+
+// Player Status Types
+export type PlayerStatusType = "online" | "offline" | "unknown";
+
+export const PLAYER_STATUSES: { value: PlayerStatusType; label: string; color: string }[] = [
+  { value: "online", label: "Online", color: "green" },
+  { value: "offline", label: "Offline", color: "red" },
+  { value: "unknown", label: "Unknown", color: "gray" },
+];
+
+// Player Status (read-only, fetched from CMS via Inventory)
+export const playerStatuses = pgTable("player_statuses", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  screenId: varchar("screen_id").references(() => screens.id).notNull(),
+  playerId: text("player_id"), // External player ID from CMS
+  cmsType: text("cms_type").notNull(), // studio, broadsign, etc.
+  status: text("status").notNull().default("unknown"), // online, offline, unknown
+  lastHeartbeat: text("last_heartbeat"),
+  currentContent: text("current_content"), // Currently playing content name
+  connectionQuality: text("connection_quality"), // good, fair, poor
+  lastUpdated: text("last_updated"),
+});
+
+export const insertPlayerStatusSchema = createInsertSchema(playerStatuses).omit({ id: true });
+export type InsertPlayerStatus = z.infer<typeof insertPlayerStatusSchema>;
+export type PlayerStatus = typeof playerStatuses.$inferSelect;
+
+// Proof of Play (PoP) Records - fetched from CMS or derived from playlogs
+export type ProofOfPlaySource = "cms" | "playlog_upload";
+export type ProofOfPlayStatus = "processed" | "pending" | "failed";
+
+export const PROOF_OF_PLAY_SOURCES: { value: ProofOfPlaySource; label: string }[] = [
+  { value: "cms", label: "CMS (Automatic)" },
+  { value: "playlog_upload", label: "Manual Upload" },
+];
+
+export const PROOF_OF_PLAY_STATUSES: { value: ProofOfPlayStatus; label: string; color: string }[] = [
+  { value: "processed", label: "Processed", color: "green" },
+  { value: "pending", label: "Pending", color: "yellow" },
+  { value: "failed", label: "Failed", color: "red" },
+];
+
+export const proofOfPlay = pgTable("proof_of_play", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  screenId: varchar("screen_id").references(() => screens.id),
+  playerId: text("player_id"),
+  creativeId: varchar("creative_id").references(() => creatives.id),
+  dealId: varchar("deal_id").references(() => deals.id),
+  lineItemId: varchar("line_item_id").references(() => lineItems.id),
+  startTimestamp: text("start_timestamp").notNull(),
+  endTimestamp: text("end_timestamp").notNull(),
+  durationSeconds: integer("duration_seconds").notNull(),
+  impressionCount: integer("impression_count").default(1),
+  mediaFileUrl: text("media_file_url"), // For verification
+  proofImageUrl: text("proof_image_url"), // Optional proof image
+  proofVideoUrl: text("proof_video_url"), // Optional proof video
+  source: text("source").notNull().default("cms"), // cms or playlog_upload
+  status: text("status").notNull().default("pending"), // processed, pending, failed
+  errorMessage: text("error_message"),
+  mediaOwnerId: varchar("media_owner_id").references(() => mediaOwners.id),
+  uploadedBy: text("uploaded_by"),
+  uploadedAt: text("uploaded_at"),
+  processedAt: text("processed_at"),
+  syncedToMeasure: boolean("synced_to_measure").default(false),
+  syncedAt: text("synced_at"),
+});
+
+export const insertProofOfPlaySchema = createInsertSchema(proofOfPlay).omit({ id: true });
+export type InsertProofOfPlay = z.infer<typeof insertProofOfPlaySchema>;
+export type ProofOfPlay = typeof proofOfPlay.$inferSelect;
+
+// Playlog Uploads - batch uploads from media owners
+export type PlaylogUploadStatus = "uploaded" | "validating" | "processing" | "completed" | "failed";
+
+export const PLAYLOG_UPLOAD_STATUSES: { value: PlaylogUploadStatus; label: string; color: string }[] = [
+  { value: "uploaded", label: "Uploaded", color: "blue" },
+  { value: "validating", label: "Validating", color: "yellow" },
+  { value: "processing", label: "Processing", color: "yellow" },
+  { value: "completed", label: "Completed", color: "green" },
+  { value: "failed", label: "Failed", color: "red" },
+];
+
+export const playlogUploads = pgTable("playlog_uploads", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  dealId: varchar("deal_id").references(() => deals.id),
+  lineItemId: varchar("line_item_id").references(() => lineItems.id),
+  creativeId: varchar("creative_id").references(() => creatives.id), // Optional filter
+  mediaOwnerId: varchar("media_owner_id").references(() => mediaOwners.id).notNull(),
+  fileName: text("file_name").notNull(),
+  fileUrl: text("file_url").notNull(),
+  totalRecords: integer("total_records").default(0),
+  validRecords: integer("valid_records").default(0),
+  invalidRecords: integer("invalid_records").default(0),
+  status: text("status").notNull().default("uploaded"),
+  validationErrors: jsonb("validation_errors"), // Array of error messages
+  proofMediaUrls: text("proof_media_urls").array(), // Images/videos as proof
+  uploadedBy: text("uploaded_by").notNull(),
+  uploadedAt: text("uploaded_at").notNull(),
+  processedAt: text("processed_at"),
+  notes: text("notes"),
+});
+
+export const insertPlaylogUploadSchema = createInsertSchema(playlogUploads).omit({ id: true });
+export type InsertPlaylogUpload = z.infer<typeof insertPlaylogUploadSchema>;
+export type PlaylogUpload = typeof playlogUploads.$inferSelect;
+
+// Playlog Template Structure (for CSV download)
+// Based on CMS industry standards (Broadsign, etc.)
+// Note: Impressions are calculated by Measure platform, not provided by user
+// Duration is calculated from start/end timestamps
+export interface PlaylogTemplateRow {
+  dealId: string; // Deal ID for mapping
+  lineItemId: string; // Line Item ID for mapping
+  referenceId: string; // Inventory reference ID (was screenId)
+  playerId?: string; // Player ID (optional)
+  creativeId: string; // Creative ID
+  startDatetime: string; // ISO format (e.g., 2024-01-15T10:00:00Z)
+  endDatetime: string; // ISO format
+  notes?: string; // Optional notes
+}
+
+// Playlog Template Guidelines (shown to user)
+export const PLAYLOG_TEMPLATE_GUIDELINES = {
+  description: "This template is used to upload playlog data for traditional campaigns.",
+  columns: {
+    dealId: "The Deal ID from the platform. Required for mapping.",
+    lineItemId: "The Line Item ID from the platform. Required for mapping.",
+    referenceId: "Your inventory reference ID (e.g., screen ID, display ID).",
+    playerId: "Optional player device ID if different from reference ID.",
+    creativeId: "The Creative ID from the platform or your internal reference.",
+    startDatetime: "When the content started playing. Format: ISO 8601 (e.g., 2024-01-15T10:00:00Z)",
+    endDatetime: "When the content finished playing. Format: ISO 8601 (e.g., 2024-01-15T10:00:15Z)",
+    notes: "Optional notes for this play record.",
+  },
+  instructions: [
+    "Do not modify the header row (first row).",
+    "The second row is a sample - replace it with your actual data.",
+    "Duration and impressions are calculated automatically by the Measure platform.",
+    "Dates must be in ISO 8601 format with timezone (Z for UTC or +HH:MM offset).",
+    "If uploading Excel (.xlsx), save as CSV before upload, or upload Excel directly.",
+  ],
+};
+
+// Geotargeting Rules
+export const geoTargetingRules = pgTable("geo_targeting_rules", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  entityType: text("entity_type").notNull(), // 'deal' | 'lineItem'
+  entityId: text("entity_id").notNull(),
+  mode: text("mode").notNull(), // 'regions' | 'proximity'
+  name: text("name"),
+  // For regions mode
+  locations: jsonb("locations"), // Array of { name, lat, lng, radius, include }
+  // For proximity mode
+  shapes: jsonb("shapes"), // Array of { type: 'polygon'|'circle'|'freeform', coordinates, measurements, include }
+  // POI targeting
+  poiCategories: text("poi_categories").array(),
+  poiLocations: jsonb("poi_locations"), // Array of selected POI IDs with include/exclude
+  createdAt: text("created_at").notNull(),
+  updatedAt: text("updated_at").notNull(),
+});
+
+export const insertGeoTargetingRuleSchema = createInsertSchema(geoTargetingRules).omit({ id: true });
+export type InsertGeoTargetingRule = z.infer<typeof insertGeoTargetingRuleSchema>;
+export type GeoTargetingRule = typeof geoTargetingRules.$inferSelect;
+
+// Geotargeting Location interface
+export interface GeoLocation {
+  id: string;
+  name: string;
+  address?: string;
+  lat: number;
+  lng: number;
+  radius: number; // in meters
+  include: boolean;
+}
+
+// Geotargeting Shape interface
+export interface GeoShape {
+  id: string;
+  type: 'polygon' | 'circle' | 'point';
+  coordinates: number[][][] | number[][] | number[];
+  measurements: string; // e.g., "8,670,133 m²"
+  include: boolean;
+}
+
+// Transit Routes (for transit inventory visualization)
+export const transitRoutes = pgTable("transit_routes", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  routeType: text("route_type").notNull(), // 'train' | 'bus' | 'mrt' | 'lrt'
+  routeNumber: text("route_number"),
+  color: text("color"), // hex color for map display
+  geojson: jsonb("geojson").notNull(), // GeoJSON LineString or MultiLineString
+  city: text("city"),
+  country: text("country"),
+  operatorName: text("operator_name"),
+});
+
+export const insertTransitRouteSchema = createInsertSchema(transitRoutes).omit({ id: true });
+export type InsertTransitRoute = z.infer<typeof insertTransitRouteSchema>;
+export type TransitRoute = typeof transitRoutes.$inferSelect;
+
+// Transit Zones (for taxi/ride-hail coverage areas)
+export const transitZones = pgTable("transit_zones", {
+  id: varchar("id").primaryKey().default(sql`gen_random_uuid()`),
+  name: text("name").notNull(),
+  zoneType: text("zone_type").notNull(), // 'taxi' | 'ridehail' | 'coverage'
+  geojson: jsonb("geojson").notNull(), // GeoJSON Polygon
+  color: text("color"),
+  city: text("city"),
+  country: text("country"),
+});
+
+export const insertTransitZoneSchema = createInsertSchema(transitZones).omit({ id: true });
+export type InsertTransitZone = z.infer<typeof insertTransitZoneSchema>;
+export type TransitZone = typeof transitZones.$inferSelect;
+
+// Creative Specifications (for Content Hub upload validation)
+export interface CreativeSpec {
+  type: string; // 'display' | 'video' | 'html' | 'native'
+  formats: string[];
+  maxSizeBytes: number;
+  maxSizeMB: number;
+  dimensions?: { width: number; height: number; label: string }[];
+  maxDuration?: number; // seconds, for video
+  minDuration?: number;
+  additionalRequirements?: string[];
+}
+
+// =====================================================
+// RECOMMENDATION ENGINE V2 TYPES
+// Integration with MW Planner Recommendation Engine
+// =====================================================
+
+// Campaign Goal Types - used for recommendation optimization
+export type CampaignGoalType = 'impressions' | 'reach' | 'sov' | 'ad_plays' | 'carbon_emission';
+
+export const CAMPAIGN_GOAL_TYPES: { value: CampaignGoalType; label: string; description: string }[] = [
+  { value: 'impressions', label: 'Impressions', description: 'Maximize total ad views' },
+  { value: 'reach', label: 'Reach', description: 'Maximize unique people who see the ad' },
+  { value: 'sov', label: 'Share of Voice', description: 'Achieve target percentage of available ad plays' },
+  { value: 'ad_plays', label: 'Ad Plays', description: 'Maximize number of times ad is displayed' },
+  { value: 'carbon_emission', label: 'Carbon Emission', description: 'Minimize environmental impact' },
+];
+
+// Inventory Classification - broadest categorization (for recommendations)
+export type RecommendationClassification = 'digital' | 'classic' | 'audio';
+
+export const RECOMMENDATION_CLASSIFICATIONS: { value: RecommendationClassification; label: string }[] = [
+  { value: 'digital', label: 'Digital' },
+  { value: 'classic', label: 'Classic' },
+  { value: 'audio', label: 'Audio' },
+];
+
+// Inventory Type - categorization by venue/placement context
+export type RecommendationInventoryType = 'ooh' | 'transit' | 'retail' | 'network' | 'radio' | 'experiential';
+
+export const RECOMMENDATION_INVENTORY_TYPES: { value: RecommendationInventoryType; label: string }[] = [
+  { value: 'ooh', label: 'OOH' },
+  { value: 'transit', label: 'Transit' },
+  { value: 'retail', label: 'Retail' },
+  { value: 'network', label: 'Network' },
+  { value: 'radio', label: 'Radio' },
+  { value: 'experiential', label: 'Experiential' },
+];
+
+// Recommendation Score Components - 8 factors from the engine
+export interface RecommendationScoreComponents {
+  measureFit: number;      // 0-100: How well inventory delivers campaign goal
+  geoFit: number;          // 0-100: Location relevance to target geography
+  availability: number;    // 0-100: Fraction of requested schedule available
+  budgetFit: number;       // 0-100: Cost efficiency relative to budget
+  audienceFit: number;     // 0-100: Audience segment overlap
+  brandFit: number;        // 0-100: Brand category to venue affinity
+  qualityFit: number;      // 0-100: Physical/creative quality score
+  timeFit: number;         // 0-100: Daypart/date alignment
+}
+
+// Default scoring weights by goal type
+export const RECOMMENDATION_WEIGHTS: Record<CampaignGoalType | 'default', Record<keyof RecommendationScoreComponents, number>> = {
+  default: { measureFit: 0.20, geoFit: 0.20, availability: 0.10, budgetFit: 0.20, audienceFit: 0.10, brandFit: 0.10, qualityFit: 0.06, timeFit: 0.04 },
+  impressions: { measureFit: 0.25, geoFit: 0.20, availability: 0.10, budgetFit: 0.18, audienceFit: 0.10, brandFit: 0.08, qualityFit: 0.05, timeFit: 0.04 },
+  reach: { measureFit: 0.22, geoFit: 0.22, availability: 0.12, budgetFit: 0.15, audienceFit: 0.12, brandFit: 0.08, qualityFit: 0.05, timeFit: 0.04 },
+  sov: { measureFit: 0.25, geoFit: 0.15, availability: 0.15, budgetFit: 0.20, audienceFit: 0.08, brandFit: 0.08, qualityFit: 0.05, timeFit: 0.04 },
+  ad_plays: { measureFit: 0.28, geoFit: 0.15, availability: 0.12, budgetFit: 0.18, audienceFit: 0.10, brandFit: 0.08, qualityFit: 0.05, timeFit: 0.04 },
+  carbon_emission: { measureFit: 0.18, geoFit: 0.15, availability: 0.10, budgetFit: 0.15, audienceFit: 0.10, brandFit: 0.08, qualityFit: 0.20, timeFit: 0.04 },
+};
+
+// Individual Inventory Recommendation
+export interface InventoryRecommendation {
+  inventoryId: string;
+  inventoryName: string;
+  screenType: string;
+  classification: RecommendationClassification;
+  inventoryType: RecommendationInventoryType;
+  format: string;
+  location: {
+    city: string;
+    country: string;
+    latitude: number;
+    longitude: number;
+  };
+  score: number;                           // Final score 0-100
+  scoreComponents: RecommendationScoreComponents;
+  metrics: {
+    estimatedImpressions: number;
+    estimatedReach?: number;
+    estimatedAdPlays?: number;
+    estimatedCost: number;
+    cpm: number;
+    dailyImpressions: number;
+  };
+  availability: {
+    availableDays: number;
+    totalDays: number;
+    summary: string;                        // e.g., "25/31 days available"
+  };
+  whyRecommended: string;                   // AI-generated explanation
+  aiUsed: boolean;
+  aiConfidence?: number;
+  warnings: string[];
+}
+
+// Recommendation Request - sent to the engine
+export interface RecommendationRequest {
+  country: string;
+  startDate: string;
+  endDate: string;
+  budget?: number;
+  currency?: string;
+  goalType?: CampaignGoalType;
+  goalValue?: number;
+  brandId?: string;
+  brandName?: string;
+  audienceSegments?: string[];
+  geography?: {
+    cities?: string[];
+    polygon?: number[][][];
+    poiIds?: string[];
+  };
+  limit?: number;
+  seed?: string;                            // For deterministic results
+}
+
+// Recommendation Response - from the engine
+export interface RecommendationResponse {
+  runId: string;
+  status: 'success' | 'no_matches' | 'partial' | 'error';
+  recommendations: InventoryRecommendation[];
+  summary: {
+    totalInventoriesAnalyzed: number;
+    totalReturned: number;
+    estimatedTotalImpressions: number;
+    estimatedTotalReach?: number;
+    estimatedTotalCost: number;
+    budgetUtilization: number;              // Percentage
+    goalAchievement?: number;               // Percentage of goal met
+  };
+  budgetAllocation?: {
+    byClassification: Record<RecommendationClassification, { percentage: number; amount: number }>;
+    byType: Record<RecommendationInventoryType, { percentage: number; amount: number }>;
+    byCity?: Record<string, { percentage: number; amount: number }>;
+  };
+  suggestions?: string[];                    // Alternative suggestions if no matches
+  warnings: string[];
+  generatedAt: string;
+}
+
+// Auto-Optimize Request for Line Items
+export interface AutoOptimizeRequest {
+  lineItemId: string;
+  dealId: string;
+  budget?: number;
+  goalType?: CampaignGoalType;
+  goalValue?: number;
+  maxInventories?: number;
+  preferredTypes?: RecommendationInventoryType[];
+}
+
+// Auto-Optimize Response
+export interface AutoOptimizeResult {
+  lineItemId: string;
+  selectedInventories: InventoryRecommendation[];
+  scheduleCreated: boolean;
+  summary: {
+    inventoriesAdded: number;
+    estimatedImpressions: number;
+    estimatedCost: number;
+    budgetRemaining: number;
+  };
+  warnings: string[];
+}
+
+// Validation Schemas for Recommendation API
+export const recommendationRequestSchema = z.object({
+  country: z.string().default("US"),
+  startDate: z.string().min(1, "Start date is required"),
+  endDate: z.string().min(1, "End date is required"),
+  budget: z.number().optional(),
+  currency: z.string().default("USD"),
+  goalType: z.enum(["impressions", "reach", "sov", "ad_plays", "carbon_emission"]).optional(),
+  goalValue: z.number().optional(),
+  brandId: z.string().optional(),
+  brandName: z.string().optional(),
+  audienceSegments: z.array(z.string()).optional(),
+  geography: z.object({
+    cities: z.array(z.string()).optional(),
+    polygon: z.array(z.array(z.array(z.number()))).optional(),
+    poiIds: z.array(z.string()).optional(),
+  }).optional(),
+  limit: z.number().min(1).max(100).default(10),
+  seed: z.string().optional(),
+});
+
+export type ValidatedRecommendationRequest = z.infer<typeof recommendationRequestSchema>;
+
+export const autoOptimizeRequestSchema = z.object({
+  budget: z.number().optional(),
+  goalType: z.enum(["impressions", "reach", "sov", "ad_plays", "carbon_emission"]).optional(),
+  goalValue: z.number().optional(),
+  maxInventories: z.number().min(1).max(20).default(5),
+  preferredTypes: z.array(z.enum(["ooh", "transit", "retail", "network", "radio", "experiential"])).optional(),
+});
+
+export type ValidatedAutoOptimizeRequest = z.infer<typeof autoOptimizeRequestSchema>;