adserver-dashboard 1.0.0

package/shared/schema.ts

@@ -0,0 +1,439 @@
+import { z } from "zod";
+
+// ============================================================================
+// CAMPAIGN API SCHEMAS
+// ============================================================================
+
+// Deal Mode
+export const dealModeEnum = z.enum([
+  "DIRECT",
+  "PROGRAMMATIC"
+]);
+
+// Deal Types
+export const dealTypeEnum = z.enum([
+  "GUARANTEED",
+  "PREFERRED_DEAL", 
+  "PRIVATE_AUCTION",
+  "EVERGREEN_PMP",
+  "DIRECT"
+]);
+
+// Auction Type
+export const auctionTypeEnum = z.union([
+  z.literal(1),
+  z.literal(2),
+  z.literal(3)
+]);
+export type AuctionType = 1 | 2 | 3;
+
+// Transaction Type
+export const transactionTypeEnum = z.enum([
+  "SPOT",
+  "AUDIENCE"
+]);
+
+// Cost Type
+export const costTypeEnum = z.enum([
+  "CPD",
+  "CPM",
+  "CPS"
+]);
+
+export const dealStatusEnum = z.enum([
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "COMPLETED",
+  "CANCELLED"
+]);
+
+export const dealSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  type: dealTypeEnum,
+  status: dealStatusEnum,
+  advertiser: z.string(),
+  buyer: z.string(),
+  startDate: z.string(),
+  endDate: z.string(),
+  totalBudget: z.number(),
+  spentBudget: z.number(),
+  impressionsGoal: z.number().optional(),
+  impressionsDelivered: z.number().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const insertDealSchema = dealSchema.omit({ 
+  id: true, 
+  createdAt: true, 
+  updatedAt: true,
+  spentBudget: true,
+  impressionsDelivered: true
+}).extend({
+  spentBudget: z.number().default(0),
+  impressionsDelivered: z.number().default(0),
+});
+
+export type Deal = z.infer<typeof dealSchema>;
+export type InsertDeal = z.infer<typeof insertDealSchema>;
+
+// LineItem Types
+export const lineItemStatusEnum = z.enum([
+  "DRAFT",
+  "READY",
+  "ACTIVE",
+  "PAUSED",
+  "COMPLETED"
+]);
+
+export const pricingModelEnum = z.enum([
+  "CPM",
+  "CPD",
+  "CPS",
+  "FIXED"
+]);
+
+export const lineItemSchema = z.object({
+  id: z.string(),
+  dealId: z.string(),
+  name: z.string(),
+  status: lineItemStatusEnum,
+  startDate: z.string(),
+  endDate: z.string(),
+  pricingModel: pricingModelEnum,
+  rate: z.number(),
+  budget: z.number(),
+  spentBudget: z.number(),
+  impressionsGoal: z.number().optional(),
+  impressionsDelivered: z.number().optional(),
+  targetLocations: z.array(z.string()).optional(),
+  targetBillboards: z.array(z.string()).optional(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const insertLineItemSchema = lineItemSchema.omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true,
+  spentBudget: true,
+  impressionsDelivered: true
+}).extend({
+  spentBudget: z.number().default(0),
+  impressionsDelivered: z.number().default(0),
+});
+
+export type LineItem = z.infer<typeof lineItemSchema>;
+export type InsertLineItem = z.infer<typeof insertLineItemSchema>;
+
+// Creative Types
+export const creativeTypeEnum = z.enum([
+  "DISPLAY",
+  "VIDEO", 
+  "AUDIO"
+]);
+
+export const creativeStatusEnum = z.enum([
+  "DRAFT",
+  "PENDING_REVIEW",
+  "APPROVED",
+  "REJECTED",
+  "ACTIVE"
+]);
+
+export const creativeSchema = z.object({
+  id: z.string(),
+  lineItemId: z.string(),
+  name: z.string(),
+  type: creativeTypeEnum,
+  status: creativeStatusEnum,
+  assetUrl: z.string(),
+  thumbnailUrl: z.string().optional(),
+  duration: z.number().optional(),
+  format: z.string(),
+  resolution: z.string().optional(),
+  fileSize: z.number().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const insertCreativeSchema = creativeSchema.omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true
+});
+
+export type Creative = z.infer<typeof creativeSchema>;
+export type InsertCreative = z.infer<typeof insertCreativeSchema>;
+
+// ============================================================================
+// SCREEN API SCHEMAS
+// ============================================================================
+
+// Billboard Types
+export const billboardTypeEnum = z.enum([
+  "DIGITAL",
+  "CLASSIC",
+  "DIGITAL_TRANSIT",
+  "CLASSIC_TRANSIT"
+]);
+
+export const billboardEnvironmentEnum = z.enum([
+  "OUTDOOR",
+  "INDOOR"
+]);
+
+export const billboardOrientationEnum = z.enum([
+  "LANDSCAPE",
+  "PORTRAIT",
+  "SQUARE"
+]);
+
+export const billboardSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  type: billboardTypeEnum,
+  mediaOwnerId: z.string(),
+  mediaOwnerName: z.string(),
+  
+  // Location
+  geom: z.string(), // POINT(longitude latitude)
+  timeZone: z.string(),
+  adminLevel0Id: z.string(),
+  adminLevel0Name: z.string(),
+  adminLevel1Id: z.string().optional(),
+  adminLevel1Name: z.string().optional(),
+  adminLevel2Id: z.string().optional(),
+  adminLevel2Name: z.string().optional(),
+  adminLevel3Id: z.string().optional(),
+  adminLevel3Name: z.string().optional(),
+  adminLevel4Id: z.string().optional(),
+  adminLevel4Name: z.string().optional(),
+  
+  // Details
+  address: z.string().optional(),
+  environment: billboardEnvironmentEnum.optional(),
+  orientation: billboardOrientationEnum.optional(),
+  mediaFormat: z.string().optional(),
+  languagePreferences: z.array(z.string()).optional(),
+  
+  // Metadata
+  archived: z.boolean(),
+  requiresContentApproval: z.boolean(),
+  leadDays: z.number(),
+  url: z.string(),
+  thumbnailUrl: z.string(),
+  
+  // Digital Billboard specific (optional)
+  playerSoftwareId: z.string().optional(),
+  playerSoftwareName: z.string().optional(),
+  playerCount: z.number().optional(),
+  screenStartTime: z.string().optional(),
+  screenEndTime: z.string().optional(),
+  spotDuration: z.number().optional(),
+  spotsPerLoop: z.number().optional(),
+  creativeSpecificationUrl: z.string().optional(),
+  
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const insertBillboardSchema = billboardSchema.omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true
+}).extend({
+  archived: z.boolean().default(false),
+  requiresContentApproval: z.boolean().default(false),
+  leadDays: z.number().default(0),
+  url: z.string().default('https://cdn.movingwalls.com/billboard.jpg'),
+  thumbnailUrl: z.string().default('https://cdn.movingwalls.com/thumbnail.jpg'),
+});
+
+export type Billboard = z.infer<typeof billboardSchema>;
+export type InsertBillboard = z.infer<typeof insertBillboardSchema>;
+
+// Billboard Panel
+export const billboardPanelSchema = z.object({
+  id: z.string(),
+  billboardId: z.string(),
+  pixelWidth: z.number().optional(),
+  pixelHeight: z.number().optional(),
+  physicalWidth: z.number(),
+  physicalHeight: z.number(),
+  panelCount: z.number(),
+});
+
+export const insertBillboardPanelSchema = billboardPanelSchema.omit({ id: true });
+
+export type BillboardPanel = z.infer<typeof billboardPanelSchema>;
+export type InsertBillboardPanel = z.infer<typeof insertBillboardPanelSchema>;
+
+// Billboard Exposure
+export const billboardExposureSchema = z.object({
+  id: z.string(),
+  billboardId: z.string(),
+  dspId: z.string(),
+  dspName: z.string(),
+});
+
+export const insertBillboardExposureSchema = billboardExposureSchema.omit({ id: true });
+
+export type BillboardExposure = z.infer<typeof billboardExposureSchema>;
+export type InsertBillboardExposure = z.infer<typeof insertBillboardExposureSchema>;
+
+// Billboard External ID
+export const billboardExternalIdSchema = z.object({
+  id: z.string(),
+  billboardId: z.string(),
+  platform: z.string(),
+  externalId: z.string(),
+});
+
+export const insertBillboardExternalIdSchema = billboardExternalIdSchema.omit({ id: true });
+
+export type BillboardExternalId = z.infer<typeof billboardExternalIdSchema>;
+export type InsertBillboardExternalId = z.infer<typeof insertBillboardExternalIdSchema>;
+
+// ============================================================================
+// SUPPORTING SCHEMAS
+// ============================================================================
+
+// Media Owner
+export const mediaOwnerSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  createdAt: z.string(),
+});
+
+export const insertMediaOwnerSchema = mediaOwnerSchema.omit({ 
+  id: true, 
+  createdAt: true 
+});
+
+export type MediaOwner = z.infer<typeof mediaOwnerSchema>;
+export type InsertMediaOwner = z.infer<typeof insertMediaOwnerSchema>;
+
+// DSP (Demand Side Platform)
+export const dspSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  dspType: z.string().optional(),
+  transactionType: z.string().optional(),
+  ipAddress: z.string().optional(),
+  country: z.string().optional(),
+  email: z.string().optional(),
+  url: z.string().optional(),
+  inventoryAccess: z.string().optional(),
+  currencyAccess: z.string().optional(),
+  mediaType: z.string().optional(),
+  accessTokenKey: z.string().optional(),
+  accessTokenSecret: z.string().optional(),
+  creativeOfflineApproval: z.boolean().default(false),
+  dealAutoApproval: z.boolean().default(false),
+  dealReopen: z.boolean().default(false),
+  enableAspectRatio: z.boolean().default(false),
+  displayAspectRatio: z.string().optional(),
+  disclaimer: z.string().optional(),
+  billingName: z.string().optional(),
+  billingAddress: z.string().optional(),
+  billingEmail: z.string().optional(),
+  reportingType: z.string().optional(),
+  reportingTimeZone: z.string().optional(),
+  reportingEmailId: z.string().optional(),
+  reportingFields: z.array(z.string()).optional(),
+  reportingTime: z.string().optional(),
+  reportingActivate: z.boolean().default(false),
+  createdBy: z.string().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string().optional(),
+});
+
+export const insertDspSchema = dspSchema.omit({ 
+  id: true, 
+  createdAt: true,
+  updatedAt: true
+});
+
+export type DSP = z.infer<typeof dspSchema>;
+export type InsertDSP = z.infer<typeof insertDspSchema>;
+
+// Buyer (DSP Seat/Buyer)
+export const buyerSchema = z.object({
+  id: z.string(),
+  dspId: z.string(),
+  dspName: z.string().optional(),
+  seatId: z.string(),
+  seatName: z.string(),
+  buyerAccountId: z.string(),
+  email: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string().optional(),
+});
+
+export const insertBuyerSchema = buyerSchema.omit({ 
+  id: true, 
+  createdAt: true,
+  updatedAt: true
+});
+
+export type Buyer = z.infer<typeof buyerSchema>;
+export type InsertBuyer = z.infer<typeof insertBuyerSchema>;
+
+// SSP
+export const sspSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  createdAt: z.string(),
+});
+
+export const insertSspSchema = sspSchema.omit({ 
+  id: true, 
+  createdAt: true 
+});
+
+export type SSP = z.infer<typeof sspSchema>;
+export type InsertSSP = z.infer<typeof insertSspSchema>;
+
+// User (extended for OAuth)
+export const userSchema = z.object({
+  id: z.string(),
+  username: z.string().optional(),
+  password: z.string().optional(),
+  
+  // OAuth fields
+  provider: z.string().optional(),
+  providerId: z.string().optional(),
+  accessToken: z.string().optional(),
+  refreshToken: z.string().optional(),
+  tokenExpiry: z.string().optional(),
+  
+  // Profile fields from IAM
+  email: z.string().optional(),
+  name: z.string().optional(),
+  avatarUrl: z.string().optional(),
+  
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
+export const insertUserSchema = userSchema.omit({ id: true, createdAt: true, updatedAt: true });
+
+export type User = z.infer<typeof userSchema>;
+export type InsertUser = z.infer<typeof insertUserSchema>;
+
+// ============================================================================
+// BULK SYNC SCHEMAS (Campaign API)
+// ============================================================================
+
+export const bulkSyncRequestSchema = z.object({
+  deals: z.array(insertDealSchema.extend({
+    lineItems: z.array(insertLineItemSchema.extend({
+      creatives: z.array(insertCreativeSchema).optional()
+    })).optional()
+  }))
+});
+
+export type BulkSyncRequest = z.infer<typeof bulkSyncRequestSchema>;

package/shared/screen-types.ts

@@ -0,0 +1,149 @@
+// Screen/Billboard API Types
+// Aligned with Screen API Swagger specification
+
+export type BillboardType = 'DIGITAL' | 'CLASSIC' | 'DIGITAL_TRANSIT' | 'CLASSIC_TRANSIT';
+
+export type BillboardEnvironment = 'OUTDOOR' | 'INDOOR';
+
+export type BillboardOrientation = 'LANDSCAPE' | 'PORTRAIT' | 'SQUARE';
+
+export interface Billboard {
+  id: string;
+  created_at: string;
+  created_by: string;
+  updated_at: string;
+  updated_by: string;
+  
+  // Media Owner
+  media_owner_id: string;
+  media_owner_name: string;
+  
+  // Location
+  geom: string; // POINT(longitude latitude)
+  time_zone: string;
+  admin_level0_id: string;
+  admin_level0_name: string; // Country
+  admin_level1_id?: string;
+  admin_level1_name?: string; // State/Region
+  admin_level2_id?: string;
+  admin_level2_name?: string; // District/County
+  admin_level3_id?: string;
+  admin_level3_name?: string; // Area/Neighborhood
+  admin_level4_id?: string;
+  admin_level4_name?: string; // Specific Location
+  
+  // Billboard Details
+  name: string;
+  type: BillboardType;
+  archived: boolean;
+  requires_content_approval: boolean;
+  lead_days: number;
+  url: string;
+  thumbnail_url: string;
+  
+  // Optional Details
+  address?: string;
+  environment?: BillboardEnvironment;
+  orientation?: BillboardOrientation;
+  media_format?: string; // e.g., "1920x1080"
+  language_preferences?: string[]; // ISO 639-1 codes
+}
+
+export interface DigitalBillboard extends Billboard {
+  player_software_id: string;
+  player_software_name: string;
+  player_count: number;
+  screen_start_time?: string; // "HH:MM:SS"
+  screen_end_time?: string; // "HH:MM:SS"
+  spot_duration?: number; // seconds
+  spots_per_loop?: number;
+  creative_specification_url?: string;
+}
+
+export interface BillboardPanel {
+  id: string;
+  billboard_id: string;
+  pixel_width?: number;
+  pixel_height?: number;
+  physical_width: number; // meters
+  physical_height: number; // meters
+  panel_count: number;
+}
+
+export interface BillboardExposure {
+  billboard_id: string;
+  dsp_id: string;
+  dsp_name?: string;
+}
+
+export interface BillboardExternalId {
+  billboard_id: string;
+  platform: string; // LMX, ViOOH, Hivestack, etc.
+  external_id: string;
+}
+
+export interface BillboardContentExclusion {
+  billboard_id: string;
+  taxonomy_id: string;
+  version: string;
+}
+
+export interface BillboardVenue {
+  billboard_id: string;
+  taxonomy_id: string;
+  version: string;
+}
+
+export interface BillboardPrice {
+  id: string;
+  billboard_id: string;
+  cost_type: 'CPD' | 'CPM' | 'CPS';
+  amount: number;
+  currency: string;
+  start_date?: string;
+  end_date?: string;
+}
+
+export interface TransitRoute {
+  id: string;
+  name: string;
+  description?: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface TransitRoutePoint {
+  id: string;
+  transit_route_id: string;
+  ordinal: number;
+  geom: string; // POINT(longitude latitude)
+}
+
+export interface BillboardWithRelations extends Billboard {
+  panels?: BillboardPanel[];
+  exposures?: BillboardExposure[];
+  external_ids?: BillboardExternalId[];
+  content_exclusions?: BillboardContentExclusion[];
+  venues?: BillboardVenue[];
+  prices?: BillboardPrice[];
+}
+
+// API Request/Response Types
+export interface BillboardListResponse {
+  data: BillboardWithRelations[];
+  pagination: {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+  };
+}
+
+export interface BulkImportBillboardRequest {
+  billboard: Partial<Billboard>;
+  panels?: Partial<BillboardPanel>[];
+  exposures?: { dsp_id: string }[];
+  external_ids?: { platform: string; external_id: string }[];
+  content_exclusions?: { taxonomy_id: string; version: string }[];
+  venues?: { taxonomy_id: string; version: string }[];
+}

package/springdocDefault.json

@@ -0,0 +1 @@
+{"openapi":"3.1.0","info":{"title":"MovingWalls Creative Management","description":"Backend APIs for Creative Management","version":"1.0.0"},"servers":[{"url":"/"}],"tags":[{"name":"Inventory Recommendation","description":"APIs to generate recommendations based on user inputs"},{"name":"Schedule Recommendations","description":"APIs for generating schedule recommendations"}],"paths":{"/api/v1/recommendation/schedules":{"post":{"tags":["Schedule Recommendations"],"summary":"Generate schedule recommendations","description":"Generate recommended schedules for the provided inventory IDs based on availability","operationId":"generateSchedules","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduleRecommendationRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseScheduleRecommendationResponseDTO"}}}}}}},"/api/v1/recommendation/runs/{runId}/selected-inventories":{"post":{"tags":["Inventory Recommendation"],"summary":"Mark selected inventories","description":"Mark selected inventories for a recommendation run. If selected inventoryIds are not in existing results (e.g., excluded by geoTargeting), generate recommendations for them and re-sort all results by finalScore. The isSelected field will be returned in recommendation result responses.","operationId":"markSelectedInventories","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectedInventoriesDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"basicAuth":[]}]}},"/api/v1/recommendation/runs/{runId}/results":{"post":{"tags":["Inventory Recommendation"],"summary":"Get recommendation results with filtering","description":"Get paginated recommendation results for a runId with filtering and sorting support. Returns error if runId is IN_PROGRESS or not found. Default sort: finalScore,desc. Valid sort fields: finalScore, inventoryId, referenceId, name, createdAt, estimatedImpressions, estimatedReach, estimatedFrequency, estimatedCost, measureFit, geoFit, availability, budgetFit, audienceFit, brandFit, qualityFit, timeFit. Filters can be applied on inventory properties, scores, forecasts, and costs.","operationId":"getRecommendationResults","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":20}},{"name":"sort","in":"query","description":"Sort parameters (format: field,direction). Multiple sorts can be specified. Example: sort=finalScore,desc&sort=inventoryId,asc","required":false,"schema":{"type":"array","items":{"type":"string"}}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationResultFilterDTO"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePaginatedRecommendationResponseDTO"}}}}},"security":[{"basicAuth":[]}]}},"/api/v1/recommendation/campaigns/{campaignId}/recommendations":{"post":{"tags":["Inventory Recommendation"],"summary":"Submit recommendation request","description":"Submit a recommendation request. Returns runId and status. If same payload already exists, returns existing runId.","operationId":"submitRecommendation","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseRecommendationStatusResponseDTO"}}}}},"security":[{"basicAuth":[]}]}}},"components":{"schemas":{"ScheduleRecommendationRequestDTO":{"type":"object","properties":{"inventoryIds":{"type":"array","items":{"type":"string"},"minItems":1},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"creativeDuration":{"type":"integer","format":"int32"},"bookingType":{"type":"string"}},"required":["endDate","inventoryIds","startDate"]},"ApiResponseScheduleRecommendationResponseDTO":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/ScheduleRecommendationResponseDTO"},"message":{"type":"string"},"error":{"$ref":"#/components/schemas/ErrorResponse"},"timestamp":{"type":"string","format":"date-time"}}},"AvailabilitySlotDetails":{"type":"object","properties":{"inventoryId":{"type":"string"},"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"isAvailable":{"type":"boolean"},"requestedSeconds":{"type":"integer","format":"int64"},"availableSeconds":{"type":"integer","format":"int64"},"allocatedSeconds":{"type":"integer","format":"int64"},"bookingMode":{"type":"string"},"loopDuration":{"type":"integer","format":"int32"},"slotCapacity":{"type":"array","items":{"$ref":"#/components/schemas/SlotCapacity"}},"issues":{"type":"array","items":{"type":"string"}},"conflictingBookings":{"type":"array","items":{"type":"string"}}}},"AvailabilitySummary":{"type":"object","properties":{"availableDays":{"type":"integer","format":"int32"},"totalDays":{"type":"integer","format":"int32"},"availabilityPercentage":{"type":"number","format":"double"},"summary":{"type":"string"},"allAvailable":{"type":"boolean"}}},"ErrorResponse":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"InventorySchedule":{"type":"object","properties":{"inventoryId":{"type":"string"},"referenceId":{"type":"string"},"inventoryName":{"type":"string"},"recommendedSchedules":{"type":"array","items":{"$ref":"#/components/schemas/RecommendedSchedule"}},"availability":{"$ref":"#/components/schemas/AvailabilitySummary"}}},"RecommendedSchedule":{"type":"object","properties":{"scheduleId":{"type":"string"},"name":{"type":"string"},"scheduleStartDate":{"type":"string","format":"date"},"scheduleEndDate":{"type":"string","format":"date"},"scheduleDays":{"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"type":{"type":"string","enum":["LOOP","DAYPART"]},"bookingMatrix":{"type":"object","additionalProperties":{"type":"array","items":{"type":"integer","format":"int32"}}},"duration":{"type":"integer","format":"int64"},"spotsPerLoop":{"type":"integer","format":"int64"},"spotsPerHour":{"type":"integer","format":"int64"},"adPlays":{"type":"integer","format":"int64"},"plannedSot":{"type":"number","format":"double"},"totalSot":{"type":"number","format":"double"},"slotDetails":{"$ref":"#/components/schemas/AvailabilitySlotDetails"}}},"ScheduleRecommendationResponseDTO":{"type":"object","properties":{"requestId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"schedules":{"type":"array","items":{"$ref":"#/components/schemas/InventorySchedule"}}}},"SlotCapacity":{"type":"object","properties":{"slotPosition":{"type":"integer","format":"int32"},"spotDuration":{"type":"integer","format":"int32"},"requestedSeconds":{"type":"integer","format":"int64"},"availableSeconds":{"type":"integer","format":"int64"},"allocatedSeconds":{"type":"integer","format":"int64"},"isSlotAvailable":{"type":"boolean"}}},"SelectedInventoriesDTO":{"type":"object","properties":{"inventoryIds":{"type":"array","items":{"type":"string"}}}},"ApiResponseVoid":{"type":"object","properties":{"success":{"type":"boolean"},"data":{},"message":{"type":"string"},"error":{"$ref":"#/components/schemas/ErrorResponse"},"timestamp":{"type":"string","format":"date-time"}}},"RecommendationResultFilterDTO":{"type":"object","description":"Filter criteria (optional)","properties":{"inventoryIds":{"type":"array","items":{"type":"string"}},"referenceIds":{"type":"array","items":{"type":"string"}},"types":{"type":"array","items":{"type":"string"}},"formats":{"type":"array","items":{"type":"string"}},"environments":{"type":"array","items":{"type":"string"}},"venueTypes":{"type":"array","items":{"type":"string"}},"orientations":{"type":"array","items":{"type":"string"}},"sizes":{"type":"array","items":{"type":"string"}},"mediaOwnerIds":{"type":"array","items":{"type":"string"}},"mediaOwnerNames":{"type":"array","items":{"type":"string"}},"countryIds":{"type":"array","items":{"type":"string"}},"countryNames":{"type":"array","items":{"type":"string"}},"stateIds":{"type":"array","items":{"type":"string"}},"stateNames":{"type":"array","items":{"type":"string"}},"cityIds":{"type":"array","items":{"type":"string"}},"cityNames":{"type":"array","items":{"type":"string"}},"minFinalScore":{"type":"number","format":"double"},"maxFinalScore":{"type":"number","format":"double"},"minMeasureFit":{"type":"number","format":"double"},"maxMeasureFit":{"type":"number","format":"double"},"minGeoFit":{"type":"number","format":"double"},"maxGeoFit":{"type":"number","format":"double"},"minAvailability":{"type":"number","format":"double"},"maxAvailability":{"type":"number","format":"double"},"minBudgetFit":{"type":"number","format":"double"},"maxBudgetFit":{"type":"number","format":"double"},"minAudienceFit":{"type":"number","format":"double"},"maxAudienceFit":{"type":"number","format":"double"},"minBrandFit":{"type":"number","format":"double"},"maxBrandFit":{"type":"number","format":"double"},"minQualityFit":{"type":"number","format":"double"},"maxQualityFit":{"type":"number","format":"double"},"minTimeFit":{"type":"number","format":"double"},"maxTimeFit":{"type":"number","format":"double"},"minEstimatedImpressions":{"type":"integer","format":"int64"},"maxEstimatedImpressions":{"type":"integer","format":"int64"},"minEstimatedReach":{"type":"integer","format":"int64"},"maxEstimatedReach":{"type":"integer","format":"int64"},"minEstimatedFrequency":{"type":"number","format":"double"},"maxEstimatedFrequency":{"type":"number","format":"double"},"minEstimatedCost":{"type":"number"},"maxEstimatedCost":{"type":"number"},"currencies":{"type":"array","items":{"type":"string"}},"minAvailabilityPercentage":{"type":"number","format":"double"},"maxAvailabilityPercentage":{"type":"number","format":"double"},"allAvailable":{"type":"boolean"}}},"ApiResponsePaginatedRecommendationResponseDTO":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/PaginatedRecommendationResponseDTO"},"message":{"type":"string"},"error":{"$ref":"#/components/schemas/ErrorResponse"},"timestamp":{"type":"string","format":"date-time"}}},"ComponentScores":{"type":"object","properties":{"measureFit":{"type":"number","format":"double"},"geoFit":{"type":"number","format":"double"},"availability":{"type":"number","format":"double"},"budgetFit":{"type":"number","format":"double"},"audienceFit":{"type":"number","format":"double"},"brandFit":{"type":"number","format":"double"},"qualityFit":{"type":"number","format":"double"},"timeFit":{"type":"number","format":"double"}}},"CostEstimate":{"type":"object","properties":{"estimatedCost":{"type":"number"},"currency":{"type":"string"},"costPerImpression":{"type":"number","format":"double"}}},"ForecastedMetrics":{"type":"object","properties":{"estimatedImpressions":{"type":"integer","format":"int64"},"estimatedReach":{"type":"integer","format":"int64"},"estimatedSov":{"type":"number","format":"double"},"estimatedFrequency":{"type":"number","format":"double"}}},"InventoryDetails":{"type":"object","properties":{"classification":{"type":"string"},"type":{"type":"string"},"format":{"type":"string"},"environment":{"type":"string"},"venueTypes":{"type":"array","items":{"type":"string"}},"orientation":{"type":"string"},"sizes":{"type":"array","items":{"type":"string"}},"mediaOwnerId":{"type":"string"},"mediaOwnerName":{"type":"string"},"address":{"type":"string"},"location":{"$ref":"#/components/schemas/InventoryLocation"}}},"InventoryLocation":{"type":"object","properties":{"countryId":{"type":"string"},"countryName":{"type":"string"},"stateId":{"type":"string"},"stateName":{"type":"string"},"cityId":{"type":"string"},"cityName":{"type":"string"},"locationCoordinates":{}}},"PaginatedRecommendationResponseDTO":{"type":"object","properties":{"runId":{"type":"string"},"campaignId":{"type":"string"},"productId":{"type":"string"},"companyId":{"type":"string"},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/RecommendedInventory"}},"pagination":{"$ref":"#/components/schemas/PaginationInfo"}}},"PaginationInfo":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"hasNext":{"type":"boolean"},"hasPrevious":{"type":"boolean"}}},"RecommendedInventory":{"type":"object","properties":{"inventoryId":{"type":"string"},"referenceId":{"type":"string"},"name":{"type":"string"},"finalScore":{"type":"number","format":"double"},"componentScores":{"$ref":"#/components/schemas/ComponentScores"},"why":{"type":"string"},"availability":{"$ref":"#/components/schemas/AvailabilitySummary"},"forecast":{"$ref":"#/components/schemas/ForecastedMetrics"},"cost":{"$ref":"#/components/schemas/CostEstimate"},"inventoryDetails":{"$ref":"#/components/schemas/InventoryDetails"},"isSelected":{"type":"boolean"},"isExcluded":{"type":"boolean"}}},"AudienceTargeting":{"type":"object","properties":{"audienceSegments":{"type":"array","items":{"type":"string"}},"demographics":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}},"Geofence":{"type":"object","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"array","items":{"type":"number","format":"double"}}},"centerLng":{"type":"number","format":"double"},"centerLat":{"type":"number","format":"double"}}},"GeographyTargeting":{"type":"object","properties":{"cities":{"type":"array","items":{"type":"string"}},"states":{"type":"array","items":{"type":"string"}},"geofences":{"type":"array","items":{"$ref":"#/components/schemas/Geofence"}}}},"RecommendationRequestDTO":{"type":"object","properties":{"country":{"type":"string","minLength":1},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"productId":{"type":"string"},"companyId":{"type":"string"},"geographyTargeting":{"$ref":"#/components/schemas/GeographyTargeting"},"audienceTargeting":{"$ref":"#/components/schemas/AudienceTargeting"},"brandId":{"type":"string"},"budget":{"type":"number"},"goal":{"type":"string","enum":["IMPRESSIONS","REACH","SOV"]},"goalValue":{"type":"integer","format":"int64"},"excludedInventoryIds":{"type":"array","items":{"type":"string"}},"excludedIabCategories":{"type":"array","items":{"type":"string"}},"topN":{"type":"integer","format":"int32"}},"required":["country","endDate","startDate"]},"ApiResponseRecommendationStatusResponseDTO":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"$ref":"#/components/schemas/RecommendationStatusResponseDTO"},"message":{"type":"string"},"error":{"$ref":"#/components/schemas/ErrorResponse"},"timestamp":{"type":"string","format":"date-time"}}},"RecommendationMetadata":{"type":"object","properties":{"totalInventoriesEvaluated":{"type":"integer","format":"int32"},"totalInventoriesRecommended":{"type":"integer","format":"int32"},"totalInventoriesExcluded":{"type":"integer","format":"int32"},"exclusionReasons":{"type":"object","additionalProperties":{"type":"integer","format":"int32"}},"averageScore":{"type":"number","format":"double"},"seed":{"type":"string"}}},"RecommendationStatusResponseDTO":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["IN_PROGRESS","COMPLETED"]},"completionPercentage":{"type":"integer","format":"int32"},"campaignId":{"type":"string"},"productId":{"type":"string"},"companyId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"metadata":{"$ref":"#/components/schemas/RecommendationMetadata"},"warnings":{"type":"array","items":{"type":"string"}}}}},"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic"}}}}