US: Section-based Reading Recommendations #32

Open
opened 2026-06-20 19:02:13 +00:00 by reid · 0 comments
Owner

User Story: As a group admin, I want the system to recommend how to split the book into sections for our weekly meetings so that reading assignments are balanced and manageable.

Acceptance Criteria:

  • Given I have uploaded an EPUB and it has been parsed into sections, When I request recommendations, Then the system should suggest which sections to assign to each of the 4 weekly meetings.
  • Given I am viewing section recommendations, When I see the suggested splits, Then each meeting should have roughly equal reading time (~25% of the book per meeting).
  • Given the recommendations are displayed, When I review them, Then I should see which chapters/sections are grouped together with estimated time for each meeting.
  • Given I am reviewing recommendations, When I want to adjust, Then I should be able to drag-and-drop sections between meetings or manually select section boundaries.
  • Given I have confirmed the recommendations, When the schedule is finalized, Then the system should lock in the assignments and notify all members of their reading targets.
  • Given the recommendation engine is working, When I load a book with 100+ sections, Then the recommendations should still be balanced and consider natural chapter breaks.

Subtasks (checklist):

  • Implement recommendation algorithm (equal time per meeting)
  • Add chapter-aware splitting logic (prefer chapter boundaries)
  • Create recommendation preview UI
  • Add drag-and-drop section reassignment
  • Implement manual boundary adjustment
  • Add recommendation confirmation flow
  • Create notification to members on finalization
  • Add recommendation regeneration if book changes
  • Add unit tests for recommendation algorithm
User Story: As a group admin, I want the system to recommend how to split the book into sections for our weekly meetings so that reading assignments are balanced and manageable. Acceptance Criteria: * **Given** I have uploaded an EPUB and it has been parsed into sections, **When** I request recommendations, **Then** the system should suggest which sections to assign to each of the 4 weekly meetings. * **Given** I am viewing section recommendations, **When** I see the suggested splits, **Then** each meeting should have roughly equal reading time (~25% of the book per meeting). * **Given** the recommendations are displayed, **When** I review them, **Then** I should see which chapters/sections are grouped together with estimated time for each meeting. * **Given** I am reviewing recommendations, **When** I want to adjust, **Then** I should be able to drag-and-drop sections between meetings or manually select section boundaries. * **Given** I have confirmed the recommendations, **When** the schedule is finalized, **Then** the system should lock in the assignments and notify all members of their reading targets. * **Given** the recommendation engine is working, **When** I load a book with 100+ sections, **Then** the recommendations should still be balanced and consider natural chapter breaks. Subtasks (checklist): - [ ] Implement recommendation algorithm (equal time per meeting) - [ ] Add chapter-aware splitting logic (prefer chapter boundaries) - [ ] Create recommendation preview UI - [ ] Add drag-and-drop section reassignment - [ ] Implement manual boundary adjustment - [ ] Add recommendation confirmation flow - [ ] Create notification to members on finalization - [ ] Add recommendation regeneration if book changes - [ ] Add unit tests for recommendation algorithm
This repo is archived. You cannot comment on issues.
No labels
1 Participants
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: HermesFactory/cloud-reader#32