adserver-dashboard 1.0.0

package/Influence-MW-AdServer-12-02-2026/tailwind.config.ts

@@ -0,0 +1,107 @@
+import type { Config } from "tailwindcss";
+
+export default {
+  darkMode: ["class"],
+  content: ["./client/index.html", "./client/src/**/*.{js,jsx,ts,tsx}"],
+  theme: {
+    extend: {
+      borderRadius: {
+        lg: ".5625rem", /* 9px */
+        md: ".375rem", /* 6px */
+        sm: ".1875rem", /* 3px */
+      },
+      colors: {
+        // Flat / base colors (regular buttons)
+        background: "hsl(var(--background) / <alpha-value>)",
+        foreground: "hsl(var(--foreground) / <alpha-value>)",
+        border: "hsl(var(--border) / <alpha-value>)",
+        input: "hsl(var(--input) / <alpha-value>)",
+        card: {
+          DEFAULT: "hsl(var(--card) / <alpha-value>)",
+          foreground: "hsl(var(--card-foreground) / <alpha-value>)",
+          border: "hsl(var(--card-border) / <alpha-value>)",
+        },
+        popover: {
+          DEFAULT: "hsl(var(--popover) / <alpha-value>)",
+          foreground: "hsl(var(--popover-foreground) / <alpha-value>)",
+          border: "hsl(var(--popover-border) / <alpha-value>)",
+        },
+        primary: {
+          DEFAULT: "hsl(var(--primary) / <alpha-value>)",
+          foreground: "hsl(var(--primary-foreground) / <alpha-value>)",
+          border: "var(--primary-border)",
+        },
+        secondary: {
+          DEFAULT: "hsl(var(--secondary) / <alpha-value>)",
+          foreground: "hsl(var(--secondary-foreground) / <alpha-value>)",
+          border: "var(--secondary-border)",
+        },
+        muted: {
+          DEFAULT: "hsl(var(--muted) / <alpha-value>)",
+          foreground: "hsl(var(--muted-foreground) / <alpha-value>)",
+          border: "var(--muted-border)",
+        },
+        accent: {
+          DEFAULT: "hsl(var(--accent) / <alpha-value>)",
+          foreground: "hsl(var(--accent-foreground) / <alpha-value>)",
+          border: "var(--accent-border)",
+        },
+        destructive: {
+          DEFAULT: "hsl(var(--destructive) / <alpha-value>)",
+          foreground: "hsl(var(--destructive-foreground) / <alpha-value>)",
+          border: "var(--destructive-border)",
+        },
+        ring: "hsl(var(--ring) / <alpha-value>)",
+        chart: {
+          "1": "hsl(var(--chart-1) / <alpha-value>)",
+          "2": "hsl(var(--chart-2) / <alpha-value>)",
+          "3": "hsl(var(--chart-3) / <alpha-value>)",
+          "4": "hsl(var(--chart-4) / <alpha-value>)",
+          "5": "hsl(var(--chart-5) / <alpha-value>)",
+        },
+        sidebar: {
+          ring: "hsl(var(--sidebar-ring) / <alpha-value>)",
+          DEFAULT: "hsl(var(--sidebar) / <alpha-value>)",
+          foreground: "hsl(var(--sidebar-foreground) / <alpha-value>)",
+          border: "hsl(var(--sidebar-border) / <alpha-value>)",
+        },
+        "sidebar-primary": {
+          DEFAULT: "hsl(var(--sidebar-primary) / <alpha-value>)",
+          foreground: "hsl(var(--sidebar-primary-foreground) / <alpha-value>)",
+          border: "var(--sidebar-primary-border)",
+        },
+        "sidebar-accent": {
+          DEFAULT: "hsl(var(--sidebar-accent) / <alpha-value>)",
+          foreground: "hsl(var(--sidebar-accent-foreground) / <alpha-value>)",
+          border: "var(--sidebar-accent-border)"
+        },
+        status: {
+          online: "rgb(34 197 94)",
+          away: "rgb(245 158 11)",
+          busy: "rgb(239 68 68)",
+          offline: "rgb(156 163 175)",
+        },
+      },
+      fontFamily: {
+        sans: ["var(--font-sans)"],
+        serif: ["var(--font-serif)"],
+        mono: ["var(--font-mono)"],
+      },
+      keyframes: {
+        "accordion-down": {
+          from: { height: "0" },
+          to: { height: "var(--radix-accordion-content-height)" },
+        },
+        "accordion-up": {
+          from: { height: "var(--radix-accordion-content-height)" },
+          to: { height: "0" },
+        },
+      },
+      animation: {
+        "accordion-down": "accordion-down 0.2s ease-out",
+        "accordion-up": "accordion-up 0.2s ease-out",
+      },
+    },
+  },
+  plugins: [require("tailwindcss-animate"), require("@tailwindcss/typography")],
+} satisfies Config;

package/Influence-MW-AdServer-12-02-2026/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "include": ["client/src/**/*", "shared/**/*", "server/**/*"],
+  "exclude": ["node_modules", "build", "dist", "**/*.test.ts"],
+  "compilerOptions": {
+    "incremental": true,
+    "tsBuildInfoFile": "./node_modules/typescript/tsbuildinfo",
+    "noEmit": true,
+    "module": "ESNext",
+    "strict": true,
+    "lib": ["esnext", "dom", "dom.iterable"],
+    "jsx": "preserve",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true,
+    "moduleResolution": "bundler",
+    "baseUrl": ".",
+    "types": ["node", "vite/client"],
+    "paths": {
+      "@/*": ["./client/src/*"],
+      "@shared/*": ["./shared/*"]
+    }
+  }
+}

package/Influence-MW-AdServer-12-02-2026/vite.config.ts

@@ -0,0 +1,40 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import path from "path";
+import runtimeErrorOverlay from "@replit/vite-plugin-runtime-error-modal";
+
+export default defineConfig({
+  plugins: [
+    react(),
+    runtimeErrorOverlay(),
+    ...(process.env.NODE_ENV !== "production" &&
+    process.env.REPL_ID !== undefined
+      ? [
+          await import("@replit/vite-plugin-cartographer").then((m) =>
+            m.cartographer(),
+          ),
+          await import("@replit/vite-plugin-dev-banner").then((m) =>
+            m.devBanner(),
+          ),
+        ]
+      : []),
+  ],
+  resolve: {
+    alias: {
+      "@": path.resolve(import.meta.dirname, "client", "src"),
+      "@shared": path.resolve(import.meta.dirname, "shared"),
+      "@assets": path.resolve(import.meta.dirname, "attached_assets"),
+    },
+  },
+  root: path.resolve(import.meta.dirname, "client"),
+  build: {
+    outDir: path.resolve(import.meta.dirname, "dist/public"),
+    emptyOutDir: true,
+  },
+  server: {
+    fs: {
+      strict: true,
+      deny: ["**/.*"],
+    },
+  },
+});

package/LINE_ITEM_BUDGET_FIELD_MAPPING.md

@@ -0,0 +1,178 @@
+# Line Item Budget Field Mapping
+
+Covers both **Traditional (Direct)** and **Programmatic** modes.
+Sources: `adserver/client/src/pages/line-item-form-page.tsx`, `adserver/PCM/`
+
+---
+
+## 1. UI Form Fields (Schema Definitions)
+
+| Form Field | Type | Default | Validation |
+|---|---|---|---|
+| `totalBudget` | `number` | — | `min(0)`, optional |
+| `currency` | `string` | `"USD"` (overridden from deal) | — |
+| `budgetConsumption` | `enum` | `"daily"` | `daily \| weekly \| monthly \| lifetime` |
+| `dailyBudget` | `number` | — | `min(0)`, optional |
+| `pacing` | `enum` | `"even"` | `even \| asap \| front-loaded` |
+| `trafficAllocation` | `number` | `100` | `0–100` |
+| `maxBid` | `number` | — | `min(0)`, optional |
+| `bidFloorBase` | `number` | — | `min(0)`, optional |
+| `cpmBase` | `number` | — | `min(0)`, optional |
+| `estimatedCostBase` | `number` | — | `min(0)`, optional |
+
+---
+
+## 2. Traditional (Direct) Mode
+
+### 2a. UI → Adserver API Payload
+
+| UI Form Field | Visible in UI | Adserver Payload Path | Value / Notes |
+|---|---|---|---|
+| `totalBudget` | Yes — "Total Budget" | `direct.budgetSetup.budgetAmount` | User input |
+| `currency` | Yes — "Currency" (read-only, from deal) | `direct.budgetSetup.currency` | Inherited from parent deal |
+| `budgetConsumption` | Yes — "Budget Consumption" select | **Not sent** | Stored in form, currently not mapped to API |
+| `dailyBudget` | Yes — "Daily Budget" | `direct.pacing.dailyCap` | User input |
+| `pacing` | **No** — hidden for Direct mode | `direct.pacing.type` | Form default `"even"` used |
+| `trafficAllocation` | **No** — hidden for Direct mode | `trafficAllocation` (top-level) | Only sent if value ≠ 100 |
+| `cpmBase` | No (auto-computed) | `direct.pricing.cpmBase` | Computed avg CPM from selected inventories; form field available as override |
+| `estimatedCostBase` | No (auto-computed) | `direct.pricing.estimatedCostBase` | Sum of estimated costs from inventories; form field available as override |
+| — | — | `direct.budgetSetup.budgetType` | Hard-coded `"TOTAL"` |
+| — | — | `direct.campaignGoal.type` | Hard-coded `"IMPRESSIONS"` |
+| — | — | `direct.campaignGoal.targetValue` | Calculated from forecast |
+
+**Full `direct` payload block:**
+```json
+{
+  "direct": {
+    "budgetSetup": {
+      "budgetType": "TOTAL",
+      "budgetAmount": <totalBudget>,
+      "currency": <currency>
+    },
+    "campaignGoal": {
+      "type": "IMPRESSIONS",
+      "targetValue": <forecast.impressions>
+    },
+    "pacing": {
+      "type": <pacing>,
+      "dailyCap": <dailyBudget>
+    },
+    "pricing": {
+      "cpmBase": <computedCpmBase>,
+      "estimatedCostBase": <computedEstimatedCostBase>
+    }
+  }
+}
+```
+
+### 2b. Adserver API Payload → PCM Backend (DB Columns)
+
+| Adserver Payload Field | PCM DB Column | PCM Type | Notes |
+|---|---|---|---|
+| `direct.budgetSetup.budgetAmount` | `budget_setup` (JSONB) → `budgetAmount` | `DECIMAL 14,2` | Stored in JSONB object |
+| `direct.budgetSetup.budgetType` | `budget_setup` (JSONB) → `budgetType` | `ENUM DAILY\|TOTAL` | Always `TOTAL` from adserver |
+| `direct.budgetSetup.currency` | `budget_setup` (JSONB) → `currency` | `TEXT` | — |
+| `direct.pacing.type` | `pacing` (JSONB) → `type` | `TEXT` | `even\|asap\|front-loaded\|back-loaded` |
+| `direct.pacing.dailyCap` | `pacing` (JSONB) → `dailyCap` | `DECIMAL 14,2` | — |
+| `direct.pricing.cpmBase` | `planning` (JSONB) → `pricing.cpmBase` | `DECIMAL 12,2` | Stored inside planning object |
+| `direct.pricing.estimatedCostBase` | `planning` (JSONB) → `pricing.estimatedCostBase` | `DECIMAL 14,2` | Stored inside planning object |
+| `direct.campaignGoal` | `campaign_goal` (JSONB) | `JSONB` | `{ type, targetValue }` |
+| `trafficAllocation` | `traffic_allocation` | `DECIMAL 5,2` | — |
+
+---
+
+## 3. Programmatic Mode
+
+### 3a. UI → Adserver API Payload
+
+| UI Form Field | Visible in UI | Adserver Payload Path | Value / Notes |
+|---|---|---|---|
+| `totalBudget` | Yes — "Total Budget" | `programmatic.netCost` | User input |
+| `maxBid` | Yes — "Max Bid / Bid Floor" | `programmatic.bidFloor` | User input |
+| `bidFloorBase` | Yes (if shown) | `programmatic.bidFloorBase` | Falls back to `maxBid` if not set |
+| `pacing` | Yes — "Pacing" select | `pacing.type` (top-level) | Lowercased before sending |
+| `trafficAllocation` | Yes — "Traffic Allocation" slider | `trafficAllocation` (top-level) | Only sent if value ≠ 100 |
+| `currency` | Yes (read-only) | **Not sent** in programmatic block | Currency stored in deal, not line item |
+| `dailyBudget` | **No** — not shown for Programmatic | Not sent | — |
+| `budgetConsumption` | **No** — not shown for Programmatic | Not sent | — |
+| `cpmBase` | **No** | Not sent | DIRECT only |
+| `estimatedCostBase` | **No** | Not sent | DIRECT only |
+| — | — | `programmatic.impressions` | From forecast calculation |
+| — | — | `programmatic.auctionType` | From deal settings (1, 2, or 3) |
+| — | — | `programmatic.impMultiplier` | Hard-coded `{ type: "ALL_TIME" }` |
+| — | — | `programmatic.thresholdCountPerDay` | GUARANTEED deals only: `ceil(impressions / days)` |
+
+**Full programmatic payload block:**
+```json
+{
+  "pacing": {
+    "type": "<pacing lowercased>"
+  },
+  "programmatic": {
+    "auctionType": <from deal>,
+    "bidFloor": <maxBid>,
+    "bidFloorBase": <bidFloorBase or maxBid>,
+    "netCost": <totalBudget>,
+    "impressions": <forecast.impressions>,
+    "impMultiplier": { "type": "ALL_TIME" },
+    "thresholdCountPerDay": <calculated, GUARANTEED only>
+  }
+}
+```
+
+### 3b. Adserver API Payload → PCM Backend (DB Columns)
+
+| Adserver Payload Field | PCM DB Column | PCM Type | Notes |
+|---|---|---|---|
+| `programmatic.bidFloor` | `bid_floor` | `DECIMAL 12,2` | — |
+| `programmatic.bidFloorBase` | `bid_floor_base` | `DECIMAL 12,2` | — |
+| `programmatic.netCost` | `net_cost` | `DECIMAL 14,2` | — |
+| `programmatic.impressions` | `impressions` | `BIGINT` | — |
+| `programmatic.auctionType` | `auction_type` | `SMALLINT` | 1, 2, or 3 |
+| `programmatic.thresholdCountPerDay` | `threshold_count_per_day` | `INTEGER` | GUARANTEED only |
+| `programmatic.impMultiplier` | `imp_multiplier` | `JSONB` | `{ type: "ALL_TIME" }` |
+| `pacing.type` | `pacing` (JSONB) → `type` | `TEXT` | — |
+| `trafficAllocation` | `traffic_allocation` | `DECIMAL 5,2` | — |
+
+---
+
+## 4. Common Fields (Both Modes)
+
+| Adserver Payload Field | PCM DB Column | Notes |
+|---|---|---|
+| `name` | `name` | — |
+| `startDate` | `start_date` | `DATE` |
+| `endDate` | `end_date` | `DATE` |
+| `status` | `status` | ENUM |
+| `currency` | `currency` | — |
+| `creativeType` | `creative_type` | ENUM |
+| `duration` | `duration` | INTEGER (seconds) |
+| `priority` | `priority` | 1–10 |
+| `timezoneId` | `timezone_id` | — |
+| `publisherId` | `publisher_id` | — |
+| `schedule` | `schedule` | JSONB |
+| `customFees` | `custom_fees` | JSONB array |
+| `frequencyCap` | `frequency_cap` | JSONB `{ period, target }` |
+| `inventories` | `line_item_inventories` join table | — |
+
+---
+
+## 5. Known Issues / Gaps
+
+| Issue | Detail |
+|---|---|
+| `budgetConsumption` not sent | Form field exists (`daily/weekly/monthly/lifetime`) but is **never included in the API payload** for either mode |
+| `pacing` sent for DIRECT | ~~Top-level `pacing` was being sent for Direct mode even though there is no Pacing UI for Direct~~ **Fixed** — now only sent for Programmatic |
+| `budgetType` hard-coded | Always sent as `"TOTAL"` regardless of `budgetConsumption` value |
+| `campaignGoal.targetValue` auto-set | Always set from forecast impressions, not user-editable |
+
+---
+
+## 6. PCM Validation Rules
+
+- **DIRECT** rejects: `auctionType`, `bidFloor`, `netCost`, `impressions`, `impMultiplier`, `thresholdCountPerDay`
+- **PROGRAMMATIC** rejects: `budgetSetup`, `campaignGoal`, `deliveryTargeting`
+- **GUARANTEED** deals: `pacing.type` is forced to `"even"`, `auctionType` forced to `3`
+- **PRIVATE_AUCTION**: `auctionType` must be `1`
+- **PREFERRED_DEAL**: `auctionType` must be `3`
+- **EVERGREEN_PMP**: `auctionType` must be `2`

package/PCM/.env.example

@@ -0,0 +1,92 @@
+# ===========================================
+# DOOH AdServer API - Environment Configuration
+# ===========================================
+# Copy this file to .env and fill in your values
+
+# ===========================================
+# DATABASE (Required)
+# ===========================================
+DATABASE_URL=postgresql://user:password@localhost:5432/dooh_adserver
+
+# ===========================================
+# SERVER (Optional)
+# ===========================================
+PORT=5000
+
+# ===========================================
+# APPROVAL WORKFLOW (Required for DIRECT campaigns)
+# ===========================================
+# Secret key for encrypting approval tokens (32+ characters recommended)
+APPROVAL_SECRET_KEY=your-secret-key-min-32-chars-long
+
+# Token expiry in days (default: 30)
+APPROVAL_TOKEN_EXPIRY_DAYS=30
+
+# Base URL for approval links (production)
+APPROVAL_BASE_URL=https://your-app.com/approve
+
+# ===========================================
+# OTP CONFIGURATION
+# ===========================================
+# OTP expiry in minutes (default: 10)
+OTP_EXPIRY_MINUTES=10
+
+# Maximum OTP verification attempts (default: 5)
+MAX_OTP_ATTEMPTS=5
+
+# Maximum OTP requests per token (default: 10)
+MAX_OTP_REQUESTS=10
+
+# Cooldown between OTP requests in seconds (default: 60)
+OTP_COOLDOWN_SECONDS=60
+
+# Development only: Predictable OTP code for testing (remove in production!)
+# DEV_OTP_CODE=123456
+
+# ===========================================
+# EMAIL NOTIFICATIONS
+# ===========================================
+# Enable/disable email sending (default: false)
+MAIL_ENABLED=false
+
+# External notification service URL
+NOTIFICATION_URL=http://notification.api.example.com/email
+
+# Sender email address
+MAIL_FROM=notification@yourcompany.com
+
+# Request timeout in milliseconds (default: 10000)
+NOTIFICATION_TIMEOUT_MS=10000
+
+# ===========================================
+# EMAIL TEMPLATES
+# ===========================================
+# Template for approval request emails
+TEMPLATE_APPROVAL_REQUEST=lmx_influence_rfa.tpl
+
+# Template for OTP verification emails
+TEMPLATE_OTP=lmx_EmailVerificationCode.tpl
+
+# Template for approved decision notification
+TEMPLATE_DECISION_APPROVED=lmx_influence_public_approved.tpl
+
+# Template for rejected decision notification
+TEMPLATE_DECISION_REJECTED=lmx_influence_public_rejected.tpl
+
+# ===========================================
+# EMAIL LAYOUT (Branding)
+# ===========================================
+# Company name displayed in emails
+LAYOUT_COMPANY_NAME=Influence
+
+# Company address in email footer
+LAYOUT_ADDRESS=123 Business Street, City, Country
+
+# Company phone number
+LAYOUT_PHONE_NUMBER=+1-234-567-8900
+
+# Company email for inquiries
+LAYOUT_EMAIL=support@yourcompany.com
+
+# Base URL for approval links in emails (production)
+DIRECT_APPROVAL_LINK=https://your-app.com/public/approval