bvandeusen/FabledCurator
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 33 Wiki Activity

feat(series): flat sequence + cosmetic dividers + pending staging (#789) #97

Merged
bvandeusen merged 2 commits from dev into main 2026-06-11 22:07:57 -04:00
Conversation 0 Commits 2 Files Changed 20
+1410 -1158
bvandeusen commented 2026-06-11 22:07:52 -04:00
Owner
Copy Link
Copy Source

Reframes series authoring (#789), in two phases.

Phase 1 — flat series + dividers

A series is now ONE continuous, series-globally-numbered page run; "chapters" become cosmetic dividers anchored to the page that begins them (they own no pages — a page's chapter is derived from the nearest preceding divider). This is what lets installments assembled from multiple sources sit in one coherent sequence.

  • Migration 0047: flatten each series to a series-global page_number (preserving today's reading order); convert each existing chapter to a divider at its first page (keeping title/stated_part); drop series_page.chapter_id; reshape series_chapter (anchor FK). Loss-safe for content.
  • Manage view = one drag-reorder grid with inline divider bars + global page numbers + per-page source-post chip + "start a chapter here".

Phase 2 — pending staging for add-from-post

  • Migration 0048: series_page.status ('placed' | 'pending') + nullable page_number.
  • "Add to existing series" stages the post's pages as pending (grouped by source post) and navigates to the series. The operator drops junk (text-free alts, bumpers) with post-name context, then places the keepers into the run with clean numbering (place_pending, splice-before or append).

Deploy

0047 + 0048 run on web boot. The series tables are tiny (unlike image_record), so no quiescing needed — just roll :latest.

Dev CI green (run 927: lint, backend, integration incl. both migrations, frontend-build).

🤖 Generated with Claude Code

Reframes series authoring (#789), in two phases. ## Phase 1 — flat series + dividers A series is now ONE continuous, series-globally-numbered page run; "chapters" become **cosmetic dividers** anchored to the page that begins them (they own no pages — a page's chapter is derived from the nearest preceding divider). This is what lets installments assembled from multiple sources sit in one coherent sequence. - **Migration 0047:** flatten each series to a series-global `page_number` (preserving today's reading order); convert each existing chapter to a divider at its first page (keeping title/`stated_part`); drop `series_page.chapter_id`; reshape `series_chapter` (anchor FK). Loss-safe for content. - Manage view = one drag-reorder grid with inline divider bars + global page numbers + per-page source-post chip + "start a chapter here". ## Phase 2 — pending staging for add-from-post - **Migration 0048:** `series_page.status` ('placed' | 'pending') + nullable `page_number`. - "Add to existing series" **stages** the post's pages as pending (grouped by source post) and **navigates** to the series. The operator drops junk (text-free alts, bumpers) with post-name context, then **places** the keepers into the run with clean numbering (`place_pending`, splice-before or append). ## Deploy 0047 + 0048 run on web boot. The series tables are tiny (unlike image_record), so no quiescing needed — just roll `:latest`. Dev CI green (run 927: lint, backend, integration incl. both migrations, frontend-build). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
bvandeusen added 2 commits 2026-06-11 22:07:52 -04:00
feat(series): flat series sequence + cosmetic chapter dividers (#789 Phase 1)
CI / lint (push) Successful in 3s
Details
CI / frontend-build (push) Successful in 21s
Details
CI / backend-lint-and-test (push) Successful in 35s
Details
CI / integration (push) Successful in 3m13s
Details
59746d213d 
Reframe a series from "ordered chapters that own pages" to ONE flat,
series-global ordered run of pages with optional cosmetic chapter DIVIDERS
over it. A chapter no longer wraps content — it's a labeled divider anchored
to the page that begins it; a page's chapter is derived as the nearest
preceding divider. This is what lets installments assembled from multiple
sources sit in one continuous, correctly-numbered sequence (operator's
Goblin Juice case).

- migration 0047: flatten each series to a series-global page_number
  (preserving today's reading order); convert each existing chapter to a
  divider anchored at its first page (keeping title/stated_part); drop
  series_page.chapter_id; reshape series_chapter (anchor_page_id UNIQUE FK,
  drop chapter_number/is_placeholder/stated_page_start/end). Loss-safe for
  content; drops empty placeholder chapters + a redundant page-1 divider.
- series_page: page_number is now the series-global order; no chapter_id.
- series_chapter: anchored divider (anchor_page_id, title, stated_part).
- series_service: flat list_pages (one run + derived dividers + per-page
  source_post + part_gaps), series-wide reorder/renumber, divider CRUD
  (create/update/move/delete); retired per-chapter reorder/merge/placement.
- api/tags: drop chapter_id from add; /chapters endpoints are divider
  create/update/delete (removed chapter reorder/merge/page-reorder).
- series_match_service: series "end" reads max(series_page.stated_page);
  accept appends via add_post. tag_service series-merge appends src's pages
  after tgt's max so the merged series stays one clean run.
- frontend: seriesManage store + SeriesManageView → one continuous
  drag-reorder grid with inline divider bars + series-global page numbers;
  reader walks the flat run, headings from dividers; PostSeriesMenu copy.
- tests reworked across the series suite for the divider model.

Phase 2 (pending staging for add-from-post) is separate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
feat(series): pending staging for add-from-post (#789 Phase 2)
CI / lint (push) Successful in 2s
Details
CI / frontend-build (push) Successful in 24s
Details
CI / backend-lint-and-test (push) Successful in 30s
Details
CI / integration (push) Successful in 3m17s
Details
7bb765b6ed 
Add-from-post no longer appends straight into the run — it STAGES the post's
pages as pending (per-page status; page_number NULL), grouped by source post,
so the operator drops junk (text-free alts, bumpers) and places the keepers
into the sequence with clean series-global numbering.

- migration 0048: series_page.status ('placed' default | 'pending') + nullable
  page_number.
- series_service: placed/pending split everywhere (list_pages returns the
  placed run + a `pending` section grouped by source post; reorder/cover/
  list_series operate on placed only); add_post stages pending; new
  place_pending(image_ids, before_image_id=None) flips pending→placed spliced
  before a page (or appended) and renumbers; junk removal reuses remove_images.
- api/tags: /add-post now returns staged count; new POST /series/<id>/pending/
  place.
- frontend: PostSeriesMenu navigates to the series after staging; seriesManage
  store surfaces `pending` + placePending; SeriesManageView gains a pending
  tray (per-post groups, place-all / place-one / drop-junk).
- tests: pending staging, place (append + insert-before), ignore-already-
  placed, drop-junk, route guard; updated add_post + match-accept expectations.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
bvandeusen merged commit dfab8f65ff into main 2026-06-11 22:07:57 -04:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
bvandeusen
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: bvandeusen/FabledCurator#97
Delete Branch "dev"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?