adserver-dashboard 1.0.0

package/PCM/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "nodejs",
+  "version": "1.0.0",
+  "description": "",
+  "type": "module",
+  "module": "index.js",
+  "scripts": {
+    "start": "node index.js",
+    "test": "node --test tests/e2e-comprehensive.test.js",
+    "seed": "node scripts/seed-comprehensive.js",
+    "seed:comprehensive": "node scripts/seed-comprehensive.js",
+    "seed:prod": "node scripts/seed-production.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@types/node": "^24.3.1",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
+    "express": "^5.1.0",
+    "joi": "^18.0.1",
+    "node-fetch": "^3.3.2",
+    "nodemon": "^3.1.10",
+    "pg": "^8.16.3",
+    "pg-hstore": "^2.3.4",
+    "sequelize": "^6.37.7",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1",
+    "uuid": "^13.0.0"
+  }
+}

package/PCM/replit.md

@@ -0,0 +1,64 @@
+# DOOH AdServer API
+
+## Overview
+This Node.js/Express.js microservice manages Digital Out-of-Home (DOOH) advertising. It provides RESTful APIs for programmatic and direct ad deals, line items, and creative asset management. The service supports various transaction types (guaranteed, private auctions), cost models (CPD, CPM, CPS), and creative types (display, video, audio). It ensures data integrity, tracks requests, and maintains audit trails, aiming to integrate programmatic and traditional direct campaigns within the expanding DOOH market.
+
+## User Preferences
+Preferred communication style: Simple, everyday language.
+
+## System Architecture
+
+### UI/UX Decisions
+The API supports dual ID resolution (internal UUIDs or external identifiers). Responses organize mode-specific fields under `direct` and `programmatic` objects.
+
+### Technical Implementations
+The service utilizes Express.js v5 with ES Modules. Joi is used for schema validation. A middleware pipeline handles JSON parsing, logging, routing, and centralized error handling. The API accommodates both `camelCase` and `snake_case` JSON payloads. Soft deletion is implemented for line items and deals, while creatives use hard delete. The system is designed for autoscale deployment and Replit Deployments.
+
+### Feature Specifications
+- **Deal Management**: Supports `PROGRAMMATIC` and `DIRECT` campaign modes with specific `dealType` constraints (e.g., `GUARANTEED`, `PRIVATE_AUCTION`). Deal IDs are auto-generated. Includes `Seller`, `Account`, and `Publisher` objects.
+- **Cost Models**: Supports `CPD`, `CPM`, `CPS`, with `CPS` restricted to non-guaranteed deals.
+- **Status Workflow**: Deals progress through statuses like `DRAFT`, `APPROVED`, `LIVE`, `ARCHIVED`, with edit restrictions based on status. Automated deal metrics are calculated.
+- **Nested Data Structure**: Uses nested objects for mode-specific fields.
+- **Line Item Scheduling and Pacing**: Priority-based scheduling with various types and pacing strategies (`even`, `asap`, `front-loaded`, `back-loaded`).
+- **Line Item Extended Fields**: `priority` (1-10), `customFees` (array of {name, amount, type: fixed/percentage, invoiced}), `frequencyCap` ({period: hour/day/week/month/lifetime, target}), `trafficAllocation` (0-100%), `inventorySource` (string).
+- **Base Price Fields**: Store original prices before custom fees are applied. PROGRAMMATIC mode uses `bidFloorBase` (number). DIRECT mode uses `pricing.cpmBase` and `pricing.estimatedCostBase` within the direct object.
+- **Creative Management**: Creatives are assigned to line items with validation and automatic inventory matching. Creatives follow a workflow: `PENDING`, `APPROVED`, `REJECTED`. Creative approval/rejection uses a unified `POST /deals/{dealId}/line-items/{lineItemId}/creatives/{creativeId}` endpoint with a decision-based payload (`decision`: `APPROVED`/`REJECTED`, case-insensitive). Reviewer fields (`reviewerId`, `reviewerName`, `reason`) are optional.
+- **API Filtering**: Extensive filtering for `GET /deals` by various parameters.
+- **Bulk Operations**: `POST /deals/sync` enables atomic insertion of deals with nested entities.
+- **Campaign Import/Sync**: Supports importing campaigns from external platforms with `payloadType`s such as `PROGRAMMATIC_STANDARD`, `DIRECT_STANDARD`, and `DIRECT_PUBLISHER_SPLIT`. Captures `account` (userId, companyName, companyId, externalId) and `advertiser` (id, seatId, name) from import payloads. It intelligently handles inventory scheduling and grouping during import, updating `totalInventories` count. Includes proportional budget capping logic to prevent inventory costs from exceeding campaign budget limits (proportional split: `(campaignBudget / totalInventories) * inventoryCount`).
+- **DIRECT Mode Auto-IO Creation**: Automatically creates Publisher Insertion Orders for `DIRECT_PUBLISHER_SPLIT` imports with derived dates and budgets from line items. Insertion order start/end dates are calculated as the earliest/latest from their publisher's line items. Budget amounts are derived from inventory `planning.pricing.estimatedCost` when available, falling back to proportional split based on inventory count. Includes budget capping to ensure total IO budget does not exceed campaign budget.
+- **Targeting**: `targeting` (demographics, venue types, geofencing) available for both `PROGRAMMATIC` and `DIRECT`. `deliveryTargeting` (real-time signals) is `DIRECT`-only. Geofencing supports Points of Interest (POIs).
+- **Campaign Approval Workflow (DIRECT Mode)**: Multi-approver workflow with OTP authentication, email notifications, a public approval portal, and decision submission. Tracks rejection reasons, cascades status to line items, and maintains an audit trail. Configurable via environment variables for email notifications and security. Supports resending approval emails via `POST /deals/{dealId}/approval/resend`.
+- **Planning (DIRECT Mode)**: Provides capacity, allocation, estimates, and pricing at line item, inventory, and deal levels.
+- **Inventory Metadata and Replacement**: Inventories support optional `deviceId` and `metadata.externalRefIds` for third-party integrations. `PUT /deals/{dealId}/line-items/{lineItemId}/inventories` replaces existing inventories atomically.
+- **Change History**: Comprehensive audit trail for deals and line items.
+- **Deal Reopen (DIRECT Mode)**: Allows reopening any DIRECT deal from various statuses, cascading to `REOPENED` status. Both internal (`influence`) and external source campaigns can be reopened by authorized users.
+- **Campaign Status Workflow**: Workflow-aware status management supporting `DIRECT` and `PROGRAMMATIC` campaigns with canonical statuses (e.g., `GENERATED`, `APPROVED`, `LIVE`), editable statuses, and transition ownership. Includes guardrail logic and auto-approval for specific conditions.
+- **Source-Based Permissions**: Enforces modification restrictions based on `INTERNAL` (`"influence"`) or `EXTERNAL` sources. External sources have limited control over pacing and budget allocation, while internal sources have full control. Import APIs do not accept "influence" as a source.
+- **Deterministic Re-Import Upsert Logic**: Campaign re-imports via `/deals/import` use deterministic identifiers for proper upsert matching:
+  - **Upsert Status Restriction**: Re-imports that update an existing deal are ONLY allowed when the deal is in `REOPENED` status. Other statuses return 409 with guidance to reopen first.
+  - **Line Item ExternalId Pattern**: For grouped inventories: `{campaignExternalId}-{publisherId}-{duration}-{inventoryFingerprint}` (MD5 hash of sorted inventory IDs). Grouping key is publisher + duration; multiple resolutions are collected into the `resolutions` array. For scheduled inventories: includes inventoryId for determinism.
+  - **Archiving Strategy**: Line items and insertion orders for removed publishers are archived (status → ARCHIVED) instead of deleted, preserving audit trails.
+  - **Publisher Reactivation**: Archived insertion orders are reactivated (status → DRAFT) when publisher returns in a subsequent import.
+
+### System Design Choices
+- **Data Persistence**: PostgreSQL via Sequelize ORM (v6) utilizing UUIDs, foreign keys, JSONB fields, and ENUM types.
+- **API Design**: RESTful architecture with nested resources, standard HTTP methods, and pagination.
+- **Auditability**: All API requests are logged to a `transaction_history` table.
+- **Error Handling**: Centralized error handling for consistent responses.
+
+## External Dependencies
+
+### Runtime
+- `express`
+- `sequelize`
+- `pg`, `pg-hstore`
+- `joi`
+- `uuid`
+- `dotenv`
+
+### Database
+- **PostgreSQL**: Primary data store (version 12+).
+
+### Documentation
+- **Swagger Documentation**: API v1.7.0 - Available at `/api-docs` (UI) and `/api-docs.json` (spec)

package/PCM/schema.sql

@@ -0,0 +1,495 @@
+-- DOOH AdServer Schema Export
+-- Generated: 2026-01-07 (from pg_dump)
+-- Order: Extensions -> ENUMs -> Tables -> Sequences -> Constraints -> Indexes -> Foreign Keys
+
+-- Extensions
+CREATE EXTENSION IF NOT EXISTS pg_trgm WITH SCHEMA public;
+CREATE EXTENSION IF NOT EXISTS pgcrypto WITH SCHEMA public;
+
+-- ENUM Types
+CREATE TYPE public.campaign_inventory_status AS ENUM (
+    'ACTIVE',
+    'INACTIVE',
+    'PENDING',
+    'ARCHIVED'
+);
+
+CREATE TYPE public.change_action_type AS ENUM (
+    'CREATE',
+    'UPDATE',
+    'DELETE',
+    'STATUS_CHANGE'
+);
+
+CREATE TYPE public.change_entity_type AS ENUM (
+    'DEAL',
+    'LINE_ITEM'
+);
+
+CREATE TYPE public.cost_type_enum AS ENUM (
+    'CPD',
+    'CPM',
+    'CPS'
+);
+
+CREATE TYPE public.creative_rotation_type_enum AS ENUM (
+    'EVEN',
+    'OPTIMIZED',
+    'MANUAL',
+    'SEQUENTIAL'
+);
+
+CREATE TYPE public.creative_type_enum AS ENUM (
+    'DISPLAY',
+    'VIDEO',
+    'AUDIO'
+);
+
+CREATE TYPE public.deal_type_enum AS ENUM (
+    'GUARANTEED',
+    'PREFERRED_DEAL',
+    'PRIVATE_AUCTION',
+    'EVERGREEN_PMP',
+    'DIRECT'
+);
+
+CREATE TYPE public.enum_deals_cost_type AS ENUM (
+    'CPD',
+    'CPM',
+    'CPS'
+);
+
+CREATE TYPE public.enum_deals_deal_type AS ENUM (
+    'GUARANTEED',
+    'PREFERRED_DEAL',
+    'PRIVATE_AUCTION',
+    'EVERGREEN_PMP',
+    'DIRECT'
+);
+
+CREATE TYPE public.enum_deals_status AS ENUM (
+    'GENERATED',
+    'PENDING',
+    'APPROVED',
+    'LIVE',
+    'COMPLETED',
+    'REOPENED',
+    'ARCHIVED',
+    'EXPIRED',
+    'DRAFT',
+    'REQUESTED'
+);
+
+CREATE TYPE public.imp_multiplier_type_enum AS ENUM (
+    'MAD',
+    'CUSTOM'
+);
+
+CREATE TYPE public.impression_type_enum AS ENUM (
+    'SPOT',
+    'AUDIENCE'
+);
+
+CREATE TYPE public.insertion_order_status AS ENUM (
+    'DRAFT',
+    'PENDING',
+    'APPROVED',
+    'LIVE',
+    'COMPLETED',
+    'ARCHIVED'
+);
+
+CREATE TYPE public.schedule_type_enum AS ENUM (
+    'ALL_TIME',
+    'ON_SCHEDULE'
+);
+
+CREATE TYPE public.status_enum AS ENUM (
+    'DRAFT',
+    'GENERATED',
+    'PENDING',
+    'APPROVED',
+    'LIVE',
+    'COMPLETED',
+    'REOPENED',
+    'ARCHIVED',
+    'EXPIRED',
+    'REQUESTED',
+    'REJECTED',
+    'CANCELED',
+    'DELETED',
+    'PENDING_CREATIVES',
+    'IN_ACTIVE'
+);
+
+CREATE TYPE public.transaction_type_enum AS ENUM (
+    'SPOT',
+    'AUDIENCE'
+);
+
+-- Table: approval_otps
+CREATE TABLE public.approval_otps (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    approval_token_id uuid NOT NULL,
+    otp_code text NOT NULL,
+    expires_at timestamp with time zone NOT NULL,
+    verified boolean DEFAULT false NOT NULL,
+    attempts integer DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+    updated_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Table: approval_tokens
+CREATE TABLE public.approval_tokens (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    deal_id text NOT NULL,
+    approver_email text NOT NULL,
+    token text NOT NULL,
+    status character varying(20) DEFAULT 'PENDING'::character varying NOT NULL,
+    rejection_reason text,
+    decision_at timestamp with time zone,
+    expires_at timestamp with time zone NOT NULL,
+    otp_verified boolean DEFAULT false NOT NULL,
+    request_id text,
+    created_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+    updated_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+    encrypted_token text,
+    CONSTRAINT approval_tokens_status_check CHECK (((status)::text = ANY ((ARRAY['PENDING'::character varying, 'APPROVED'::character varying, 'REJECTED'::character varying])::text[])))
+);
+
+-- Table: change_history
+CREATE TABLE public.change_history (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    entity_type public.change_entity_type NOT NULL,
+    entity_id uuid NOT NULL,
+    deal_id text,
+    line_item_id text,
+    action public.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 '{}'::jsonb,
+    created_at timestamp with time zone DEFAULT now()
+);
+
+-- Table: deal_id_counters
+CREATE TABLE public.deal_id_counters (
+    id integer NOT NULL,
+    prefix character varying(10) NOT NULL,
+    current_value bigint DEFAULT 0 NOT NULL,
+    created_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP,
+    updated_at timestamp with time zone DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Sequence for deal_id_counters
+CREATE SEQUENCE public.deal_id_counters_id_seq
+    AS integer
+    START WITH 1
+    INCREMENT BY 1
+    NO MINVALUE
+    NO MAXVALUE
+    CACHE 1;
+
+ALTER SEQUENCE public.deal_id_counters_id_seq OWNED BY public.deal_id_counters.id;
+
+-- Table: deals
+CREATE TABLE public.deals (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    source text NOT NULL,
+    external_id text,
+    deal_id text,
+    name text,
+    deal_type public.deal_type_enum,
+    transaction_type text,
+    auction_type smallint,
+    buyers jsonb,
+    seller jsonb,
+    currency text,
+    cost_type public.cost_type_enum,
+    delivery_goal bigint,
+    net_cost numeric(14,2),
+    net_cost_per_day numeric(14,2),
+    timezone_id text,
+    start_date date,
+    end_date date,
+    impressions bigint,
+    account jsonb,
+    country text,
+    status public.status_enum DEFAULT 'GENERATED'::public.status_enum,
+    active boolean DEFAULT true,
+    is_playing boolean DEFAULT false,
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now(),
+    updated_at timestamp with time zone DEFAULT now(),
+    version integer DEFAULT 1,
+    brand text,
+    client_type text,
+    mode text,
+    approval_emails text[],
+    market_selection jsonb,
+    budget_setup jsonb,
+    campaign_goal jsonb,
+    publishers jsonb,
+    advertiser jsonb,
+    published boolean DEFAULT false,
+    reopened boolean DEFAULT false,
+    non_billable boolean DEFAULT false,
+    stop_bid_requests boolean DEFAULT false,
+    imp_multiplier_type text,
+    line_items_count integer DEFAULT 0,
+    planning jsonb,
+    CONSTRAINT deals_client_type_check CHECK (((client_type IS NULL) OR (client_type = ANY (ARRAY['DIRECT_ADVERTISER'::text, 'AGENCY'::text])))),
+    CONSTRAINT deals_mode_check CHECK (((mode IS NULL) OR (mode = ANY (ARRAY['PROGRAMMATIC'::text, 'DIRECT'::text]))))
+);
+
+-- Table: line_item_creatives
+CREATE TABLE public.line_item_creatives (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    creative_id text,
+    creative_uri text,
+    mime_type text,
+    duration integer,
+    deal_id text,
+    inventory_ids text[],
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now(),
+    updated_at timestamp with time zone DEFAULT now(),
+    creative_type text,
+    resolution text,
+    status text DEFAULT 'PENDING'::text,
+    reviewer_id text,
+    reviewer_name text,
+    reviewed_at timestamp with time zone,
+    thumbnail text,
+    line_item_id uuid
+);
+
+-- Table: line_item_inventories
+CREATE TABLE public.line_item_inventories (
+    id text NOT NULL,
+    deal_id text,
+    name text,
+    size text,
+    publisher_id text,
+    publisher_name text,
+    publisher_external_id text,
+    latitude double precision,
+    longitude double precision,
+    venue_type text,
+    thumbnail text,
+    timezone text,
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now(),
+    updated_at timestamp with time zone DEFAULT now(),
+    ad_unit_code text,
+    reference_id text,
+    device_id text,
+    country_iso2 text,
+    country_iso3 text,
+    venue_type_ids text[],
+    bcat jsonb,
+    publisher_domain text,
+    enable_aspect_ratio boolean DEFAULT false,
+    display_aspect_ratio text,
+    planning jsonb,
+    line_item_id uuid NOT NULL
+);
+
+-- Table: line_items
+CREATE TABLE public.line_items (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    source text NOT NULL,
+    external_id text,
+    deal_id text,
+    name text,
+    deal_type public.deal_type_enum,
+    auction_type smallint,
+    creative_type public.creative_type_enum,
+    duration integer,
+    impression_type public.impression_type_enum,
+    timezone_id text,
+    start_date date,
+    end_date date,
+    threshold_count_per_day integer,
+    delivery_goal bigint,
+    sizes text[],
+    schedule jsonb,
+    currency text,
+    cost_type public.cost_type_enum,
+    bid_floor numeric(12,2),
+    net_cost numeric(14,2),
+    net_cost_per_day numeric(14,2),
+    impressions bigint,
+    status public.status_enum,
+    is_playing boolean DEFAULT false,
+    publisher_id text,
+    creative_rotation_type public.creative_rotation_type_enum,
+    metadata jsonb,
+    created_at timestamp with time zone DEFAULT now(),
+    updated_at timestamp with time zone DEFAULT now(),
+    version integer DEFAULT 1,
+    mode text,
+    resolutions text[],
+    creative_source text,
+    total_inventories integer DEFAULT 0,
+    adm_creative_sync boolean DEFAULT false,
+    non_billable boolean DEFAULT false,
+    stop_bid_requests boolean DEFAULT false,
+    imp_multiplier jsonb,
+    budget_setup jsonb,
+    campaign_goal jsonb,
+    pacing jsonb,
+    targeting jsonb,
+    planning jsonb,
+    delivery_targeting jsonb
+);
+
+-- Table: publisher_insertion_orders
+CREATE TABLE public.publisher_insertion_orders (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    deal_id text NOT NULL,
+    publisher_id text NOT NULL,
+    publisher_name text,
+    io_number text,
+    status public.insertion_order_status DEFAULT 'DRAFT'::public.insertion_order_status,
+    budget_amount numeric(14,2),
+    currency text,
+    start_date date,
+    end_date date,
+    summary jsonb DEFAULT '{}'::jsonb,
+    external_sync_reference jsonb DEFAULT '{}'::jsonb,
+    published boolean DEFAULT false,
+    published_at timestamp with time zone,
+    metadata jsonb DEFAULT '{}'::jsonb,
+    version integer DEFAULT 1,
+    created_at timestamp with time zone DEFAULT now(),
+    updated_at timestamp with time zone DEFAULT now()
+);
+
+-- Table: transaction_history
+CREATE TABLE public.transaction_history (
+    id uuid DEFAULT gen_random_uuid() NOT NULL,
+    request_id text,
+    method text,
+    endpoint text,
+    payload jsonb,
+    response_status integer,
+    created_at timestamp with time zone NOT NULL
+);
+
+-- Column defaults
+ALTER TABLE ONLY public.deal_id_counters ALTER COLUMN id SET DEFAULT nextval('public.deal_id_counters_id_seq'::regclass);
+
+-- Primary Key Constraints
+ALTER TABLE ONLY public.approval_otps
+    ADD CONSTRAINT approval_otps_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.approval_tokens
+    ADD CONSTRAINT approval_tokens_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.approval_tokens
+    ADD CONSTRAINT approval_tokens_token_key UNIQUE (token);
+
+ALTER TABLE ONLY public.change_history
+    ADD CONSTRAINT change_history_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.deal_id_counters
+    ADD CONSTRAINT deal_id_counters_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.deal_id_counters
+    ADD CONSTRAINT deal_id_counters_prefix_key UNIQUE (prefix);
+
+ALTER TABLE ONLY public.deals
+    ADD CONSTRAINT deals_deal_id_key UNIQUE (deal_id);
+
+ALTER TABLE ONLY public.deals
+    ADD CONSTRAINT deals_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.deals
+    ADD CONSTRAINT deals_source_external_id_key UNIQUE (source, external_id);
+
+ALTER TABLE ONLY public.line_item_creatives
+    ADD CONSTRAINT line_item_creatives_creative_id_deal_id_key UNIQUE (creative_id, deal_id);
+
+ALTER TABLE ONLY public.line_item_creatives
+    ADD CONSTRAINT line_item_creatives_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.line_item_inventories
+    ADD CONSTRAINT line_item_inventories_pkey PRIMARY KEY (id, line_item_id);
+
+ALTER TABLE ONLY public.line_items
+    ADD CONSTRAINT line_items_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.line_items
+    ADD CONSTRAINT line_items_source_external_id_key UNIQUE (source, external_id);
+
+ALTER TABLE ONLY public.publisher_insertion_orders
+    ADD CONSTRAINT publisher_insertion_orders_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.transaction_history
+    ADD CONSTRAINT transaction_history_pkey PRIMARY KEY (id);
+
+ALTER TABLE ONLY public.deals
+    ADD CONSTRAINT unique_deal_id UNIQUE (deal_id);
+
+ALTER TABLE ONLY public.line_items
+    ADD CONSTRAINT unique_external_id UNIQUE (external_id);
+
+-- Indexes
+CREATE INDEX idx_approval_otps_approval_token_id ON public.approval_otps USING btree (approval_token_id);
+CREATE INDEX idx_approval_otps_otp_code ON public.approval_otps USING btree (otp_code);
+CREATE INDEX idx_approval_tokens_approver_email ON public.approval_tokens USING btree (approver_email);
+CREATE INDEX idx_approval_tokens_deal_id ON public.approval_tokens USING btree (deal_id);
+CREATE INDEX idx_approval_tokens_status ON public.approval_tokens USING btree (status);
+CREATE INDEX idx_approval_tokens_token ON public.approval_tokens USING btree (token);
+CREATE INDEX idx_change_history_action ON public.change_history USING btree (action);
+CREATE INDEX idx_change_history_created_at ON public.change_history USING btree (created_at);
+CREATE INDEX idx_change_history_deal_id ON public.change_history USING btree (deal_id);
+CREATE INDEX idx_change_history_entity ON public.change_history USING btree (entity_type, entity_id);
+CREATE INDEX idx_change_history_line_item_id ON public.change_history USING btree (line_item_id);
+CREATE INDEX idx_creatives_uri_trgm ON public.line_item_creatives USING gin (creative_uri public.gin_trgm_ops);
+CREATE INDEX idx_deal_id_counters_prefix ON public.deal_id_counters USING btree (prefix);
+CREATE INDEX idx_deals_source ON public.deals USING btree (source);
+CREATE INDEX idx_deals_time ON public.deals USING btree (start_date, end_date);
+CREATE INDEX idx_line_item_inventories_id ON public.line_item_inventories USING btree (id);
+CREATE INDEX idx_line_item_inventories_line_item_id ON public.line_item_inventories USING btree (line_item_id);
+CREATE INDEX idx_line_item_inventories_planning ON public.line_item_inventories USING gin (planning) WHERE (planning IS NOT NULL);
+CREATE INDEX idx_line_items_planning ON public.line_items USING gin (planning) WHERE (planning IS NOT NULL);
+CREATE INDEX idx_lineitem_inv_pub ON public.line_item_inventories USING btree (publisher_id);
+CREATE INDEX idx_lineitems_deal ON public.line_items USING btree (deal_id);
+CREATE INDEX idx_lineitems_publisher ON public.line_items USING btree (publisher_id);
+CREATE INDEX idx_lineitems_time ON public.line_items USING btree (start_date, end_date);
+CREATE INDEX idx_publisher_insertion_orders_deal_id ON public.publisher_insertion_orders USING btree (deal_id);
+CREATE UNIQUE INDEX idx_publisher_insertion_orders_deal_publisher ON public.publisher_insertion_orders USING btree (deal_id, publisher_id);
+CREATE INDEX idx_publisher_insertion_orders_publisher_id ON public.publisher_insertion_orders USING btree (publisher_id);
+
+-- Foreign Key Constraints
+ALTER TABLE ONLY public.approval_otps
+    ADD CONSTRAINT approval_otps_approval_token_id_fkey FOREIGN KEY (approval_token_id) REFERENCES public.approval_tokens(id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.approval_tokens
+    ADD CONSTRAINT approval_tokens_deal_id_fkey FOREIGN KEY (deal_id) REFERENCES public.deals(deal_id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.line_item_creatives
+    ADD CONSTRAINT line_item_creatives_deal_id_fkey FOREIGN KEY (deal_id) REFERENCES public.deals(deal_id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.line_item_creatives
+    ADD CONSTRAINT line_item_creatives_line_item_id_fkey FOREIGN KEY (line_item_id) REFERENCES public.line_items(id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.line_item_inventories
+    ADD CONSTRAINT line_item_inventories_deal_id_fkey FOREIGN KEY (deal_id) REFERENCES public.deals(deal_id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.line_item_inventories
+    ADD CONSTRAINT line_item_inventories_line_item_id_fkey FOREIGN KEY (line_item_id) REFERENCES public.line_items(id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.line_items
+    ADD CONSTRAINT line_items_deal_id_fkey FOREIGN KEY (deal_id) REFERENCES public.deals(deal_id) ON DELETE CASCADE;
+
+ALTER TABLE ONLY public.publisher_insertion_orders
+    ADD CONSTRAINT publisher_insertion_orders_deal_id_fkey FOREIGN KEY (deal_id) REFERENCES public.deals(deal_id) ON DELETE CASCADE;