feat: Adjust server-side timers when resuming an execution

[hectoras]

Associated Jira issue: TR-5911

Changelog:

• Makes the ConcurringSessionService to store the timestamp when a test is suspended because another one has been launched.
• Introduces a method to adjust the timers for a test based on the current timestamp and the timestamp when the test was paused
  • This method is called by the LTI Delivery Provider when a paused test is resumed (here)
  • It tried to use the suspension timestamp if available; otherwise, it uses the highest timestamp associated with an item
  • The suspension timestamp is stored as part of the test session in the same way as the suspension reason was stored
• Fixes a bug when handling the item duration cache, as the old code assumed item durations would only be updated for the currently-running test.
  • If the test is not running, getCurrentRouteItem() may be null

[github-actions]

Front-end summary Node 18

💯 Total	✅ Passed	⏭️ Skipped	❌ Failed
708	708	0	0

[shpran]

[Optional]

Suggested change

	$timestamp = $timer->getLastTimestamp(
	$testSession->getItemTags($item)
	);
	$timestamp = $timer->getLastTimestamp($testSession->getItemTags($item));

[shpran]

Are we sure, that we can use $this (TestSession) instead of RoutItem ?

[hectoras]

This solves a bug: If this ends up being called on a test (lets call it test B) other than the one we are current running (lets call it test A), $routeItem is null. That is, getCurrentRouteItem() returns null when called from a request associated with the test runner session for test A to get the current item for test B.

    protected function getCurrentRouteItem()
    {
        if ($this->isRunning() === true) {
            return $this->getRoute()->current();
        }

        return false;
    }

The test we are pausing (B) is / was running, but not in the current request (which is "bound" to A), and we need this to work also in that case (so the elapsed time for the item of test B is stored when suspending the test).

Both $routeItem->getAssessmentItemRef() and $this->getAssessmentTest() return an instance of AssessmentTest that refers to the same test.

[jsconan]

I've tested the feature and it looks to work well. Additional checks would be needed at QA side to validate that all is working seamlessly without impacting the other places.

I only have one concern regarding the added logs, which are great but too verbose IMO. I'd rather advise reducing this by moving them to a lower level (trace or debug).

Review Checklist

• New code is covered by tests (if applicable)
• Tests are running successfully (old and new ones) on my local machine (if applicable)
• New code respects code style rules
• New code respects best practices
• New code is not subject to concurrency issues (if applicable)
• Feature is working correctly on my local machine (if applicable)
• Acceptance criteria are respected
• Pull request title and description are meaningful
• Pull request's target is not master
• Commits are following conventional commits
• Commits messages are meaningful
• Commits are atomic

[github-actions]

Version

Target Version	48.3.0
Last version	48.2.1

There are 0 BREAKING CHANGE, 1 feature, 5 fixes

[hectoras]

These changes passed QA, therefore I'm merging this PR.

[hectoras]

Released as v48.3.0.