tracker

6.0 KB

1. # Typed headings and the Series / Shows split (tickets #20, #21 — mission 022 (old 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. Since the merge (mission 023 (old 070)) the shared clock's order is: adult backfill → details repair (#26) → kind backfill → credits job
27. (#28); the collection seed (#19) waits for all of them. The daily sync / delta step and the #26 completion store `tmdbType` +
28. `kind` too (details.hl `withDetailsFields`).
29. * A title with a show genre or without `tmdbId`: kind from the stored data, **no request**.
30. * Else `GET /tv/<tmdbId>` (one request), then 260 ms pause. 404 → kind from the genres + `kindCheck`, not asked again.
31. No answer / 429 / 5xx → back of the queue, ≤ 2 retries per start.
32. * A title TMDB's type makes a show moves from /series to /shows at once (`catalog.hl refreshCatalogShow`).
33. * Log: `kind backfill: start, N TV titles without a kind`, every `TRACKER_KINDS_LOG_EVERY` (500) titles,
34. `kind backfill done: n/N titles, series= shows= fromGenre= moved= requests= errors= retries= seconds=`, or `nothing to do`.
35. * `TRACKER_KINDS=0` = off (also off without `TMDB_READ_TOKEN`; the lists still split by genre).
37. ## Addresses
39. | Path | What |
40. |---|---|
41. | `/series`, `/series/page/<n>` | every series (components/allseries.hl), newest released episode first, 24 per page |
42. | `/shows`, `/shows/page/<n>` | every show (components/allshows.hl), same order |
43. | `/series/<slug>`, `/movies/<slug>` | the title page (components/show.hl, a component route) |
44. | `/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 |
45. | `/my/series`, `/my/shows` | `/my/:tv` → components/myshows.hl; any other word → "Not found" |
47. * **Why a function route**: hl:web cannot answer a redirect from a component route, and one pattern cannot be
48. "component for shows, 301 for series".
49. * So `showsRoute` renders the page the way hl:web's own `on http.request` component branch does:
50. `server.router.match('/series/<slug>')` (same component and params), `server.page(m, session, host, headers)`,
51. and a new session + cookie when the browser brought none.
52. * This uses hl:web internals (`router`, `page`, `hostOf`, `requestHeaders`, `sessions`): **re-check after re-vendoring hl:web**
53. (the kinds gate covers it).
54. * Effect in the browser: a link to `/shows/<slug>` is a full page load (the client router only navigates component routes
55. itself). Every other title page is still a client-side navigation.
56. * All links use `shows.hl titlePath(show)`: lists, tiles, search, filmography, /my/*, /<shortId>, the import's landing page.
57. Movies moved from `/shows/<slug>` to `/movies/<slug>` (my decision: `/shows/` now means TV shows; the old movie URLs answer 301).
59. ## Headings and colours (#20)
61. * Markup: `h1 { class = "typed" typeWord { class = "type-word type-<kind>" "Series" } typeSep { "|" } typeName { <name> } }`.
62. * Pages: title page (Movie / Series / Show), `/genres/<g>` (Genre), `/person/<slug>` (Person).
63. List pages `/movies`, `/series`, `/shows` show only the word; `/my/series` and `/my/shows` say "My Series" / "My Shows".
64. * `h1.typed` is a flex row with a gap, so the server's whitespace and a client-built page look the same.
65. A long name wraps in its own column right of "Show |".
66. * Colours (styles.hl, palette tokens; one per type, everywhere the type word appears — headings, homepage row headings,
67. search labels, filmography labels):
69. | Type | Token | Colour |
70. |---|---|---|
71. | Movie | `yellow` | `#dcdcaa` |
72. | Series | `greenDark` (the accent) | `#4ec9b0` |
73. | Show | `purple` | `#c586c0` |
74. | Genre | `blueDark` (the pills) | `#569bd4` |
75. | Person | `orange` (artist links) | `#ce9178` |
76. | Franchise | `blueLight` | `#9cdcfe` |
77. | Timeline | `greenLight` | `#b5cea8` |
79. The name is `colorTextStrong` (white), the bar `colorTextMuted`.
80. * Franchise / Timeline: the classes `type-franchise` / `type-timeline` exist for tracker#19's pages (branch t19). Those pages
81. are not on this branch; their headings get the same markup when the branches are merged.
82. * TMDB results in the search ("Fetch from web") say **TV** (TMDB's search tells no TV type) or Movie.
84. ## Home
86. * Signed in: five tiles — Unwatched, Schedule, Series → `/my/series`, Shows → `/my/shows` (a microphone icon), Movies.
87. Three per row on a phone, five from 40rem.
88. * Three rows: Movies, Series, Shows (10 each, `catalog.hl latestMovies / latestSeries / latestShows`).