ls1intum
diff --git a/‎.github/workflows/auto-generate-openapi.yml‎
Lines changed: 0 additions & 7 deletions b/‎.github/workflows/auto-generate-openapi.yml‎
Lines changed: 0 additions & 7 deletions
diff --git a/‎.gitignore‎
Lines changed: 3 additions & 0 deletions b/‎.gitignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 89 additions & 21 deletions b/‎README.md‎
Lines changed: 89 additions & 21 deletions
diff --git a/‎build.gradle‎
Lines changed: 55 additions & 1 deletion b/‎build.gradle‎
Lines changed: 55 additions & 1 deletion
diff --git a/‎docker/local-setup/docker-compose.yml‎
Lines changed: 4 additions & 0 deletions b/‎docker/local-setup/docker-compose.yml‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎docker/nginx.conf‎
Lines changed: 2 additions & 2 deletions b/‎docker/nginx.conf‎
Lines changed: 2 additions & 2 deletions
@@ -56,13 +56,6 @@ jobs:
       - name: Generate OpenAPI Spec
         env:
           SPRING_PROFILES_ACTIVE: openapi
-          SPRING_DATASOURCE_URL: jdbc:postgresql://localhost:5432/harmonia
-          SPRING_DATASOURCE_USERNAME: postgres
-          SPRING_DATASOURCE_PASSWORD: harmonia
-          SPRING_DATASOURCE_DRIVER_CLASS_NAME: org.postgresql.Driver
-          SPRING_JPA_HIBERNATE_DDL_AUTO: none
-          SPRING_LIQUIBASE_ENABLED: false
-          SPRING_DOCKER_COMPOSE_ENABLED: false
         run: ./gradlew generateApiDocs -x webapp
 
       - name: Generate Client Code
 
@@ -37,5 +37,8 @@ out/
 .vscode/
 
 Projects/
+repos/
 test-credentials.properties
+.env.integration-test
 /.DS_Store
+local/
@@ -14,15 +14,15 @@ metrics into a single platform, enabling course staff to ensure fair and evidenc
 
 ### Key Features
 
-* **On-Demand Analysis:** Instructors can trigger a new analysis job course-wide or per-team, with a high-performance
+- **On-Demand Analysis:** Instructors can trigger a new analysis job course-wide or per-team, with a high-performance
   target completion time of $\sim 15$ minutes for typical course sizes ($\sim 200$ teams).
-* **Teams Overview Table:** A sortable and filterable dashboard of all teams, featuring key metrics:
-    * **Course Averages** are prominently displayed to provide context for team-specific scores.
-    * Quantitative data like **Total Commits**, **Lines Written**, and **Team Members**.
-    * **Collaboration Quality Index (CQI)** (0-100 score).
-* **Team Detail View:** An in-depth page providing comprehensive collaboration evidence, including:
-    * The final **CQI** and all contributing sub-scores.
-    * A concise, AI-generated **Short Narrative Report** summarizing activity and referencing key commits.
+- **Teams Overview Table:** A sortable and filterable dashboard of all teams, featuring key metrics:
+  - **Course Averages** are prominently displayed to provide context for team-specific scores.
+  - Quantitative data like **Total Commits**, **Lines Written**, and **Team Members**.
+  - **Collaboration Quality Index (CQI)** (0-100 score).
+- **Team Detail View:** An in-depth page providing comprehensive collaboration evidence, including:
+  - The final **CQI** and all contributing sub-scores.
+  - A concise, AI-generated **Short Narrative Report** summarizing activity and referencing key commits.
 
 ---
 
@@ -33,7 +33,7 @@ Harmonia is built as a Java/Spring-based monolith, prioritizing stability and jo
 ## 💻 Technology Stack
 
 | Component | Technology                   |
-|:----------|:-----------------------------|
+| :-------- | :--------------------------- |
 | Client    | React 19.2 + TypeScript      |
 | Server    | Spring Boot (Jave)           |
 | Database  | PostgreSQL 18 with Hibernate |
@@ -60,7 +60,7 @@ Use the provided startup scripts for an automated setup:
 **Windows (PowerShell):**
 
 ```powershell
-.\scripts\docker_start.ps1 
+.\scripts\docker_start.ps1
 ```
 
 The scripts will:
@@ -82,9 +82,9 @@ Alternatively, you can manually build and launch everything:
    ```
 
 2. Access the services:
-    * Client (served by nginx): http://localhost:5173
-    * Spring Boot server: http://localhost:8080
-    * PostgreSQL: localhost:5432 (user `postgres`, password `harmonia`)
+   - Client (served by nginx): http://localhost:5173
+   - Spring Boot server: http://localhost:8080
+   - PostgreSQL: localhost:5432 (user `postgres`, password `harmonia`)
 
 The Compose setup builds the Gradle boot jar inside `docker/server.Dockerfile`, bundles the React client with Vite via
 `docker/client.Dockerfile`, and proxies `/api` + `/actuator` calls from nginx to the server container. All images
@@ -106,17 +106,85 @@ following commands to build and run the server locally:
 1. Make sure to run the Docker container.
 
 2. **Build the Project:** Compile the server application.
-    ```bash
+
+   ```bash
    ./gradlew clean build -x test
    ```
 
 3. **Run the Server:** Start the Spring Boot application.
-    ```bash
+
+   ```bash
    ./gradlew bootRun
    ```
 
 ---
 
+## 🧪 Testing & Code Quality
+
+Harmonia enforces strict code quality standards for both the server (Java) and client (TypeScript).
+
+### Server (Java)
+
+1. **Run Unit Tests:**
+
+   ```bash
+   ./gradlew test
+   ```
+
+2. **Run Integration Tests (with Credentials):**
+   These tests require external services (e.g., Artemis, LLM) and credentials.
+
+   _Setup:_ Create `src/test/resources/test-credentials.properties` or set environment variables (`ARTEMIS_TEST_URL`, etc.).
+
+   ```bash
+   ./gradlew integrationTest
+   ```
+
+3. **Check Code Style (Spotless & Checkstyle):**
+
+   ```bash
+   ./gradlew spotlessCheck checkstyleMain
+   ```
+
+4. **Auto-fix Formatting Issues:**
+   ```bash
+   ./gradlew spotlessApply
+   ```
+
+### 🤖 Local AI Setup (LM Studio)
+
+For local development or running integration tests that require an LLM, we recommend using [LM Studio](https://lmstudio.ai/).
+
+1. **Download & Install:** Install LM Studio.
+2. **Download Model:** Search for and download `google/gemma-3-1b`.
+3. **Load Model:** In the AI Chat or Local Server tab, load the `google/gemma-3-1b` model.
+4. **Configure Context Length:** In the "Configuration" sidebar, set the **Context Length** to `16384` (16k).
+5. **Start Server:** Ensure the Local Server is running (usually on `http://localhost:1234`).
+
+### Client (TypeScript)
+
+Navigate to the webapp directory first: `cd src/main/webapp`
+
+1. **Run Type Checking:**
+
+   ```bash
+   npm run compile:ts
+   ```
+
+2. **Check Code Style (Prettier & ESLint):**
+
+   ```bash
+   npm run prettier:check
+   npm run lint
+   ```
+
+3. **Auto-fix Formatting Issues:**
+   ```bash
+   npm run prettier:fix
+   ```
+
+---
+
 ## 📘 OpenAPI Workflow (Server → React Client)
 
 Harmonia uses SpringDoc to automatically generate an OpenAPI 3.0 specification, which is then used to generate a fully
@@ -163,12 +231,12 @@ and server in sync.
 - Merges Tailwind classes and resolves conflicts (e.g., `px-2` vs. `px-4`)
 - Needed for shadcn/ui components that combine base & conditional styles
 - **Example:**
-    ```ts
-    const classes = twMerge(
-      "px-4 py-2 text-sm text-gray-500",  // base styles
-      isActive && "text-blue-600 font-bold" // conditional styles
-     );
-    ```
+  ```ts
+  const classes = twMerge(
+    "px-4 py-2 text-sm text-gray-500", // base styles
+    isActive && "text-blue-600 font-bold" // conditional styles
+  );
+  ```
 
 #### `clsx`
 
 
@@ -101,6 +101,8 @@ dependencies {
             // needed to reduce the number of vulnerabilities, also see https://mvnrepository.com/artifact/org.yaml/snakeyaml
         }
     }
+    // H2 in-memory database for OpenAPI generation and testing
+    runtimeOnly 'com.h2database:h2'
 
     annotationProcessor 'org.projectlombok:lombok'
     annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
@@ -116,7 +118,59 @@ dependencies {
 }
 
 tasks.named('test') {
-    useJUnitPlatform()
+    useJUnitPlatform {
+        // Exclude integration and e2e tests from regular test runs
+        // These require external services (LM Studio, Artemis, etc.)
+        excludeTags 'integration', 'e2e'
+    }
+}
+
+// Integration test task - requires external services
+// Run with: ./gradlew integrationTest
+// Automatically loads credentials from src/test/resources/test-credentials.properties
+tasks.register('integrationTest', Test) {
+    description = 'Runs integration tests that require external services (LM Studio, Artemis, DB)'
+    group = 'verification'
+    
+    useJUnitPlatform {
+        includeTags 'integration', 'e2e'
+    }
+    
+    // Explicitly set the test classes and classpath
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    
+    // Show standard output logs in the console
+    testLogging {
+        showStandardStreams = true
+        events "passed", "skipped", "failed"
+    }
+    
+    shouldRunAfter tasks.named('test')
+    
+    // Load credentials from properties file if it exists
+    def credentialsFile = file('src/test/resources/test-credentials.properties')
+    if (credentialsFile.exists()) {
+        def props = new Properties()
+        credentialsFile.withInputStream { stream ->
+            props.load(stream)
+        }
+        // Set all properties as environment variables
+        props.forEach { key, value ->
+            environment key.toString(), value.toString()
+        }
+    }
+    
+    // Pass through system environment variables (override file if set)
+    if (System.getenv('ARTEMIS_TEST_URL')) environment 'ARTEMIS_TEST_URL', System.getenv('ARTEMIS_TEST_URL')
+    if (System.getenv('ARTEMIS_TEST_USERNAME')) environment 'ARTEMIS_TEST_USERNAME', System.getenv('ARTEMIS_TEST_USERNAME')
+    if (System.getenv('ARTEMIS_TEST_PASSWORD')) environment 'ARTEMIS_TEST_PASSWORD', System.getenv('ARTEMIS_TEST_PASSWORD')
+    if (System.getenv('ARTEMIS_TEST_COURSE')) environment 'ARTEMIS_TEST_COURSE', System.getenv('ARTEMIS_TEST_COURSE')
+    if (System.getenv('ARTEMIS_TEST_EXERCISE_ID')) environment 'ARTEMIS_TEST_EXERCISE_ID', System.getenv('ARTEMIS_TEST_EXERCISE_ID')
+    if (System.getenv('ARTEMIS_TEST_MAX_TEAMS')) environment 'ARTEMIS_TEST_MAX_TEAMS', System.getenv('ARTEMIS_TEST_MAX_TEAMS')
+    
+    // Always enable LLM tests for this task
+    environment 'LLM_INTEGRATION_TESTS', 'true'
 }
 
 // Available commands:
 
@@ -32,6 +32,10 @@ services:
       SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/harmonia
       SPRING_DATASOURCE_USERNAME: postgres
       SPRING_DATASOURCE_PASSWORD: harmonia
+      # Override AI base URL to point to host machine
+      SPRING_AI_OPENAI_BASE_URL: http://host.docker.internal:1234
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     ports:
       - "8080:8080"
     healthcheck:
 
@@ -82,7 +82,7 @@ http {
         add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload' always;
         add_header X-Frame-Options "SAMEORIGIN" always;
 
-        # Proxy API requests to backend server
+        # Proxy API requests to server
         location /api/ {
             proxy_http_version 1.1;
             proxy_set_header Upgrade $http_upgrade;
@@ -96,7 +96,7 @@ http {
             proxy_pass http://harmonia_server/api/;
         }
 
-        # Proxy actuator requests to backend server
+        # Proxy actuator requests to server
         location /actuator/ {
             proxy_http_version 1.1;
             proxy_set_header Host $host;