Adaptive learning: Improve mastery calculation

[JohannesStoehr]

🚨 🚨 This PR contains a database migration 🚨 🚨

Checklist

General

• I tested all changes and their related features with all corresponding user types on a test server.
• Language: I followed the guidelines for inclusive, diversity-sensitive, and appreciative language.
• I chose a title conforming to the naming conventions for pull requests.

Server

• Important: I implemented the changes with a very good performance and prevented too many (unnecessary) database calls.
• I strictly followed the server coding and design guidelines.
• I added multiple integration tests (Spring) related to the features (with a high test coverage).
• I added pre-authorization annotations according to the guidelines and checked the course groups for all new REST Calls (security).
• I documented the Java code using JavaDoc style.

Client

• Important: I implemented the changes with a very good performance, prevented too many (unnecessary) REST calls and made sure the UI is responsive, even with large data.
• I strictly followed the client coding and design guidelines.
• I added multiple integration tests (Jest) related to the features (with a high test coverage), while following the test guidelines.
• I documented the TypeScript code using JSDoc style.
• I translated all newly inserted strings into English and German.

Motivation and Context

#8756
Tl;dr: Improve the calculation of the mastery for competencies.

Description

The progress now depends on the actual score of the exercises linked to that competency.
The confidence is no longer shown to students but is still use to calculate the mastery. It is now a factor that multiplied with the progress gives the mastery.

Steps for Testing

Prerequisites:

• 1 Instructor
• 1 Student

1. Log in to Artemis
2. Navigate to Course Administration
3. Create a competency
4. Create a lecture with lecture units. Link the lecture units to the competency during their creation
5. Create exercises. Link them to the competency during their creation
6. Participate as a student and check the following things:
   • The progress increases whenever you complete a lecture unit or increase your score in an exercise
   • The mastery is roughly the same as the progress unless:
     • There are multiple exercises and your latest scores are higher/lower than the average score
     • You mainly gained points in easy/hard exercises while there are also exercises with other difficulties linked to the competency
     • You quickly solved programming exercises (achieved >=80% in <= 3 submissions)
   • If the mastery is different, there is a help icon next to the mastery value in the details page and the student gets an explanation by hovering over it

Testserver States

Note

These badges show the state of the test servers.
Green = Currently available, Red = Currently locked

Review Progress

Performance Review

• I (as a reviewer) confirm that the client changes (in particular related to REST calls and UI responsiveness) are implemented with a very good performance
• I (as a reviewer) confirm that the server changes (in particular related to database calls) are implemented with a very good performance

Code Review

• Code Review 1
• Code Review 2

Manual Tests

• Test 1
• Test 2

Test Coverage

Client

Class/File	Line Coverage	Confirmation (assert/expect)
competency-card.component.ts	100%	✅
competency-rings.component.ts	84.21%	✅
learning-path-node.component.ts	100%	✅
competency-node-details.component.ts	95.23%	✅
course-competencies-details.component.ts	77.01%	✅
course-competencies.component.ts	96.61%	✅

Server

Class/File	Line Coverage	Confirmation (assert/expect)
LearningObjectService.java	100%	✅
ParticipantScoreService.java	95%	✅
CompetencyProgressService.java	94%	✅
LearningPathNgxService.java	97%	✅
LearningPathRecommendationService.java	96%	✅
LearningPathService.java	99%	✅
LearningMetricsService.java	99%	✅
ParticipantScoreScheduleService.java	89%	✅
CompetencyResource.java	95%	✅

Screenshots

New student course dashboard:

Overview over all competencies with explanation for progress and mastery:

Overview over one competency with explanation for diverging progress and confidence:

Summary by CodeRabbit

• New Features

  • Introduced constants for score thresholds for result evaluation.
  • Added confidence reason tracking in competency progress.
  • Enhanced competency progress calculations based on exercises and lecture units.
  • Refactored learning path and metrics services for improved performance and accuracy.

• Bug Fixes

  • Corrected logic for determining completion status in exercises.
  • Fixed duplication issues in competency lecture unit retrieval.

• Refactor

  • Improved readability and maintainability by using switch-case statements.
  • Consolidated confidence calculations and exercise mastery queries.

• Tests

  • Added comprehensive tests for LearningObjectService methods to validate user completion status.

[coderabbitai]

Actionable comments posted: 1