tracker

5.7 KB

1. # Typed headings and the Series / Shows split (tickets #20, #21 — mission 068)
3. Creator: "make the page headings have types in their headings: Movie | Riddick, Series | Reacher, Genre | Action — and have
4. them use their colors but the title in white" (#20) and "i want to split series and shows - all that game show and reality
5. and talkshow stuff goes into shows and the real series are Series and /series" (#21).
7. ## Kinds
9. * A TV title (`shows.type = 'series'`) has a **kind**: `series` or `show`. Movies (`type = 'movie'`) have none.
10. * **Rule** (`shows.hl kindOfTitle`, architect's reading in the ticket): a **show** when TMDB's TV `type` is Reality, Talk Show,
11. News or Video, OR the title has one of our genres Reality / Talk / News; everything else is a **series** (TMDB types
12. Scripted, Miniseries, Documentary — and "type not known").
13. * **Stored** on the title: `kind` and TMDB's `tmdbType`; `kindCheck` = why no type is known (`TMDB 404`, `no tmdbId`,
14. `TMDB gave no type`). `shows.hl titleKind(show)` = stored `kind`, else the rule from the genres alone.
15. * **Who stores it**:
16. * the **kind backfill** (below), once for every TV title;
17. * the **daily sync** (`tmdbsync.hl syncShow`: the details answer has `type`);
18. * the **adult backfill** (`backfillTitle`, a TV title's details);
19. * the **search import** (`search.hl importTitle`).
20. * Titles the person fill adds (`people.hl addMinimalTitle`) get no kind: the genres decide until the next start's backfill.
22. ## Kind backfill (`project.hl kindTick` → `tmdbsync.hl kindTitle`)
24. * Queue at start = every TV title without a stored kind (resumes after a restart).
25. * Starts after the adult backfill is done (or off); waits while the daily sync runs; ONE title per step on the shared 0.1 s clock.
26. * A title with a show genre or without `tmdbId`: kind from the stored data, **no request**.
27. * Else `GET /tv/<tmdbId>` (one request), then 260 ms pause. 404 → kind from the genres + `kindCheck`, not asked again.
28. No answer / 429 / 5xx → back of the queue, ≤ 2 retries per start.
29. * A title TMDB's type makes a show moves from /series to /shows at once (`catalog.hl refreshCatalogShow`).
30. * Log: `kind backfill: start, N TV titles without a kind`, every `TRACKER_KINDS_LOG_EVERY` (500) titles,
31. `kind backfill done: n/N titles, series= shows= fromGenre= moved= requests= errors= retries= seconds=`, or `nothing to do`.
32. * `TRACKER_KINDS=0` = off (also off without `TMDB_READ_TOKEN`; the lists still split by genre).
34. ## Addresses
36. | Path | What |
37. |---|---|
38. | `/series`, `/series/page/<n>` | every series (components/allseries.hl), newest released episode first, 24 per page |
39. | `/shows`, `/shows/page/<n>` | every show (components/allshows.hl), same order |
40. | `/series/<slug>`, `/movies/<slug>` | the title page (components/show.hl, a component route) |
41. | `/shows/<slug>` | FUNCTION route `project.hl showsRoute`: a series → **301** `/series/<slug>`, a movie → **301** `/movies/<slug>`; a show (or an unknown slug → the page's "Not found") is rendered as the Show component |
42. | `/my/series`, `/my/shows` | `/my/:tv` → components/myshows.hl; any other word → "Not found" |
44. * **Why a function route**: hl:web cannot answer a redirect from a component route, and one pattern cannot be
45. "component for shows, 301 for series".
46. * So `showsRoute` renders the page the way hl:web's own `on http.request` component branch does:
47. `server.router.match('/series/<slug>')` (same component and params), `server.page(m, session, host, headers)`,
48. and a new session + cookie when the browser brought none.
49. * This uses hl:web internals (`router`, `page`, `hostOf`, `requestHeaders`, `sessions`): **re-check after re-vendoring hl:web**
50. (the kinds gate covers it).
51. * Effect in the browser: a link to `/shows/<slug>` is a full page load (the client router only navigates component routes
52. itself). Every other title page is still a client-side navigation.
53. * All links use `shows.hl titlePath(show)`: lists, tiles, search, filmography, /my/*, /<shortId>, the import's landing page.
54. Movies moved from `/shows/<slug>` to `/movies/<slug>` (my decision: `/shows/` now means TV shows; the old movie URLs answer 301).
56. ## Headings and colours (#20)
58. * Markup: `h1 { class = "typed" typeWord { class = "type-word type-<kind>" "Series" } typeSep { "|" } typeName { <name> } }`.
59. * Pages: title page (Movie / Series / Show), `/genres/<g>` (Genre), `/person/<slug>` (Person).
60. List pages `/movies`, `/series`, `/shows` show only the word; `/my/series` and `/my/shows` say "My Series" / "My Shows".
61. * `h1.typed` is a flex row with a gap, so the server's whitespace and a client-built page look the same.
62. A long name wraps in its own column right of "Show |".
63. * Colours (styles.hl, palette tokens; one per type, everywhere the type word appears — headings, homepage row headings,
64. search labels, filmography labels):
66. | Type | Token | Colour |
67. |---|---|---|
68. | Movie | `yellow` | `#dcdcaa` |
69. | Series | `greenDark` (the accent) | `#4ec9b0` |
70. | Show | `purple` | `#c586c0` |
71. | Genre | `blueDark` (the pills) | `#569bd4` |
72. | Person | `orange` (artist links) | `#ce9178` |
73. | Franchise | `blueLight` | `#9cdcfe` |
74. | Timeline | `greenLight` | `#b5cea8` |
76. The name is `colorTextStrong` (white), the bar `colorTextMuted`.
77. * Franchise / Timeline: the classes `type-franchise` / `type-timeline` exist for tracker#19's pages (branch t19). Those pages
78. are not on this branch; their headings get the same markup when the branches are merged.
79. * TMDB results in the search ("Fetch from web") say **TV** (TMDB's search tells no TV type) or Movie.
81. ## Home
83. * Signed in: five tiles — Unwatched, Schedule, Series → `/my/series`, Shows → `/my/shows` (a microphone icon), Movies.
84. Three per row on a phone, five from 40rem.
85. * Three rows: Movies, Series, Shows (10 each, `catalog.hl latestMovies / latestSeries / latestShows`).