Epic 2: Collections

[jmakowski1123]

• Discovery: Modelling Collections on the Backend modular-learning#221
• [Libraries] [Collections] [Backend] Collections model in Learning Core modular-learning#225
• [Libraries] [Collections] [Backend] REST CRUD API for Collections in v2 Libraries modular-learning#226
• [Libraries] [Collections] [Backend] API to associate library component(s) with collection(s) modular-learning#227
• [Libraries] [Collections] [Backend] Add tags to collections modular-learning#228
• [Libraries] [Collections] [Backend] store collections in Studio Library Index modular-learning#229
• [Libraries] [Collections] [Backend] store component-collection association in Studio Library Index modular-learning#230
• Library Home - Create new collection #1100
• Library Collections Tab #1102
• Collections Page - Bare bones #1101
• Collections Page: Collections Sidebar #1089
• Collections Page - Search within a collection #1103
• Sort Collection Components - Collections Page #1166
• Collections Page - Filter by Tags #1169

---

Added to original scope:

• Store Collection metadata + component count in meilisearch #1260
• [Libraries] [Collections] [Backend] Soft Delete collections modular-learning#231
• Open a collection page from 3-dot menu on a collection card #1310
• Open a Collection Page from the collection tile or collection sidebar #1322

Potential missed requirements (are these in scope for MVP?)

• Implement "Add to collection" on the component sidebar  #1287
• Edit a Collection #1296
• Soft Delete a Collection #1295

[pomegranited]

@jmakowski1123 @bradenmacdonald Do we have a story for deleting collections? I don't see it in any of the frontend tickets yet. Also asking because openedx/modular-learning#225 introduced an enabled flag which we assume could be used to "soft delete" a collection, and so we need to know how the the Delete part of the REST API should work. Thanks!

[bradenmacdonald]

I'm not sure. @jmakowski1123 or perhaps @lizc577 or @sdaitzman can answer.

[pomegranited]

@jmakowski1123 @lizc577 @sdaitzman I've created an issue for this question, please see openedx/modular-learning#231

@bradenmacdonald could you please add that issue to this ticket? I don't have access to edit this.

[pomegranited]

Hi @jmakowski1123 CC @bradenmacdonald -- is it possible for me to get edit access to issues for this epic? I've made a few notes in comments, but it would be helpful if I could edit them directly.

[pomegranited]

Searching/filtering/sorting a list of Collections

@jmakowski1123 @bradenmacdonald CC @lizc577 @sdaitzman @marcotuts I can't find any frontend tickets in this epic to handle searching/filtering/sorting the Collections lists shown on the Home page and the Collections tab.

Note that this is different from sorting/filtering the Collection's Components, which will be done when viewing a single Collection, and is handled by these tickets:

• [Libraries] [Collections] [Backend] store component-collection association in Studio Library Index modular-learning#230
• Collections Page - Search within a collection #1103
• Collections Page - Filter by Tags #1169
• Sort Collection Components - Collections Page #1166

If we need to be able to do this, we'll need some frontend tickets.
But it also raises a Product question, since there's two ways to think about maintaining Collections data in the search index.

Option 1: Index only the Collection metadata

This option is simpler, and ignores the Collection Components' metadata, i.e

• Keyword search applies only to Collection title + description
• Filtering by Collection Tags uses only Tags added by [Libraries] [Collections] [Backend] Add tags to collections modular-learning#228
• Filtering by (block) Type does not apply to Collections.
• Sorting has these caveats:
  • "Recently Modified" is only relevant to changes to the Collection title and description; the modified date is not updated when adding/removing Components.
  • "Recently Published" does not apply (Collections can't be published).
  • "Title", "Newest", "Oldest" are straightforward, using the Collection title and created dates.

The backend work to support this is already being handled by openedx/modular-learning#229, but we need to add some simple frontend tickets.

Option 2: Include the Collection Components metadata in the indexed Collection

Whenever a Component is added/removed from a Collection, the search metadata for the Collection is updated to reflect this change. Since there can be many Components in a Collection, this could result in very large indexes and performance issues. But we gain the following features:

• Keyword search applies to Collection title + description + the Component fields we decide to store with the Collection.
• Filtering by Tag means we can locate Collections by Tag and Collections that contain Components with the given Tags.
• Filtering by (block) Type means we can locate Collections that contain Components of the given block type.
• Sorting:
  • "Recently Modified" could reflect whether a Collection has had Components recently added/removed.
  • "Recently Published" could use the most recent published date of a Collection's Components.
  • "Title", "Newest", "Oldest" is unchanged, using the Collection title and created dates.

The frontend work is still straightforward with Option 2. But it's a more difficult lift for the backend, and requires planning for performance and search data usability, and to guard against race conditions.

[bradenmacdonald]

@pomegranited

I can't find any frontend tickets in this epic to handle searching/filtering/sorting the Collections lists shown on the Home page and the Collections tab.

I think that will be covered by #1102 . Maybe we can explicitly add it to the scope, but I think that since we've already implemented the keywords search and the sorting and filtering for "components" and "home", I think it should mostly be already implemented on the components tab.

Re your other questions, I feel pretty clearly that we should go for Option 1 for the MVP at least; I think it's not only simpler, but it also makes more sense to me.

However, there is a simple and clear product question that affects either option: when we modify a component that's part of one or more collection(s), do we consider that collection(s) to have been modified too? Should both the component and the collection(s) then show up as "Recently Modified"?

[bradenmacdonald]

OK: answer to the above from Slack seems to be that modifying a component should modify the collection(s) too.

[pomegranited]

Noted, will do ^ as part of openedx/modular-learning#227

[pomegranited]

@jmakowski1123 @bradenmacdonald Some additional tasks to consider adding to the scope here:

• Soft Delete a Collection #1295 -- frontend ticket for [Libraries] [Collections] [Backend] Soft Delete collections modular-learning#231
• Edit a Collection #1296 -- frontend ticket; backend already done.

[bradenmacdonald]

Thanks @pomegranited - I put those into the description now. But I'll let @jmakowski1123 decide what's in scope.