diff --git a/docs/metadata-and-matching.md b/docs/metadata-and-matching.md index 39c00be..e23118f 100644 --- a/docs/metadata-and-matching.md +++ b/docs/metadata-and-matching.md @@ -73,6 +73,14 @@ Paul's point, 1 November 2026: the library holds several copies of many titles ( - **Staying on the clock:** selection must be repeatable from a saved seed and the pool, so restarting the app rejoins the same programme. A window already published doesn't change when the library does. - **Across channels:** a title can sit in several pools, but the same film shouldn't air on two channels at once unless that's intended. +## Broadcast, not playlist + +Paul's direction, 1 November 2026: at this scale Orbit must stay smart and feel like a TV broadcast, not a running playlist. + +- **Indexing:** filter quickly by channel tag, genre, decade and series. Today's database only indexes type and title, and genres and tags sit in one text field, so a separate indexed table for them is needed. +- **Series grouping:** a series is what gets recommended or placed on a channel. Episodes stay attached to it and are fetched when it's needed, so a million episodes never compete as separate choices. +- **Programming:** schedules are built from series and films in sensible order and slots, with next-episode progress for each series, rather than shuffled single items. + ## What the metadata supports Early samples show genres and external IDs on nearly every film and series (3,998 and 3,997 of the first 4,000 imported), so stable-ID identification and genre matching look reliable. Studios and cast are usable but not complete, and episodes carry little of their own, so they should inherit from their series. Coverage across all 132,545 titles: year 132,111, external IDs 131,287, date 129,182, genres 129,119, rating 86,863, tags 58,224. So about a third of titles have no rating, which matters for profiles and mature channels: an unrated title can't be treated as safe.