adserver-dashboard 1.0.0

package/PCM/src/dto/EmailRequestDTO.js

@@ -0,0 +1,166 @@
+export class ApprovalEmailBodyDTO {
+  constructor({
+    user = {},
+    approverEmail = '',
+    dealName,
+    dealId,
+    budget,
+    noLineItems,
+    approvalLink,
+    publisherName = '',
+    logoUrl = null,
+    layoutCompanyName = '',
+    layoutAddress = '',
+    layoutPhoneNumber = '',
+    layoutEmail = ''
+  }) {
+    const derivedFirstname = approverEmail ? approverEmail.split('@')[0] : '';
+    this.user = {
+      firstname: user.firstname || derivedFirstname,
+      lastname: user.lastname || ''
+    };
+    this.deal_name = dealName;
+    this.deal_id = dealId;
+    this.budget = budget;
+    this.no_line_items = String(noLineItems);
+    this.approval_link = approvalLink;
+    this.publisher_name = publisherName;
+    this.logoUrl = logoUrl;
+    this.layoutCompanyName = layoutCompanyName;
+    this.layoutAddress = layoutAddress;
+    this.layoutPhoneNumber = layoutPhoneNumber;
+    this.layoutEmail = layoutEmail;
+  }
+
+  toJSON() {
+    return JSON.stringify({
+      user: this.user,
+      deal_name: this.deal_name,
+      deal_id: this.deal_id,
+      budget: this.budget,
+      no_line_items: this.no_line_items,
+      approval_link: this.approval_link,
+      publisher_name: this.publisher_name,
+      logoUrl: this.logoUrl,
+      layoutCompanyName: this.layoutCompanyName,
+      layoutAddress: this.layoutAddress,
+      layoutPhoneNumber: this.layoutPhoneNumber,
+      layoutEmail: this.layoutEmail
+    });
+  }
+}
+
+export class OTPEmailBodyDTO {
+  constructor({
+    user = {},
+    approverEmail = '',
+    code,
+    mediaownerName = '',
+    logoUrl = null,
+    layoutCompanyName = '',
+    layoutAddress = '',
+    layoutPhoneNumber = '',
+    layoutEmail = ''
+  }) {
+    const derivedFirstname = approverEmail ? approverEmail.split('@')[0] : '';
+    this.user = {
+      firstname: user.firstname || derivedFirstname,
+      lastname: user.lastname || ''
+    };
+    this.code = code;
+    this.mediaownerName = mediaownerName;
+    this.logoUrl = logoUrl;
+    this.layoutCompanyName = layoutCompanyName;
+    this.layoutAddress = layoutAddress;
+    this.layoutPhoneNumber = layoutPhoneNumber;
+    this.layoutEmail = layoutEmail;
+  }
+
+  toJSON() {
+    return JSON.stringify({
+      user: this.user,
+      code: this.code,
+      mediaownerName: this.mediaownerName,
+      logoUrl: this.logoUrl,
+      layoutCompanyName: this.layoutCompanyName,
+      layoutAddress: this.layoutAddress,
+      layoutPhoneNumber: this.layoutPhoneNumber,
+      layoutEmail: this.layoutEmail
+    });
+  }
+}
+
+export class DecisionEmailBodyDTO {
+  constructor({
+    user = {},
+    sellerEmail = '',
+    dealName,
+    dealId,
+    budget,
+    noLineItems,
+    approverEmail,
+    logoUrl = null,
+    layoutCompanyName = '',
+    layoutAddress = '',
+    layoutPhoneNumber = '',
+    layoutEmail = ''
+  }) {
+    const derivedFirstname = sellerEmail ? sellerEmail.split('@')[0] : '';
+    this.user = {
+      firstname: user.firstname || derivedFirstname,
+      lastname: user.lastname || ''
+    };
+    this.deal_name = dealName;
+    this.deal_id = dealId;
+    this.budget = budget;
+    this.no_line_items = String(noLineItems);
+    this.approver = approverEmail;
+    this.logoUrl = logoUrl;
+    this.layoutCompanyName = layoutCompanyName;
+    this.layoutAddress = layoutAddress;
+    this.layoutPhoneNumber = layoutPhoneNumber;
+    this.layoutEmail = layoutEmail;
+  }
+
+  toJSON() {
+    return JSON.stringify({
+      user: this.user,
+      deal_name: this.deal_name,
+      deal_id: this.deal_id,
+      budget: this.budget,
+      no_line_items: this.no_line_items,
+      approver: this.approver,
+      logoUrl: this.logoUrl,
+      layoutCompanyName: this.layoutCompanyName,
+      layoutAddress: this.layoutAddress,
+      layoutPhoneNumber: this.layoutPhoneNumber,
+      layoutEmail: this.layoutEmail
+    });
+  }
+}
+
+export class EmailRequestDTO {
+  constructor({
+    from,
+    to,
+    subject,
+    body,
+    template
+  }) {
+    this.from = from;
+    this.to = Array.isArray(to) ? to : [to];
+    this.subject = subject;
+    this.body = body;
+    this.template = template;
+  }
+
+  toPayload() {
+    return {
+      from: this.from,
+      to: this.to,
+      subject: this.subject,
+      body: typeof this.body === 'string' ? this.body : this.body.toJSON(),
+      template: this.template
+    };
+  }
+}

package/PCM/src/middleware/errorHandler.js

@@ -0,0 +1,52 @@
+export const errorHandler = (err, req, res, next) => {
+  console.error('Error:', err);
+
+  if (err.name === 'ValidationError') {
+    const errors = err.details?.map(detail => ({
+      field: detail.path.join('.'),
+      message: detail.message
+    })) || [];
+
+    return res.status(400).json({
+      code: 'VALIDATION_ERROR',
+      message: 'Invalid request payload',
+      errors
+    });
+  }
+
+  if (err.name === 'SequelizeUniqueConstraintError') {
+    const fields = err.errors?.map(e => e.path).join(', ') || 'unknown';
+    return res.status(409).json({
+      code: 'CONFLICT',
+      message: `Duplicate value for: ${fields}`,
+      details: err.errors?.map(e => ({ field: e.path, value: e.value, message: e.message })) || []
+    });
+  }
+
+  if (err.name === 'SequelizeValidationError') {
+    return res.status(400).json({
+      code: 'VALIDATION_ERROR',
+      message: 'Database validation failed',
+      errors: err.errors?.map(e => ({ field: e.path, message: e.message, value: e.value })) || []
+    });
+  }
+
+  if (err.name === 'SequelizeForeignKeyConstraintError') {
+    return res.status(400).json({
+      code: 'REFERENCE_ERROR',
+      message: 'Referenced resource does not exist'
+    });
+  }
+
+  if (err.statusCode) {
+    return res.status(err.statusCode).json({
+      code: err.code || 'ERROR',
+      message: err.message
+    });
+  }
+
+  res.status(500).json({
+    code: 'INTERNAL_ERROR',
+    message: 'An unexpected error occurred'
+  });
+};

package/PCM/src/middleware/logger.js

@@ -0,0 +1,26 @@
+import { v4 as uuidv4 } from 'uuid';
+import TransactionHistory from '../models/TransactionHistory.js';
+
+export const requestLogger = async (req, res, next) => {
+  const requestId = uuidv4();
+  req.requestId = requestId;
+
+  const originalSend = res.send;
+  res.send = function (data) {
+    res.send = originalSend;
+    
+    TransactionHistory.create({
+      request_id: requestId,
+      method: req.method,
+      endpoint: req.originalUrl || req.url,
+      payload: req.body || {},
+      response_status: res.statusCode
+    }).catch(err => {
+      console.error('Error logging transaction:', err);
+    });
+    
+    return res.send(data);
+  };
+
+  next();
+};

package/PCM/src/migrations/001_add_campaign_mode_fields.sql

@@ -0,0 +1,36 @@
+-- Migration: Add Campaign Mode fields to deals table
+-- Version: 001
+-- Date: December 2025
+-- Description: Adds brand, client_type, mode, approval_emails, market_selection, budget_setup, campaign_goal fields
+-- Note: Using TEXT for client_type and mode to match Sequelize model and avoid ENUM management complexity
+
+-- Add new columns to deals table (all TEXT-based for flexibility)
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS brand TEXT;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS client_type TEXT;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS mode TEXT;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS approval_emails TEXT[];
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS market_selection JSONB;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS budget_setup JSONB;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS campaign_goal JSONB;
+
+-- Add check constraints for validation (instead of ENUMs)
+DO $$
+BEGIN
+    IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'deals_client_type_check') THEN
+        ALTER TABLE deals ADD CONSTRAINT deals_client_type_check 
+            CHECK (client_type IS NULL OR client_type IN ('DIRECT_ADVERTISER', 'AGENCY'));
+    END IF;
+    IF NOT EXISTS (SELECT 1 FROM pg_constraint WHERE conname = 'deals_mode_check') THEN
+        ALTER TABLE deals ADD CONSTRAINT deals_mode_check 
+            CHECK (mode IS NULL OR mode IN ('PROGRAMMATIC', 'DIRECT'));
+    END IF;
+END$$;
+
+-- Add comments for documentation
+COMMENT ON COLUMN deals.brand IS 'Brand name (dropdown selection)';
+COMMENT ON COLUMN deals.client_type IS 'Client type: BUYER or AGENCY';
+COMMENT ON COLUMN deals.mode IS 'Campaign mode: PROGRAMMATIC or DIRECT';
+COMMENT ON COLUMN deals.approval_emails IS 'List of approval email addresses (required for DIRECT mode)';
+COMMENT ON COLUMN deals.market_selection IS 'Market and currency selection (required for DIRECT mode)';
+COMMENT ON COLUMN deals.budget_setup IS 'Budget configuration (required for DIRECT mode)';
+COMMENT ON COLUMN deals.campaign_goal IS 'Campaign goal configuration (required for DIRECT mode)';

package/PCM/src/migrations/002_create_deal_id_counters.sql

@@ -0,0 +1,22 @@
+-- Migration: Create deal_id_counters table for sequence tracking
+-- This table maintains sequence counters for auto-generating deal IDs
+
+CREATE TABLE IF NOT EXISTS deal_id_counters (
+    id SERIAL PRIMARY KEY,
+    prefix VARCHAR(10) NOT NULL UNIQUE,
+    current_value BIGINT NOT NULL DEFAULT 0,
+    created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Initialize counters for each deal type prefix
+INSERT INTO deal_id_counters (prefix, current_value) VALUES 
+    ('GD', 0),
+    ('PD', 0),
+    ('PA', 0),
+    ('EG', 0),
+    ('DIR', 0)
+ON CONFLICT (prefix) DO NOTHING;
+
+-- Create index for faster lookups
+CREATE INDEX IF NOT EXISTS idx_deal_id_counters_prefix ON deal_id_counters(prefix);

package/PCM/src/migrations/003_update_publishers_column.sql

@@ -0,0 +1,15 @@
+DO $$
+BEGIN
+  IF EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'deals' AND column_name = 'publisher_ids') THEN
+    IF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'deals' AND column_name = 'publishers') THEN
+      ALTER TABLE deals ADD COLUMN publishers JSONB;
+      UPDATE deals SET publishers = (
+        SELECT jsonb_agg(jsonb_build_object('id', elem, 'name', elem))
+        FROM unnest(publisher_ids) AS elem
+      ) WHERE publisher_ids IS NOT NULL AND array_length(publisher_ids, 1) > 0;
+    END IF;
+    ALTER TABLE deals DROP COLUMN publisher_ids;
+  ELSIF NOT EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'deals' AND column_name = 'publishers') THEN
+    ALTER TABLE deals ADD COLUMN publishers JSONB;
+  END IF;
+END $$;

package/PCM/src/migrations/004_add_direct_dealtype_and_advertiser.sql

@@ -0,0 +1,5 @@
+-- Add DIRECT to deal_type enum (using correct enum name)
+ALTER TYPE deal_type_enum ADD VALUE IF NOT EXISTS 'DIRECT';
+
+-- Add advertiser column if not exists
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS advertiser JSONB;

package/PCM/src/migrations/005_add_programmatic_fields_and_update_enums.sql

@@ -0,0 +1,31 @@
+-- Add new status values to status enum
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'REQUESTED';
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'REJECTED';
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'CANCELED';
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'DELETED';
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'PENDING_CREATIVES';
+ALTER TYPE status_enum ADD VALUE IF NOT EXISTS 'IN_ACTIVE';
+
+-- Create transaction_type enum if not exists
+DO $$ BEGIN
+  CREATE TYPE transaction_type_enum AS ENUM ('SPOT', 'AUDIENCE');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+-- Create imp_multiplier_type enum if not exists
+DO $$ BEGIN
+  CREATE TYPE imp_multiplier_type_enum AS ENUM ('MAD', 'CUSTOM');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+-- Add new programmatic fields
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS published BOOLEAN DEFAULT false;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS reopened BOOLEAN DEFAULT false;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS non_billable BOOLEAN DEFAULT false;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS stop_bid_requests BOOLEAN DEFAULT false;
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS imp_multiplier_type imp_multiplier_type_enum;
+
+-- Set default status to GENERATED for new records
+ALTER TABLE deals ALTER COLUMN status SET DEFAULT 'GENERATED';

package/PCM/src/migrations/006_add_line_item_programmatic_fields.sql

@@ -0,0 +1,12 @@
+-- Migration: Add programmatic fields to line_items table
+-- Date: 2025-12-10
+
+-- Add new columns to line_items table using TEXT types to avoid enum issues
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS mode TEXT;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS resolutions TEXT[];
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS creative_source TEXT;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS total_inventories INTEGER DEFAULT 0;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS adm_creative_sync BOOLEAN DEFAULT false;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS non_billable BOOLEAN DEFAULT false;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS stop_bid_requests BOOLEAN DEFAULT false;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS imp_multiplier JSONB;

package/PCM/src/migrations/007_add_line_item_direct_fields.sql

@@ -0,0 +1,15 @@
+-- Migration: Add DIRECT mode fields to line_items table
+-- Date: 2025-01-10
+-- Description: Adds budgetSetup, campaignGoal, pacing, and targeting fields for DIRECT mode line items
+
+-- Add DIRECT mode specific fields
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS budget_setup JSONB;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS campaign_goal JSONB;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS pacing JSONB;
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS targeting JSONB;
+
+-- Add comments for documentation
+COMMENT ON COLUMN line_items.budget_setup IS 'Budget configuration for DIRECT mode line items';
+COMMENT ON COLUMN line_items.campaign_goal IS 'Campaign goal settings for DIRECT mode line items';
+COMMENT ON COLUMN line_items.pacing IS 'Pacing configuration for DIRECT mode line items';
+COMMENT ON COLUMN line_items.targeting IS 'Targeting rules for DIRECT mode line items';

package/PCM/src/migrations/008_add_inventory_fields.sql

@@ -0,0 +1,45 @@
+-- Migration: Add comprehensive inventory fields to line_item_inventories table
+-- Date: 2025-01-10
+-- Description: Adds new fields for ad unit identification, location, venue, display settings, and content controls
+
+-- Identifier fields
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS ad_unit_code TEXT;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS reference_id TEXT;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS device_id TEXT;
+
+-- Location/Country fields
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS country_iso2 TEXT;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS country_iso3 TEXT;
+
+-- Venue fields
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS venue_type_ids TEXT[];
+
+-- Operational metrics
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS spots_per_hour INTEGER;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS spot_duration INTEGER;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS clients INTEGER;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS "group" TEXT;
+
+-- Content controls
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS bcat JSONB;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS publisher_domain TEXT;
+
+-- Display/Aspect ratio fields
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS enable_aspect_ratio BOOLEAN DEFAULT false;
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS display_aspect_ratio TEXT;
+
+-- Add comments for documentation
+COMMENT ON COLUMN line_item_inventories.ad_unit_code IS 'Ad unit code identifier';
+COMMENT ON COLUMN line_item_inventories.reference_id IS 'External reference identifier';
+COMMENT ON COLUMN line_item_inventories.device_id IS 'Device identifier';
+COMMENT ON COLUMN line_item_inventories.country_iso2 IS 'ISO 3166-1 alpha-2 country code';
+COMMENT ON COLUMN line_item_inventories.country_iso3 IS 'ISO 3166-1 alpha-3 country code';
+COMMENT ON COLUMN line_item_inventories.venue_type_ids IS 'Array of venue type identifiers';
+COMMENT ON COLUMN line_item_inventories.spots_per_hour IS 'Number of ad spots per hour';
+COMMENT ON COLUMN line_item_inventories.spot_duration IS 'Duration of each spot in seconds';
+COMMENT ON COLUMN line_item_inventories.clients IS 'Number of clients/advertisers';
+COMMENT ON COLUMN line_item_inventories."group" IS 'Inventory grouping identifier';
+COMMENT ON COLUMN line_item_inventories.bcat IS 'Blocked categories list [{name, code}]';
+COMMENT ON COLUMN line_item_inventories.publisher_domain IS 'Publisher domain URL';
+COMMENT ON COLUMN line_item_inventories.enable_aspect_ratio IS 'Whether aspect ratio constraints are enabled';
+COMMENT ON COLUMN line_item_inventories.display_aspect_ratio IS 'Display aspect ratio (e.g., 16:9)';

package/PCM/src/migrations/009_move_inventory_fields_to_metadata.sql

@@ -0,0 +1,32 @@
+-- Migration: Move inventory operational fields to metadata JSONB
+-- Fields moved: spots_per_hour, spot_duration, clients, group
+-- (transit was already stored in metadata, not as a column)
+-- New fields added to metadata: networkId, packageId
+-- This migration is idempotent - safe to run multiple times
+
+-- Step 1: Migrate existing data from columns to metadata (only if columns exist)
+DO $$
+BEGIN
+  IF EXISTS (SELECT 1 FROM information_schema.columns WHERE table_name = 'line_item_inventories' AND column_name = 'spots_per_hour') THEN
+    EXECUTE '
+      UPDATE line_item_inventories
+      SET metadata = COALESCE(metadata, ''{}''::jsonb)
+        || jsonb_strip_nulls(jsonb_build_object(
+          ''spotsPerHour'', spots_per_hour,
+          ''spotDuration'', spot_duration,
+          ''clients'', clients,
+          ''group'', "group"
+        ))
+      WHERE spots_per_hour IS NOT NULL 
+         OR spot_duration IS NOT NULL 
+         OR clients IS NOT NULL 
+         OR "group" IS NOT NULL
+    ';
+  END IF;
+END $$;
+
+-- Step 2: Drop the columns that are now in metadata
+ALTER TABLE line_item_inventories DROP COLUMN IF EXISTS spots_per_hour;
+ALTER TABLE line_item_inventories DROP COLUMN IF EXISTS spot_duration;
+ALTER TABLE line_item_inventories DROP COLUMN IF EXISTS clients;
+ALTER TABLE line_item_inventories DROP COLUMN IF EXISTS "group";

package/PCM/src/migrations/010_add_draft_status_and_line_items_count.sql

@@ -0,0 +1,23 @@
+DO $$
+BEGIN
+    IF NOT EXISTS (
+        SELECT 1 FROM pg_enum 
+        WHERE enumlabel = 'DRAFT' 
+        AND enumtypid = (SELECT oid FROM pg_type WHERE typname = 'enum_deals_status')
+    ) THEN
+        ALTER TYPE "enum_deals_status" ADD VALUE 'DRAFT' BEFORE 'REQUESTED';
+    END IF;
+END$$;
+
+DO $$
+BEGIN
+    IF NOT EXISTS (
+        SELECT 1 FROM pg_enum 
+        WHERE enumlabel = 'DRAFT' 
+        AND enumtypid = (SELECT oid FROM pg_type WHERE typname = 'status_enum')
+    ) THEN
+        ALTER TYPE "status_enum" ADD VALUE 'DRAFT' BEFORE 'GENERATED';
+    END IF;
+END$$;
+
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS line_items_count INTEGER DEFAULT 0;

package/PCM/src/migrations/011_add_planning_field.sql

@@ -0,0 +1,21 @@
+-- Migration: Add planning field for DIRECT campaigns
+-- The planning object contains capacity, allocation, estimates, and pricing data
+
+-- Add planning column to deals table (aggregated from line items)
+ALTER TABLE deals ADD COLUMN IF NOT EXISTS planning JSONB;
+
+-- Add planning column to line_items table
+ALTER TABLE line_items ADD COLUMN IF NOT EXISTS planning JSONB;
+
+-- Add planning column to line_item_inventories table
+ALTER TABLE line_item_inventories ADD COLUMN IF NOT EXISTS planning JSONB;
+
+-- Create index for planning field on line_items (for querying DIRECT campaigns with planning data)
+CREATE INDEX IF NOT EXISTS idx_line_items_planning ON line_items USING GIN (planning) WHERE planning IS NOT NULL;
+
+-- Create index for planning field on line_item_inventories
+CREATE INDEX IF NOT EXISTS idx_line_item_inventories_planning ON line_item_inventories USING GIN (planning) WHERE planning IS NOT NULL;
+
+-- Comment on columns
+COMMENT ON COLUMN line_items.planning IS 'Planning data for DIRECT campaigns: capacity, allocation, estimates, pricing';
+COMMENT ON COLUMN line_item_inventories.planning IS 'Planning data for DIRECT inventory units: capacity, allocation, estimates, pricing';

package/PCM/src/migrations/012_fix_inventory_composite_pk.sql

@@ -0,0 +1,17 @@
+-- Migration: Change line_item_inventories primary key to composite (id, line_item_id)
+-- This allows the same inventory to be assigned to multiple line items
+
+-- Step 1: Drop the existing primary key constraint
+ALTER TABLE line_item_inventories DROP CONSTRAINT IF EXISTS line_item_inventories_pkey;
+
+-- Step 2: Make line_item_id NOT NULL (required for composite PK)
+ALTER TABLE line_item_inventories ALTER COLUMN line_item_id SET NOT NULL;
+
+-- Step 3: Create composite primary key
+ALTER TABLE line_item_inventories ADD PRIMARY KEY (id, line_item_id);
+
+-- Step 4: Add index for faster lookups by inventory id alone
+CREATE INDEX IF NOT EXISTS idx_line_item_inventories_id ON line_item_inventories(id);
+
+-- Step 5: Add index for faster lookups by line_item_id
+CREATE INDEX IF NOT EXISTS idx_line_item_inventories_line_item_id ON line_item_inventories(line_item_id);

package/PCM/src/migrations/013_make_external_id_optional.sql

@@ -0,0 +1,3 @@
+-- Make external_id optional for deals and line_items
+ALTER TABLE deals ALTER COLUMN external_id DROP NOT NULL;
+ALTER TABLE line_items ALTER COLUMN external_id DROP NOT NULL;

package/PCM/src/migrations/014_create_change_history.sql

@@ -0,0 +1,38 @@
+-- Create change_history table for tracking all changes to deals and line items
+DO $$ BEGIN
+  CREATE TYPE change_entity_type AS ENUM ('DEAL', 'LINE_ITEM');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+DO $$ BEGIN
+  CREATE TYPE change_action_type AS ENUM ('CREATE', 'UPDATE', 'DELETE', 'STATUS_CHANGE');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+CREATE TABLE IF NOT EXISTS change_history (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  entity_type change_entity_type NOT NULL,
+  entity_id UUID NOT NULL,
+  deal_id TEXT,
+  line_item_id TEXT,
+  action change_action_type NOT NULL,
+  field_name TEXT,
+  previous_value JSONB,
+  current_value JSONB,
+  changed_by TEXT,
+  changed_by_email TEXT,
+  request_id TEXT,
+  ip_address TEXT,
+  user_agent TEXT,
+  summary TEXT,
+  metadata JSONB DEFAULT '{}',
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_change_history_entity ON change_history(entity_type, entity_id);
+CREATE INDEX IF NOT EXISTS idx_change_history_deal_id ON change_history(deal_id);
+CREATE INDEX IF NOT EXISTS idx_change_history_line_item_id ON change_history(line_item_id);
+CREATE INDEX IF NOT EXISTS idx_change_history_created_at ON change_history(created_at);
+CREATE INDEX IF NOT EXISTS idx_change_history_action ON change_history(action);

package/PCM/src/migrations/016_create_publisher_insertion_orders.sql

@@ -0,0 +1,33 @@
+-- Create publisher_insertion_orders table for minimal insertion order objects per publisher
+-- Used for multiple publishers with common campaign budget
+
+DO $$ BEGIN
+  CREATE TYPE insertion_order_status AS ENUM ('DRAFT', 'PENDING', 'APPROVED', 'LIVE', 'COMPLETED', 'ARCHIVED');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+CREATE TABLE IF NOT EXISTS publisher_insertion_orders (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  deal_id TEXT NOT NULL REFERENCES deals(deal_id) ON DELETE CASCADE,
+  publisher_id TEXT NOT NULL,
+  publisher_name TEXT,
+  io_number TEXT,
+  status insertion_order_status DEFAULT 'DRAFT',
+  budget_amount DECIMAL(14, 2),
+  currency TEXT,
+  start_date DATE,
+  end_date DATE,
+  summary JSONB DEFAULT '{}',
+  external_sync_reference JSONB DEFAULT '{}',
+  published BOOLEAN DEFAULT false,
+  published_at TIMESTAMP WITH TIME ZONE,
+  metadata JSONB DEFAULT '{}',
+  version INTEGER DEFAULT 1,
+  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
+  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_publisher_insertion_orders_deal_id ON publisher_insertion_orders(deal_id);
+CREATE INDEX IF NOT EXISTS idx_publisher_insertion_orders_publisher_id ON publisher_insertion_orders(publisher_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_publisher_insertion_orders_deal_publisher ON publisher_insertion_orders(deal_id, publisher_id);