adserver-dashboard 1.0.0

package/DEMO_STATUS.md

@@ -0,0 +1,579 @@
+# Ad Server Platform - Demo Status
+
+**Last Updated**: February 18, 2026
+**Demo Date**: December 26, 2025
+
+---
+
+## Executive Summary
+
+The Ad Server Platform is ready for demo. The core deal creation workflow, authentication, targeting (including geofencing), inventory selection, **public approval workflow** for DIRECT mode campaigns, **third-party platform integration** via `/deals/import/convert` API, and **DSP/Buyer management modules** are fully functional. Recent updates include a **redesigned Line Item form** with single-page layout, pill-style Ad Duration selection, Sheet-based Media Owner and Inventory Format selectors, dedicated Pacing & Traffic Allocation section, **consistent table styling** across DSP and Buyer list pages, **API payload cleanup** removing UI-only fields, **weather signal targeting** for DIRECT deals, **geofencing coordinate fix**, **side popover pattern** for all targeting sections with real API integrations, **consistent navigation pattern** with left-side back icon across deal pages, **Market Insights Panel** in deal creation sidebar, and **branded authentication loader**.
+
+---
+
+## Recent Development
+
+### February 18, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Update Deal - Back Button Fix** | Removed duplicate "Back to Deals" button from Update Deal page header; only left-side back arrow icon remains, consistent with line item form navigation pattern |
+| **Navigation Consistency** | Standardized back navigation across deal pages — Update Deal and Direct Campaign Details use icon-only back button on left side; Line Item form uses simplified "Back" text button |
+| **Market Insights Panel** | Added Market Insights sidebar panel to deal creation/edit page showing country demographics, population, available inventories, and estimated impressions |
+| **Auth Callback - Brand Loader** | Authentication callback page now uses `MWBrandLoader` component for branded loading experience during sign-in flow |
+| **Settings - Recommendation Weights** | Settings page includes configurable weight sliders for recommendation algorithm (Measure Fit, Geo Fit, Availability, Budget Fit, Audience Fit, Brand Fit, Quality Fit, Time Fit) |
+| **Non-Billable for Traditional Deals** | Added `nonBillable` checkbox to Traditional (DIRECT) deal creation form; field included in `direct` payload and restored in edit mode |
+
+### February 17, 2026
+
+| Category | Changes |
+|----------|---------|
+| **API Payload Cleanup** | Removed UI-only fields not in API schema: `unlimitedBudget`, `automatedBidding`, `signalEnabled`, generic Signals section, Billing (billable/non-billable) |
+| **Delivery Targeting Restriction** | `deliveryTargeting` restricted to DIRECT deals only — API rejects it for PROGRAMMATIC; UI section hidden for programmatic line items |
+| **New Payload Fields** | Added `frequencyCap`, `trafficAllocation`, `inventorySource` to line item API payload and builder functions |
+| **Weather Signals (DIRECT)** | New "Delivery Signals" section with weather conditions grid (Sunny, Partly Cloudy, Cloudy, Rainy, Stormy, Snowy, Windy, Foggy, Hazy) and temperature range (min/max with Celsius/Fahrenheit) |
+| **Geofencing Coordinates** | Geofencing payload now sends `lat` and `lng` (required by API); handles Point geometries (search) and Polygon geometries (centroid); edit mode restores `geoLocations` state |
+| **SSP/Exchange Sheet** | Replaced inline Collapsible with Sheet (side popover) for SSP/Exchange selection; real API integration with `/api/v1/companies?is_ssp=true` |
+| **Inventory Type Sheet** | Side popover for inventory type selection; real API integration with `/api/v1/inventory-types`; API queries only fire when drawer is open |
+| **Media Owner Sheet** | Side popover with real API data from companies endpoint |
+| **Inventory Format Sheet** | Side popover for inventory display formats; real API integration with `/api/v1/inventory-display-formats` |
+| **Venue Type Tree** | Recursive tree with unlimited hierarchy depth (API-driven); side drawer with search and checkboxes |
+| **Deal Creation Fixes** | Removed description field from programmatic deals; removed seller field from deal list/filters; fixed impression multiplier type handling; removed status dropdown from deal creation |
+| **Line Item Priority** | Added priority field to line item API payload |
+| **Custom Fees** | Custom fees now included in line item creation payload |
+| **Geography Map** | Map opens directly by clicking the geography row |
+| **Form Validation** | Validation errors shown to user on save |
+| **Traditional Deal Fixes** | Bid Strategy and Auction Type hidden for traditional deals |
+| **DSP/Buyer Real API** | Real API data for DSP (read-only) and Buyer (CRUD) pages; added to side menu |
+| **Sticky Sidebar** | Sidebar navigation stays fixed while scrolling |
+| **Theme Selection** | Theme picker added to profile dropdown |
+| **Custom Toggle** | Custom toggle switch component replacing Switch for better visibility |
+
+### February 12, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Line Item Form - Status Removed** | Removed Status dropdown from top row; form defaults to Draft status silently |
+| **Ad Duration Pill Buttons** | Replaced checkbox-based duration with pill/chip-style buttons (5s, 10s, 15s, 20s, 30s) with Custom input field |
+| **Pacing & Traffic Allocation** | New dedicated AccordionSection after Budget Options; Pacing (Even/ASAP/Front-loaded) and Traffic Allocation slider (0-100%) moved out of Advanced Options |
+| **Media Owner Sheet Popover** | Side panel with search, Country/Type filter dropdowns, 10 sample media owners (JCDecaux, Clear Channel, Lamar, etc.) with checkbox multi-select |
+| **Inventory Format Sheet Popover** | Side panel grouped by OOH/Transit/Retail categories with "Select All" per group and selection count |
+| **Unlimited Budget Toggle** | Custom toggle button replacing Switch component for reliable rendering |
+| **Advanced Options Simplified** | Contains only Frequency Cap (Ad Plays + Period); Pacing/Traffic removed from this section |
+| **DSP Table Styling** | DSP list table now matches deals list grid: `bg-[#F3F3F3]` header, `text-[11px] uppercase`, `text-[13px]` cells, proper column widths |
+| **Buyer Table Styling** | Buyer list table now matches deals list grid with same header/cell/row styling as DSP and deals pages |
+| **Row Number Formatting** | S.No column in DSP/Buyer tables now zero-padded (01, 02, ...) like deals table |
+
+### January 23, 2026
+
+| Category | Changes |
+|----------|---------|
+| **i18n 100% Coverage** | Achieved complete internationalization coverage across all 22 pages and 75+ components |
+| **13 Namespaces** | Added 7 new namespaces: contentHub, wizard, campaigns, inventory, lineItems, approval, dashboard |
+| **Content Hub Translations** | Translated creative-grid, creative-filters, folder-dialogs, creative-upload, bulk-transcode, creative-selector |
+| **Line Item Wizard Translations** | Translated all 7 wizard steps: creatives, summary, schedule, targeting, inventory, details, inventory-schedule |
+| **Geofencing Translations** | Translated UploadTab, SelectedLocationsSidebar, geofencing-map, schedule-rule-editor, planner components |
+| **Inventory Translations** | Translated advanced-filters-panel, inventory-details-sheet, map-view, availability-view |
+| **Dashboard Translations** | Translated dashboard overview, quick actions, recent activity, stats sections |
+| **Approval Translations** | Translated OTP verification, approval forms, line-item-details-sheet, public approval page |
+| **Deal Components Translations** | Translated import-from-planner-dialog, deal-filter-panel, hierarchical-venue-selector |
+| **All Languages Synced** | Japanese (formal keigo), Chinese (Simplified), Arabic (Modern Standard with RTL) fully synchronized |
+
+### January 22, 2026
+
+| Category | Changes |
+|----------|---------|
+| **GUARANTEED Deal Fix** | Added required `thresholdCountPerDay` field to line item payload for GUARANTEED deals (default value: 1) |
+| **Deal Status Transition** | Fixed deal status not transitioning to GENERATED when first line item is created |
+| **saveLineItemOnly Fix** | Updated function to include thresholdCountPerDay for GUARANTEED deal types |
+| **createInitialLineItem Fix** | Updated function to include thresholdCountPerDay for GUARANTEED deal types |
+
+### January 21, 2026
+
+| Category | Changes |
+|----------|---------|
+| **DSP Management Module** | Complete CRUD functionality for DSP management with list, create, edit, delete operations |
+| **Buyer Management Module** | Complete CRUD functionality for Buyer management linked to DSPs |
+| **DSP List Page** | Paginated table with search, columns: S.No, DSP Name, IP, Country, Email, URL, Created By, Created On, Actions |
+| **DSP Form Page** | Multi-section form with DSP details, contact person, bidder details |
+| **Buyer List Page** | Paginated table with columns: S.No, DSP, Seat ID, Seat Name, Buyer Account ID, Email ID, Actions |
+| **Buyer Form Page** | Form with DSP selection, seat ID, seat name, buyer account ID, email fields |
+| **i18n Integration** | Full translation support for DSP/Buyer modules (en/ja/zh/ar) with `dsp:` and `buyer:` namespaces |
+| **Validation Translations** | Error mapping pattern for Zod validation messages - schemas unchanged, translation at display time |
+| **Sidebar Navigation** | Removed Inventory and Measure menu items from sidebar; expandable sections with sub-items |
+| **Routes Added** | `/dsp`, `/dsp/new`, `/dsp/edit/:id`, `/buyers`, `/buyers/new`, `/buyers/edit/:id` |
+| **Publisher ID** | Added publisher ID to deals list page for logged-in users |
+| **Inventory Management** | New inventory management features and map view capabilities |
+| **Product Switcher** | Moved product switcher to header left with updated design |
+| **Expandable Inventory Cards** | Added ability to expand inventory cards to show more details |
+| **Programmatic Deals** | Updated platform to support programmatic deals with mode-aware line items |
+| **Line Item Wizard** | Separated inventory and schedule into distinct steps |
+| **Campaign Forecast Panel** | Added forecast panel to inventory and schedule tabs |
+| **Planning Data** | Added planning data and capacity details to inventory selection |
+| **Infinite Scroll** | Updated inventory view to use infinite scroll, removed "view all" option |
+| **Smart Recommendation** | Renamed from "AI Smart Recommendation" to "Smart Recommendation" |
+
+### January 20, 2026
+
+| Category | Changes |
+|----------|---------|
+| **AI Recommendations** | Improved AI recommendations and inventory card display |
+| **Inventory Pagination** | Adjusted pagination to always appear at the bottom |
+| **Inventory Details** | Increased width of inventory details panel/popover |
+| **Reference ID Display** | Added reference ID and estimated cost to inventory recommendation cards |
+| **Recommendation Scoring** | Added recommendation scoring and availability details to inventory cards |
+
+### January 14, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Recommendation Engine** | Integrated recommendation engine into inventory scheduling flow |
+| **Recommendation API** | Updated API paths, added company identifier from user session, structured demographics |
+| **Recommendation Polling** | Updated to repeatedly use the same submission request with POST status checks |
+| **Line Item Creation** | Create line item earlier to enable AI recommendations |
+| **Reference ID** | Added reference ID from external inventory system for updates |
+| **CPM/eCPM Display** | Updated to display correct currency |
+| **Creatives Tab** | Made sure creatives are visible in the creative tab |
+| **Planner Targeting** | Made planner targeting read-only and restricted schedule edits |
+| **Budget/Target Values** | Allow editing budget and target values for planner campaigns when empty |
+| **Approved Deals Display** | Show full UI for already approved/rejected deals instead of error message |
+| **Campaign Details** | Updated to show correct status and brand information |
+| **OTP Input** | Improved OTP input and UI elements for campaign approval |
+| **Deal History** | Improved deal history page to show detailed approval information |
+| **Approval Sheet** | Improved functionality and user experience |
+| **Agency Endpoint** | Updated endpoint and data handling for improved company information |
+
+### January 13, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Planner Deal Editing** | Made deal line item fields read-only when restricted |
+| **Edit Button** | Show edit button for planner deals in line item view |
+| **Restricted Edits** | Updated deal editing to allow restricted edits for planner deals |
+| **Resend Approval Emails** | Added functionality to resend approval emails |
+| **Planner Deal Creatives** | Added ability to update planner deal creatives |
+| **Auto-Approval Tests** | Updated request approval sheet test for auto-approval behavior |
+
+### January 9, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Resend Approval Email** | New "Resend Approval Email" button for PENDING deals - opens sheet to select approvers and resend |
+| **Planner Restricted Edit** | Approved Planner deals can be edited with restricted mode - only pacing and creatives editable, other fields read-only |
+| **Seller/Account Email** | Added editable seller email field in deal add/edit page, auto-populates with logged-in user email |
+| **Auto-Approval Support** | Request Approval button now enabled even without approvers - shows "Auto-approve" for auto-approval flow |
+| **Edit Deal URL Fix** | Fixed navigation from Line Items dropdown - now correctly routes to `/deals/edit/{id}` |
+| **MW Planner Badge** | Added purple "Planner" badge in deals table to identify deals from MW Planner source |
+| **Creative Library Grid** | Improved grid layout showing 2-6 columns responsively with compact 4:3 cards |
+| **Pacing Graph Labels** | Fixed translation keys for chart labels (Projected Pacing Delivery, Goal Percentage, No.of Days) |
+| **Dynamic Cap Labels** | Daily/Hourly cap labels now change based on goal type (Impression/Reach/SOV) |
+| **Deal Creatives Display** | Fixed creative assignments display with proper API field mapping |
+| **Line Item Inventories** | Fixed inventories display with separate API query for inventory details |
+
+### January 8, 2026
+
+| Category | Changes |
+|----------|---------|
+| **Public Approval Page** | Built comprehensive public approval page for DIRECT mode campaigns with token-based email links |
+| **Approval Stats Display** | Shows Total Approvers, Approved count, Pending count, and Rejected count with visual indicators |
+| **Campaign Header** | Displays Deal ID (full), Country, Budget (currency formatted), and Flight Dates |
+| **Line Items Table** | Implemented table with S.No, Line Item, Inventories, Flight Dates, and Pacing columns |
+| **Line Item Details Sheet** | Created slide-out sheet with 3 tabs: Inventories, Schedule, and Creatives |
+| **Inventories Tab** | Fetches inventories by lineItemId from Inventory API with paginated display |
+| **Schedule Tab** | Shows days of week, hours, validity period, and schedule type/priority |
+| **Creatives Tab** | Displays video player for MP4s with HTML5 `<video>` element controls |
+| **Approval Flow** | Differentiated messages: success on first submission vs "already submitted" warning on return visits |
+| **OTP Verification** | Token-based verification for secure public access without login |
+| **Deal Status Types** | Updated Deal type definition to include all status values (APPROVED, REJECTED, PENDING, etc.) |
+| **Seller Information** | Enabled seller.email, seller.phone, and account object in deal creation payload |
+| **Third-Party Integration** | `/deals/import/convert` API with DIRECT_PUBLISHER_SPLIT payload type for external platforms |
+| **ADS Sync** | ADS request generated only after campaign is APPROVED; complete data sent in approved state |
+| **UTF-8 Encoding** | Fixed name encoding issue - shared message payload now properly encoded in UTF-8 |
+| **seatId Integration** | seatId will be retrieved from company API (scheduled for next deployment) |
+| **Planner Deployment** | Planner migration to `deals-api-stg.movingwalls.com` in progress (replacing legacy endpoint) |
+| **UI Cleanup** | Removed Budget and Status columns from public approval line items table; removed source=influence filter |
+
+### January 2, 2026
+
+| Category | Changes |
+|----------|---------|
+| **API Error Handling** | Improved validation error display with toast notifications showing specific field errors |
+| **Inventory API** | Fixed inventory payload format to only include `id` field (removed `inventoryId` and extraneous fields) |
+| **Toast Notifications** | Added `<Toaster />` component to App.tsx to properly render toast messages |
+
+### December 27-31, 2025
+
+| Category | Changes |
+|----------|---------|
+| **Internationalization (i18n)** | Added full i18n support for 4 languages: English, Chinese, Japanese, Arabic (RTL) |
+| **Translation Coverage** | Translated deal creation, line item wizard, navigation, and common UI components |
+| **API Integration** | Updated all APIs to use logged-in user's company ID for content, inventory, and deals |
+| **Inventory Management** | Refactored line item inventory updates to use separate API endpoint |
+
+### December 25-26, 2025
+
+| Category | Changes |
+|----------|---------|
+| **Testing Infrastructure** | Added Vitest 4.0.16 with @testing-library/react and jsdom |
+| **Test Coverage** | 90 automated tests with 99%+ coverage on utility functions |
+| **AI Reference** | Created AI_REFERENCE.md as canonical coding standards document |
+| **Code Cleanup** | Removed unused campaign wizard, theme toggle, and mock data files |
+| **Error Handling** | Added `APIError` class and `formatAPIErrorForToast` utility for structured error display |
+| **Success Messages** | Added toast notifications for successful line item creation/updates |
+
+---
+
+## Feature Status Checklist
+
+### Infrastructure
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| AWS Deployment | INF-01 | ✅ Ready | influence.movingwalls.com live on AWS (CloudFront + S3) |
+
+### Authentication
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| User Login | AUTH-01 | ✅ Working | SSO OAuth 2.0 with PKCE, auto-redirects to login page |
+| Dashboard Redirect | AUTH-02 | ✅ Working | Redirects to `/deals` dashboard after successful login |
+
+### Inventory Module
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Create Inventory | INV-01 | ⚠️ N/A | Inventories sourced from external JAD API (read-only) |
+| Edit Inventory | INV-02 | ⚠️ N/A | Managed by JAD system |
+| Toggle Status | INV-03 | ⚠️ N/A | Managed by JAD system |
+| Data Persistence | INV-04 | ✅ Working | Selected inventories persist via Influence Deals API |
+
+### Deal Module
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Create Deal | DEAL-01 | ✅ Working | Full 6-step wizard: Deal Details → Line Items → Targeting → Inventory → Creatives → Summary |
+| Line Items | DEAL-02 | ✅ Working | Create, edit, delete line items with budgets, pricing models, and impression goals |
+| Targeting - Demographics | DEAL-03 | ✅ Working | Age, gender, income, interests selectors with API persistence |
+| Targeting - POI | DEAL-04 | ✅ Working | POI search by category, interactive geofencing map with drawing tools |
+| Targeting - Location | DEAL-05 | ✅ Working | Map-based location drawing, CSV upload support, configurable radius circles |
+| Inventory Selection | DEAL-06 | ✅ Working | Search JAD inventories, paginated results (25/50/100 per page), assign to line items |
+| Schedule Customization | DEAL-07 | ✅ Working | Date picker for flight dates, hourly schedule grid per day |
+| Manual Status Change | DEAL-08 | ✅ Working | Change deal status (Draft/Live) from summary step |
+| Stage-Based Editing | DEAL-09 | ✅ Working | Only DRAFT, GENERATED, REOPENED stages allow editing |
+| MW Planner Badge | DEAL-10 | ✅ Working | Purple badge identifies deals from MW Planner source |
+| Seller Email Field | DEAL-11 | ✅ Working | Editable seller email for approval notifications |
+| Dynamic Goal Labels | DEAL-12 | ✅ Working | Daily/Hourly cap labels change based on goal type (Impressions/Reach/SOV) |
+| Pacing Graph | DEAL-13 | ✅ Working | Visual pacing delivery graph with proper translations |
+
+### Public Approval Workflow (DIRECT Mode)
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Public Approval Page | APPR-01 | ✅ Working | Token-based access via email links (no login required) |
+| Campaign Summary | APPR-02 | ✅ Working | Shows Deal ID, Country, Budget (formatted), Flight Dates in header |
+| Approval Stats | APPR-03 | ✅ Working | Displays Total/Approved/Pending/Rejected approver counts |
+| Line Items Table | APPR-04 | ✅ Working | S.No, Line Item, Inventories, Flight Dates, Pacing columns |
+| Line Item Details Sheet | APPR-05 | ✅ Working | Slide-out sheet with Inventories, Schedule, Creatives tabs |
+| Inventories Tab | APPR-06 | ✅ Working | Fetches inventories by lineItemId with paginated display |
+| Schedule Tab | APPR-07 | ✅ Working | Shows days, hours, validity, schedule type/priority |
+| Creatives Tab | APPR-08 | ✅ Working | Video player for MP4s with playback controls |
+| OTP Verification | APPR-09 | ✅ Working | Secure token-based verification for public access |
+| Approve/Reject Actions | APPR-10 | ✅ Working | Submit approval decision with differentiated success/warning messages |
+| Already Decided State | APPR-11 | ✅ Working | Shows "already submitted" warning for return visits |
+| MediaOwner Final Approval | APPR-12 | ✅ Working | Only MediaOwner can give final approval on campaigns from Planner |
+| Auto-Approval | APPR-13 | ✅ Working | Deals without approvers can be auto-approved with dedicated button |
+| Seller Email Notifications | APPR-14 | ✅ Working | Seller/account email receives approval/rejection notifications |
+| Resend Approval Email | APPR-15 | ✅ Working | Resend approval emails to selected approvers for PENDING deals |
+| Planner Restricted Edit | APPR-16 | ✅ Working | Edit approved Planner deals with restricted mode (pacing & creatives only) |
+
+### Line Item Form Redesign (February 2026)
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Single-Page Form | LIF-01 | ✅ Working | Google Ad Manager style with collapsible accordion sections |
+| Status Removed | LIF-02 | ✅ Working | Status dropdown removed; defaults to Draft silently |
+| Ad Duration Pill Buttons | LIF-03 | ✅ Working | Pill/chip-style buttons (5s, 10s, 15s, 20s, 30s) with Custom input |
+| Pacing & Traffic Section | LIF-04 | ✅ Working | Dedicated section with Pacing dropdown and Traffic Allocation slider |
+| Media Owner Sheet | LIF-05 | ✅ Working | Side panel with search, country/type filters, 10 sample media owners |
+| Inventory Format Sheet | LIF-06 | ✅ Working | Side panel grouped by OOH/Transit/Retail with Select All per group |
+| Unlimited Budget Toggle | LIF-07 | ✅ Working | Custom toggle button for reliable rendering |
+| Advanced Options | LIF-08 | ✅ Working | Simplified to Frequency Cap only (Ad Plays + Period) |
+| Form Insights Sidebar | LIF-09 | ✅ Working | Dynamic tips, Quick Tips, and Campaign Forecast panels |
+| AI Inventory Recommendations | LIF-10 | ✅ Working | AI-powered inventory suggestions based on campaign parameters |
+
+### DSP Management
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| DSP List | DSP-01 | ✅ Working | Paginated table with search, matching deals list grid styling |
+| View DSP | DSP-02 | ✅ Working | Read-only view of DSP details (no add/delete) |
+| Edit DSP | DSP-03 | ✅ Working | Pre-populated form with existing DSP data |
+| Table Styling | DSP-04 | ✅ Working | Matches deals list: `bg-[#F3F3F3]` header, `text-[11px] uppercase`, proper column widths |
+| i18n Support | DSP-05 | ✅ Working | Full translation support (en/ja/zh/ar) with `dsp:` namespace |
+
+### Buyer Management
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Buyer List | BUY-01 | ✅ Working | Paginated table matching deals list grid styling |
+| Create Buyer | BUY-02 | ✅ Working | Form with DSP dropdown from real API, seat ID, seat name, buyer account ID, email |
+| Edit Buyer | BUY-03 | ✅ Working | Pre-populated form with existing Buyer data |
+| Delete Buyer | BUY-04 | ✅ Working | Confirmation dialog before deletion |
+| Table Styling | BUY-05 | ✅ Working | Matches deals list: `bg-[#F3F3F3]` header, `text-[11px] uppercase`, proper column widths |
+| i18n Support | BUY-06 | ✅ Working | Full translation support (en/ja/zh/ar) with `buyer:` namespace |
+
+### Third-Party Integration
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Campaign Import API | INT-01 | ✅ Working | `/deals/import/convert` endpoint for external platform integration |
+| PROGRAMMATIC_STANDARD | INT-02 | ✅ Working | Programmatic campaign with line items and inventories |
+| DIRECT_STANDARD | INT-03 | ✅ Working | Direct campaign with line items and inventories |
+| DIRECT_PUBLISHER_SPLIT | INT-04 | ✅ Working | Direct campaign with intelligent inventory grouping by publisher + resolution + duration |
+| Schedule-Based Grouping | INT-05 | ✅ Working | Inventories WITH schedule become individual line items; WITHOUT schedule are grouped |
+| External Platforms | INT-06 | ✅ Working | Supports Broadsign, Vistar, Hivestack, Place Exchange, and custom platforms |
+| Source Permissions | INT-07 | ✅ Working | External sources have limited edit permissions (pacing, budget allocation only) |
+
+### ADS Sync Integration
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| ADS Request Generation | ADS-01 | ✅ Working | ADS request generated only after campaign is APPROVED |
+| Complete Data Sync | ADS-02 | ✅ Working | Complete campaign data sent only in approved state |
+| UTF-8 Encoding | ADS-03 | ✅ Fixed | Shared message payload properly encoded in UTF-8 |
+| seatId from Company API | ADS-04 | 🔄 Pending | seatId retrieved from company API (next deployment) |
+| Planner API Migration | ADS-05 | 🔄 In Progress | Planner deploying to `deals-api-stg.movingwalls.com` |
+
+### Internationalization (i18n)
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Language Support | I18N-01 | ✅ Working | English, Chinese (zh), Japanese (ja), Arabic (ar) |
+| RTL Support | I18N-02 | ✅ Working | Arabic language with RTL layout direction |
+| Translation Files | I18N-03 | ✅ Working | 13 namespace files: common, deals, creatives, navigation, dsp, buyer, contentHub, wizard, campaigns, inventory, lineItems, approval, dashboard |
+| Language Switcher | I18N-04 | ✅ Working | UI component for runtime language switching |
+| 100% Coverage | I18N-05 | ✅ Working | All 22 pages and 75+ components fully translated |
+| Translation Styles | I18N-06 | ✅ Working | Japanese keigo (です/ます), Simplified Chinese, Modern Standard Arabic |
+
+### Navigation
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Module Switching | NAV-01 | ✅ Working | Sidebar navigation between Deals, Inventory, Content Hub modules |
+
+### Usability
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Basic Error Handling | USAB-01 | ✅ Working | Form validation with Zod schemas, toast notifications for actions |
+| API Error Display | USAB-02 | ✅ Working | Specific validation errors shown in toast notifications |
+| Responsive Design | USAB-03 | ✅ Working | Optimized for desktop browsers (1280px+) |
+
+### Testing
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| Core Flow Test | TEST-01 | ✅ Ready | Login → Deal creation → Inventory selection flow verified |
+| Unit Testing | TEST-02 | ✅ Working | Vitest with 147 tests across 54+ test suites |
+| Test Commands | TEST-03 | ✅ Working | `npm test`, `npm run test:coverage`, `npm run test:watch` |
+| Test Results Page | TEST-04 | ✅ Working | Live test results at [/test-results](/test-results) |
+| CI/CD Integration | TEST-05 | ✅ Working | GitLab CI pipeline runs tests on every push |
+
+### Documentation
+
+| Feature | Task ID | Status | Notes |
+|---------|---------|--------|-------|
+| AI Reference | DOC-01 | ✅ Complete | AI_REFERENCE.md with coding standards, patterns, conventions |
+| User Guide | DOC-02 | ❌ Not Started | No user documentation created yet |
+
+---
+
+## Additional Features (Beyond Original Scope)
+
+| Module | Feature | Status | Notes |
+|--------|---------|--------|-------|
+| Content Hub | Creative Upload | ✅ Working | Upload images/videos with drag-and-drop |
+| Content Hub | Approve/Reject Workflow | ✅ Working | Review creatives with comments |
+| Content Hub | Delete Creatives | ✅ Working | Delete with confirmation dialog |
+| Content Hub | Folder Organization | ✅ Working | Organize creatives into folders |
+| Content Hub | Transcoding | ✅ Working | Transcode videos to multiple formats |
+
+---
+
+## Test Accounts
+
+| Account | Email | Role | Purpose |
+|---------|-------|------|---------|
+| Agency Account | `planner-admin@ooh-auth.local` | Agency | Campaign setup and configuration |
+| Media Owner Account | `jeki@jeki.com` | Media Owner | Final campaign approval |
+
+**Note**: Only MediaOwner can give final approval on campaigns from the Planner. For E2E testing, use the agency account to set up the campaign, then switch to the media owner account for final approval.
+
+---
+
+## Demo Flow Guide
+
+### Test Account Setup
+
+Before starting the demo, ensure you have access to:
+- **Agency Account**: `planner-admin@ooh-auth.local` - for campaign setup
+- **Media Owner Account**: `jeki@jeki.com` - for final approval
+
+### Recommended Demo Sequence
+
+#### Part 1: Campaign Setup (Agency Account)
+
+1. **Login as Agency** (1 min)
+   - Visit `influence-stg.movingwalls.com`
+   - Login with `planner-admin@ooh-auth.local`
+   - Auto-redirects to Deals dashboard after authentication
+
+2. **Create a New DIRECT Deal** (5 min)
+   - Click "New Deal" button
+   - Select Mode: **DIRECT**
+   - Fill in deal details:
+     - Deal Name: "Q1 2026 Brand Campaign"
+     - Brand: Enter brand name
+     - Client Type: "Direct Advertiser" or "Agency"
+     - Country: Select market (e.g., Japan, Malaysia)
+     - Currency: Select appropriate currency
+     - Budget: Enter total budget amount
+     - Flight Dates: Select start and end dates
+
+3. **Add Line Items** (5 min)
+   - Click "Add Line Item"
+   - Configure line item:
+     - Name: "Digital Billboards - City Center"
+     - Pricing Model: CPM
+     - Rate and Budget allocation
+     - Goal: Impressions target
+   - Set pacing (Even, ASAP, Custom)
+   - Add multiple line items to show flexibility
+
+4. **Select Inventory** (5 min)
+   - Search for billboards by name or location
+   - Filter by venue type using taxonomy
+   - Select multiple inventories
+   - Show pagination (25/50/100 per page)
+   - Assign inventories to line items
+
+5. **Configure Schedule** (3 min)
+   - Set flight dates for each line item
+   - Configure hourly schedule grid (days and hours)
+   - Set schedule priority and type
+
+6. **Assign Creatives** (3 min)
+   - Navigate to Creatives step
+   - Select or upload creative assets
+   - Assign creatives to line items
+
+7. **Review & Submit for Approval** (2 min)
+   - Review summary of all configured details
+   - Add approval emails (include media owner email)
+   - Click "Submit for Approval"
+
+#### Part 2: Campaign Approval (Media Owner Account)
+
+8. **Login as Media Owner** (1 min)
+   - Logout from agency account
+   - Login with `jeki@jeki.com` (Media Owner)
+
+9. **Approve Campaign** (3 min)
+   - Navigate to Deals dashboard
+   - Find the pending campaign
+   - Review campaign details, line items, inventories
+   - Click "Approve" to give final approval
+   - **Note**: Only MediaOwner can give final approval
+
+10. **Verify ADS Sync** (2 min)
+    - After approval, ADS request is automatically generated
+    - Complete campaign data syncs to ADS in approved state
+
+### Optional: Public Approval Flow Demo (5 min)
+
+1. Create a DIRECT campaign with approval emails
+2. Open the approval email link (token-based, no login required)
+3. Verify OTP if required
+4. Review campaign details:
+   - Campaign summary with Deal ID, Country, Budget, Flight Dates
+   - Line items table with inventories, schedule, pacing
+   - Click line item to see details sheet (Inventories, Schedule, Creatives tabs)
+5. Approve or Reject the campaign
+6. Show "already submitted" message on return visit
+
+### Optional: Third-Party Integration Demo (5 min)
+
+1. Use `/deals/import/convert` API endpoint
+2. Select payload type: `DIRECT_PUBLISHER_SPLIT`
+3. Send external platform campaign data (Broadsign, Vistar, etc.)
+4. Show intelligent inventory grouping:
+   - Inventories WITH schedule → Individual line items
+   - Inventories WITHOUT schedule → Grouped by publisher + resolution + duration
+5. Verify converted deal structure in response
+
+### Optional: Content Hub Demo (3 min)
+
+1. Navigate to Content Hub
+2. Upload a creative (image or video)
+3. Show the approval workflow
+4. Demonstrate folder organization
+
+---
+
+## Pending Items / Known Issues
+
+1. **Schedule Discussion**: Flagged challenge with Sanchit in DSM - requires follow-up discussion
+
+2. **Inventory Management**: Inventories are read-only from JAD API. The platform does not support creating/editing inventories directly.
+
+3. **Signal Targeting**: Weather, traffic, and event triggers are UI-only. Backend integration not yet implemented.
+
+4. **Reporting/Analytics**: No reporting dashboard available yet.
+
+5. **Mobile Responsiveness**: UI optimized for desktop only. Mobile view may have layout issues.
+
+6. **MediaOwner Testing Constraint**: On staging, cannot change inventory mediaOwner to test company. E2E testing requires proper media owner user setup.
+
+---
+
+## Technical Notes for Demo
+
+- **API Endpoints**: All APIs are live and connected
+- **Authentication**: Uses OAuth 2.0 with PKCE for secure login
+- **Data Persistence**: All changes save to Influence Deals API in real-time
+- **Pagination**: Inventory lists use header-based pagination (x-total-count, x-page, etc.)
+- **Error Handling**: API validation errors display specific field/message details in toast notifications
+- **Internationalization**: UI supports 4 languages with RTL for Arabic
+- **ADS Sync**: Campaign data syncs to ADS only after APPROVED status
+- **Planner API**: Deploying to `deals-api-stg.movingwalls.com`
+- **External Platform Integration**: Uses `/deals/import/convert` with payload types: PROGRAMMATIC_STANDARD, DIRECT_STANDARD, DIRECT_PUBLISHER_SPLIT
+
+---
+
+## API Endpoints Reference
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/deals` | GET | List all deals with pagination and filters |
+| `/deals` | POST | Create a new deal |
+| `/deals/{id}` | GET | Get deal by ID |
+| `/deals/{id}` | PUT | Update deal |
+| `/deals/{id}/line-items` | GET/POST | List/Create line items |
+| `/deals/{id}/line-items/{lineItemId}` | GET/PUT/DELETE | Manage line item |
+| `/deals/{id}/line-items/{lineItemId}/inventories` | GET/PUT | Manage inventories |
+| `/deals/{id}/line-items/{lineItemId}/creatives` | GET/POST | Manage creatives |
+| `/deals/import/convert` | POST | Convert external payload to internal schema |
+| `/deals/import` | POST | Import and persist external campaign |
+| `/api/v1/public/approval/campaign` | GET | Public campaign details (token-based) |
+| `/api/v1/public/approval/verify-otp` | POST | Verify OTP for public approval |
+| `/api/v1/public/approval/submit` | POST | Submit approval decision |
+
+---
+
+## Contacts
+
+For technical issues during the demo:
+- Check browser console for errors
+- Verify network connectivity
+- Confirm user has valid SSO credentials
+- For MediaOwner approval issues, ensure user is on the correct media owner company

package/Dockerfile

@@ -0,0 +1,61 @@
+# Dockerfile for Ad Server Frontend
+# Builds and serves the static React application
+#
+# Note: For production, the app is deployed as a static site to S3/CloudFront.
+# This Dockerfile is provided for local development/testing or alternative deployments.
+
+# ================================
+# Stage 1: Build the application
+# ================================
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --prefer-offline
+
+# Copy source code
+COPY . ./
+
+# Build the application
+RUN npm run build
+
+# Verify build output
+RUN ls -la dist/client/ && echo "Build complete"
+
+# ================================
+# Stage 2: Serve with nginx
+# ================================
+FROM nginx:alpine AS runner
+
+# Copy nginx configuration for SPA routing
+RUN echo 'server { \
+    listen 5000; \
+    root /usr/share/nginx/html; \
+    index index.html; \
+    location / { \
+        try_files $uri $uri/ /index.html; \
+    } \
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { \
+        expires 1y; \
+        add_header Cache-Control "public, immutable"; \
+    } \
+    gzip on; \
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript; \
+}' > /etc/nginx/conf.d/default.conf
+
+# Copy built assets
+COPY --from=builder /app/dist/client /usr/share/nginx/html
+
+# Expose port
+EXPOSE 5000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=10s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:5000/ || exit 1
+
+# Start nginx
+CMD ["nginx", "-g", "daemon off;"]

package/Influence-MW-AdServer-12-02-2026/client/index.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1" />
+    <title>Influence - DOOH Adserver Platform</title>
+    <meta name="description" content="Influence is a comprehensive DOOH adserver platform for managing digital out-of-home advertising campaigns, inventory, and programmatic integrations." />
+    <link rel="icon" type="image/png" href="/favicon.png" />
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Architects+Daughter&family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&family=Fira+Code:wght@300..700&family=Geist+Mono:wght@100..900&family=Geist:wght@100..900&family=IBM+Plex+Mono:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;1,100;1,200;1,300;1,400;1,500;1,600;1,700&family=IBM+Plex+Sans:ital,wght@0,100..700;1,100..700&family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Lora:ital,wght@0,400..700;1,400..700&family=Merriweather:ital,opsz,wght@0,18..144,300..900;1,18..144,300..900&family=Montserrat:ital,wght@0,100..900;1,100..900&family=Open+Sans:ital,wght@0,300..800;1,300..800&family=Outfit:wght@100..900&family=Oxanium:wght@200..800&family=Playfair+Display:ital,wght@0,400..900;1,400..900&family=Plus+Jakarta+Sans:ital,wght@0,200..800;1,200..800&family=Poppins:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&family=Roboto+Mono:ital,wght@0,100..700;1,100..700&family=Roboto:ital,wght@0,100..900;1,100..900&family=Source+Code+Pro:ital,wght@0,200..900;1,200..900&family=Source+Serif+4:ital,opsz,wght@0,8..60,200..900;1,8..60,200..900&family=Space+Grotesk:wght@300..700&family=Space+Mono:ital,wght@0,400;0,700;1,400;1,700&display=swap" rel="stylesheet">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>