Epic: Create Channel — backend prerequisites for the redesigned creation flow #62

Closed
opened 2026-07-01 23:01:35 +02:00 by timothy · 2 comments
Owner

Overview

The redesigned Create Channel flow (see #59 §6 and docs/superpowers/specs/2026-07-01-chicorytv-ui-redesign-design.md) replaces the inherited 4-editor chain (Channel → Schedule → Schedule Items → Playout) with a single library-to-lineup builder. Per the "design pulls the API" principle, that UX needs several backend capabilities that don't exist yet.

This is the umbrella tracking issue. Each capability has its own sub-issue, worked one at a time.

Target UX (context)

One screen: browse/search the library with artwork on the left, drag shows into the channel lineup on the right; friendly toggles (shuffle, always-on); one image used as both listing logo and on-screen bug; technical settings via built-in/custom Channel Templates with an advanced override; a single "Create channel" button that builds everything atomically.

Sub-issues

  • #63 — Composite "create channel from lineup" endpoint
  • #64 — Channel Templates (built-in + custom)
  • #65 — Library browse + search API with artwork
  • #66 — Full image-type support for logo/watermark (incl. transparent re-encode)
  • #67 — Unified logo/bug image handling
  • #68 — Investigate "always-on vs on-demand" playout mode

Suggested order

Investigate #68 and design #64 (templates) early — the composite endpoint (#63) depends on both. #65/#66/#67 can proceed in parallel.

Related

## Overview The redesigned **Create Channel** flow (see [#59 §6](http://192.168.1.95:3000/timothy/ersatztv/issues/59) and `docs/superpowers/specs/2026-07-01-chicorytv-ui-redesign-design.md`) replaces the inherited 4-editor chain (Channel → Schedule → Schedule Items → Playout) with a single library-to-lineup builder. Per the "design pulls the API" principle, that UX needs several backend capabilities that don't exist yet. This is the **umbrella** tracking issue. Each capability has its own sub-issue, worked one at a time. ## Target UX (context) One screen: browse/search the library with artwork on the left, drag shows into the channel lineup on the right; friendly toggles (shuffle, always-on); one image used as both listing logo and on-screen bug; technical settings via built-in/custom **Channel Templates** with an advanced override; a single "Create channel" button that builds everything atomically. ## Sub-issues - [x] #63 — Composite "create channel from lineup" endpoint - [x] #64 — Channel Templates (built-in + custom) - [x] #65 — Library browse + search API with artwork - [x] #66 — Full image-type support for logo/watermark (incl. transparent re-encode) - [x] #67 — Unified logo/bug image handling - [x] #68 — Investigate "always-on vs on-demand" playout mode ## Suggested order Investigate #68 and design #64 (templates) early — the composite endpoint (#63) depends on both. #65/#66/#67 can proceed in parallel. ## Related - Parent redesign: #59 - REST API foundation: #2
Author
Owner

Plan audit (2026-07-02, under #59) cross-checked this epic against the ChannelBuilder.jsx prototype field-by-field. Verdict: #63 and #64 are correctly scoped and are the two genuine hard blockers, but the set had three holes, now filed/fixed:

  1. #104 — image upload endpoint (new): #66/#67 both assume an upload path exists; none does (zero IFormFile in the codebase; CreateChannel.Logo expects a file already on disk). Hard-blocks #89.
  2. #105 — filler-preset/watermark/graphics-element list endpoints (new): the Advanced pickers (and #86's Filler/Overrides tabs) have no data source.
  3. #65 amended: browse projection also needs per-item duration/counts, collection metadata, a library list (consume #103), and typed picker resolution for #86.

Also: #68 is not a Channel Builder prerequisite — the "Always playing" toggle maps to the existing writable ChannelPlayoutMode.Continuous/OnDemand; #68's reframed resume/bookmark scope is an independent feature and was never wired as a #89 dep. And #63 should include a "next free channel number" suggestion in its response (the prototype's AUTO badge).

Plan audit (2026-07-02, under #59) cross-checked this epic against the ChannelBuilder.jsx prototype field-by-field. Verdict: **#63 and #64 are correctly scoped and are the two genuine hard blockers**, but the set had three holes, now filed/fixed: 1. **#104 — image upload endpoint** (new): #66/#67 both assume an upload path exists; none does (zero `IFormFile` in the codebase; `CreateChannel.Logo` expects a file already on disk). Hard-blocks #89. 2. **#105 — filler-preset/watermark/graphics-element list endpoints** (new): the Advanced pickers (and #86's Filler/Overrides tabs) have no data source. 3. **#65 amended**: browse projection also needs per-item duration/counts, collection metadata, a library list (consume #103), and typed picker resolution for #86. Also: **#68 is not a Channel Builder prerequisite** — the "Always playing" toggle maps to the existing writable `ChannelPlayoutMode.Continuous/OnDemand`; #68's reframed resume/bookmark scope is an independent feature and was never wired as a #89 dep. And #63 should include a "next free channel number" suggestion in its response (the prototype's AUTO badge).
timothy added the apienhancementpriority: low labels 2026-07-11 19:03:42 +02:00
Author
Owner

Closing record

Outcome: Umbrella epic complete — closing as done. Every declared child shipped (#63 composite from-lineup endpoint, #64 Channel Templates, #65 library browse/search with artwork, #66 full image-type support, #67 unified logo/bug handling, #68 reframed to resume/bookmark and closed), as did all three holes the 2026-07-02 plan audit added (#104 image upload, #105 filler-preset/watermark/graphics-element list endpoints, #103 media-sources read model) plus the consuming SPA screens (#86 schedule editor, #89 Channel Builder). Body checkboxes reconciled to match — they had drifted unticked while the linked issues closed.
Root cause: n/a (epic, not a bug). The issue stayed open purely as bookkeeping drift: an umbrella has no fixes #N commit to auto-close it, so it outlived its last child.
Decisions/conventions changed: none. Decisions produced under this epic were recorded on the children at the time (e.g. iptv.logo-drives-bug-preset from #67, ondemand reframing from #68).
Reusable knowledge: An umbrella epic is not a work pickup — scripts/select-queue.sh ranks it like any other issue but flags nothing when its children are already closed, so it surfaces at the top of a thin backlog as a phantom candidate. Resolve an epic-shaped candidate by enumerating its children AND any issues added by later plan-audit comments (they are not in the body checklist), then check whether any open issue actually depends on it versus merely citing it for provenance — #503 cites #67 only as where the bug was found, which is not a dependency.
Verification: State of #63/#64/#65/#66/#67/#68/#86/#89/#103/#104/#105/#59/#2 read live from the Gitea API — all closed. Swept all 36 open issues for references to #62–#68; the only hit was #503 (provenance-only).
Deferred: none.
Docs updated: none required — no convention, route, endpoint, or decision changed by closing a completed umbrella.

## Closing record **Outcome:** Umbrella epic complete — closing as done. Every declared child shipped (#63 composite from-lineup endpoint, #64 Channel Templates, #65 library browse/search with artwork, #66 full image-type support, #67 unified logo/bug handling, #68 reframed to resume/bookmark and closed), as did all three holes the 2026-07-02 plan audit added (#104 image upload, #105 filler-preset/watermark/graphics-element list endpoints, #103 media-sources read model) plus the consuming SPA screens (#86 schedule editor, #89 Channel Builder). Body checkboxes reconciled to match — they had drifted unticked while the linked issues closed. **Root cause:** n/a (epic, not a bug). The issue stayed open purely as bookkeeping drift: an umbrella has no `fixes #N` commit to auto-close it, so it outlived its last child. **Decisions/conventions changed:** none. Decisions produced under this epic were recorded on the children at the time (e.g. `iptv.logo-drives-bug-preset` from #67, `ondemand` reframing from #68). **Reusable knowledge:** An umbrella epic is not a work pickup — `scripts/select-queue.sh` ranks it like any other issue but flags nothing when its children are already closed, so it surfaces at the top of a thin backlog as a phantom candidate. Resolve an epic-shaped candidate by enumerating its children AND any issues added by later plan-audit comments (they are not in the body checklist), then check whether any *open* issue actually depends on it versus merely citing it for provenance — #503 cites #67 only as where the bug was found, which is not a dependency. **Verification:** State of #63/#64/#65/#66/#67/#68/#86/#89/#103/#104/#105/#59/#2 read live from the Gitea API — all closed. Swept all 36 open issues for references to #62–#68; the only hit was #503 (provenance-only). **Deferred:** none. **Docs updated:** none required — no convention, route, endpoint, or decision changed by closing a completed umbrella.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: timothy/ersatztv#62