Improve polling on the home page to more accurately and quickly display information related to sync statuses

marcellamaki commented 9 months ago

Observed in connection with several different issues during the 0.16 sync session on Feb 14 2024

Observed behavior

"Resources are missing or not supported" banner sometimes displays for "too long", meaning that it does not disappear on its own without a manual refresh (or navigation away from the page and back), which can be confusing for users. It also means that banner that displays a waiting to sync or actively syncing status is not necessarily refreshing and displaying in the way it was originally intended to, which was to provide feedback for these intermediary stages
There is also no indication of which lessons or quizzes have missing resources - is it all? is it one?
There is no indication of whether or not the missing resources are waiting for another sync

Desired behavior/Acceptance Criteria

Fix polling on the home page (either this was lost entirely, inadvertently, or there is a bug somewhere, or, we need to adjust the frequency) - the goal is to ensure that the polling is frequent enough to provide meaningful updates to the user, without spamming the server unnecessarily. Once assigned, please suggest an approach in the issue comments for discussion before proceeding to implement.
Add the "warning" icon (a yellow triangle with an "!" centered) to the lesson or quiz card that can be used to indicate a missing the resource, and use the KCircularLoader to indicate that a sync is happening. So, we want to: 1) fix the banner display, and 2) have a consistent display, aligned to the banner state, on the specific card or cards that shows if resources are missing or waiting to sync
Learners should not be able to click into a lesson or quiz that has no available resources

Steps to reproduce
Set up two Kolibris - one as a Learn Only Device (LOD) and one as a full facility. The LOD should be set up to sync back the main facility
Assign some resources to the Learner
In order to cause a "failure" or missing resources, disconnecting the facility device and the LOD manually (stopping the facility server for instance) may be the best approach to reproduce
Observe the display of the missing resources
Restart and reconnect the devices to the shared LAN
Observe that the missing resource display does not disappear until page refresh

Context

0.16.x

Technmad commented 9 months ago

@marcellamaki Can i give it a shot

AlexVelezLl commented 9 months ago

Hi @Technmad! Sure, I'll assign this issue to you :). Thanks for your interest in contributing to Kolibri :open_hands:

Technmad commented 9 months ago

@AlexVelezLl Thanks for opportunity, I'll start right away

Janarthana2992 commented 8 months ago

can I work on this issue, as a GSOC 24' applicant? @AlexVelezLl

AlexVelezLl commented 8 months ago

Hi @Technmad! are you still working on this? If @Technmad is no longer working on this, we can assign it to you @Janarthana2992. :open_hands:

AlexVelezLl commented 8 months ago

Hello, since @Technmad did not respond, I will assign this issue to you, @Janarthana2992. Thank you very much for volunteering. Let us know if you have any questions.

rtibbles commented 2 weeks ago

Unassigning as no updates in over 6 months.

learningequality / kolibri