General: Add cleanup service for admins

src/main/java/de/tum/cit/aet/artemis/assessment/repository/FeedbackRepository.java

@@ -2,15 +2,18 @@
 
 import static de.tum.cit.aet.artemis.core.config.Constants.PROFILE_CORE;
 
+import java.time.ZonedDateTime;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.Set;
 
 import org.springframework.context.annotation.Profile;
+import org.springframework.data.jpa.repository.Modifying;
 import org.springframework.data.jpa.repository.Query;
 import org.springframework.data.repository.query.Param;
 import org.springframework.stereotype.Repository;
+import org.springframework.transaction.annotation.Transactional;
 
 import de.tum.cit.aet.artemis.assessment.domain.Feedback;
 import de.tum.cit.aet.artemis.assessment.domain.GradingCriterion;
@@ -95,4 +98,83 @@ default boolean hasFeedbackByExerciseGradingCriteria(Set<GradingCriterion> gradi
                 .map(GradingInstruction::getId).toList();
         return hasFeedbackFromGradingInstructionIds(gradingInstructionsIds);
     }
+
+    /**
+     * Deletes {@link Feedback} entries where the associated {@link Result} has no submission and no participation.
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM Feedback f
+            WHERE f.result IN (SELECT r
+                               FROM Result r
+                               WHERE r.submission IS NULL
+                                   AND r.participation IS NULL)
+            """)
+    void deleteFeedbackForOrphanResults();
+
+    /**
+     * Deletes {@link Feedback} entries with a {@code null} result.
+     * Returns {@code void}
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM Feedback f WHERE f.result IS NULL
+            """)
+    void deleteOrphanFeedback();
+
+    /**
+     * Deletes {@link Feedback} entries associated with rated {@link Result} that are not the latest rated result
+     * for a {@link Participation}, within courses conducted between the specified date range.
+     * This query removes old feedback entries that are not part of the latest rated results, for courses whose
+     * end date is before {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM Feedback f
+            WHERE f.result IN (SELECT r
+                               FROM Result r
+                               JOIN r.participation p
+                               LEFT JOIN p.exercise e
+                               LEFT JOIN e.course c
+                               WHERE r.id NOT IN (SELECT MAX(r2.id)
+                                                  FROM Result r2
+                                                  WHERE r2.participation.id = p.id
+                                                      AND r2.rated=true
+                                                  )
+                                   AND c.endDate < :deleteTo
+                                   AND c.startDate > :deleteFrom
+                               )
+            """)
+    void deleteOldFeedbackThatAreNotLatestRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
+
+    /**
+     * Deletes non-rated {@link Feedback} entries where the associated course's start and end dates
+     * are between the specified date range.
+     * This query deletes feedback for non-rated results within courses whose end date is before
+     * {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM Feedback f
+            WHERE f.result IN (SELECT r
+                               FROM Result r
+                               JOIN r.participation p
+                               JOIN p.exercise e
+                               JOIN e.course c
+                               WHERE r.rated=false
+                                   AND c.endDate < :deleteTo
+                                   AND c.startDate > :deleteFrom
+                               )
+            """)
+    void deleteOldNonRatedFeedbackWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
 }

src/main/java/de/tum/cit/aet/artemis/assessment/repository/LongFeedbackTextRepository.java

@@ -1,14 +1,23 @@
 package de.tum.cit.aet.artemis.assessment.repository;
 
+import static de.tum.cit.aet.artemis.core.config.Constants.PROFILE_CORE;
+
+import java.time.ZonedDateTime;
 import java.util.List;
 import java.util.Optional;
 
+import org.springframework.context.annotation.Profile;
+import org.springframework.data.jpa.repository.Modifying;
 import org.springframework.data.jpa.repository.Query;
 import org.springframework.data.repository.query.Param;
+import org.springframework.stereotype.Repository;
+import org.springframework.transaction.annotation.Transactional;
 
 import de.tum.cit.aet.artemis.assessment.domain.LongFeedbackText;
 import de.tum.cit.aet.artemis.core.repository.base.ArtemisJpaRepository;
 
+@Profile(PROFILE_CORE)
+@Repository
 public interface LongFeedbackTextRepository extends ArtemisJpaRepository<LongFeedbackText, Long> {
 
     @Query("""
@@ -39,4 +48,89 @@ public interface LongFeedbackTextRepository extends ArtemisJpaRepository<LongFee
     default LongFeedbackText findByFeedbackIdWithFeedbackAndResultAndParticipationElseThrow(final Long feedbackId) {
         return getValueElseThrow(findWithFeedbackAndResultAndParticipationByFeedbackId(feedbackId), feedbackId);
     }
+
+    /**
+     * Deletes {@link LongFeedbackText} entries linked to {@link Feedback} where the associated
+     * {@link Result} has no participation and no submission.
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM LongFeedbackText lft
+            WHERE lft.feedback.id IN (SELECT f.id
+                                      FROM Feedback f
+                                      WHERE f.result.participation IS NULL AND f.result.submission IS NULL
+                                      )
+            """)
+    void deleteLongFeedbackTextForOrphanResult();
+
+    /**
+     * Deletes {@link LongFeedbackText} linked to {@link Feedback} with a {@code null} result.
+     * Returns {@code void}
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM LongFeedbackText lft
+            WHERE lft.feedback IN (SELECT f
+                                   FROM Feedback f
+                                   WHERE f.result IS NULL
+                                  )
+            """)
+    void deleteLongFeedbackTextForEmptyFeedback();
+
+    /**
+     * Deletes {@link LongFeedbackText} entries associated with rated {@link Result} that are not the latest rated result
+     * for a {@link Participation}, within courses conducted between the specified date range.
+     * This query removes old long feedback text that is not part of the latest rated results, for courses whose
+     * end date is before {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM LongFeedbackText lft
+            WHERE lft.feedback IN (SELECT f
+                                   FROM Feedback f
+                                   JOIN f.result r
+                                   JOIN r.participation p
+                                   LEFT JOIN p.exercise e
+                                   LEFT JOIN e.course c
+                                   WHERE f.result.id NOT IN (SELECT MAX(r2.id)
+                                                             FROM Result r2
+                                                             WHERE r2.participation.id = p.id
+                                                                 AND r2.rated=true)
+                                       AND c.endDate < :deleteTo
+                                       AND c.startDate > :deleteFrom
+                                   )
+            """)
+    void deleteLongFeedbackTextForRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
+
+    /**
+     * Deletes {@link LongFeedbackText} entries linked to non-rated {@link Feedback} where the associated course's start
+     * and end dates are between the specified date range.
+     * This query deletes long feedback text for feedback associated with non-rated results, within courses whose
+     * end date is before {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM LongFeedbackText lft
+            WHERE lft.feedback IN (SELECT f
+                                   FROM Feedback f
+                                   JOIN f.result r
+                                   JOIN r.participation p
+                                   LEFT JOIN p.exercise e
+                                   LEFT JOIN e.course c
+                                   WHERE r.rated=false
+                                       AND c.endDate < :deleteTo
+                                       AND c.startDate > :deleteFrom
+                                   )
+            """)
+    void deleteLongFeedbackTextForNonRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
 }

src/main/java/de/tum/cit/aet/artemis/assessment/repository/ParticipantScoreRepository.java

@@ -4,6 +4,7 @@
 import static org.springframework.data.jpa.repository.EntityGraph.EntityGraphType.LOAD;
 
 import java.time.Instant;
+import java.time.ZonedDateTime;
 import java.util.Collection;
 import java.util.List;
 import java.util.Map;
@@ -176,4 +177,110 @@ default void setAverageScoreForStatisticsDTO(CourseManagementOverviewExerciseSta
         }
         exerciseStatisticsDTO.setAverageScoreInPercent(averageScore != null ? averageScore : 0.0);
     }
+
+    /**
+     * Deletes {@link ParticipantScore} entries where the associated {@link Result} is not the latest rated result
+     * for a {@link Participation}, within courses conducted between the specified date range.
+     * This query removes participant scores linked to results that are not the most recent rated results, for courses
+     * whose end date is before {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM ParticipantScore ps
+            WHERE ps.lastResult IN (SELECT r
+                                    FROM Result r
+                                    JOIN r.participation p
+                                    LEFT JOIN p.exercise e
+                                    LEFT JOIN e.course c
+                                    WHERE r.id NOT IN (SELECT MAX(r2.id)
+                                                       FROM Result r2
+                                                       WHERE r2.participation.id = p.id AND r2.rated=true
+                                                       )
+                                        AND c.endDate < :deleteTo
+                                        AND c.startDate > :deleteFrom
+                                    )
+            """)
+    void deleteParticipantScoresForNonLatestLastResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
+
+    /**
+     * Deletes {@link ParticipantScore} entries where the associated last rated {@link Result} is not the latest rated result
+     * for a {@link Participation}, within courses conducted between the specified date range.
+     * This query removes participant scores linked to rated results that are not the most recent rated results, for courses
+     * whose end date is before {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM ParticipantScore ps
+            WHERE ps.lastRatedResult IN (SELECT r
+                                         FROM Result r
+                                         JOIN r.participation p
+                                         LEFT JOIN p.exercise e
+                                         LEFT JOIN e.course c
+                                         WHERE r.id NOT IN (SELECT MAX(r2.id)
+                                                            FROM Result r2
+                                                            WHERE r2.participation.id = p.id
+                                                                AND r2.rated=true
+                                                            )
+                                             AND c.endDate < :deleteTo
+                                             AND c.startDate > :deleteFrom
+                                         )
+            """)
+    void deleteParticipantScoresForNonLatestLastRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
+
+    /**
+     * Deletes {@link ParticipantScore} entries where the associated {@link Result} is the latest result and is non-rated,
+     * and the course's start and end dates are between the specified date range.
+     * This query deletes participant scores for non-rated results within courses whose end date is before
+     * {@code deleteTo} and start date is after {@code deleteFrom}.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM ParticipantScore ps
+            WHERE ps.lastResult IN (SELECT r
+                                    FROM Result r
+                                    JOIN r.participation p
+                                    LEFT JOIN p.exercise e
+                                    LEFT JOIN e.course c
+                                    WHERE r.rated=false AND c.endDate < :deleteTo
+                                        AND c.startDate > :deleteFrom                                                                       )
+            """)
+    void deleteParticipantScoresForLatestNonRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
+
+    /**
+     * Deletes {@link ParticipantScore} entries where the associated {@link Result} is non-rated, even though
+     * it is marked as the last rated result, to prevent potential integrity violations.
+     * The deletion is based on courses whose start and end dates fall within the specified range.
+     * This scenario should not normally occur, as non-rated results cannot be marked as rated, but the
+     * method ensures cleanup in case of any potential integrity issues.
+     *
+     * @param deleteFrom the start date for selecting courses
+     * @param deleteTo   the end date for selecting courses
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE FROM ParticipantScore ps
+            WHERE ps.lastRatedResult IN (SELECT r
+                                         FROM Result r
+                                         JOIN r.participation p
+                                         LEFT JOIN p.exercise e
+                                         LEFT JOIN e.course c
+                                         WHERE r.rated=false
+                                             AND c.endDate < :deleteTo
+                                             AND c.startDate > :deleteFrom
+                                        )
+            """)
+    void deleteParticipantScoresForNonRatedResultsWhereCourseDateBetween(@Param("deleteFrom") ZonedDateTime deleteFrom, @Param("deleteTo") ZonedDateTime deleteTo);
 }

src/main/java/de/tum/cit/aet/artemis/assessment/repository/RatingRepository.java

@@ -65,4 +65,20 @@ public interface RatingRepository extends ArtemisJpaRepository<Rating, Long> {
      * @return number of total ratings given for the exercise
      */
     long countByResult_Participation_Exercise_Id(long exerciseId);
+
+    /**
+     * Deletes {@link Rating} entries where the associated {@link Result} has no submission and no participation.
+     */
+    @Modifying
+    @Transactional
+    @Query("""
+            DELETE
+            FROM Rating rt
+            WHERE rt.result IN
+                (SELECT r
+                FROM Result r WHERE
+                r.submission IS NULL
+                    AND r.participation IS NULL)
+            """)
+    void deleteOrphanRating();
 }