fix: modernize test suite for Vitest 4.x and stabilize Docker integration

.github/workflows/ci.yml

@@ -2,20 +2,19 @@ name: CI (Quality Gate & Coverage)
 
 on:
   push:
-    branches:
-      - '**'        # Triggert bei JEDEM Push auf JEDEN Branch
+    branches: [ '**' ]
   pull_request:
-    branches:
-      - '**'        # Triggert bei JEDEM Pull Request
+    branches: [ '**' ]
 
 permissions:
   contents: write
   pages: write
   id-token: write
 
 jobs:
+  # JOB 1: Schnellläufer (Unit Tests, Linting, TypeCheck)
   build-and-test:
-    name: Lint, TypeCheck & Unit Tests
+    name: Lint & Unit Tests
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -29,58 +28,103 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      # Neu: Auch Unit-Tests brauchen die Toolchain zum Kompilieren
+      - name: Cache Arduino Toolchain (Unit)
+        uses: actions/cache@v4
+        with:
+          path: |
+            /usr/local/bin/arduino-cli
+            ~/.arduino15
+          key: ${{ runner.os }}-arduino-unit-${{ hashFiles('package-lock.json') }}
+
       - name: Install Arduino CLI & Core
         run: |
-          curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh
-          arduino-cli core update-index
-          arduino-cli core install arduino:avr
+          if ! command -v arduino-cli &> /dev/null; then
+            curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh
+          fi
+          arduino-cli core list | grep "arduino:avr" || (arduino-cli core update-index && arduino-cli core install arduino:avr)
 
-      - name: Static Analysis (Lint & TypeCheck)
+      - name: Static Analysis & Unit Tests
+        env:
+          # Separater Pfad für Unit-Tests, um Seiteneffekte zu vermeiden
+          ARDUINO_CACHE_DIR: /tmp/arduino-unit-cache
         run: |
           npm run check
           npm run lint
-
-      - name: Run Tests with Coverage
-        # Ersetzt den normalen Test-Lauf, da Coverage alles abdeckt
-        run: npm run test:coverage
+          npm run test:coverage
 
       - name: Deploy Coverage to GitHub Pages
-        # Nur bei Push auf Haupt-Branches ausführen
         if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master')
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./coverage/lcov-report
           publish_branch: gh-pages
 
+  # JOB 2: Schwergewicht (Docker & E2E)
   e2e-tests:
     name: Playwright E2E
-    needs: build-and-test # WICHTIG: Startet erst, wenn Unit-Tests grün sind
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: '20'
           cache: 'npm'
+
       - name: Install dependencies
         run: npm ci
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Cache E2E Assets (Arduino, Playwright, Sketches)
+        uses: actions/cache@v4
+        with:
+          path: |
+            /usr/local/bin/arduino-cli
+            ~/.arduino15
+            ~/.cache/ms-playwright
+            server/arduino-cache
+            storage/binaries
+          key: ${{ runner.os }}-e2e-turbo-${{ hashFiles('package-lock.json', 'server/services/arduino-compiler.ts') }}
+          restore-keys: |
+            ${{ runner.os }}-e2e-turbo-
+
       - name: Install Arduino CLI & Core
         run: |
-          curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh
-          arduino-cli core update-index
-          arduino-cli core install arduino:avr
+          if ! command -v arduino-cli &> /dev/null; then
+            curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh
+          fi
+          arduino-cli core list | grep "arduino:avr" || (arduino-cli core update-index && arduino-cli core install arduino:avr)
+
       - name: Install Playwright Browsers
         run: npx playwright install --with-deps chromium
+
+      - name: Build Sandbox Image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          load: true
+          tags: unowebsim-sandbox:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
       - name: Run E2E Tests
-        run: npx playwright test --update-snapshots=missing
+        env:
+          ARDUINO_CACHE_DIR: ${{ github.workspace }}/server/arduino-cache
+        run: npx playwright test --update-snapshots=missing --workers=2
+
       - name: Commit new Linux visual baselines
         if: always()
         run: |
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git config user.name "github-actions[bot]"
           git add 'e2e/visual-full-context.spec.ts-snapshots/*-linux.png'
           git diff --staged --quiet || (git commit -m "chore(e2e): update linux visual baselines [skip ci]" && git push)
+
       - name: Upload E2E Report & Artifacts
         if: always()
         uses: actions/upload-artifact@v4
@@ -89,4 +133,4 @@ jobs:
           path: |
             playwright-report/
             test-results/
-          retention-days: 7
+          retention-days: 7

.gitignore

@@ -34,6 +34,10 @@ yarn-error.log*
 /coverage/
 *.tsbuildinfo
 
+# Arduino Compiler Cache (Binaries & Build-Artifacts)
+server/arduino-cache/
+storage/binaries/
+
 # Project specific temp folders (runtime artifacts)
 /temp/*
 !/temp/.gitkeep

.husky/pre-push

@@ -1 +1,2 @@
-npm run test
+# Führt nur Tests aus, die Dateien betreffen, die sich seit dem letzten Push geändert haben
+npm run test:fast

.vscode/settings.json

@@ -1,28 +1,28 @@
 {
   "files.exclude": {
-    "vite.config.ts": true,
-    "vercel.json": true,
-    "test-vercel-build.sh": true,
-    "tsconfig.json": true,
-    "tailwind.config.ts": true,
-    "screenshot.png": true,
-    "README copy.md": true,
-    "postcss.config.js": true,
-    "package-lock.json": true,
-    "LICENSE": true,
-    "drizzle.config.ts": true,
-    "components.json": true,
-    "build.sh": true,
-    ".vercelignore": true,
-    ".gitlab-ci.yml": true,
-    "node_modules": true,
-    "temp": true,
-    "vitest.config.ts": true,
-    "playwright.config.ts": true,
-    "package.json": true,
-    "licenses.json": true,
-    "docker-compose.yml": true,
-    "commitlint.config.cjs": true
+    "vite.config.ts": false,
+    "vercel.json": false,
+    "test-vercel-build.sh": false,
+    "tsconfig.json": false,
+    "tailwind.config.ts": false,
+    "screenshot.png": false,
+    "README copy.md": false,
+    "postcss.config.js": false,
+    "package-lock.json": false,
+    "LICENSE": false,
+    "drizzle.config.ts": false,
+    "components.json": false,
+    "build.sh": false,
+    ".vercelignore": false,
+    ".gitlab-ci.yml": false,
+    "node_modules": false,
+    "temp": false,
+    "vitest.config.ts": false,
+    "playwright.config.ts": false,
+    "package.json": false,
+    "licenses.json": false,
+    "docker-compose.yml": false,
+    "commitlint.config.cjs": false
   },
   "chat.tools.terminal.autoApprove": {
     "npm ls": true,

Dockerfile

@@ -1,12 +1,8 @@
 # Multi-stage build using Node 25.2.1
 FROM node:25.2.1 AS builder
 WORKDIR /app
-
-# Install dependencies (including devDeps for build)
 COPY package.json package-lock.json* ./
 RUN npm install
-
-# Copy sources and build (client + server)
 COPY . .
 RUN npm run build
 
@@ -15,24 +11,30 @@ RUN npm run build
 FROM node:25.2.1-slim AS runner
 WORKDIR /app
 ENV NODE_ENV=production
+# WICHTIG: Setze die Variable auch im Container, damit der Pfad konsistent bleibt
+ENV ARDUINO_CACHE_DIR=/app/server/arduino-cache
 
 # Install Arduino CLI and required tools
 RUN apt-get update \
-	&& apt-get install -y --no-install-recommends curl ca-certificates tar xz-utils g++ \
-	&& curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh \
-	&& arduino-cli config init \
-	&& arduino-cli core update-index \
-	&& arduino-cli core install arduino:avr \
-	&& apt-get clean \
-	&& rm -rf /var/lib/apt/lists/*
+    && apt-get install -y --no-install-recommends curl ca-certificates tar xz-utils g++ \
+    && curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | BINDIR=/usr/local/bin sh \
+    && arduino-cli config init \
+    && arduino-cli core update-index \
+    && arduino-cli core install arduino:avr \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Erstelle die notwendigen Verzeichnisse für den Compiler-Cache und Storage
+# Damit der Node-User (falls du einen nutzt) Schreibrechte hat
+RUN mkdir -p /app/server/arduino-cache /app/storage/binaries /app/temp
 
 # Copy built artifacts
 COPY --from=builder /app/dist ./dist
 
-# Copy package metadata and install all dependencies
-# (vite is marked as external in esbuild but needed at runtime for middleware mode)
+# Copy package metadata and install dependencies
 COPY package.json package-lock.json* ./
+# Da Vite zur Laufzeit gebraucht wird, bleiben wir bei --production=false
 RUN npm install --legacy-peer-deps --production=false
 
 EXPOSE 3000
-CMD ["npm", "run", "start"]
+CMD ["npm", "run", "start"]