Series list command should have an "unclaimed" filter #426

New issue

Open

opened 2025-03-29 14:38:51 +00:00 by Vylpes · 0 comments

Vylpes commented

2025-03-29 14:38:51 +00:00

Owner

Epic:
Story Points: 3

Add an "unclaimed" filter to the existing series list command so users can list only series that currently have unclaimed cards. Additionally, add an "Unclaimed" button to the existing series list pagination UI (alongside Previous / Next) that toggles the filter on and shows only unclaimed series; include a Back (or Clear) button to revert to the previous unfiltered list/pagination.

This will let users quickly find active drops or card series that still have cards available to claim and inspect what they're missing.

Background / context

The /series list (or prefix) command currently lists series with pagination (prev/next). Users want an easy way to filter to series with currently unclaimed card instances.
UX suggestion: a UI button (next to previous/next) labeled "Unclaimed" triggers the filter; when active, the UI shows only unclaimed series and provides a "Back" button to undo the filter and return to the prior page state.

Acceptance Criteria

The series list command accepts a new filter option "unclaimed" (CLI or slash command):
- Examples:
  - Slash: /series list filter:unclaimed
When the "unclaimed" filter is applied, results include only series that currently have at least one card instance matching "unclaimed" semantics (see Clarifying Questions).
The response format (embed fields, sorting, paging) is consistent with existing series list output.
The pagination UI gains a new interactive button labeled "Unclaimed" (or a toggle). When clicked:
- It filters the displayed results to unclaimed series.
- The UI shows a "Back" (or "Clear filter") button to return to the previous unfiltered paginated view and page index.
- If there are no matching series, a friendly message is shown (same pattern as no-results today).
Query and command must be performant on large datasets (use EXISTS or indexed columns; avoid loading all rows into memory).
Unit and integration tests added for query and command behavior, including UI button actions.
Documentation (command help / README) updated to mention the new filter and the UI button behavior.

Subtasks

Implement filter backend logic
Implement button to toggle on the filter
Implement button to toggle off the filter
Add unit tests
Add documentation

Notes

Also at the bottom with the previous and next buttons, maybe a button that says “unclaimed” and it generates all the unclaimed ones so you can see what you’re missing? Then adding a back button to undo that “search filter” if you like

Epic: \ Story Points: 3 --- Add an "unclaimed" filter to the existing series list command so users can list only series that currently have unclaimed cards. Additionally, add an "Unclaimed" button to the existing series list pagination UI (alongside Previous / Next) that toggles the filter on and shows only unclaimed series; include a Back (or Clear) button to revert to the previous unfiltered list/pagination. This will let users quickly find active drops or card series that still have cards available to claim and inspect what they're missing. Background / context - The /series list (or prefix) command currently lists series with pagination (prev/next). Users want an easy way to filter to series with currently unclaimed card instances. - UX suggestion: a UI button (next to previous/next) labeled "Unclaimed" triggers the filter; when active, the UI shows only unclaimed series and provides a "Back" button to undo the filter and return to the prior page state. ## Acceptance Criteria - The series list command accepts a new filter option "unclaimed" (CLI or slash command): - Examples: - Slash: /series list filter:unclaimed - When the "unclaimed" filter is applied, results include only series that currently have at least one card instance matching "unclaimed" semantics (see Clarifying Questions). - The response format (embed fields, sorting, paging) is consistent with existing series list output. - The pagination UI gains a new interactive button labeled "Unclaimed" (or a toggle). When clicked: - It filters the displayed results to unclaimed series. - The UI shows a "Back" (or "Clear filter") button to return to the previous unfiltered paginated view and page index. - If there are no matching series, a friendly message is shown (same pattern as no-results today). - Query and command must be performant on large datasets (use EXISTS or indexed columns; avoid loading all rows into memory). - Unit and integration tests added for query and command behavior, including UI button actions. - Documentation (command help / README) updated to mention the new filter and the UI button behavior. ## Subtasks - [ ] Implement filter backend logic - [ ] Implement button to toggle on the filter - [ ] Implement button to toggle off the filter - [ ] Add unit tests - [ ] Add documentation ## Notes - Also at the bottom with the previous and next buttons, maybe a button that says “unclaimed” and it generates all the unclaimed ones so you can see what you’re missing? Then adding a back button to undo that “search filter” if you like