[Feature Request]: Introduce support for multiple classrooms (GSoC'24 4.2)

[BenHenning]

[Feature Request]: Introduce support for multiple classrooms (GSoC'24 4.2)

[BenHenning]

NB: This issue is locked to ensure that it only contains updates for requirements. If you have questions regarding this project, please use its corresponding discussion category: https://github.com/oppia/oppia-android/discussions/categories/gsoc-q-a-4-2-multiple-classrooms-support.

[BenHenning]

NB: The main issue comment has been updated to include the technical details directly rather than a link to a Gist (so that we can easily change this if needed). Please note that there are some small changes to the requirements to better align with the PRD for the feature (as some key UX confusions were cleared up that influenced the original technical design).

[theMr17]

Milestone 1

✅ PR 1.1 - #5410

Introduce a new feature flag for the multiple classrooms feature.

Starting Date	Creation Date	Merge Date
27-05-2024	27-05-2024	28-05-2024

	Tasks	Due Dates
✅	Introduce feature flag in FeatureFlagConstants.kt file.	27-05-2024
✅	Add dagger providers for the new feature flag.	27-05-2024

⬜ PR 1.2 - #5418

Update the model & domain layer to support the definition of classrooms, and specify a classroom per-topic.

Starting Date	Creation Date	Merge Date
28-05-2024	31-05-2024	03-06-2024

	Tasks	Due Dates
✅	Add ClassroomSummary & ClassroomIdList objects to topic.proto file.	29-05-2024
✅	Update topic related objects to include classroomId & classroomTitle fields.	30-05-2024
✅	Create test data json & textproto files for classrooms.	31-05-2024

⬜ PR 1.3 - #5419

Introduce ClassroomController and modify TopicListController & ProfileManagmentController.

Starting Date	Creation Date	Merge Date
04-06-2024	10-06-2024	14-06-2024

	Tasks	Due Dates
✅	Introduce ClassroomController to surface getClassroomList function.	04-06-2024
✅	Add tests for getClassroomList function.	05-06-2024
✅	Migrate getTopicList from TopicListController to ClassroomController.	07-06-2024
✅	Migrate tests for getTopicList function.	08-06-2024
✅	Modify ProfileManagementController to track last selected classroom.	09-06-2024
✅	Add tests for new functions in ProfileManagementController.	10-06-2024

⬜ PR 1.4

Introduce a new activity & related fragments/views/tests for a new classroom list page.

Starting Date	Creation Date	Merge Date
11-06-2024	21-06-2024	25-06-2024

	Tasks	Due Dates
⬜	Create ClassroomListActivity, ClassroomListFragment & ClassroomListViewModel.	12-06-2024
⬜	Gate the new ClassroomListActivity.	13-06-2024
⬜	Add tests to verify the gating.	14-06-2024
⬜	Introduce Jetpack Compose Dependencies.	16-06-2024
⬜	Implement the Sticky Header and other elements of the ComposeView.	17-06-2024
⬜	Implement the Topic List UI.	19-06-2024
⬜	Add tests for the Sticky Header and other elements of the ComposeView.	20-06-2024
⬜	Add tests for the Topic List UI.	21-06-2024

Milestone 2

⬜ PR 2.1

Update 'recently played' topic cards to include classroom information and update tests.

Starting Date	Creation Date	Merge Date
08-07-2024	11-07-2024	15-07-2024

	Tasks	Due Dates
⬜	Update topic cards UI.	09-07-2024
⬜	Update tests for the UI changes.	11-07-2024

⬜ PR 2.2

Implement new recommendations logic & UI support for the classroom selection and add tests.

Starting Date	Creation Date	Merge Date
13-07-2024	18-07-2024	20-07-2024

	Tasks	Due Dates
⬜	Update the recommendation logic to include classroom information.	16-07-2024
⬜	Update tests for the logic changes.	18-07-2024

⬜ PR 2.3

Ensure the existing event logs are captured in the new screen and related tests in preparation for removal & implement new event log.

Starting Date	Creation Date	Merge Date
21-07-2024	25-07-2024	28-07-2024

	Tasks	Due Dates
⬜	Ensure that the existing event logs are captured in the new screen.	21-07-2024
⬜	Add classroomId field in ExplorationContext object and update related tests.	22-07-2024
⬜	Implement logging of start_exploration event.	23-07-2024
⬜	Add tests to verify the behaviour of the new event.	25-07-2024

⬜ Task 2.4

Test, iterate, and work with the tech lead to finalize and launch the feature.

Starting Date	Completion Date
29-07-2024	04-08-2024

⬜ PR 2.5

Audit home activity/fragment & recommendation tests to ensure the new utilities cover the same behaviors. Remove the old home activity/fragment.

Starting Date	Creation Date	Merge Date
02-08-2024	06-08-2024	09-08-2024

	Tasks	Due Dates
⬜	Verify that the new utilities cover the same behaviour.	04-08-2024
⬜	Enable the ENABLE_MULTIPLE_CLASSROOMS feature flag.	06-07-2024

[DubeySandeep]

@theMr17 It looks like the PR 1.2 was expected to be merged by 03-06-2024, can you please raise a schedule slip and explain what's going on so that we can help you fix it?

[theMr17]

Yes, @DubeySandeep, PR 1.2 (#5418) was supposed to be merged on the mentioned date. The PR is currently under review by @adhiamboperes. We are likely pending a decision regarding the structure of the classroom model, specifically the approach for storing the topic ID list of the classroom, which is being discussed in the CLaM team chat.

Additionally, please note that the work related to PR 1.3 (#5419) is completed as well and is ready for review. I am currently working on PR 1.4. Except for the schedule slip in merging PR 1.2, everything seems to be on track and ahead of schedule.

PR 1.4 is partly blocked by #4937 (PR 1.4 requires Kotlin v1.6.10 for Compose dependencies on Gradle) and #4886 (PR 1.4 requires Bazel 6.5.0 for Compose dependencies on Bazel).