Livestreams & show cockpit

Livestreams covers two surfaces: the **imported history table** (`/app/livestreams`) and the **show cockpit** (`/app/livestreams/[id]`), which is the operational hub for preparing and reviewing a scheduled Whatnot live.

Two surfaces

Cockpit sections

The left sidebar groups the page by intent so you always know what each block is for.

Tutorial: connect inventory

1. 1

   Stock first

   Build Inventory for the same Whatnot shop (manual, from sold SKUs, or inventory CSV). Unit COGS unlocks projected prices.

2. 2

   Open the show cockpit

   From Calendar, click the event → `/app/livestreams/[id]`. Ensure the event’s shop matches the inventory shop.

3. 3

   Connect inventory

   In Lineup, click Connect inventory, tick the lots for this show, then Add selected. Items already in the lineup are hidden.

4. 4

   Or add a manual product

   Use Add manual product for a one-off lot (title, optional SKU/category, quantity, unit COGS). Prices fill in automatically.

5. 5

   Tune prices

   Edit auction start, floor, and target (+10%) inline, then Save on the row. Roles (opener / peak / filler / closer / VIP bait) can be set manually too.

Projected prices

When you add a lot, WhatCopilot proposes three levels from COGS so you know your floor before you open auctions:

• **Floor (profitable)** ≈ `unit_cogs / (1 − 0.10)` — break-even after ~10% fee buffer
• **Target (+10%)** = `floor × 1.10` — modest net margin goal
• **Auction start** ≈ `35% of floor` (min step 1), optionally capped by the 25th percentile of past auction starts for that SKU/category

Suggestion algorithm

Generate timeline suggestions computes an explainable score per product × hour inside your slot, then places lots greedily on ~20-minute windows.

Signals (shop history from imports)

• Hour heat — when your shop sells most (order timestamps)
• SKU / category × hour fit — which product types convert in which hours
• Velocity — revenue strength of the SKU
• Margin score — net vs COGS when available
• Stock pressure — prioritize low / critical on-hand quantities
• Top-buyer hours — when high spenders tend to buy (closers / VIP)
• Novelty — new SKUs with little history are steered away from blind peak placement

Score shape

`score(item, hour) = w_hour·heat + w_fit·fit + w_margin·margin + w_velocity·velocity + w_stock·stock + w_buyer·buyerHour + w_novelty·novelty − w_risk·underFloorRisk`

Default weights favor fit + heat + margin/velocity, with smaller weights for stock, buyers, and novelty. Each placement stores a `score_breakdown` you (and Orion) can inspect.

Show placement rules

• Early window → openers (known lots, energy)
• Peak heat hours → headliners (velocity / margin)
• Softer hours → fillers and controlled novelty tests
• Late window → closers / VIP bait when top-buyer overlap is strong

Results & debrief

1. Import the Seller Weekly Orders Report after the show (Imports)
2. On Results, confirm auto-match or manually link the imported livestream
3. Review KPI cards (orders, unique buyers, estimated duration, buyer / net revenue)
4. Open Debrief to see which planned lots sold, units, net, and vs floor / target

Ask Orion about the plan

From the cockpit, Ask Orion opens a conversation with your event id and lineup. Orion calls `suggestLiveLineup` to read the same structured coach pack (insights, scores, prices — no raw CSV). It may call `proposeLiveLineupChanges` with real `itemId`s; **you** confirm Apply in the UI. Orion never writes the lineup. Set `recompute=true` only when you ask to refresh engine suggestions.

History table features

• Account filter; search by title / id
• Columns: live, orders, unique buyers, estimated duration (tooltip), buyer revenue, net revenue
• Default sort: net revenue; multi-select → Analyze with Orion
• Open prep when the livestream is linked to a calendar event

Limits

• No real-time Whatnot API — prep is offline; results arrive with the weekly CSV lag
• Demo cockpit is read-only
• Matching lineup to sales uses SKU first, then product title
• Estimated duration on history is not the official stream length

Related

• Calendar — create the slot that opens the cockpit
• Inventory — stock + COGS to connect
• Imports — Seller Weekly CSV
• Statistics — sales-by-hour heat
• Orion — coach on the structured plan