General: Display total LLM cost in course detail view

src/main/java/de/tum/cit/aet/artemis/core/dto/CourseManagementDetailViewDTO.java

@@ -8,5 +8,5 @@
 public record CourseManagementDetailViewDTO(Integer numberOfStudentsInCourse, Integer numberOfTeachingAssistantsInCourse, Integer numberOfEditorsInCourse,
         Integer numberOfInstructorsInCourse, Double currentPercentageAssessments, Long currentAbsoluteAssessments, Long currentMaxAssessments, Double currentPercentageComplaints,
         Long currentAbsoluteComplaints, Long currentMaxComplaints, Double currentPercentageMoreFeedbacks, Long currentAbsoluteMoreFeedbacks, Long currentMaxMoreFeedbacks,
-        Double currentPercentageAverageScore, Double currentAbsoluteAverageScore, Double currentMaxAverageScore, List<Integer> activeStudents) {
+        Double currentPercentageAverageScore, Double currentAbsoluteAverageScore, Double currentMaxAverageScore, List<Integer> activeStudents, Double currentTotalLlmCostInEur) {
 }

src/main/java/de/tum/cit/aet/artemis/core/repository/LLMTokenUsageTraceRepository.java

@@ -3,6 +3,8 @@
 import static de.tum.cit.aet.artemis.core.config.Constants.PROFILE_CORE;
 
 import org.springframework.context.annotation.Profile;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
 import org.springframework.stereotype.Repository;
 
 import de.tum.cit.aet.artemis.core.domain.LLMTokenUsageTrace;
@@ -11,4 +13,13 @@
 @Profile(PROFILE_CORE)
 @Repository
 public interface LLMTokenUsageTraceRepository extends ArtemisJpaRepository<LLMTokenUsageTrace, Long> {
+
+    @Query("""
+                SELECT COALESCE(ROUND(SUM((req.numInputTokens * req.costPerMillionInputTokens / 1000000) +
+                                (req.numOutputTokens * req.costPerMillionOutputTokens / 1000000)), 2), 0.0)
+                FROM LLMTokenUsageRequest req
+                JOIN req.trace trace
+                WHERE trace.courseId = :courseId
+            """)
+    Double calculateTotalLlmCostInEurForCourse(@Param("courseId") Long courseId);
 }

src/main/java/de/tum/cit/aet/artemis/core/service/CourseService.java

@@ -83,6 +83,7 @@
 import de.tum.cit.aet.artemis.core.dto.TutorLeaderboardDTO;
 import de.tum.cit.aet.artemis.core.dto.pageablesearch.SearchTermPageableSearchDTO;
 import de.tum.cit.aet.artemis.core.repository.CourseRepository;
+import de.tum.cit.aet.artemis.core.repository.LLMTokenUsageTraceRepository;
 import de.tum.cit.aet.artemis.core.repository.StatisticsRepository;
 import de.tum.cit.aet.artemis.core.repository.UserRepository;
 import de.tum.cit.aet.artemis.core.security.Role;
@@ -214,6 +215,8 @@ public class CourseService {
 
     private final BuildJobRepository buildJobRepository;
 
+    private final LLMTokenUsageTraceRepository llmTokenUsageTraceRepository;
+
     public CourseService(CourseRepository courseRepository, ExerciseService exerciseService, ExerciseDeletionService exerciseDeletionService,
             AuthorizationCheckService authCheckService, UserRepository userRepository, LectureService lectureService, GroupNotificationRepository groupNotificationRepository,
             ExerciseGroupRepository exerciseGroupRepository, AuditEventRepository auditEventRepository, UserService userService, ExamDeletionService examDeletionService,
@@ -227,7 +230,7 @@ public CourseService(CourseRepository courseRepository, ExerciseService exercise
             LearningPathApi learningPathApi, Optional<IrisSettingsService> irisSettingsService, LectureRepository lectureRepository,
             TutorialGroupNotificationRepository tutorialGroupNotificationRepository, TutorialGroupChannelManagementService tutorialGroupChannelManagementService,
             PrerequisitesApi prerequisitesApi, CompetencyRelationApi competencyRelationApi, PostRepository postRepository, AnswerPostRepository answerPostRepository,
-            BuildJobRepository buildJobRepository, FaqRepository faqRepository) {
+            BuildJobRepository buildJobRepository, FaqRepository faqRepository, LLMTokenUsageTraceRepository llmTokenUsageTraceRepository) {
         this.courseRepository = courseRepository;
         this.exerciseService = exerciseService;
         this.exerciseDeletionService = exerciseDeletionService;
@@ -271,6 +274,7 @@ public CourseService(CourseRepository courseRepository, ExerciseService exercise
         this.postRepository = postRepository;
         this.answerPostRepository = answerPostRepository;
         this.faqRepository = faqRepository;
+        this.llmTokenUsageTraceRepository = llmTokenUsageTraceRepository;
     }
 
     /**
@@ -805,7 +809,7 @@ public CourseManagementDetailViewDTO getStatsForDetailView(Course course, Gradin
         Set<Exercise> exercises = exerciseRepository.findAllExercisesByCourseId(course.getId());
         if (exercises == null || exercises.isEmpty()) {
             return new CourseManagementDetailViewDTO(numberOfStudentsInCourse, numberOfTeachingAssistantsInCourse, numberOfEditorsInCourse, numberOfInstructorsInCourse, 0.0, 0L,
-                    0L, 0.0, 0L, 0L, 0.0, 0L, 0L, 0.0, 0.0, 0.0, List.of());
+                    0L, 0.0, 0L, 0L, 0.0, 0L, 0L, 0.0, 0.0, 0.0, List.of(), 0.0);
         }
         // For the average score we need to only consider scores which are included completely or as bonus
         Set<Exercise> includedExercises = exercises.stream().filter(Exercise::isCourseExercise)
@@ -854,10 +858,12 @@ public CourseManagementDetailViewDTO getStatsForDetailView(Course course, Gradin
         var currentAbsoluteAverageScore = roundScoreSpecifiedByCourseSettings((averageScoreForCourse / 100.0) * currentMaxAverageScore, course);
         var currentPercentageAverageScore = currentMaxAverageScore > 0.0 ? roundScoreSpecifiedByCourseSettings(averageScoreForCourse, course) : 0.0;
 
+        double currentTotalLlmCostInEur = llmTokenUsageTraceRepository.calculateTotalLlmCostInEurForCourse(course.getId());
+
         return new CourseManagementDetailViewDTO(numberOfStudentsInCourse, numberOfTeachingAssistantsInCourse, numberOfEditorsInCourse, numberOfInstructorsInCourse,
                 currentPercentageAssessments, numberOfAssessments, numberOfSubmissions, currentPercentageComplaints, currentAbsoluteComplaints, currentMaxComplaints,
                 currentPercentageMoreFeedbacks, currentAbsoluteMoreFeedbacks, currentMaxMoreFeedbacks, currentPercentageAverageScore, currentAbsoluteAverageScore,
-                currentMaxAverageScore, activeStudents);
+                currentMaxAverageScore, activeStudents, currentTotalLlmCostInEur);
     }
 
     private double calculatePercentage(double positive, double total) {

src/main/resources/config/liquibase/changelog/20241217150008_changelog.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
+                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
+    <changeSet id="20241217150008" author="wasnertobias">
+        <createIndex indexName="idx_llm_token_usage_trace_course_id" tableName="llm_token_usage_trace">
+            <column name="course_id"/>
+        </createIndex>
+    </changeSet>
+</databaseChangeLog>

src/main/resources/config/liquibase/master.xml

@@ -41,6 +41,7 @@
     <include file="classpath:config/liquibase/changelog/20241114122713_changelog.xml" relativeToChangelogFile="false"/>
     <include file="classpath:config/liquibase/changelog/20241119191919_changelog.xml" relativeToChangelogFile="false"/>
     <include file="classpath:config/liquibase/changelog/20241125000900_changelog.xml" relativeToChangelogFile="false"/>
+    <include file="classpath:config/liquibase/changelog/20241217150008_changelog.xml" relativeToChangelogFile="false"/>
 
     <!-- NOTE: please use the format "YYYYMMDDhhmmss_changelog.xml", i.e. year month day hour minutes seconds and not something else! -->
     <!-- we should also stay in a chronological order! -->

src/main/webapp/app/course/manage/course-management-detail-view-dto.model.ts

@@ -26,5 +26,8 @@ export class CourseManagementDetailViewDto {
 
     activeStudents?: number[];
 
+    // LLM Stats
+    currentTotalLlmCostInEur: number;
+
     constructor() {}
 }

src/main/webapp/app/course/manage/detail/course-detail-doughnut-chart.component.html

@@ -9,11 +9,15 @@ <h5 class="text-center">{{ 'artemisApp.course.detail.' + doughnutChartTitle + 'T
     }
     <div class="doughnut-chart-container" [ngClass]="titleLink ? 'clickable' : ''" (click)="openCorrespondingPage()">
         <div class="doughnut-chart-text">
-            @if (receivedStats) {
+            @if (receivedStats && currentPercentage != undefined) {
                 <div class="h4">{{ currentPercentage }}%</div>
+            } @else if (receivedStats && showText) {
+                <div class="h4">{{ showText }}</div>
             }
-            @if (receivedStats) {
+            @if (receivedStats && !showText) {
                 <div class="h6">{{ currentAbsolute }} / {{ currentMax }}</div>
+            } @else if (receivedStats && currentPercentage != undefined) {
+                <div class="h6">{{ showText }}</div>
             }
             @if (!receivedStats) {
                 <div class="h3">

src/main/webapp/app/course/manage/detail/course-detail-doughnut-chart.component.ts

@@ -21,6 +21,7 @@ export class CourseDetailDoughnutChartComponent implements OnChanges, OnInit {
     @Input() currentAbsolute: number | undefined;
     @Input() currentMax: number | undefined;
     @Input() course: Course;
+    @Input() showText: string | undefined;
 
     receivedStats = false;
     doughnutChartTitle: string;
@@ -49,7 +50,7 @@ export class CourseDetailDoughnutChartComponent implements OnChanges, OnInit {
     ngOnChanges(): void {
         // [0, 0, 0] will lead to the chart not being displayed,
         // assigning [0, 0, 1] (PIE_CHART_NA_FALLBACK_VALUE) works around this issue and displays 0 %, 0 / 0 with a grey circle
-        if (this.currentAbsolute == undefined && !this.receivedStats) {
+        if (this.currentAbsolute == undefined && !this.receivedStats && !this.showText) {
             this.updatePieChartData(PIE_CHART_NA_FALLBACK_VALUE);
         } else {
             this.receivedStats = true;
@@ -84,6 +85,10 @@ export class CourseDetailDoughnutChartComponent implements OnChanges, OnInit {
                 }
                 this.ngxData[0].name = 'Average score';
                 break;
+            case DoughnutChartType.CURRENT_LLM_COST:
+                this.doughnutChartTitle = 'currentTotalLLMCost';
+                this.titleLink = undefined;
+                break;
             default:
                 this.doughnutChartTitle = '';
                 this.titleLink = undefined;

src/main/webapp/app/course/manage/detail/course-detail.component.html

@@ -40,6 +40,13 @@
                             [currentAbsolute]="courseDTO?.currentAbsoluteAverageScore"
                             [currentMax]="courseDTO?.currentMaxAverageScore"
                         />
+                        <jhi-course-detail-doughnut-chart
+                            class="doughnut-container col-sm-6 my-3"
+                            [course]="course"
+                            [contentType]="DoughnutChartType.CURRENT_LLM_COST"
+                            [showText]="courseDTO?.currentTotalLlmCostInEur + ' €'"
+                            [currentMax]="0"
+                        />
                     </div>
                 </div>
                 <jhi-course-detail-line-chart class="col-xxl-8" [course]="course" [numberOfStudentsInCourse]="course.numberOfStudents!" [initialStats]="activeStudents" />

src/main/webapp/app/course/manage/detail/course-detail.component.ts

@@ -28,6 +28,7 @@ export enum DoughnutChartType {
     AVERAGE_EXERCISE_SCORE = 'AVERAGE_EXERCISE_SCORE',
     PARTICIPATIONS = 'PARTICIPATIONS',
     QUESTIONS = 'QUESTIONS',
+    CURRENT_LLM_COST = 'LLM_COST',
 }
 
 @Component({

src/main/webapp/i18n/de/course.json

@@ -259,7 +259,8 @@
                 "assessmentsTitle": "Insgesamte Bewertungen",
                 "complaintsTitle": "Insgesamte Beschwerden",
                 "moreFeedbackTitle": "Insgesamte Feedbackanfragen",
-                "averageStudentScoreTitle": "Durchschnittliche Punktzahl der Studierenden"
+                "averageStudentScoreTitle": "Durchschnittliche Punktzahl der Studierenden",
+                "currentTotalLLMCostTitle": "Insgesamte LLM Kosten"
             },
             "activeStudents": "Aktive Studierende: {{ students }}",
             "notStartedYet": "Der Kurs hat noch nicht offiziell begonnen. Offizieller Kursstart:",

src/main/webapp/i18n/en/course.json

@@ -259,7 +259,8 @@
                 "assessmentsTitle": "Total Assessments",
                 "complaintsTitle": "Total Complaints",
                 "moreFeedbackTitle": "More Feedback Requests",
-                "averageStudentScoreTitle": "Average Student Score"
+                "averageStudentScoreTitle": "Average Student Score",
+                "currentTotalLLMCostTitle": "Total LLM Cost"
             },
             "activeStudents": "Active students: {{ students }}",
             "notStartedYet": "The course has not officially started yet. Official course start:",

src/test/javascript/spec/component/course/detail/course-detail-doughnut-chart.component.spec.ts

@@ -80,6 +80,13 @@ describe('CourseDetailDoughnutChartComponent', () => {
         expect(component.doughnutChartTitle).toBe('averageStudentScore');
         expect(component.titleLink).toBe('scores');
 
+        component.contentType = DoughnutChartType.CURRENT_LLM_COST;
+
+        component.ngOnInit();
+
+        expect(component.doughnutChartTitle).toBe('currentTotalLLMCost');
+        expect(component.titleLink).toBeUndefined();
+
         component.contentType = DoughnutChartType.AVERAGE_EXERCISE_SCORE;
 
         component.ngOnInit();

src/test/javascript/spec/component/course/detail/course-detail.component.spec.ts

@@ -57,6 +57,8 @@ describe('Course Management Detail Component', () => {
         currentAbsoluteAverageScore: 90,
         currentMaxAverageScore: 100,
         activeStudents: [4, 10, 14, 35],
+        // LLM
+        currentTotalLlmCostInEur: 82.3,
     };
 
     beforeEach(() => {