US: Shared EPUB Upload and Section Splitting #29

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

User Story: As a group admin, I want to upload an EPUB file and have it automatically split into sections so that my reading group can progress through the book together in manageable chunks.

Acceptance Criteria:

  • Given I am a group admin, When I navigate to the group book section, Then I should see an option to upload an EPUB file.
  • Given I have selected an EPUB file to upload, When I confirm the upload, Then the system should parse the EPUB and identify chapter/section boundaries.
  • Given the EPUB has been parsed, When I view the section breakdown, Then I should see a list of detected sections with titles and estimated reading time for each.
  • Given I am viewing the section breakdown, When I choose to adjust section boundaries, Then I should be able to merge or split sections manually.
  • Given the EPUB has been split into sections, When I request section recommendations for meetings, Then the system should suggest which sections to assign to each weekly meeting based on length and chapter boundaries.
  • Given I have confirmed the section recommendations, When I finalize the group book schedule, Then all group members should be able to see the reading schedule with target sections per meeting.
  • Given I am a group admin, When I want to replace the current book, Then I should be able to upload a new EPUB and restart the section splitting process without losing group membership.

Subtasks (checklist):

  • Create GroupBook model to link EPUB to group
  • Implement EPUB parsing service (extract chapters/sections)
  • Create Section model with order, title, start/end positions
  • Implement automatic section detection algorithm
  • Create section recommendation engine (4 meetings, 1 month)
  • Implement manual section adjustment UI
  • Add file validation (EPUB format check)
  • Create group book management endpoints
  • Add progress tracking per member linked to sections
User Story: As a group admin, I want to upload an EPUB file and have it automatically split into sections so that my reading group can progress through the book together in manageable chunks. Acceptance Criteria: * **Given** I am a group admin, **When** I navigate to the group book section, **Then** I should see an option to upload an EPUB file. * **Given** I have selected an EPUB file to upload, **When** I confirm the upload, **Then** the system should parse the EPUB and identify chapter/section boundaries. * **Given** the EPUB has been parsed, **When** I view the section breakdown, **Then** I should see a list of detected sections with titles and estimated reading time for each. * **Given** I am viewing the section breakdown, **When** I choose to adjust section boundaries, **Then** I should be able to merge or split sections manually. * **Given** the EPUB has been split into sections, **When** I request section recommendations for meetings, **Then** the system should suggest which sections to assign to each weekly meeting based on length and chapter boundaries. * **Given** I have confirmed the section recommendations, **When** I finalize the group book schedule, **Then** all group members should be able to see the reading schedule with target sections per meeting. * **Given** I am a group admin, **When** I want to replace the current book, **Then** I should be able to upload a new EPUB and restart the section splitting process without losing group membership. Subtasks (checklist): - [ ] Create GroupBook model to link EPUB to group - [ ] Implement EPUB parsing service (extract chapters/sections) - [ ] Create Section model with order, title, start/end positions - [ ] Implement automatic section detection algorithm - [ ] Create section recommendation engine (4 meetings, 1 month) - [ ] Implement manual section adjustment UI - [ ] Add file validation (EPUB format check) - [ ] Create group book management endpoints - [ ] Add progress tracking per member linked to sections
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#29