Merge branch 'main' into dev

Reviewed-on: #48

.gitea/workflows/deploy.yaml

@@ -125,6 +125,18 @@ jobs:
           docker build -t "$FRONTEND_IMAGE" ./frontend
           docker push "$FRONTEND_IMAGE"
 
+      - name: Cleanup Docker on runner (prevent vdisk growth)
+        if: always()
+        shell: bash
+        run: |
+          set +e
+
+          # Keep recent artifacts, drop old local residue from CI builds.
+          docker container prune -f --filter "until=168h" || true
+          docker image prune -a -f --filter "until=168h" || true
+          docker builder prune -a -f --filter "until=168h" || true
+          docker network prune -f --filter "until=168h" || true
+
   deploy:
     needs: build-and-push
     runs-on: ubuntu-latest
@@ -205,9 +217,12 @@ jobs:
           ADMIN_TTL="${ADMIN_TTL:-480}"
           printf 'ADMIN_PASSWORD="%s"\nADMIN_SESSION_SECRET="%s"\nADMIN_SESSION_TTL_MINUTES="%s"\n' \
             "${{ secrets.ADMIN_PASSWORD }}" "${{ secrets.ADMIN_SESSION_SECRET }}" "$ADMIN_TTL" >> /tmp/full_env.env
+          if [[ -n "${{ secrets.OPENAI_API_KEY }}" ]]; then
+            printf 'OPENAI_API_KEY="%s"\n' "${{ secrets.OPENAI_API_KEY }}" >> /tmp/full_env.env
+          fi
 
           echo "Preparing to send env file with variables:"
-          grep -Ev "PASSWORD|SECRET" /tmp/full_env.env || true
+          grep -Ev "PASSWORD|SECRET|KEY|TOKEN" /tmp/full_env.env || true
 
           ssh -i ~/.ssh/id_ed25519 -o BatchMode=yes "${{ secrets.SERVER_USER }}@${{ secrets.SERVER_HOST }}" \
             "setenv ${{ env.ENV }}" < /tmp/full_env.env

README.md

@@ -33,7 +33,7 @@ Configura il percorso di OrcaSlicer in `backend/src/main/resources/application.p
 
 - `MEDIA_STORAGE_ROOT` per la root `storage_media` usata dal backend (`original/`, `public/`, `private/`)
 - `SHOP_STORAGE_ROOT` per la root `storage_shop` usata dal backend per i modelli dei prodotti shop
-- `MEDIA_FFMPEG_PATH` per il binario `ffmpeg`
+- `MEDIA_FFMPEG_PATH` per il binario `ffmpeg` (nel deploy Docker default: `/usr/local/bin/ffmpeg-media`)
 - `MEDIA_UPLOAD_MAX_FILE_SIZE_BYTES` per il limite per asset immagine
 
 ```bash
@@ -107,7 +107,10 @@ Operativamente:
 Assicurati che `slicer.path` punti al binario corretto. Su macOS è solitamente `/Applications/OrcaSlicer.app/Contents/MacOS/OrcaSlicer`. Su Linux è il percorso all'AppImage (estratta o meno).
 
 ### FFmpeg e media pubblici
-Verifica che `MEDIA_FFMPEG_PATH` punti a un `ffmpeg` con supporto JPEG, WebP e AVIF. Se gli URL media restituiti dalle API admin non sono raggiungibili, controlla che `APP_FRONTEND_BASE_URL` punti al dominio corretto, che `location /media/` sia esposto da Nginx e che il volume `storage_media` sia montato correttamente.
+Verifica che `MEDIA_FFMPEG_PATH` punti a un `ffmpeg` con supporto JPEG, WebP e AVIF (encoder + muxer AVIF). Nel container backend il default è `/usr/local/bin/ffmpeg-media`: usa `/usr/bin/ffmpeg` se già compatibile, altrimenti installa un fallback statico con supporto AVIF. Se gli URL media restituiti dalle API admin non sono raggiungibili, controlla che `APP_FRONTEND_BASE_URL` punti al dominio corretto, che `location /media/` sia esposto da Nginx e che il volume `storage_media` sia montato correttamente.
 
 ### Database connection
 Verifica le credenziali in `application.properties`. Se usi Docker, puoi passare `DB_URL`, `DB_USERNAME` e `DB_PASSWORD` come variabili d'ambiente.
+
+### Deploy e traduzioni OpenAI
+Nel deploy Gitea la chiave OpenAI deve stare nel secret `OPENAI_API_KEY`. La pipeline la aggiunge al file `.env` dell'ambiente durante il deploy e il container backend la riceve come variabile runtime. I file `deploy/envs/*.env` restano per i valori specifici di `dev/int/prod`.

backend/Dockerfile

@@ -12,25 +12,48 @@ RUN ./gradlew bootJar -x test --no-daemon
 FROM eclipse-temurin:21-jre-jammy
 ARG ORCA_VERSION=2.3.1
 ARG ORCA_DOWNLOAD_URL
+ARG FFMPEG_STATIC_URL=https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz
 
 # Install system dependencies for OrcaSlicer and media processing.
-# The build fails fast if the packaged ffmpeg lacks JPEG/WebP/AVIF encoders.
+# Prefer system ffmpeg; if AVIF support is incomplete, install a static ffmpeg fallback.
 RUN set -eux; \
     apt-get update; \
     DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
     ffmpeg \
     wget \
+    xz-utils \
+    ca-certificates \
     assimp-utils \
     libgl1 \
     libglib2.0-0 \
     libgtk-3-0 \
     libdbus-1-3 \
     libwebkit2gtk-4.0-37; \
-    ffmpeg -hide_banner -encoders > /tmp/ffmpeg-encoders.txt; \
+    check_ffmpeg_support() { \
-    grep -Eq '[[:space:]]mjpeg[[:space:]]' /tmp/ffmpeg-encoders.txt; \
+      ffmpeg_bin="$1"; \
-    grep -Eq '[[:space:]](libwebp|webp)[[:space:]]' /tmp/ffmpeg-encoders.txt; \
+      "$ffmpeg_bin" -hide_banner -encoders > /tmp/ffmpeg-encoders.txt 2>&1 || return 1; \
-    grep -Eq '[[:space:]](libaom-av1|librav1e|libsvtav1)[[:space:]]' /tmp/ffmpeg-encoders.txt; \
+      "$ffmpeg_bin" -hide_banner -muxers > /tmp/ffmpeg-muxers.txt 2>&1 || return 1; \
+      grep -Eq '[[:space:]]mjpeg[[:space:]]' /tmp/ffmpeg-encoders.txt || return 1; \
+      grep -Eq '[[:space:]](libwebp|webp)[[:space:]]' /tmp/ffmpeg-encoders.txt || return 1; \
+      grep -Eq '[[:space:]](libaom-av1|librav1e|libsvtav1)[[:space:]]' /tmp/ffmpeg-encoders.txt || return 1; \
+      grep -Eq '[[:space:]]avif([[:space:]]|,|$)' /tmp/ffmpeg-muxers.txt || return 1; \
+      return 0; \
+    }; \
+    if check_ffmpeg_support /usr/bin/ffmpeg; then \
+      ln -sf /usr/bin/ffmpeg /usr/local/bin/ffmpeg-media; \
+    else \
+      echo "System ffmpeg lacks AVIF support, installing static fallback from ${FFMPEG_STATIC_URL}"; \
+      wget -q "${FFMPEG_STATIC_URL}" -O /tmp/ffmpeg-static.tar.xz; \
+      tar -xJf /tmp/ffmpeg-static.tar.xz -C /tmp; \
+      FFMPEG_STATIC_BIN="$(find /tmp -maxdepth 2 -type f -name ffmpeg | head -n 1)"; \
+      test -n "${FFMPEG_STATIC_BIN}"; \
+      install -m 0755 "${FFMPEG_STATIC_BIN}" /usr/local/bin/ffmpeg-media; \
+      check_ffmpeg_support /usr/local/bin/ffmpeg-media; \
+    fi; \
+    rm -f /tmp/ffmpeg-muxers.txt; \
     rm -f /tmp/ffmpeg-encoders.txt; \
+    rm -f /tmp/ffmpeg-static.tar.xz; \
+    rm -rf /tmp/ffmpeg-*-amd64-static; \
     rm -rf /var/lib/apt/lists/*
 
 # Install OrcaSlicer
@@ -71,6 +94,8 @@ ENV PATH="/opt/orcaslicer/usr/bin:${PATH}"
 # Set Slicer Path env variable for Java app
 ENV SLICER_PATH="/opt/orcaslicer/AppRun"
 ENV ASSIMP_PATH="assimp"
+# Use ffmpeg selected at image build time (system or static fallback) for media generation.
+ENV MEDIA_FFMPEG_PATH="/usr/local/bin/ffmpeg-media"
 
 WORKDIR /app
 # Copy JAR from build stage

backend/build.gradle

@@ -42,6 +42,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
 	implementation 'net.codecrete.qrbill:qrbill-generator:3.4.0'
 	implementation 'org.springframework.boot:spring-boot-starter-mail'
+	implementation 'org.jsoup:jsoup:1.18.3'
 	implementation platform('org.lwjgl:lwjgl-bom:3.3.4')
 	implementation 'org.lwjgl:lwjgl'
 	implementation 'org.lwjgl:lwjgl-assimp'

backend/entrypoint.sh

@@ -1,10 +1,61 @@
 #!/bin/sh
+set -e
+
+# In container default to the ffmpeg selected during image build.
+if [ -z "${MEDIA_FFMPEG_PATH:-}" ]; then
+  MEDIA_FFMPEG_PATH="/usr/local/bin/ffmpeg-media"
+fi
+export MEDIA_FFMPEG_PATH
+
+validate_ffmpeg_support() {
+  ffmpeg_bin="$1"
+  if ! command -v "$ffmpeg_bin" >/dev/null 2>&1; then
+    echo "ERROR: FFmpeg executable not found: ${ffmpeg_bin}" >&2
+    exit 11
+  fi
+
+  encoders="$(mktemp)"
+  muxers="$(mktemp)"
+  trap 'rm -f "$encoders" "$muxers"' EXIT
+
+  "$ffmpeg_bin" -hide_banner -encoders > "$encoders" 2>&1 || {
+    echo "ERROR: Unable to inspect FFmpeg encoders from ${ffmpeg_bin}" >&2
+    cat "$encoders" >&2
+    exit 12
+  }
+  "$ffmpeg_bin" -hide_banner -muxers > "$muxers" 2>&1 || {
+    echo "ERROR: Unable to inspect FFmpeg muxers from ${ffmpeg_bin}" >&2
+    cat "$muxers" >&2
+    exit 13
+  }
+
+  grep -Eq '[[:space:]]mjpeg[[:space:]]' "$encoders" || {
+    echo "ERROR: FFmpeg '${ffmpeg_bin}' missing JPEG encoder (mjpeg)." >&2
+    exit 14
+  }
+  grep -Eq '[[:space:]](libwebp|webp)[[:space:]]' "$encoders" || {
+    echo "ERROR: FFmpeg '${ffmpeg_bin}' missing WebP encoder." >&2
+    exit 15
+  }
+  grep -Eq '[[:space:]](libaom-av1|librav1e|libsvtav1)[[:space:]]' "$encoders" || {
+    echo "ERROR: FFmpeg '${ffmpeg_bin}' missing AVIF-capable encoder." >&2
+    exit 16
+  }
+  grep -Eq '[[:space:]]avif([[:space:]]|,|$)' "$muxers" || {
+    echo "ERROR: FFmpeg '${ffmpeg_bin}' missing AVIF muxer." >&2
+    exit 17
+  }
+}
+
+validate_ffmpeg_support "$MEDIA_FFMPEG_PATH"
+
 echo "----------------------------------------------------------------"
 echo "Starting Backend Application"
 echo "DB_URL: $DB_URL"
 echo "DB_USERNAME: $DB_USERNAME"
 echo "SPRING_DATASOURCE_URL: $SPRING_DATASOURCE_URL"
 echo "SLICER_PATH: $SLICER_PATH"
+echo "MEDIA_FFMPEG_PATH: $MEDIA_FFMPEG_PATH"
 echo "----------------------------------------------------------------"
 
 # Determine which environment variables to use for database connection

backend/src/main/java/com/printcalculator/controller/OptionsController.java

@@ -94,6 +94,10 @@ public class OptionsController {
                                     v.getId(),
                                     v.getVariantDisplayName(),
                                     v.getColorName(),
+                                    v.getColorLabelIt(),
+                                    v.getColorLabelEn(),
+                                    v.getColorLabelDe(),
+                                    v.getColorLabelFr(),
                                     resolveHexColor(v),
                                     v.getFinishType() != null ? v.getFinishType() : "GLOSSY",
                                     v.getStockSpools() != null ? v.getStockSpools().doubleValue() : 0d,

backend/src/main/java/com/printcalculator/controller/QuoteSessionController.java

@@ -130,6 +130,7 @@ public class QuoteSessionController {
     }
 
     @GetMapping("/{id}")
+    @Transactional(readOnly = true)
     public ResponseEntity<Map<String, Object>> getQuoteSession(@PathVariable UUID id) {
         QuoteSession session = sessionRepo.findById(id)
                 .orElseThrow(() -> new RuntimeException("Session not found"));

backend/src/main/java/com/printcalculator/controller/SitemapController.java

@@ -0,0 +1,37 @@
+package com.printcalculator.controller;
+
+import com.printcalculator.service.shop.ShopSitemapService;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.CacheControl;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.Duration;
+
+@RestController
+public class SitemapController {
+    private final ShopSitemapService shopSitemapService;
+    private final long cacheSeconds;
+
+    public SitemapController(
+            ShopSitemapService shopSitemapService,
+            @Value("${app.sitemap.shop.cache-seconds:3600}") long cacheSeconds
+    ) {
+        this.shopSitemapService = shopSitemapService;
+        this.cacheSeconds = Math.max(cacheSeconds, 0L);
+    }
+
+    @GetMapping(value = "/api/sitemap-shop.xml", produces = MediaType.APPLICATION_XML_VALUE)
+    public ResponseEntity<String> getShopSitemap() {
+        CacheControl cacheControl = cacheSeconds > 0
+                ? CacheControl.maxAge(Duration.ofSeconds(cacheSeconds)).cachePublic()
+                : CacheControl.noCache();
+
+        return ResponseEntity.ok()
+                .contentType(MediaType.parseMediaType("application/xml;charset=UTF-8"))
+                .cacheControl(cacheControl)
+                .body(shopSitemapService.getShopSitemapXml());
+    }
+}

backend/src/main/java/com/printcalculator/controller/admin/AdminShopProductController.java

@@ -1,8 +1,11 @@
 package com.printcalculator.controller.admin;
 
 import com.printcalculator.dto.AdminShopProductDto;
+import com.printcalculator.dto.AdminTranslateShopProductRequest;
+import com.printcalculator.dto.AdminTranslateShopProductResponse;
 import com.printcalculator.dto.AdminUpsertShopProductRequest;
 import com.printcalculator.service.admin.AdminShopProductControllerService;
+import com.printcalculator.service.admin.AdminShopProductTranslationService;
 import org.springframework.core.io.Resource;
 import org.springframework.core.io.UrlResource;
 import org.springframework.http.HttpHeaders;
@@ -29,9 +32,12 @@ import java.util.UUID;
 @Transactional(readOnly = true)
 public class AdminShopProductController {
     private final AdminShopProductControllerService adminShopProductControllerService;
+    private final AdminShopProductTranslationService adminShopProductTranslationService;
 
-    public AdminShopProductController(AdminShopProductControllerService adminShopProductControllerService) {
+    public AdminShopProductController(AdminShopProductControllerService adminShopProductControllerService,
+                                      AdminShopProductTranslationService adminShopProductTranslationService) {
         this.adminShopProductControllerService = adminShopProductControllerService;
+        this.adminShopProductTranslationService = adminShopProductTranslationService;
     }
 
     @GetMapping
@@ -50,6 +56,11 @@ public class AdminShopProductController {
         return ResponseEntity.ok(adminShopProductControllerService.createProduct(payload));
     }
 
+    @PostMapping("/translate")
+    public ResponseEntity<AdminTranslateShopProductResponse> translateProduct(@RequestBody AdminTranslateShopProductRequest payload) {
+        return ResponseEntity.ok(adminShopProductTranslationService.translateProduct(payload));
+    }
+
     @PutMapping("/{productId}")
     @Transactional
     public ResponseEntity<AdminShopProductDto> updateProduct(@PathVariable UUID productId,

backend/src/main/java/com/printcalculator/dto/AdminFilamentVariantDto.java

@@ -12,6 +12,10 @@ public class AdminFilamentVariantDto {
     private String materialTechnicalTypeLabel;
     private String variantDisplayName;
     private String colorName;
+    private String colorLabelIt;
+    private String colorLabelEn;
+    private String colorLabelDe;
+    private String colorLabelFr;
     private String colorHex;
     private String finishType;
     private String brand;
@@ -89,6 +93,38 @@ public class AdminFilamentVariantDto {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }

backend/src/main/java/com/printcalculator/dto/AdminShopCategoryDto.java

@@ -10,9 +10,25 @@ public class AdminShopCategoryDto {
     private String parentCategoryName;
     private String slug;
     private String name;
+    private String nameIt;
+    private String nameEn;
+    private String nameDe;
+    private String nameFr;
     private String description;
+    private String descriptionIt;
+    private String descriptionEn;
+    private String descriptionDe;
+    private String descriptionFr;
     private String seoTitle;
+    private String seoTitleIt;
+    private String seoTitleEn;
+    private String seoTitleDe;
+    private String seoTitleFr;
     private String seoDescription;
+    private String seoDescriptionIt;
+    private String seoDescriptionEn;
+    private String seoDescriptionDe;
+    private String seoDescriptionFr;
     private String ogTitle;
     private String ogDescription;
     private Boolean indexable;
@@ -69,6 +85,38 @@ public class AdminShopCategoryDto {
         this.name = name;
     }
 
+    public String getNameIt() {
+        return nameIt;
+    }
+
+    public void setNameIt(String nameIt) {
+        this.nameIt = nameIt;
+    }
+
+    public String getNameEn() {
+        return nameEn;
+    }
+
+    public void setNameEn(String nameEn) {
+        this.nameEn = nameEn;
+    }
+
+    public String getNameDe() {
+        return nameDe;
+    }
+
+    public void setNameDe(String nameDe) {
+        this.nameDe = nameDe;
+    }
+
+    public String getNameFr() {
+        return nameFr;
+    }
+
+    public void setNameFr(String nameFr) {
+        this.nameFr = nameFr;
+    }
+
     public String getDescription() {
         return description;
     }
@@ -77,6 +125,38 @@ public class AdminShopCategoryDto {
         this.description = description;
     }
 
+    public String getDescriptionIt() {
+        return descriptionIt;
+    }
+
+    public void setDescriptionIt(String descriptionIt) {
+        this.descriptionIt = descriptionIt;
+    }
+
+    public String getDescriptionEn() {
+        return descriptionEn;
+    }
+
+    public void setDescriptionEn(String descriptionEn) {
+        this.descriptionEn = descriptionEn;
+    }
+
+    public String getDescriptionDe() {
+        return descriptionDe;
+    }
+
+    public void setDescriptionDe(String descriptionDe) {
+        this.descriptionDe = descriptionDe;
+    }
+
+    public String getDescriptionFr() {
+        return descriptionFr;
+    }
+
+    public void setDescriptionFr(String descriptionFr) {
+        this.descriptionFr = descriptionFr;
+    }
+
     public String getSeoTitle() {
         return seoTitle;
     }
@@ -85,6 +165,38 @@ public class AdminShopCategoryDto {
         this.seoTitle = seoTitle;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
     public String getSeoDescription() {
         return seoDescription;
     }
@@ -93,6 +205,38 @@ public class AdminShopCategoryDto {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }

backend/src/main/java/com/printcalculator/dto/AdminShopProductDto.java

@@ -27,7 +27,15 @@ public class AdminShopProductDto {
     private String descriptionDe;
     private String descriptionFr;
     private String seoTitle;
+    private String seoTitleIt;
+    private String seoTitleEn;
+    private String seoTitleDe;
+    private String seoTitleFr;
     private String seoDescription;
+    private String seoDescriptionIt;
+    private String seoDescriptionEn;
+    private String seoDescriptionDe;
+    private String seoDescriptionFr;
     private String ogTitle;
     private String ogDescription;
     private Boolean indexable;
@@ -215,6 +223,38 @@ public class AdminShopProductDto {
         this.seoTitle = seoTitle;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
     public String getSeoDescription() {
         return seoDescription;
     }
@@ -223,6 +263,38 @@ public class AdminShopProductDto {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }

backend/src/main/java/com/printcalculator/dto/AdminShopProductVariantDto.java

@@ -9,6 +9,10 @@ public class AdminShopProductVariantDto {
     private String sku;
     private String variantLabel;
     private String colorName;
+    private String colorLabelIt;
+    private String colorLabelEn;
+    private String colorLabelDe;
+    private String colorLabelFr;
     private String colorHex;
     private String internalMaterialCode;
     private BigDecimal priceChf;
@@ -50,6 +54,38 @@ public class AdminShopProductVariantDto {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }

backend/src/main/java/com/printcalculator/dto/AdminTranslateShopProductRequest.java

@@ -0,0 +1,89 @@
+package com.printcalculator.dto;
+
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+public class AdminTranslateShopProductRequest {
+    private UUID categoryId;
+    private String sourceLanguage;
+    private Boolean overwriteExisting;
+    private List<String> materialCodes;
+    private Map<String, String> names;
+    private Map<String, String> excerpts;
+    private Map<String, String> descriptions;
+    private Map<String, String> seoTitles;
+    private Map<String, String> seoDescriptions;
+
+    public UUID getCategoryId() {
+        return categoryId;
+    }
+
+    public void setCategoryId(UUID categoryId) {
+        this.categoryId = categoryId;
+    }
+
+    public String getSourceLanguage() {
+        return sourceLanguage;
+    }
+
+    public void setSourceLanguage(String sourceLanguage) {
+        this.sourceLanguage = sourceLanguage;
+    }
+
+    public Boolean getOverwriteExisting() {
+        return overwriteExisting;
+    }
+
+    public void setOverwriteExisting(Boolean overwriteExisting) {
+        this.overwriteExisting = overwriteExisting;
+    }
+
+    public List<String> getMaterialCodes() {
+        return materialCodes;
+    }
+
+    public void setMaterialCodes(List<String> materialCodes) {
+        this.materialCodes = materialCodes;
+    }
+
+    public Map<String, String> getNames() {
+        return names;
+    }
+
+    public void setNames(Map<String, String> names) {
+        this.names = names;
+    }
+
+    public Map<String, String> getExcerpts() {
+        return excerpts;
+    }
+
+    public void setExcerpts(Map<String, String> excerpts) {
+        this.excerpts = excerpts;
+    }
+
+    public Map<String, String> getDescriptions() {
+        return descriptions;
+    }
+
+    public void setDescriptions(Map<String, String> descriptions) {
+        this.descriptions = descriptions;
+    }
+
+    public Map<String, String> getSeoTitles() {
+        return seoTitles;
+    }
+
+    public void setSeoTitles(Map<String, String> seoTitles) {
+        this.seoTitles = seoTitles;
+    }
+
+    public Map<String, String> getSeoDescriptions() {
+        return seoDescriptions;
+    }
+
+    public void setSeoDescriptions(Map<String, String> seoDescriptions) {
+        this.seoDescriptions = seoDescriptions;
+    }
+}

backend/src/main/java/com/printcalculator/dto/AdminTranslateShopProductResponse.java

@@ -0,0 +1,70 @@
+package com.printcalculator.dto;
+
+import java.util.List;
+import java.util.Map;
+
+public class AdminTranslateShopProductResponse {
+    private String sourceLanguage;
+    private List<String> targetLanguages;
+    private Map<String, String> names;
+    private Map<String, String> excerpts;
+    private Map<String, String> descriptions;
+    private Map<String, String> seoTitles;
+    private Map<String, String> seoDescriptions;
+
+    public String getSourceLanguage() {
+        return sourceLanguage;
+    }
+
+    public void setSourceLanguage(String sourceLanguage) {
+        this.sourceLanguage = sourceLanguage;
+    }
+
+    public List<String> getTargetLanguages() {
+        return targetLanguages;
+    }
+
+    public void setTargetLanguages(List<String> targetLanguages) {
+        this.targetLanguages = targetLanguages;
+    }
+
+    public Map<String, String> getNames() {
+        return names;
+    }
+
+    public void setNames(Map<String, String> names) {
+        this.names = names;
+    }
+
+    public Map<String, String> getExcerpts() {
+        return excerpts;
+    }
+
+    public void setExcerpts(Map<String, String> excerpts) {
+        this.excerpts = excerpts;
+    }
+
+    public Map<String, String> getDescriptions() {
+        return descriptions;
+    }
+
+    public void setDescriptions(Map<String, String> descriptions) {
+        this.descriptions = descriptions;
+    }
+
+    public Map<String, String> getSeoTitles() {
+        return seoTitles;
+    }
+
+    public void setSeoTitles(Map<String, String> seoTitles) {
+        this.seoTitles = seoTitles;
+    }
+
+    public Map<String, String> getSeoDescriptions() {
+        return seoDescriptions;
+    }
+
+    public void setSeoDescriptions(Map<String, String> seoDescriptions) {
+        this.seoDescriptions = seoDescriptions;
+    }
+}

backend/src/main/java/com/printcalculator/dto/AdminUpsertFilamentVariantRequest.java

@@ -6,6 +6,10 @@ public class AdminUpsertFilamentVariantRequest {
     private Long materialTypeId;
     private String variantDisplayName;
     private String colorName;
+    private String colorLabelIt;
+    private String colorLabelEn;
+    private String colorLabelDe;
+    private String colorLabelFr;
     private String colorHex;
     private String finishType;
     private String brand;
@@ -40,6 +44,38 @@ public class AdminUpsertFilamentVariantRequest {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }

backend/src/main/java/com/printcalculator/dto/AdminUpsertShopCategoryRequest.java

@@ -6,9 +6,25 @@ public class AdminUpsertShopCategoryRequest {
     private UUID parentCategoryId;
     private String slug;
     private String name;
+    private String nameIt;
+    private String nameEn;
+    private String nameDe;
+    private String nameFr;
     private String description;
+    private String descriptionIt;
+    private String descriptionEn;
+    private String descriptionDe;
+    private String descriptionFr;
     private String seoTitle;
+    private String seoTitleIt;
+    private String seoTitleEn;
+    private String seoTitleDe;
+    private String seoTitleFr;
     private String seoDescription;
+    private String seoDescriptionIt;
+    private String seoDescriptionEn;
+    private String seoDescriptionDe;
+    private String seoDescriptionFr;
     private String ogTitle;
     private String ogDescription;
     private Boolean indexable;
@@ -39,6 +55,38 @@ public class AdminUpsertShopCategoryRequest {
         this.name = name;
     }
 
+    public String getNameIt() {
+        return nameIt;
+    }
+
+    public void setNameIt(String nameIt) {
+        this.nameIt = nameIt;
+    }
+
+    public String getNameEn() {
+        return nameEn;
+    }
+
+    public void setNameEn(String nameEn) {
+        this.nameEn = nameEn;
+    }
+
+    public String getNameDe() {
+        return nameDe;
+    }
+
+    public void setNameDe(String nameDe) {
+        this.nameDe = nameDe;
+    }
+
+    public String getNameFr() {
+        return nameFr;
+    }
+
+    public void setNameFr(String nameFr) {
+        this.nameFr = nameFr;
+    }
+
     public String getDescription() {
         return description;
     }
@@ -47,6 +95,38 @@ public class AdminUpsertShopCategoryRequest {
         this.description = description;
     }
 
+    public String getDescriptionIt() {
+        return descriptionIt;
+    }
+
+    public void setDescriptionIt(String descriptionIt) {
+        this.descriptionIt = descriptionIt;
+    }
+
+    public String getDescriptionEn() {
+        return descriptionEn;
+    }
+
+    public void setDescriptionEn(String descriptionEn) {
+        this.descriptionEn = descriptionEn;
+    }
+
+    public String getDescriptionDe() {
+        return descriptionDe;
+    }
+
+    public void setDescriptionDe(String descriptionDe) {
+        this.descriptionDe = descriptionDe;
+    }
+
+    public String getDescriptionFr() {
+        return descriptionFr;
+    }
+
+    public void setDescriptionFr(String descriptionFr) {
+        this.descriptionFr = descriptionFr;
+    }
+
     public String getSeoTitle() {
         return seoTitle;
     }
@@ -55,6 +135,38 @@ public class AdminUpsertShopCategoryRequest {
         this.seoTitle = seoTitle;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
     public String getSeoDescription() {
         return seoDescription;
     }
@@ -63,6 +175,38 @@ public class AdminUpsertShopCategoryRequest {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }

backend/src/main/java/com/printcalculator/dto/AdminUpsertShopProductRequest.java

@@ -22,7 +22,15 @@ public class AdminUpsertShopProductRequest {
     private String descriptionDe;
     private String descriptionFr;
     private String seoTitle;
+    private String seoTitleIt;
+    private String seoTitleEn;
+    private String seoTitleDe;
+    private String seoTitleFr;
     private String seoDescription;
+    private String seoDescriptionIt;
+    private String seoDescriptionEn;
+    private String seoDescriptionDe;
+    private String seoDescriptionFr;
     private String ogTitle;
     private String ogDescription;
     private Boolean indexable;
@@ -175,6 +183,38 @@ public class AdminUpsertShopProductRequest {
         this.seoTitle = seoTitle;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
     public String getSeoDescription() {
         return seoDescription;
     }
@@ -183,6 +223,38 @@ public class AdminUpsertShopProductRequest {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }

backend/src/main/java/com/printcalculator/dto/AdminUpsertShopProductVariantRequest.java

@@ -8,6 +8,10 @@ public class AdminUpsertShopProductVariantRequest {
     private String sku;
     private String variantLabel;
     private String colorName;
+    private String colorLabelIt;
+    private String colorLabelEn;
+    private String colorLabelDe;
+    private String colorLabelFr;
     private String colorHex;
     private String internalMaterialCode;
     private BigDecimal priceChf;
@@ -47,6 +51,38 @@ public class AdminUpsertShopProductVariantRequest {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }

backend/src/main/java/com/printcalculator/dto/OptionsResponse.java

@@ -15,6 +15,10 @@ public record OptionsResponse(
             Long id,
             String name,
             String colorName,
+            String colorLabelIt,
+            String colorLabelEn,
+            String colorLabelDe,
+            String colorLabelFr,
             String hexColor,
             String finishType,
             Double stockSpools,

backend/src/main/java/com/printcalculator/dto/OrderItemDto.java

@@ -17,9 +17,17 @@ public class OrderItemDto {
     private String shopProductName;
     private String shopVariantLabel;
     private String shopVariantColorName;
+    private String shopVariantColorLabelIt;
+    private String shopVariantColorLabelEn;
+    private String shopVariantColorLabelDe;
+    private String shopVariantColorLabelFr;
     private String shopVariantColorHex;
     private String filamentVariantDisplayName;
     private String filamentColorName;
+    private String filamentColorLabelIt;
+    private String filamentColorLabelEn;
+    private String filamentColorLabelDe;
+    private String filamentColorLabelFr;
     private String filamentColorHex;
     private String quality;
     private BigDecimal nozzleDiameterMm;
@@ -73,6 +81,18 @@ public class OrderItemDto {
     public String getShopVariantColorName() { return shopVariantColorName; }
     public void setShopVariantColorName(String shopVariantColorName) { this.shopVariantColorName = shopVariantColorName; }
 
+    public String getShopVariantColorLabelIt() { return shopVariantColorLabelIt; }
+    public void setShopVariantColorLabelIt(String shopVariantColorLabelIt) { this.shopVariantColorLabelIt = shopVariantColorLabelIt; }
+
+    public String getShopVariantColorLabelEn() { return shopVariantColorLabelEn; }
+    public void setShopVariantColorLabelEn(String shopVariantColorLabelEn) { this.shopVariantColorLabelEn = shopVariantColorLabelEn; }
+
+    public String getShopVariantColorLabelDe() { return shopVariantColorLabelDe; }
+    public void setShopVariantColorLabelDe(String shopVariantColorLabelDe) { this.shopVariantColorLabelDe = shopVariantColorLabelDe; }
+
+    public String getShopVariantColorLabelFr() { return shopVariantColorLabelFr; }
+    public void setShopVariantColorLabelFr(String shopVariantColorLabelFr) { this.shopVariantColorLabelFr = shopVariantColorLabelFr; }
+
     public String getShopVariantColorHex() { return shopVariantColorHex; }
     public void setShopVariantColorHex(String shopVariantColorHex) { this.shopVariantColorHex = shopVariantColorHex; }
 
@@ -82,6 +102,18 @@ public class OrderItemDto {
     public String getFilamentColorName() { return filamentColorName; }
     public void setFilamentColorName(String filamentColorName) { this.filamentColorName = filamentColorName; }
 
+    public String getFilamentColorLabelIt() { return filamentColorLabelIt; }
+    public void setFilamentColorLabelIt(String filamentColorLabelIt) { this.filamentColorLabelIt = filamentColorLabelIt; }
+
+    public String getFilamentColorLabelEn() { return filamentColorLabelEn; }
+    public void setFilamentColorLabelEn(String filamentColorLabelEn) { this.filamentColorLabelEn = filamentColorLabelEn; }
+
+    public String getFilamentColorLabelDe() { return filamentColorLabelDe; }
+    public void setFilamentColorLabelDe(String filamentColorLabelDe) { this.filamentColorLabelDe = filamentColorLabelDe; }
+
+    public String getFilamentColorLabelFr() { return filamentColorLabelFr; }
+    public void setFilamentColorLabelFr(String filamentColorLabelFr) { this.filamentColorLabelFr = filamentColorLabelFr; }
+
     public String getFilamentColorHex() { return filamentColorHex; }
     public void setFilamentColorHex(String filamentColorHex) { this.filamentColorHex = filamentColorHex; }
 

backend/src/main/java/com/printcalculator/dto/ShopProductVariantOptionDto.java

@@ -8,6 +8,7 @@ public record ShopProductVariantOptionDto(
         String sku,
         String variantLabel,
         String colorName,
+        String colorLabel,
         String colorHex,
         BigDecimal priceChf,
         Boolean isDefault

backend/src/main/java/com/printcalculator/entity/FilamentVariant.java

@@ -24,6 +24,18 @@ public class FilamentVariant {
     @Column(name = "color_name", nullable = false, length = Integer.MAX_VALUE)
     private String colorName;
 
+    @Column(name = "color_label_it", length = Integer.MAX_VALUE)
+    private String colorLabelIt;
+
+    @Column(name = "color_label_en", length = Integer.MAX_VALUE)
+    private String colorLabelEn;
+
+    @Column(name = "color_label_de", length = Integer.MAX_VALUE)
+    private String colorLabelDe;
+
+    @Column(name = "color_label_fr", length = Integer.MAX_VALUE)
+    private String colorLabelFr;
+
     @Column(name = "color_hex", length = Integer.MAX_VALUE)
     private String colorHex;
 
@@ -93,6 +105,38 @@ public class FilamentVariant {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }
@@ -173,4 +217,60 @@ public class FilamentVariant {
         this.createdAt = createdAt;
     }
 
+    public String getColorLabelForLanguage(String language) {
+        return resolveLocalizedValue(
+                language,
+                colorName,
+                colorLabelIt,
+                colorLabelEn,
+                colorLabelDe,
+                colorLabelFr
+        );
+    }
+
+    private String resolveLocalizedValue(String language,
+                                         String fallback,
+                                         String valueIt,
+                                         String valueEn,
+                                         String valueDe,
+                                         String valueFr) {
+        String normalizedLanguage = normalizeLanguage(language);
+        String preferred = switch (normalizedLanguage) {
+            case "it" -> valueIt;
+            case "en" -> valueEn;
+            case "de" -> valueDe;
+            case "fr" -> valueFr;
+            default -> null;
+        };
+        String resolved = firstNonBlank(preferred, fallback);
+        if (resolved != null) {
+            return resolved;
+        }
+        return firstNonBlank(valueIt, valueEn, valueDe, valueFr);
+    }
+
+    private String normalizeLanguage(String language) {
+        if (language == null) {
+            return "";
+        }
+        String normalized = language.trim().toLowerCase();
+        int separatorIndex = normalized.indexOf('-');
+        if (separatorIndex > 0) {
+            normalized = normalized.substring(0, separatorIndex);
+        }
+        return normalized;
+    }
+
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
+
 }

backend/src/main/java/com/printcalculator/entity/ShopCategory.java

@@ -15,6 +15,7 @@ import jakarta.persistence.Table;
 import org.hibernate.annotations.ColumnDefault;
 
 import java.time.OffsetDateTime;
+import java.util.List;
 import java.util.UUID;
 
 @Entity
@@ -23,6 +24,8 @@ import java.util.UUID;
         @Index(name = "ix_shop_category_active_sort", columnList = "is_active, sort_order")
 })
 public class ShopCategory {
+    public static final List<String> SUPPORTED_LANGUAGES = List.of("it", "en", "de", "fr");
+
     @Id
     @GeneratedValue(strategy = GenerationType.AUTO)
     @Column(name = "shop_category_id", nullable = false)
@@ -38,15 +41,63 @@ public class ShopCategory {
     @Column(name = "name", nullable = false, length = Integer.MAX_VALUE)
     private String name;
 
+    @Column(name = "name_it", length = Integer.MAX_VALUE)
+    private String nameIt;
+
+    @Column(name = "name_en", length = Integer.MAX_VALUE)
+    private String nameEn;
+
+    @Column(name = "name_de", length = Integer.MAX_VALUE)
+    private String nameDe;
+
+    @Column(name = "name_fr", length = Integer.MAX_VALUE)
+    private String nameFr;
+
     @Column(name = "description", length = Integer.MAX_VALUE)
     private String description;
 
+    @Column(name = "description_it", length = Integer.MAX_VALUE)
+    private String descriptionIt;
+
+    @Column(name = "description_en", length = Integer.MAX_VALUE)
+    private String descriptionEn;
+
+    @Column(name = "description_de", length = Integer.MAX_VALUE)
+    private String descriptionDe;
+
+    @Column(name = "description_fr", length = Integer.MAX_VALUE)
+    private String descriptionFr;
+
     @Column(name = "seo_title", length = Integer.MAX_VALUE)
     private String seoTitle;
 
+    @Column(name = "seo_title_it", length = Integer.MAX_VALUE)
+    private String seoTitleIt;
+
+    @Column(name = "seo_title_en", length = Integer.MAX_VALUE)
+    private String seoTitleEn;
+
+    @Column(name = "seo_title_de", length = Integer.MAX_VALUE)
+    private String seoTitleDe;
+
+    @Column(name = "seo_title_fr", length = Integer.MAX_VALUE)
+    private String seoTitleFr;
+
     @Column(name = "seo_description", length = Integer.MAX_VALUE)
     private String seoDescription;
 
+    @Column(name = "seo_description_it", length = Integer.MAX_VALUE)
+    private String seoDescriptionIt;
+
+    @Column(name = "seo_description_en", length = Integer.MAX_VALUE)
+    private String seoDescriptionEn;
+
+    @Column(name = "seo_description_de", length = Integer.MAX_VALUE)
+    private String seoDescriptionDe;
+
+    @Column(name = "seo_description_fr", length = Integer.MAX_VALUE)
+    private String seoDescriptionFr;
+
     @Column(name = "og_title", length = Integer.MAX_VALUE)
     private String ogTitle;
 
@@ -139,6 +190,38 @@ public class ShopCategory {
         this.name = name;
     }
 
+    public String getNameIt() {
+        return nameIt;
+    }
+
+    public void setNameIt(String nameIt) {
+        this.nameIt = nameIt;
+    }
+
+    public String getNameEn() {
+        return nameEn;
+    }
+
+    public void setNameEn(String nameEn) {
+        this.nameEn = nameEn;
+    }
+
+    public String getNameDe() {
+        return nameDe;
+    }
+
+    public void setNameDe(String nameDe) {
+        this.nameDe = nameDe;
+    }
+
+    public String getNameFr() {
+        return nameFr;
+    }
+
+    public void setNameFr(String nameFr) {
+        this.nameFr = nameFr;
+    }
+
     public String getDescription() {
         return description;
     }
@@ -147,6 +230,38 @@ public class ShopCategory {
         this.description = description;
     }
 
+    public String getDescriptionIt() {
+        return descriptionIt;
+    }
+
+    public void setDescriptionIt(String descriptionIt) {
+        this.descriptionIt = descriptionIt;
+    }
+
+    public String getDescriptionEn() {
+        return descriptionEn;
+    }
+
+    public void setDescriptionEn(String descriptionEn) {
+        this.descriptionEn = descriptionEn;
+    }
+
+    public String getDescriptionDe() {
+        return descriptionDe;
+    }
+
+    public void setDescriptionDe(String descriptionDe) {
+        this.descriptionDe = descriptionDe;
+    }
+
+    public String getDescriptionFr() {
+        return descriptionFr;
+    }
+
+    public void setDescriptionFr(String descriptionFr) {
+        this.descriptionFr = descriptionFr;
+    }
+
     public String getSeoTitle() {
         return seoTitle;
     }
@@ -155,6 +270,38 @@ public class ShopCategory {
         this.seoTitle = seoTitle;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
     public String getSeoDescription() {
         return seoDescription;
     }
@@ -163,6 +310,38 @@ public class ShopCategory {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }
@@ -218,4 +397,109 @@ public class ShopCategory {
     public void setUpdatedAt(OffsetDateTime updatedAt) {
         this.updatedAt = updatedAt;
     }
+
+    public String getNameForLanguage(String language) {
+        return resolveLocalizedValue(language, name, nameIt, nameEn, nameDe, nameFr);
+    }
+
+    public void setNameForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> nameIt = value;
+            case "en" -> nameEn = value;
+            case "de" -> nameDe = value;
+            case "fr" -> nameFr = value;
+            default -> {
+            }
+        }
+    }
+
+    public String getDescriptionForLanguage(String language) {
+        return resolveLocalizedValue(language, description, descriptionIt, descriptionEn, descriptionDe, descriptionFr);
+    }
+
+    public void setDescriptionForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> descriptionIt = value;
+            case "en" -> descriptionEn = value;
+            case "de" -> descriptionDe = value;
+            case "fr" -> descriptionFr = value;
+            default -> {
+            }
+        }
+    }
+
+    public String getSeoTitleForLanguage(String language) {
+        return resolveLocalizedValue(language, seoTitle, seoTitleIt, seoTitleEn, seoTitleDe, seoTitleFr);
+    }
+
+    public void setSeoTitleForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> seoTitleIt = value;
+            case "en" -> seoTitleEn = value;
+            case "de" -> seoTitleDe = value;
+            case "fr" -> seoTitleFr = value;
+            default -> {
+            }
+        }
+    }
+
+    public String getSeoDescriptionForLanguage(String language) {
+        return resolveLocalizedValue(language, seoDescription, seoDescriptionIt, seoDescriptionEn, seoDescriptionDe, seoDescriptionFr);
+    }
+
+    public void setSeoDescriptionForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> seoDescriptionIt = value;
+            case "en" -> seoDescriptionEn = value;
+            case "de" -> seoDescriptionDe = value;
+            case "fr" -> seoDescriptionFr = value;
+            default -> {
+            }
+        }
+    }
+
+    private String resolveLocalizedValue(String language,
+                                         String fallback,
+                                         String valueIt,
+                                         String valueEn,
+                                         String valueDe,
+                                         String valueFr) {
+        String normalizedLanguage = normalizeLanguage(language);
+        String preferred = switch (normalizedLanguage) {
+            case "it" -> valueIt;
+            case "en" -> valueEn;
+            case "de" -> valueDe;
+            case "fr" -> valueFr;
+            default -> null;
+        };
+        String resolved = firstNonBlank(preferred, fallback);
+        if (resolved != null) {
+            return resolved;
+        }
+        return firstNonBlank(valueIt, valueEn, valueDe, valueFr);
+    }
+
+    private String normalizeLanguage(String language) {
+        if (language == null) {
+            return "";
+        }
+        String normalized = language.trim().toLowerCase();
+        int separatorIndex = normalized.indexOf('-');
+        if (separatorIndex > 0) {
+            normalized = normalized.substring(0, separatorIndex);
+        }
+        return normalized;
+    }
+
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
 }

backend/src/main/java/com/printcalculator/entity/ShopProduct.java

@@ -86,9 +86,33 @@ public class ShopProduct {
     @Column(name = "seo_title", length = Integer.MAX_VALUE)
     private String seoTitle;
 
+    @Column(name = "seo_title_it", length = Integer.MAX_VALUE)
+    private String seoTitleIt;
+
+    @Column(name = "seo_title_en", length = Integer.MAX_VALUE)
+    private String seoTitleEn;
+
+    @Column(name = "seo_title_de", length = Integer.MAX_VALUE)
+    private String seoTitleDe;
+
+    @Column(name = "seo_title_fr", length = Integer.MAX_VALUE)
+    private String seoTitleFr;
+
     @Column(name = "seo_description", length = Integer.MAX_VALUE)
     private String seoDescription;
 
+    @Column(name = "seo_description_it", length = Integer.MAX_VALUE)
+    private String seoDescriptionIt;
+
+    @Column(name = "seo_description_en", length = Integer.MAX_VALUE)
+    private String seoDescriptionEn;
+
+    @Column(name = "seo_description_de", length = Integer.MAX_VALUE)
+    private String seoDescriptionDe;
+
+    @Column(name = "seo_description_fr", length = Integer.MAX_VALUE)
+    private String seoDescriptionFr;
+
     @Column(name = "og_title", length = Integer.MAX_VALUE)
     private String ogTitle;
 
@@ -319,6 +343,70 @@ public class ShopProduct {
         this.seoDescription = seoDescription;
     }
 
+    public String getSeoTitleIt() {
+        return seoTitleIt;
+    }
+
+    public void setSeoTitleIt(String seoTitleIt) {
+        this.seoTitleIt = seoTitleIt;
+    }
+
+    public String getSeoTitleEn() {
+        return seoTitleEn;
+    }
+
+    public void setSeoTitleEn(String seoTitleEn) {
+        this.seoTitleEn = seoTitleEn;
+    }
+
+    public String getSeoTitleDe() {
+        return seoTitleDe;
+    }
+
+    public void setSeoTitleDe(String seoTitleDe) {
+        this.seoTitleDe = seoTitleDe;
+    }
+
+    public String getSeoTitleFr() {
+        return seoTitleFr;
+    }
+
+    public void setSeoTitleFr(String seoTitleFr) {
+        this.seoTitleFr = seoTitleFr;
+    }
+
+    public String getSeoDescriptionIt() {
+        return seoDescriptionIt;
+    }
+
+    public void setSeoDescriptionIt(String seoDescriptionIt) {
+        this.seoDescriptionIt = seoDescriptionIt;
+    }
+
+    public String getSeoDescriptionEn() {
+        return seoDescriptionEn;
+    }
+
+    public void setSeoDescriptionEn(String seoDescriptionEn) {
+        this.seoDescriptionEn = seoDescriptionEn;
+    }
+
+    public String getSeoDescriptionDe() {
+        return seoDescriptionDe;
+    }
+
+    public void setSeoDescriptionDe(String seoDescriptionDe) {
+        this.seoDescriptionDe = seoDescriptionDe;
+    }
+
+    public String getSeoDescriptionFr() {
+        return seoDescriptionFr;
+    }
+
+    public void setSeoDescriptionFr(String seoDescriptionFr) {
+        this.seoDescriptionFr = seoDescriptionFr;
+    }
+
     public String getOgTitle() {
         return ogTitle;
     }
@@ -428,6 +516,36 @@ public class ShopProduct {
         }
     }
 
+    public String getSeoTitleForLanguage(String language) {
+        return resolveLocalizedValue(language, seoTitle, seoTitleIt, seoTitleEn, seoTitleDe, seoTitleFr);
+    }
+
+    public void setSeoTitleForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> seoTitleIt = value;
+            case "en" -> seoTitleEn = value;
+            case "de" -> seoTitleDe = value;
+            case "fr" -> seoTitleFr = value;
+            default -> {
+            }
+        }
+    }
+
+    public String getSeoDescriptionForLanguage(String language) {
+        return resolveLocalizedValue(language, seoDescription, seoDescriptionIt, seoDescriptionEn, seoDescriptionDe, seoDescriptionFr);
+    }
+
+    public void setSeoDescriptionForLanguage(String language, String value) {
+        switch (normalizeLanguage(language)) {
+            case "it" -> seoDescriptionIt = value;
+            case "en" -> seoDescriptionEn = value;
+            case "de" -> seoDescriptionDe = value;
+            case "fr" -> seoDescriptionFr = value;
+            default -> {
+            }
+        }
+    }
+
     private String resolveLocalizedValue(String language,
                                          String fallback,
                                          String valueIt,

backend/src/main/java/com/printcalculator/entity/ShopProductVariant.java

@@ -42,6 +42,18 @@ public class ShopProductVariant {
     @Column(name = "color_name", nullable = false, length = Integer.MAX_VALUE)
     private String colorName;
 
+    @Column(name = "color_label_it", length = Integer.MAX_VALUE)
+    private String colorLabelIt;
+
+    @Column(name = "color_label_en", length = Integer.MAX_VALUE)
+    private String colorLabelEn;
+
+    @Column(name = "color_label_de", length = Integer.MAX_VALUE)
+    private String colorLabelDe;
+
+    @Column(name = "color_label_fr", length = Integer.MAX_VALUE)
+    private String colorLabelFr;
+
     @Column(name = "color_hex", length = Integer.MAX_VALUE)
     private String colorHex;
 
@@ -152,6 +164,38 @@ public class ShopProductVariant {
         this.colorName = colorName;
     }
 
+    public String getColorLabelIt() {
+        return colorLabelIt;
+    }
+
+    public void setColorLabelIt(String colorLabelIt) {
+        this.colorLabelIt = colorLabelIt;
+    }
+
+    public String getColorLabelEn() {
+        return colorLabelEn;
+    }
+
+    public void setColorLabelEn(String colorLabelEn) {
+        this.colorLabelEn = colorLabelEn;
+    }
+
+    public String getColorLabelDe() {
+        return colorLabelDe;
+    }
+
+    public void setColorLabelDe(String colorLabelDe) {
+        this.colorLabelDe = colorLabelDe;
+    }
+
+    public String getColorLabelFr() {
+        return colorLabelFr;
+    }
+
+    public void setColorLabelFr(String colorLabelFr) {
+        this.colorLabelFr = colorLabelFr;
+    }
+
     public String getColorHex() {
         return colorHex;
     }
@@ -215,4 +259,60 @@ public class ShopProductVariant {
     public void setUpdatedAt(OffsetDateTime updatedAt) {
         this.updatedAt = updatedAt;
     }
+
+    public String getColorLabelForLanguage(String language) {
+        return resolveLocalizedValue(
+                language,
+                colorName,
+                colorLabelIt,
+                colorLabelEn,
+                colorLabelDe,
+                colorLabelFr
+        );
+    }
+
+    private String resolveLocalizedValue(String language,
+                                         String fallback,
+                                         String valueIt,
+                                         String valueEn,
+                                         String valueDe,
+                                         String valueFr) {
+        String normalizedLanguage = normalizeLanguage(language);
+        String preferred = switch (normalizedLanguage) {
+            case "it" -> valueIt;
+            case "en" -> valueEn;
+            case "de" -> valueDe;
+            case "fr" -> valueFr;
+            default -> null;
+        };
+        String resolved = firstNonBlank(preferred, fallback);
+        if (resolved != null) {
+            return resolved;
+        }
+        return firstNonBlank(valueIt, valueEn, valueDe, valueFr);
+    }
+
+    private String normalizeLanguage(String language) {
+        if (language == null) {
+            return "";
+        }
+        String normalized = language.trim().toLowerCase();
+        int separatorIndex = normalized.indexOf('-');
+        if (separatorIndex > 0) {
+            normalized = normalized.substring(0, separatorIndex);
+        }
+        return normalized;
+    }
+
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
 }

backend/src/main/java/com/printcalculator/repository/QuoteLineItemRepository.java

@@ -1,6 +1,7 @@
 package com.printcalculator.repository;
 
 import com.printcalculator.entity.QuoteLineItem;
+import org.springframework.data.jpa.repository.EntityGraph;
 import org.springframework.data.jpa.repository.JpaRepository;
 
 import java.util.List;
@@ -8,9 +9,16 @@ import java.util.Optional;
 import java.util.UUID;
 
 public interface QuoteLineItemRepository extends JpaRepository<QuoteLineItem, UUID> {
+    @EntityGraph(attributePaths = {"filamentVariant", "shopProduct", "shopProductVariant"})
     List<QuoteLineItem> findByQuoteSessionId(UUID quoteSessionId);
+
+    @EntityGraph(attributePaths = {"filamentVariant", "shopProduct", "shopProductVariant"})
     List<QuoteLineItem> findByQuoteSessionIdOrderByCreatedAtAsc(UUID quoteSessionId);
+
+    @EntityGraph(attributePaths = {"filamentVariant", "shopProduct", "shopProductVariant"})
     Optional<QuoteLineItem> findByIdAndQuoteSession_Id(UUID lineItemId, UUID quoteSessionId);
+
+    @EntityGraph(attributePaths = {"shopProductVariant"})
     Optional<QuoteLineItem> findFirstByQuoteSession_IdAndLineItemTypeAndShopProductVariant_Id(
             UUID quoteSessionId,
             String lineItemType,

backend/src/main/java/com/printcalculator/service/OrderService.java

@@ -29,6 +29,7 @@ import java.util.*;
 @Service
 public class OrderService {
     private static final Path QUOTE_STORAGE_ROOT = Paths.get("storage_quotes").toAbsolutePath().normalize();
+    private static final String SHOP_LINE_ITEM_TYPE = "SHOP_PRODUCT";
 
     private final OrderRepository orderRepo;
     private final OrderItemRepository orderItemRepo;
@@ -235,19 +236,21 @@ public class OrderService {
 
             oItem = orderItemRepo.save(oItem);
 
-            String relativePath = "orders/" + order.getId() + "/3d-files/" + oItem.getId() + "/" + storedFilename;
-            oItem.setStoredRelativePath(relativePath);
-
             Path sourcePath = resolveStoredQuotePath(qItem.getStoredPath(), session.getId());
             if (sourcePath == null || !Files.exists(sourcePath)) {
+                if (requiresStoredSourceFile(qItem)) {
                     throw new IllegalStateException("Source file not available for quote line item " + qItem.getId());
                 }
+            } else {
+                String relativePath = "orders/" + order.getId() + "/3d-files/" + oItem.getId() + "/" + storedFilename;
+                oItem.setStoredRelativePath(relativePath);
                 try {
                     storageService.store(sourcePath, Paths.get(relativePath));
                     oItem.setFileSizeBytes(Files.size(sourcePath));
                 } catch (IOException e) {
                     throw new RuntimeException("Failed to copy quote file for line item " + qItem.getId(), e);
                 }
+            }
 
             oItem = orderItemRepo.save(oItem);
             savedItems.add(oItem);
@@ -318,6 +321,12 @@ public class OrderService {
         return "stl";
     }
 
+    private boolean requiresStoredSourceFile(QuoteLineItem qItem) {
+        return !SHOP_LINE_ITEM_TYPE.equalsIgnoreCase(
+                qItem.getLineItemType() != null ? qItem.getLineItemType() : ""
+        );
+    }
+
     private Path resolveStoredQuotePath(String storedPath, UUID expectedSessionId) {
         if (storedPath == null || storedPath.isBlank()) {
             return null;

backend/src/main/java/com/printcalculator/service/admin/AdminFilamentControllerService.java

@@ -161,10 +161,21 @@ public class AdminFilamentControllerService {
         String normalizedColorHex = normalizeAndValidateColorHex(payload.getColorHex());
         String normalizedFinishType = normalizeAndValidateFinishType(payload.getFinishType(), payload.getIsMatte());
         String normalizedBrand = normalizeOptional(payload.getBrand());
+        String fallbackColorLabel = firstNonBlank(
+                normalizeOptional(payload.getColorLabelIt()),
+                normalizeOptional(payload.getColorLabelEn()),
+                normalizeOptional(payload.getColorLabelDe()),
+                normalizeOptional(payload.getColorLabelFr()),
+                normalizedColorName
+        );
 
         variant.setFilamentMaterialType(material);
         variant.setVariantDisplayName(normalizedDisplayName);
         variant.setColorName(normalizedColorName);
+        variant.setColorLabelIt(firstNonBlank(normalizeOptional(payload.getColorLabelIt()), fallbackColorLabel));
+        variant.setColorLabelEn(firstNonBlank(normalizeOptional(payload.getColorLabelEn()), fallbackColorLabel));
+        variant.setColorLabelDe(firstNonBlank(normalizeOptional(payload.getColorLabelDe()), fallbackColorLabel));
+        variant.setColorLabelFr(firstNonBlank(normalizeOptional(payload.getColorLabelFr()), fallbackColorLabel));
         variant.setColorHex(normalizedColorHex);
         variant.setFinishType(normalizedFinishType);
         variant.setBrand(normalizedBrand);
@@ -226,6 +237,18 @@ public class AdminFilamentControllerService {
         return normalized.isBlank() ? null : normalized;
     }
 
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
+
     private FilamentMaterialType validateAndResolveMaterial(AdminUpsertFilamentVariantRequest payload) {
         if (payload == null || payload.getMaterialTypeId() == null) {
             throw new ResponseStatusException(BAD_REQUEST, "Material type id is required");
@@ -306,6 +329,10 @@ public class AdminFilamentControllerService {
 
         dto.setVariantDisplayName(variant.getVariantDisplayName());
         dto.setColorName(variant.getColorName());
+        dto.setColorLabelIt(variant.getColorLabelIt());
+        dto.setColorLabelEn(variant.getColorLabelEn());
+        dto.setColorLabelDe(variant.getColorLabelDe());
+        dto.setColorLabelFr(variant.getColorLabelFr());
         dto.setColorHex(variant.getColorHex());
         dto.setFinishType(variant.getFinishType());
         dto.setBrand(variant.getBrand());

backend/src/main/java/com/printcalculator/service/admin/AdminMediaControllerService.java

@@ -402,7 +402,7 @@ public class AdminMediaControllerService {
 
         if (!skippedFormats.isEmpty()) {
             logger.warn(
-                    "Skipping media formats for asset {} because FFmpeg encoders are unavailable: {}",
+                    "Skipping media formats for asset {} because FFmpeg support is unavailable: {}",
                     asset.getId(),
                     String.join(", ", skippedFormats)
             );

backend/src/main/java/com/printcalculator/service/admin/AdminShopCategoryControllerService.java

@@ -67,13 +67,13 @@ public class AdminShopCategoryControllerService {
     @Transactional
     public AdminShopCategoryDto createCategory(AdminUpsertShopCategoryRequest payload) {
         ensurePayload(payload);
-        String normalizedName = normalizeRequiredName(payload.getName());
+        LocalizedCategoryContent localizedContent = normalizeLocalizedCategoryContent(payload);
-        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), normalizedName);
+        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), localizedContent.defaultName());
         ensureSlugAvailable(normalizedSlug, null);
 
         ShopCategory category = new ShopCategory();
         category.setCreatedAt(OffsetDateTime.now());
-        applyPayload(category, payload, normalizedName, normalizedSlug, null);
+        applyPayload(category, payload, localizedContent, normalizedSlug, null);
 
         ShopCategory saved = shopCategoryRepository.save(category);
         return getCategory(saved.getId());
@@ -86,11 +86,11 @@ public class AdminShopCategoryControllerService {
         ShopCategory category = shopCategoryRepository.findById(categoryId)
                 .orElseThrow(() -> new ResponseStatusException(NOT_FOUND, "Shop category not found"));
 
-        String normalizedName = normalizeRequiredName(payload.getName());
+        LocalizedCategoryContent localizedContent = normalizeLocalizedCategoryContent(payload);
-        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), normalizedName);
+        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), localizedContent.defaultName());
         ensureSlugAvailable(normalizedSlug, category.getId());
 
-        applyPayload(category, payload, normalizedName, normalizedSlug, category.getId());
+        applyPayload(category, payload, localizedContent, normalizedSlug, category.getId());
         ShopCategory saved = shopCategoryRepository.save(category);
         return getCategory(saved.getId());
     }
@@ -112,17 +112,33 @@ public class AdminShopCategoryControllerService {
 
     private void applyPayload(ShopCategory category,
                               AdminUpsertShopCategoryRequest payload,
-                              String normalizedName,
+                              LocalizedCategoryContent localizedContent,
                               String normalizedSlug,
                               UUID currentCategoryId) {
         ShopCategory parentCategory = resolveParentCategory(payload.getParentCategoryId(), currentCategoryId);
 
         category.setParentCategory(parentCategory);
         category.setSlug(normalizedSlug);
-        category.setName(normalizedName);
+        category.setName(localizedContent.defaultName());
-        category.setDescription(normalizeOptional(payload.getDescription()));
+        category.setNameIt(localizedContent.names().get("it"));
-        category.setSeoTitle(normalizeOptional(payload.getSeoTitle()));
+        category.setNameEn(localizedContent.names().get("en"));
-        category.setSeoDescription(normalizeOptional(payload.getSeoDescription()));
+        category.setNameDe(localizedContent.names().get("de"));
+        category.setNameFr(localizedContent.names().get("fr"));
+        category.setDescription(localizedContent.defaultDescription());
+        category.setDescriptionIt(localizedContent.descriptions().get("it"));
+        category.setDescriptionEn(localizedContent.descriptions().get("en"));
+        category.setDescriptionDe(localizedContent.descriptions().get("de"));
+        category.setDescriptionFr(localizedContent.descriptions().get("fr"));
+        category.setSeoTitle(localizedContent.defaultSeoTitle());
+        category.setSeoTitleIt(localizedContent.seoTitles().get("it"));
+        category.setSeoTitleEn(localizedContent.seoTitles().get("en"));
+        category.setSeoTitleDe(localizedContent.seoTitles().get("de"));
+        category.setSeoTitleFr(localizedContent.seoTitles().get("fr"));
+        category.setSeoDescription(localizedContent.defaultSeoDescription());
+        category.setSeoDescriptionIt(localizedContent.seoDescriptions().get("it"));
+        category.setSeoDescriptionEn(localizedContent.seoDescriptions().get("en"));
+        category.setSeoDescriptionDe(localizedContent.seoDescriptions().get("de"));
+        category.setSeoDescriptionFr(localizedContent.seoDescriptions().get("fr"));
         category.setOgTitle(normalizeOptional(payload.getOgTitle()));
         category.setOgDescription(normalizeOptional(payload.getOgDescription()));
         category.setIndexable(payload.getIndexable() == null || payload.getIndexable());
@@ -161,14 +177,6 @@ public class AdminShopCategoryControllerService {
         }
     }
 
-    private String normalizeRequiredName(String name) {
-        String normalized = normalizeOptional(name);
-        if (normalized == null) {
-            throw new ResponseStatusException(BAD_REQUEST, "Category name is required");
-        }
-        return normalized;
-    }
-
     private String normalizeAndValidateSlug(String slug, String fallbackName) {
         String source = normalizeOptional(slug);
         if (source == null) {
@@ -203,6 +211,103 @@ public class AdminShopCategoryControllerService {
         return normalized.isBlank() ? null : normalized;
     }
 
+    private String normalizeRequired(String value, String message) {
+        String normalized = normalizeOptional(value);
+        if (normalized == null) {
+            throw new ResponseStatusException(BAD_REQUEST, message);
+        }
+        return normalized;
+    }
+
+    private LocalizedCategoryContent normalizeLocalizedCategoryContent(AdminUpsertShopCategoryRequest payload) {
+        String legacyName = normalizeOptional(payload.getName());
+        String fallbackName = firstNonBlank(
+                legacyName,
+                normalizeOptional(payload.getNameIt()),
+                normalizeOptional(payload.getNameEn()),
+                normalizeOptional(payload.getNameDe()),
+                normalizeOptional(payload.getNameFr())
+        );
+        if (fallbackName == null) {
+            throw new ResponseStatusException(BAD_REQUEST, "Category name is required");
+        }
+
+        Map<String, String> names = new LinkedHashMap<>();
+        names.put("it", normalizeRequired(firstNonBlank(normalizeOptional(payload.getNameIt()), fallbackName), "Italian category name is required"));
+        names.put("en", normalizeRequired(firstNonBlank(normalizeOptional(payload.getNameEn()), fallbackName), "English category name is required"));
+        names.put("de", normalizeRequired(firstNonBlank(normalizeOptional(payload.getNameDe()), fallbackName), "German category name is required"));
+        names.put("fr", normalizeRequired(firstNonBlank(normalizeOptional(payload.getNameFr()), fallbackName), "French category name is required"));
+
+        String fallbackDescription = firstNonBlank(
+                normalizeOptional(payload.getDescription()),
+                normalizeOptional(payload.getDescriptionIt()),
+                normalizeOptional(payload.getDescriptionEn()),
+                normalizeOptional(payload.getDescriptionDe()),
+                normalizeOptional(payload.getDescriptionFr())
+        );
+        Map<String, String> descriptions = new LinkedHashMap<>();
+        descriptions.put("it", firstNonBlank(normalizeOptional(payload.getDescriptionIt()), fallbackDescription));
+        descriptions.put("en", firstNonBlank(normalizeOptional(payload.getDescriptionEn()), fallbackDescription));
+        descriptions.put("de", firstNonBlank(normalizeOptional(payload.getDescriptionDe()), fallbackDescription));
+        descriptions.put("fr", firstNonBlank(normalizeOptional(payload.getDescriptionFr()), fallbackDescription));
+
+        String fallbackSeoTitle = firstNonBlank(
+                normalizeOptional(payload.getSeoTitle()),
+                normalizeOptional(payload.getSeoTitleIt()),
+                normalizeOptional(payload.getSeoTitleEn()),
+                normalizeOptional(payload.getSeoTitleDe()),
+                normalizeOptional(payload.getSeoTitleFr())
+        );
+        Map<String, String> seoTitles = new LinkedHashMap<>();
+        seoTitles.put("it", firstNonBlank(normalizeOptional(payload.getSeoTitleIt()), fallbackSeoTitle));
+        seoTitles.put("en", firstNonBlank(normalizeOptional(payload.getSeoTitleEn()), fallbackSeoTitle));
+        seoTitles.put("de", firstNonBlank(normalizeOptional(payload.getSeoTitleDe()), fallbackSeoTitle));
+        seoTitles.put("fr", firstNonBlank(normalizeOptional(payload.getSeoTitleFr()), fallbackSeoTitle));
+
+        String fallbackSeoDescription = firstNonBlank(
+                normalizeOptional(payload.getSeoDescription()),
+                normalizeOptional(payload.getSeoDescriptionIt()),
+                normalizeOptional(payload.getSeoDescriptionEn()),
+                normalizeOptional(payload.getSeoDescriptionDe()),
+                normalizeOptional(payload.getSeoDescriptionFr())
+        );
+        Map<String, String> seoDescriptions = new LinkedHashMap<>();
+        seoDescriptions.put("it", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionIt()), fallbackSeoDescription), "Italian"));
+        seoDescriptions.put("en", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionEn()), fallbackSeoDescription), "English"));
+        seoDescriptions.put("de", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionDe()), fallbackSeoDescription), "German"));
+        seoDescriptions.put("fr", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionFr()), fallbackSeoDescription), "French"));
+
+        return new LocalizedCategoryContent(
+                names.get("it"),
+                firstNonBlank(descriptions.get("it"), fallbackDescription),
+                firstNonBlank(seoTitles.get("it"), fallbackSeoTitle),
+                firstNonBlank(seoDescriptions.get("it"), fallbackSeoDescription),
+                names,
+                descriptions,
+                seoTitles,
+                seoDescriptions
+        );
+    }
+
+    private String validateSeoDescriptionLength(String value, String languageLabel) {
+        if (value != null && value.length() > 160) {
+            throw new ResponseStatusException(BAD_REQUEST, languageLabel + " SEO description must be at most 160 characters");
+        }
+        return value;
+    }
+
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
+
     private CategoryContext buildContext() {
         List<ShopCategory> categories = shopCategoryRepository.findAllByOrderBySortOrderAscNameAsc();
         List<ShopProduct> products = shopProductRepository.findAll();
@@ -278,9 +383,25 @@ public class AdminShopCategoryControllerService {
         dto.setParentCategoryName(category.getParentCategory() != null ? category.getParentCategory().getName() : null);
         dto.setSlug(category.getSlug());
         dto.setName(category.getName());
+        dto.setNameIt(category.getNameIt());
+        dto.setNameEn(category.getNameEn());
+        dto.setNameDe(category.getNameDe());
+        dto.setNameFr(category.getNameFr());
         dto.setDescription(category.getDescription());
+        dto.setDescriptionIt(category.getDescriptionIt());
+        dto.setDescriptionEn(category.getDescriptionEn());
+        dto.setDescriptionDe(category.getDescriptionDe());
+        dto.setDescriptionFr(category.getDescriptionFr());
         dto.setSeoTitle(category.getSeoTitle());
+        dto.setSeoTitleIt(category.getSeoTitleIt());
+        dto.setSeoTitleEn(category.getSeoTitleEn());
+        dto.setSeoTitleDe(category.getSeoTitleDe());
+        dto.setSeoTitleFr(category.getSeoTitleFr());
         dto.setSeoDescription(category.getSeoDescription());
+        dto.setSeoDescriptionIt(category.getSeoDescriptionIt());
+        dto.setSeoDescriptionEn(category.getSeoDescriptionEn());
+        dto.setSeoDescriptionDe(category.getSeoDescriptionDe());
+        dto.setSeoDescriptionFr(category.getSeoDescriptionFr());
         dto.setOgTitle(category.getOgTitle());
         dto.setOgDescription(category.getOgDescription());
         dto.setIndexable(category.getIndexable());
@@ -331,4 +452,16 @@ public class AdminShopCategoryControllerService {
             Map<UUID, Integer> descendantProductCounts
     ) {
     }
+
+    private record LocalizedCategoryContent(
+            String defaultName,
+            String defaultDescription,
+            String defaultSeoTitle,
+            String defaultSeoDescription,
+            Map<String, String> names,
+            Map<String, String> descriptions,
+            Map<String, String> seoTitles,
+            Map<String, String> seoDescriptions
+    ) {
+    }
 }

backend/src/main/java/com/printcalculator/service/admin/AdminShopProductControllerService.java

@@ -22,6 +22,9 @@ import com.printcalculator.service.SlicerService;
 import com.printcalculator.service.media.PublicMediaQueryService;
 import com.printcalculator.service.shop.ShopStorageService;
 import com.printcalculator.service.storage.ClamAVService;
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Document;
+import org.jsoup.safety.Safelist;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Service;
@@ -64,6 +67,10 @@ public class AdminShopProductControllerService {
     private static final Pattern DIACRITICS_PATTERN = Pattern.compile("\\p{M}+");
     private static final Pattern NON_ALPHANUMERIC_PATTERN = Pattern.compile("[^a-z0-9]+");
     private static final Pattern EDGE_DASH_PATTERN = Pattern.compile("(^-+|-+$)");
+    private static final Safelist PRODUCT_DESCRIPTION_SAFELIST = Safelist.none()
+            .addTags("p", "div", "br", "strong", "b", "em", "i", "u", "ul", "ol", "li", "a")
+            .addAttributes("a", "href")
+            .addProtocols("a", "href", "http", "https", "mailto", "tel");
 
     private final ShopProductRepository shopProductRepository;
     private final ShopCategoryRepository shopCategoryRepository;
@@ -163,7 +170,13 @@ public class AdminShopProductControllerService {
             }
         }
 
-        shopProductModelAssetRepository.findByProduct_Id(productId).ifPresent(asset -> deleteExistingModelFile(asset, productId));
+        shopProductModelAssetRepository.findByProduct_Id(productId).ifPresent(asset -> {
+            deleteExistingModelFile(asset, productId);
+            shopProductModelAssetRepository.delete(asset);
+        });
+        if (!variants.isEmpty()) {
+            shopProductVariantRepository.deleteAll(variants);
+        }
         shopProductRepository.delete(product);
     }
 
@@ -315,10 +328,18 @@ public class AdminShopProductControllerService {
         product.setDescriptionEn(localizedContent.descriptions().get("en"));
         product.setDescriptionDe(localizedContent.descriptions().get("de"));
         product.setDescriptionFr(localizedContent.descriptions().get("fr"));
-        product.setSeoTitle(normalizeOptional(payload.getSeoTitle()));
+        product.setSeoTitle(localizedContent.defaultSeoTitle());
-        product.setSeoDescription(normalizeOptional(payload.getSeoDescription()));
+        product.setSeoTitleIt(localizedContent.seoTitles().get("it"));
-        product.setOgTitle(normalizeOptional(payload.getOgTitle()));
+        product.setSeoTitleEn(localizedContent.seoTitles().get("en"));
-        product.setOgDescription(normalizeOptional(payload.getOgDescription()));
+        product.setSeoTitleDe(localizedContent.seoTitles().get("de"));
+        product.setSeoTitleFr(localizedContent.seoTitles().get("fr"));
+        product.setSeoDescription(localizedContent.defaultSeoDescription());
+        product.setSeoDescriptionIt(localizedContent.seoDescriptions().get("it"));
+        product.setSeoDescriptionEn(localizedContent.seoDescriptions().get("en"));
+        product.setSeoDescriptionDe(localizedContent.seoDescriptions().get("de"));
+        product.setSeoDescriptionFr(localizedContent.seoDescriptions().get("fr"));
+        product.setOgTitle(localizedContent.defaultSeoTitle());
+        product.setOgDescription(localizedContent.defaultSeoDescription());
         product.setIndexable(payload.getIndexable() == null || payload.getIndexable());
         product.setIsFeatured(Boolean.TRUE.equals(payload.getIsFeatured()));
         product.setIsActive(payload.getIsActive() == null || payload.getIsActive());
@@ -332,6 +353,13 @@ public class AdminShopProductControllerService {
         String normalizedColorName = normalizeRequired(payload.getColorName(), "Variant colorName is required");
         String normalizedVariantLabel = normalizeOptional(payload.getVariantLabel());
         String normalizedSku = normalizeOptional(payload.getSku());
+        String fallbackColorLabel = firstNonBlank(
+                normalizeOptional(payload.getColorLabelIt()),
+                normalizeOptional(payload.getColorLabelEn()),
+                normalizeOptional(payload.getColorLabelDe()),
+                normalizeOptional(payload.getColorLabelFr()),
+                normalizedColorName
+        );
         String normalizedMaterialCode = normalizeRequired(
                 payload.getInternalMaterialCode(),
                 "Variant internalMaterialCode is required"
@@ -359,6 +387,10 @@ public class AdminShopProductControllerService {
         variant.setSku(normalizedSku);
         variant.setVariantLabel(normalizedVariantLabel != null ? normalizedVariantLabel : normalizedColorName);
         variant.setColorName(normalizedColorName);
+        variant.setColorLabelIt(firstNonBlank(normalizeOptional(payload.getColorLabelIt()), fallbackColorLabel));
+        variant.setColorLabelEn(firstNonBlank(normalizeOptional(payload.getColorLabelEn()), fallbackColorLabel));
+        variant.setColorLabelDe(firstNonBlank(normalizeOptional(payload.getColorLabelDe()), fallbackColorLabel));
+        variant.setColorLabelFr(firstNonBlank(normalizeOptional(payload.getColorLabelFr()), fallbackColorLabel));
         variant.setColorHex(normalizeColorHex(payload.getColorHex()));
         variant.setInternalMaterialCode(normalizedMaterialCode);
         variant.setPriceChf(price);
@@ -374,16 +406,23 @@ public class AdminShopProductControllerService {
         }
 
         List<AdminUpsertShopProductVariantRequest> normalized = new ArrayList<>(payloads);
-        Set<String> colorKeys = new LinkedHashSet<>();
+        Set<String> variantKeys = new LinkedHashSet<>();
         int defaultCount = 0;
         for (AdminUpsertShopProductVariantRequest payload : normalized) {
             if (payload == null) {
                 throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Variant payload is required");
             }
             String colorName = normalizeRequired(payload.getColorName(), "Variant colorName is required");
-            String colorKey = colorName.toLowerCase(Locale.ROOT);
+            String materialCode = normalizeRequired(
-            if (!colorKeys.add(colorKey)) {
+                    payload.getInternalMaterialCode(),
-                throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Duplicate variant colorName: " + colorName);
+                    "Variant internalMaterialCode is required"
+            ).toUpperCase(Locale.ROOT);
+            String variantKey = materialCode + "|" + colorName.toLowerCase(Locale.ROOT);
+            if (!variantKeys.add(variantKey)) {
+                throw new ResponseStatusException(
+                        HttpStatus.BAD_REQUEST,
+                        "Duplicate variant combination: " + materialCode + " / " + colorName
+                );
             }
             if (Boolean.TRUE.equals(payload.getIsDefault())) {
                 defaultCount++;
@@ -467,7 +506,15 @@ public class AdminShopProductControllerService {
         dto.setDescriptionDe(product.getDescriptionDe());
         dto.setDescriptionFr(product.getDescriptionFr());
         dto.setSeoTitle(product.getSeoTitle());
+        dto.setSeoTitleIt(product.getSeoTitleIt());
+        dto.setSeoTitleEn(product.getSeoTitleEn());
+        dto.setSeoTitleDe(product.getSeoTitleDe());
+        dto.setSeoTitleFr(product.getSeoTitleFr());
         dto.setSeoDescription(product.getSeoDescription());
+        dto.setSeoDescriptionIt(product.getSeoDescriptionIt());
+        dto.setSeoDescriptionEn(product.getSeoDescriptionEn());
+        dto.setSeoDescriptionDe(product.getSeoDescriptionDe());
+        dto.setSeoDescriptionFr(product.getSeoDescriptionFr());
         dto.setOgTitle(product.getOgTitle());
         dto.setOgDescription(product.getOgDescription());
         dto.setIndexable(product.getIndexable());
@@ -495,6 +542,10 @@ public class AdminShopProductControllerService {
         dto.setSku(variant.getSku());
         dto.setVariantLabel(variant.getVariantLabel());
         dto.setColorName(variant.getColorName());
+        dto.setColorLabelIt(variant.getColorLabelIt());
+        dto.setColorLabelEn(variant.getColorLabelEn());
+        dto.setColorLabelDe(variant.getColorLabelDe());
+        dto.setColorLabelFr(variant.getColorLabelFr());
         dto.setColorHex(variant.getColorHex());
         dto.setInternalMaterialCode(variant.getInternalMaterialCode());
         dto.setPriceChf(variant.getPriceChf());
@@ -584,25 +635,55 @@ public class AdminShopProductControllerService {
         excerpts.put("fr", firstNonBlank(normalizeOptional(payload.getExcerptFr()), fallbackExcerpt));
 
         String fallbackDescription = firstNonBlank(
-                normalizeOptional(payload.getDescription()),
+                normalizeRichTextOptional(payload.getDescription()),
-                normalizeOptional(payload.getDescriptionIt()),
+                normalizeRichTextOptional(payload.getDescriptionIt()),
-                normalizeOptional(payload.getDescriptionEn()),
+                normalizeRichTextOptional(payload.getDescriptionEn()),
-                normalizeOptional(payload.getDescriptionDe()),
+                normalizeRichTextOptional(payload.getDescriptionDe()),
-                normalizeOptional(payload.getDescriptionFr())
+                normalizeRichTextOptional(payload.getDescriptionFr())
         );
         Map<String, String> descriptions = new LinkedHashMap<>();
-        descriptions.put("it", firstNonBlank(normalizeOptional(payload.getDescriptionIt()), fallbackDescription));
+        descriptions.put("it", firstNonBlank(normalizeRichTextOptional(payload.getDescriptionIt()), fallbackDescription));
-        descriptions.put("en", firstNonBlank(normalizeOptional(payload.getDescriptionEn()), fallbackDescription));
+        descriptions.put("en", firstNonBlank(normalizeRichTextOptional(payload.getDescriptionEn()), fallbackDescription));
-        descriptions.put("de", firstNonBlank(normalizeOptional(payload.getDescriptionDe()), fallbackDescription));
+        descriptions.put("de", firstNonBlank(normalizeRichTextOptional(payload.getDescriptionDe()), fallbackDescription));
-        descriptions.put("fr", firstNonBlank(normalizeOptional(payload.getDescriptionFr()), fallbackDescription));
+        descriptions.put("fr", firstNonBlank(normalizeRichTextOptional(payload.getDescriptionFr()), fallbackDescription));
+
+        String fallbackSeoTitle = firstNonBlank(
+                normalizeOptional(payload.getSeoTitle()),
+                normalizeOptional(payload.getSeoTitleIt()),
+                normalizeOptional(payload.getSeoTitleEn()),
+                normalizeOptional(payload.getSeoTitleDe()),
+                normalizeOptional(payload.getSeoTitleFr())
+        );
+        Map<String, String> seoTitles = new LinkedHashMap<>();
+        seoTitles.put("it", firstNonBlank(normalizeOptional(payload.getSeoTitleIt()), fallbackSeoTitle));
+        seoTitles.put("en", firstNonBlank(normalizeOptional(payload.getSeoTitleEn()), fallbackSeoTitle));
+        seoTitles.put("de", firstNonBlank(normalizeOptional(payload.getSeoTitleDe()), fallbackSeoTitle));
+        seoTitles.put("fr", firstNonBlank(normalizeOptional(payload.getSeoTitleFr()), fallbackSeoTitle));
+
+        String fallbackSeoDescription = firstNonBlank(
+                normalizeOptional(payload.getSeoDescription()),
+                normalizeOptional(payload.getSeoDescriptionIt()),
+                normalizeOptional(payload.getSeoDescriptionEn()),
+                normalizeOptional(payload.getSeoDescriptionDe()),
+                normalizeOptional(payload.getSeoDescriptionFr())
+        );
+        Map<String, String> seoDescriptions = new LinkedHashMap<>();
+        seoDescriptions.put("it", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionIt()), fallbackSeoDescription), "Italian"));
+        seoDescriptions.put("en", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionEn()), fallbackSeoDescription), "English"));
+        seoDescriptions.put("de", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionDe()), fallbackSeoDescription), "German"));
+        seoDescriptions.put("fr", validateSeoDescriptionLength(firstNonBlank(normalizeOptional(payload.getSeoDescriptionFr()), fallbackSeoDescription), "French"));
 
         return new LocalizedProductContent(
                 names.get("it"),
                 firstNonBlank(excerpts.get("it"), fallbackExcerpt),
                 firstNonBlank(descriptions.get("it"), fallbackDescription),
+                firstNonBlank(seoTitles.get("it"), fallbackSeoTitle),
+                firstNonBlank(seoDescriptions.get("it"), fallbackSeoDescription),
                 names,
                 excerpts,
-                descriptions
+                descriptions,
+                seoTitles,
+                seoDescriptions
         );
     }
 
@@ -630,6 +711,27 @@ public class AdminShopProductControllerService {
         return normalized.isBlank() ? null : normalized;
     }
 
+    private String normalizeRichTextOptional(String value) {
+        String normalized = normalizeOptional(value);
+        if (normalized == null) {
+            return null;
+        }
+
+        String sanitized = Jsoup.clean(
+                normalized,
+                "",
+                PRODUCT_DESCRIPTION_SAFELIST,
+                new Document.OutputSettings().prettyPrint(false)
+        ).trim();
+
+        if (sanitized.isBlank()) {
+            return null;
+        }
+
+        String plainText = Jsoup.parse(sanitized).text();
+        return plainText != null && !plainText.trim().isEmpty() ? sanitized : null;
+    }
+
     private String firstNonBlank(String... values) {
         if (values == null) {
             return null;
@@ -670,6 +772,13 @@ public class AdminShopProductControllerService {
         return normalized.toUpperCase(Locale.ROOT);
     }
 
+    private String validateSeoDescriptionLength(String value, String languageLabel) {
+        if (value != null && value.length() > 160) {
+            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, languageLabel + " SEO description must be at most 160 characters");
+        }
+        return value;
+    }
+
     private void validateModelUpload(MultipartFile file) {
         if (file == null || file.isEmpty()) {
             throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "3D model file is required");
@@ -786,9 +895,13 @@ public class AdminShopProductControllerService {
             String defaultName,
             String defaultExcerpt,
             String defaultDescription,
+            String defaultSeoTitle,
+            String defaultSeoDescription,
             Map<String, String> names,
             Map<String, String> excerpts,
-            Map<String, String> descriptions
+            Map<String, String> descriptions,
+            Map<String, String> seoTitles,
+            Map<String, String> seoDescriptions
     ) {
     }
 }

backend/src/main/java/com/printcalculator/service/admin/AdminShopProductTranslationService.java

@@ -0,0 +1,685 @@
+package com.printcalculator.service.admin;
+
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import com.printcalculator.dto.AdminTranslateShopProductRequest;
+import com.printcalculator.dto.AdminTranslateShopProductResponse;
+import com.printcalculator.entity.ShopCategory;
+import com.printcalculator.repository.ShopCategoryRepository;
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Document;
+import org.jsoup.safety.Safelist;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.HttpStatus;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.server.ResponseStatusException;
+
+import java.io.IOException;
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.time.Duration;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.UUID;
+
+@Service
+@Transactional(readOnly = true)
+public class AdminShopProductTranslationService {
+    private static final List<String> SUPPORTED_LANGUAGES = List.of("it", "en", "de", "fr");
+    private static final Safelist PRODUCT_DESCRIPTION_SAFELIST = Safelist.none()
+            .addTags("p", "div", "br", "strong", "b", "em", "i", "u", "ul", "ol", "li", "a")
+            .addAttributes("a", "href")
+            .addProtocols("a", "href", "http", "https", "mailto", "tel");
+    private static final String DEFAULT_SHOP_CONTEXT = """
+            3D fab is a Swiss-based 3D printing shop and technical service.
+            The tone must be practical, clear, technical, and trustworthy.
+            Avoid hype, avoid invented claims, and avoid vague marketing filler.
+            Preserve all brand names, measurements, materials, SKUs, codes, and technical terminology exactly when they should not be translated.
+            When the source field is empty, return an empty string rather than inventing content.
+            For descriptions, preserve safe HTML structure when present and keep output ready for an ecommerce/admin form.
+            For SEO, prefer concise, natural phrases suitable for ecommerce and search snippets.
+            """;
+
+    private final ShopCategoryRepository shopCategoryRepository;
+    private final ObjectMapper objectMapper;
+    private final HttpClient httpClient;
+    private final String apiKey;
+    private final String baseUrl;
+    private final String model;
+    private final Duration timeout;
+    private final String promptCacheKeyPrefix;
+    private final String additionalBusinessContext;
+
+    public AdminShopProductTranslationService(ShopCategoryRepository shopCategoryRepository,
+                                              ObjectMapper objectMapper,
+                                              @Value("${openai.translation.api-key:}") String apiKey,
+                                              @Value("${openai.translation.base-url:https://api.openai.com/v1}") String baseUrl,
+                                              @Value("${openai.translation.model:gpt-5.4}") String model,
+                                              @Value("${openai.translation.timeout-seconds:45}") long timeoutSeconds,
+                                              @Value("${openai.translation.prompt-cache-key-prefix:printcalc-shop-product-translation-v1}") String promptCacheKeyPrefix,
+                                              @Value("${openai.translation.business-context:}") String additionalBusinessContext) {
+        this.shopCategoryRepository = shopCategoryRepository;
+        this.objectMapper = objectMapper;
+        this.apiKey = apiKey != null ? apiKey.trim() : "";
+        this.baseUrl = normalizeBaseUrl(baseUrl);
+        this.model = model != null ? model.trim() : "";
+        this.timeout = Duration.ofSeconds(Math.max(timeoutSeconds, 5));
+        this.promptCacheKeyPrefix = promptCacheKeyPrefix != null && !promptCacheKeyPrefix.isBlank()
+                ? promptCacheKeyPrefix.trim()
+                : "printcalc-shop-product-translation-v1";
+        this.additionalBusinessContext = additionalBusinessContext != null ? additionalBusinessContext.trim() : "";
+        this.httpClient = HttpClient.newBuilder()
+                .connectTimeout(this.timeout)
+                .build();
+    }
+
+    public AdminTranslateShopProductResponse translateProduct(AdminTranslateShopProductRequest payload) {
+        ensureConfigured();
+        NormalizedTranslationRequest normalizedRequest = normalizeRequest(payload);
+        List<String> targetLanguages = resolveTargetLanguages(normalizedRequest);
+        if (targetLanguages.isEmpty()) {
+            return emptyResponse(normalizedRequest.sourceLanguage());
+        }
+
+        CategoryContext categoryContext = loadCategoryContext(normalizedRequest.categoryId());
+        String businessContext = buildBusinessContext(categoryContext, normalizedRequest.materialCodes());
+
+        TranslationBundle generated = callOpenAiFunction(
+                "generate_product_translations",
+                "Generate translated product copy for the requested target languages.",
+                buildInstructions("Generate the first-pass translations.", businessContext),
+                buildGenerationInput(normalizedRequest, targetLanguages, categoryContext),
+                buildTranslationToolSchema(targetLanguages),
+                "generate"
+        );
+
+        TranslationBundle normalizedGenerated = sanitizeBundle(generated, targetLanguages);
+        List<String> validationNotes = buildValidationNotes(normalizedGenerated, targetLanguages);
+
+        TranslationBundle reviewed = callOpenAiFunction(
+                "review_product_translations",
+                "Review and correct translated product copy while preserving meaning, SEO limits, and technical terminology.",
+                buildInstructions("Review and correct the generated translations.", businessContext),
+                buildReviewInput(normalizedRequest, normalizedGenerated, targetLanguages, categoryContext, validationNotes),
+                buildTranslationToolSchema(targetLanguages),
+                "review"
+        );
+
+        TranslationBundle finalBundle = sanitizeBundle(reviewed, targetLanguages);
+        ensureRequiredTranslations(finalBundle, targetLanguages);
+        return toResponse(normalizedRequest.sourceLanguage(), targetLanguages, finalBundle);
+    }
+
+    private void ensureConfigured() {
+        if (apiKey.isBlank() || model.isBlank()) {
+            throw new ResponseStatusException(
+                    HttpStatus.SERVICE_UNAVAILABLE,
+                    "OpenAI translation is not configured on the backend"
+            );
+        }
+    }
+
+    private NormalizedTranslationRequest normalizeRequest(AdminTranslateShopProductRequest payload) {
+        if (payload == null) {
+            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Translation payload is required");
+        }
+
+        String sourceLanguage = normalizeLanguage(payload.getSourceLanguage());
+        if (!SUPPORTED_LANGUAGES.contains(sourceLanguage)) {
+            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Unsupported source language");
+        }
+
+        Map<String, String> names = normalizeLocalizedMap(payload.getNames(), false);
+        Map<String, String> excerpts = normalizeLocalizedMap(payload.getExcerpts(), false);
+        Map<String, String> descriptions = normalizeLocalizedMap(payload.getDescriptions(), true);
+        Map<String, String> seoTitles = normalizeLocalizedMap(payload.getSeoTitles(), false);
+        Map<String, String> seoDescriptions = normalizeLocalizedMap(payload.getSeoDescriptions(), false);
+
+        if (names.get(sourceLanguage).isBlank()) {
+            throw new ResponseStatusException(
+                    HttpStatus.BAD_REQUEST,
+                    "The active source language must have a product name before translation"
+            );
+        }
+
+        Set<String> materialCodes = new LinkedHashSet<>();
+        if (payload.getMaterialCodes() != null) {
+            for (String materialCode : payload.getMaterialCodes()) {
+                String normalizedCode = normalizeOptional(materialCode);
+                if (normalizedCode != null) {
+                    materialCodes.add(normalizedCode.toUpperCase(Locale.ROOT));
+                }
+            }
+        }
+
+        return new NormalizedTranslationRequest(
+                payload.getCategoryId(),
+                sourceLanguage,
+                Boolean.TRUE.equals(payload.getOverwriteExisting()),
+                List.copyOf(materialCodes),
+                names,
+                excerpts,
+                descriptions,
+                seoTitles,
+                seoDescriptions
+        );
+    }
+
+    private List<String> resolveTargetLanguages(NormalizedTranslationRequest request) {
+        List<String> targetLanguages = new ArrayList<>();
+        for (String language : SUPPORTED_LANGUAGES) {
+            if (language.equals(request.sourceLanguage())) {
+                continue;
+            }
+            if (request.overwriteExisting() || needsTranslation(request, language)) {
+                targetLanguages.add(language);
+            }
+        }
+        return targetLanguages;
+    }
+
+    private boolean needsTranslation(NormalizedTranslationRequest request, String language) {
+        return request.names().get(language).isBlank()
+                || request.excerpts().get(language).isBlank()
+                || normalizeRichTextOptional(request.descriptions().get(language)) == null
+                || request.seoTitles().get(language).isBlank()
+                || request.seoDescriptions().get(language).isBlank();
+    }
+
+    private CategoryContext loadCategoryContext(UUID categoryId) {
+        if (categoryId == null) {
+            return null;
+        }
+        ShopCategory category = shopCategoryRepository.findById(categoryId).orElse(null);
+        if (category == null) {
+            return null;
+        }
+        return new CategoryContext(
+                category.getSlug(),
+                Map.of(
+                        "it", safeValue(category.getNameIt()),
+                        "en", safeValue(category.getNameEn()),
+                        "de", safeValue(category.getNameDe()),
+                        "fr", safeValue(category.getNameFr())
+                ),
+                Map.of(
+                        "it", safeValue(category.getDescriptionIt()),
+                        "en", safeValue(category.getDescriptionEn()),
+                        "de", safeValue(category.getDescriptionDe()),
+                        "fr", safeValue(category.getDescriptionFr())
+                )
+        );
+    }
+
+    private String buildBusinessContext(CategoryContext categoryContext, List<String> materialCodes) {
+        StringBuilder context = new StringBuilder(DEFAULT_SHOP_CONTEXT);
+        if (!additionalBusinessContext.isBlank()) {
+            context.append('\n').append(additionalBusinessContext.trim());
+        }
+        if (categoryContext != null) {
+            context.append("\nCategory slug: ").append(categoryContext.slug());
+            context.append("\nCategory names: ").append(writeJson(categoryContext.names()));
+            if (categoryContext.descriptions().values().stream().anyMatch(value -> !value.isBlank())) {
+                context.append("\nCategory descriptions: ").append(writeJson(categoryContext.descriptions()));
+            }
+        }
+        if (materialCodes != null && !materialCodes.isEmpty()) {
+            context.append("\nMaterial codes present in the product: ").append(String.join(", ", materialCodes));
+        }
+        return context.toString();
+    }
+
+    private String buildInstructions(String task, String businessContext) {
+        return """
+                You are a senior ecommerce localization editor.
+                Task: %s
+                Return only the function call arguments that match the provided schema.
+                Always preserve meaning, HTML safety, and technical precision.
+                Never invent specifications or marketing claims not present in the source.
+                If a source field is empty, return an empty string for that field.
+                General context:
+                %s
+                """.formatted(task, businessContext);
+    }
+
+    private String buildGenerationInput(NormalizedTranslationRequest request,
+                                        List<String> targetLanguages,
+                                        CategoryContext categoryContext) {
+        ObjectNode input = objectMapper.createObjectNode();
+        input.put("sourceLanguage", request.sourceLanguage());
+        input.set("targetLanguages", objectMapper.valueToTree(targetLanguages));
+        input.put("overwriteExisting", request.overwriteExisting());
+        input.set("source", localizedFieldNode(request, request.sourceLanguage()));
+        input.set("existingTranslations", existingTranslationsNode(request, targetLanguages));
+        input.set("materialCodes", objectMapper.valueToTree(request.materialCodes()));
+        if (categoryContext != null) {
+            input.put("categorySlug", categoryContext.slug());
+            input.set("categoryNames", objectMapper.valueToTree(categoryContext.names()));
+        }
+        return writeJson(input);
+    }
+
+    private String buildReviewInput(NormalizedTranslationRequest request,
+                                    TranslationBundle generated,
+                                    List<String> targetLanguages,
+                                    CategoryContext categoryContext,
+                                    List<String> validationNotes) {
+        ObjectNode input = objectMapper.createObjectNode();
+        input.put("sourceLanguage", request.sourceLanguage());
+        input.set("targetLanguages", objectMapper.valueToTree(targetLanguages));
+        input.set("source", localizedFieldNode(request, request.sourceLanguage()));
+        input.set("generatedTranslations", generated.toJsonNode(objectMapper));
+        input.set("validationNotes", objectMapper.valueToTree(validationNotes));
+        input.set("materialCodes", objectMapper.valueToTree(request.materialCodes()));
+        if (categoryContext != null) {
+            input.put("categorySlug", categoryContext.slug());
+            input.set("categoryNames", objectMapper.valueToTree(categoryContext.names()));
+        }
+        return writeJson(input);
+    }
+
+    private ObjectNode localizedFieldNode(NormalizedTranslationRequest request, String language) {
+        ObjectNode node = objectMapper.createObjectNode();
+        node.put("name", request.names().get(language));
+        node.put("excerpt", request.excerpts().get(language));
+        node.put("description", request.descriptions().get(language));
+        node.put("seoTitle", request.seoTitles().get(language));
+        node.put("seoDescription", request.seoDescriptions().get(language));
+        return node;
+    }
+
+    private ObjectNode existingTranslationsNode(NormalizedTranslationRequest request, List<String> targetLanguages) {
+        ObjectNode node = objectMapper.createObjectNode();
+        for (String language : targetLanguages) {
+            node.set(language, localizedFieldNode(request, language));
+        }
+        return node;
+    }
+
+    private ObjectNode buildTranslationToolSchema(List<String> targetLanguages) {
+        ObjectNode root = objectMapper.createObjectNode();
+        root.put("type", "object");
+        root.put("additionalProperties", false);
+
+        ObjectNode properties = root.putObject("properties");
+        ObjectNode translations = properties.putObject("translations");
+        translations.put("type", "object");
+        translations.put("additionalProperties", false);
+
+        ObjectNode translationProperties = translations.putObject("properties");
+        ArrayNode requiredTranslations = translations.putArray("required");
+        for (String language : targetLanguages) {
+            translationProperties.set(language, buildTranslationSchemaForLanguage(language));
+            requiredTranslations.add(language);
+        }
+
+        ArrayNode required = root.putArray("required");
+        required.add("translations");
+        return root;
+    }
+
+    private ObjectNode buildTranslationSchemaForLanguage(String language) {
+        ObjectNode languageSchema = objectMapper.createObjectNode();
+        languageSchema.put("type", "object");
+        languageSchema.put("additionalProperties", false);
+        languageSchema.put("description", "Localized product copy for language " + language);
+
+        ObjectNode properties = languageSchema.putObject("properties");
+        addSchemaString(properties, "name", "Translated product name. Never empty.");
+        addSchemaString(properties, "excerpt", "Short excerpt. Empty string if source excerpt is empty.");
+        addSchemaString(properties, "description", "Product description as safe HTML or empty string if source description is empty.");
+        addSchemaString(properties, "seoTitle", "SEO title. Empty string if source SEO title is empty.");
+        addSchemaString(properties, "seoDescription", "SEO description, ideally under 160 characters. Empty string if source SEO description is empty.");
+
+        ArrayNode required = languageSchema.putArray("required");
+        required.add("name");
+        required.add("excerpt");
+        required.add("description");
+        required.add("seoTitle");
+        required.add("seoDescription");
+        return languageSchema;
+    }
+
+    private void addSchemaString(ObjectNode properties, String name, String description) {
+        ObjectNode property = properties.putObject(name);
+        property.put("type", "string");
+        property.put("description", description);
+    }
+
+    private TranslationBundle callOpenAiFunction(String functionName,
+                                                 String functionDescription,
+                                                 String instructions,
+                                                 String input,
+                                                 ObjectNode parametersSchema,
+                                                 String cacheSuffix) {
+        ObjectNode requestPayload = objectMapper.createObjectNode();
+        requestPayload.put("model", model);
+        requestPayload.put("instructions", instructions);
+        requestPayload.put("input", input);
+        requestPayload.put("tool_choice", "required");
+        requestPayload.put("temperature", 0.2);
+        requestPayload.put("store", false);
+        requestPayload.put("prompt_cache_key", promptCacheKeyPrefix + ":" + cacheSuffix);
+
+        ArrayNode tools = requestPayload.putArray("tools");
+        ObjectNode tool = tools.addObject();
+        tool.put("type", "function");
+        tool.put("name", functionName);
+        tool.put("description", functionDescription);
+        tool.put("strict", true);
+        tool.set("parameters", parametersSchema);
+
+        JsonNode responseNode = postResponsesRequest(requestPayload);
+        JsonNode output = responseNode.path("output");
+        if (output.isArray()) {
+            for (JsonNode item : output) {
+                if ("function_call".equals(item.path("type").asText())) {
+                    String arguments = item.path("arguments").asText("");
+                    if (arguments.isBlank()) {
+                        break;
+                    }
+                    try {
+                        JsonNode argumentsNode = objectMapper.readTree(arguments);
+                        JsonNode translationsNode = argumentsNode.path("translations");
+                        if (!translationsNode.isObject()) {
+                            throw new ResponseStatusException(
+                                    HttpStatus.BAD_GATEWAY,
+                                    "OpenAI returned a function call without translations"
+                            );
+                        }
+                        return TranslationBundle.fromJson(translationsNode);
+                    } catch (JsonProcessingException exception) {
+                        throw new ResponseStatusException(
+                                HttpStatus.BAD_GATEWAY,
+                                "OpenAI returned invalid JSON arguments",
+                                exception
+                        );
+                    }
+                }
+            }
+        }
+
+        throw new ResponseStatusException(
+                HttpStatus.BAD_GATEWAY,
+                "OpenAI did not return the expected function call"
+        );
+    }
+
+    private JsonNode postResponsesRequest(ObjectNode requestPayload) {
+        HttpRequest request = HttpRequest.newBuilder()
+                .uri(URI.create(baseUrl + "/responses"))
+                .timeout(timeout)
+                .header("Authorization", "Bearer " + apiKey)
+                .header("Content-Type", "application/json")
+                .POST(HttpRequest.BodyPublishers.ofString(writeJson(requestPayload)))
+                .build();
+
+        try {
+            HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
+            JsonNode body = readJson(response.body());
+            if (response.statusCode() >= 400) {
+                String message = body.path("error").path("message").asText("").trim();
+                throw new ResponseStatusException(
+                        HttpStatus.BAD_GATEWAY,
+                        message.isBlank() ? "OpenAI translation request failed" : message
+                );
+            }
+            return body;
+        } catch (IOException exception) {
+            throw new ResponseStatusException(
+                    HttpStatus.BAD_GATEWAY,
+                    "Unable to read the OpenAI translation response",
+                    exception
+            );
+        } catch (InterruptedException exception) {
+            Thread.currentThread().interrupt();
+            throw new ResponseStatusException(
+                    HttpStatus.BAD_GATEWAY,
+                    "The OpenAI translation request was interrupted",
+                    exception
+            );
+        }
+    }
+
+    private List<String> buildValidationNotes(TranslationBundle bundle, List<String> targetLanguages) {
+        List<String> notes = new ArrayList<>();
+        for (String language : targetLanguages) {
+            if (bundle.names().getOrDefault(language, "").isBlank()) {
+                notes.add(language + ": translated name is empty and must be fixed");
+            }
+            String seoDescription = bundle.seoDescriptions().getOrDefault(language, "");
+            if (seoDescription.length() > 160) {
+                notes.add(language + ": seoDescription exceeds 160 characters and must be shortened");
+            }
+            String description = bundle.descriptions().getOrDefault(language, "");
+            if (!description.isBlank() && normalizeRichTextOptional(description) == null) {
+                notes.add(language + ": description lost meaningful text during sanitization");
+            }
+        }
+        if (notes.isEmpty()) {
+            notes.add("No structural validation issues were found. Review naturalness, terminology, SEO clarity, and consistency.");
+        }
+        return notes;
+    }
+
+    private TranslationBundle sanitizeBundle(TranslationBundle bundle, List<String> targetLanguages) {
+        Map<String, String> names = new LinkedHashMap<>();
+        Map<String, String> excerpts = new LinkedHashMap<>();
+        Map<String, String> descriptions = new LinkedHashMap<>();
+        Map<String, String> seoTitles = new LinkedHashMap<>();
+        Map<String, String> seoDescriptions = new LinkedHashMap<>();
+
+        for (String language : targetLanguages) {
+            names.put(language, safeValue(bundle.names().get(language)));
+            excerpts.put(language, safeValue(bundle.excerpts().get(language)));
+            descriptions.put(language, safeDescription(bundle.descriptions().get(language)));
+            seoTitles.put(language, safeValue(bundle.seoTitles().get(language)));
+            seoDescriptions.put(language, limitSeoDescription(safeValue(bundle.seoDescriptions().get(language))));
+        }
+
+        return new TranslationBundle(names, excerpts, descriptions, seoTitles, seoDescriptions);
+    }
+
+    private void ensureRequiredTranslations(TranslationBundle bundle, List<String> targetLanguages) {
+        for (String language : targetLanguages) {
+            if (bundle.names().getOrDefault(language, "").isBlank()) {
+                throw new ResponseStatusException(
+                        HttpStatus.BAD_GATEWAY,
+                        "OpenAI did not return a valid translated name for " + language.toUpperCase(Locale.ROOT)
+                );
+            }
+        }
+    }
+
+    private AdminTranslateShopProductResponse toResponse(String sourceLanguage,
+                                                         List<String> targetLanguages,
+                                                         TranslationBundle bundle) {
+        AdminTranslateShopProductResponse response = new AdminTranslateShopProductResponse();
+        response.setSourceLanguage(sourceLanguage);
+        response.setTargetLanguages(targetLanguages);
+        response.setNames(bundle.names());
+        response.setExcerpts(bundle.excerpts());
+        response.setDescriptions(bundle.descriptions());
+        response.setSeoTitles(bundle.seoTitles());
+        response.setSeoDescriptions(bundle.seoDescriptions());
+        return response;
+    }
+
+    private AdminTranslateShopProductResponse emptyResponse(String sourceLanguage) {
+        AdminTranslateShopProductResponse response = new AdminTranslateShopProductResponse();
+        response.setSourceLanguage(sourceLanguage);
+        response.setTargetLanguages(List.of());
+        response.setNames(Map.of());
+        response.setExcerpts(Map.of());
+        response.setDescriptions(Map.of());
+        response.setSeoTitles(Map.of());
+        response.setSeoDescriptions(Map.of());
+        return response;
+    }
+
+    private Map<String, String> normalizeLocalizedMap(Map<String, String> rawValues, boolean richText) {
+        Map<String, String> normalized = new LinkedHashMap<>();
+        for (String language : SUPPORTED_LANGUAGES) {
+            String value = rawValues != null ? rawValues.get(language) : null;
+            if (richText) {
+                normalized.put(language, normalizeRichTextOptional(value) != null ? normalizeRichTextOptional(value) : "");
+            } else {
+                normalized.put(language, safeValue(value));
+            }
+        }
+        return normalized;
+    }
+
+    private String safeValue(String value) {
+        return value == null ? "" : value.trim();
+    }
+
+    private String safeDescription(String value) {
+        String normalized = normalizeRichTextOptional(value);
+        return normalized != null ? normalized : "";
+    }
+
+    private String limitSeoDescription(String value) {
+        String normalized = safeValue(value);
+        if (normalized.length() <= 160) {
+            return normalized;
+        }
+        int lastSpace = normalized.lastIndexOf(' ', 157);
+        if (lastSpace >= 120) {
+            return normalized.substring(0, lastSpace).trim();
+        }
+        return normalized.substring(0, 160).trim();
+    }
+
+    private String normalizeOptional(String value) {
+        if (value == null) {
+            return null;
+        }
+        String normalized = value.trim();
+        return normalized.isBlank() ? null : normalized;
+    }
+
+    private String normalizeLanguage(String language) {
+        if (language == null) {
+            return "";
+        }
+        String normalized = language.trim().toLowerCase(Locale.ROOT);
+        int separatorIndex = normalized.indexOf('-');
+        if (separatorIndex > 0) {
+            normalized = normalized.substring(0, separatorIndex);
+        }
+        return normalized;
+    }
+
+    private String normalizeRichTextOptional(String value) {
+        String normalized = normalizeOptional(value);
+        if (normalized == null) {
+            return null;
+        }
+
+        String sanitized = Jsoup.clean(
+                normalized,
+                "",
+                PRODUCT_DESCRIPTION_SAFELIST,
+                new Document.OutputSettings().prettyPrint(false)
+        ).trim();
+        if (sanitized.isBlank()) {
+            return null;
+        }
+
+        String plainText = Jsoup.parse(sanitized).text();
+        return plainText != null && !plainText.trim().isEmpty() ? sanitized : null;
+    }
+
+    private String normalizeBaseUrl(String rawBaseUrl) {
+        String normalized = rawBaseUrl != null && !rawBaseUrl.isBlank()
+                ? rawBaseUrl.trim()
+                : "https://api.openai.com/v1";
+        while (normalized.endsWith("/")) {
+            normalized = normalized.substring(0, normalized.length() - 1);
+        }
+        return normalized;
+    }
+
+    private String writeJson(Object value) {
+        try {
+            return objectMapper.writeValueAsString(value);
+        } catch (JsonProcessingException exception) {
+            throw new ResponseStatusException(
+                    HttpStatus.INTERNAL_SERVER_ERROR,
+                    "Unable to serialize translation payload",
+                    exception
+            );
+        }
+    }
+
+    private JsonNode readJson(String rawJson) throws IOException {
+        return objectMapper.readTree(rawJson);
+    }
+
+    private record NormalizedTranslationRequest(UUID categoryId,
+                                                String sourceLanguage,
+                                                boolean overwriteExisting,
+                                                List<String> materialCodes,
+                                                Map<String, String> names,
+                                                Map<String, String> excerpts,
+                                                Map<String, String> descriptions,
+                                                Map<String, String> seoTitles,
+                                                Map<String, String> seoDescriptions) {
+    }
+
+    private record CategoryContext(String slug,
+                                   Map<String, String> names,
+                                   Map<String, String> descriptions) {
+    }
+
+    private record TranslationBundle(Map<String, String> names,
+                                     Map<String, String> excerpts,
+                                     Map<String, String> descriptions,
+                                     Map<String, String> seoTitles,
+                                     Map<String, String> seoDescriptions) {
+        static TranslationBundle fromJson(JsonNode translationsNode) {
+            Map<String, String> names = new LinkedHashMap<>();
+            Map<String, String> excerpts = new LinkedHashMap<>();
+            Map<String, String> descriptions = new LinkedHashMap<>();
+            Map<String, String> seoTitles = new LinkedHashMap<>();
+            Map<String, String> seoDescriptions = new LinkedHashMap<>();
+
+            translationsNode.fieldNames().forEachRemaining(language -> {
+                JsonNode localizedNode = translationsNode.path(language);
+                names.put(language, localizedNode.path("name").asText(""));
+                excerpts.put(language, localizedNode.path("excerpt").asText(""));
+                descriptions.put(language, localizedNode.path("description").asText(""));
+                seoTitles.put(language, localizedNode.path("seoTitle").asText(""));
+                seoDescriptions.put(language, localizedNode.path("seoDescription").asText(""));
+            });
+
+            return new TranslationBundle(names, excerpts, descriptions, seoTitles, seoDescriptions);
+        }
+
+        ObjectNode toJsonNode(ObjectMapper objectMapper) {
+            ObjectNode root = objectMapper.createObjectNode();
+            ObjectNode translations = root.putObject("translations");
+            for (String language : names.keySet()) {
+                ObjectNode languageNode = translations.putObject(language);
+                languageNode.put("name", names.getOrDefault(language, ""));
+                languageNode.put("excerpt", excerpts.getOrDefault(language, ""));
+                languageNode.put("description", descriptions.getOrDefault(language, ""));
+                languageNode.put("seoTitle", seoTitles.getOrDefault(language, ""));
+                languageNode.put("seoDescription", seoDescriptions.getOrDefault(language, ""));
+            }
+            return root;
+        }
+    }
+}

backend/src/main/java/com/printcalculator/service/media/MediaFfmpegService.java

@@ -29,13 +29,18 @@ public class MediaFfmpegService {
             "WEBP", List.of("libwebp", "webp"),
             "AVIF", List.of("libaom-av1", "librav1e", "libsvtav1")
     );
+    private static final Map<String, List<String>> REQUIRED_MUXERS = Map.of(
+            "AVIF", List.of("avif")
+    );
 
     private final String ffmpegExecutable;
     private final Set<String> availableEncoders;
+    private final Set<String> availableMuxers;
 
     public MediaFfmpegService(@Value("${media.ffmpeg.path:ffmpeg}") String ffmpegPath) {
         this.ffmpegExecutable = resolveExecutable(ffmpegPath);
         this.availableEncoders = Collections.unmodifiableSet(loadAvailableEncoders());
+        this.availableMuxers = Collections.unmodifiableSet(loadAvailableMuxers());
     }
 
     public void generateVariant(Path source, Path target, int widthPx, int heightPx, String format) throws IOException {
@@ -47,9 +52,13 @@ public class MediaFfmpegService {
         Path targetPath = sanitizeMediaPath(target, "target", false);
         Files.createDirectories(targetPath.getParent());
 
-        String encoder = resolveEncoder(format);
+        String normalizedFormat = normalizeFormat(format);
+        String encoder = resolveEncoder(normalizedFormat);
         if (encoder == null) {
-            throw new IOException("FFmpeg encoder not available for media format " + format + ".");
+            throw new IOException("FFmpeg encoder not available for media format " + normalizedFormat + ".");
+        }
+        if (!hasRequiredMuxer(normalizedFormat)) {
+            throw new IOException("FFmpeg muxer not available for media format " + normalizedFormat + ".");
         }
 
         List<String> command = new ArrayList<>();
@@ -66,7 +75,7 @@ public class MediaFfmpegService {
         command.add("1");
         command.add("-an");
 
-        switch (format) {
+        switch (normalizedFormat) {
             case "JPEG" -> {
                 command.add("-c:v");
                 command.add(encoder);
@@ -86,8 +95,10 @@ public class MediaFfmpegService {
                 command.add("30");
                 command.add("-b:v");
                 command.add("0");
+                command.add("-f");
+                command.add("avif");
             }
-            default -> throw new IllegalArgumentException("Unsupported media format: " + format);
+            default -> throw new IllegalArgumentException("Unsupported media format: " + normalizedFormat);
         }
 
         command.add(targetPath.toString());
@@ -112,14 +123,16 @@ public class MediaFfmpegService {
     }
 
     public boolean canEncode(String format) {
-        return resolveEncoder(format) != null;
+        String normalizedFormat = normalizeFormat(format);
+        return resolveEncoder(normalizedFormat) != null && hasRequiredMuxer(normalizedFormat);
     }
 
     private String resolveEncoder(String format) {
-        if (format == null) {
+        String normalizedFormat = normalizeFormat(format);
+        if (normalizedFormat == null) {
             return null;
         }
-        List<String> candidates = ENCODER_CANDIDATES.get(format.trim().toUpperCase(Locale.ROOT));
+        List<String> candidates = ENCODER_CANDIDATES.get(normalizedFormat);
         if (candidates == null) {
             return null;
         }
@@ -129,6 +142,21 @@ public class MediaFfmpegService {
                 .orElse(null);
     }
 
+    private boolean hasRequiredMuxer(String format) {
+        List<String> requiredMuxers = REQUIRED_MUXERS.get(format);
+        if (requiredMuxers == null || requiredMuxers.isEmpty()) {
+            return true;
+        }
+        return requiredMuxers.stream().anyMatch(availableMuxers::contains);
+    }
+
+    private String normalizeFormat(String format) {
+        if (format == null) {
+            return null;
+        }
+        return format.trim().toUpperCase(Locale.ROOT);
+    }
+
     private Set<String> loadAvailableEncoders() {
         List<String> command = List.of(ffmpegExecutable, "-hide_banner", "-encoders");
         try {
@@ -154,6 +182,31 @@ public class MediaFfmpegService {
         }
     }
 
+    private Set<String> loadAvailableMuxers() {
+        List<String> command = List.of(ffmpegExecutable, "-hide_banner", "-muxers");
+        try {
+            Process process = startValidatedProcess(command);
+            String output;
+            try (InputStream processStream = process.getInputStream()) {
+                output = new String(processStream.readAllBytes(), StandardCharsets.UTF_8);
+            }
+
+            int exitCode = process.waitFor();
+            if (exitCode != 0) {
+                logger.warn("Unable to inspect FFmpeg muxers. Falling back to empty muxer list.");
+                return Set.of();
+            }
+            return parseAvailableMuxers(output);
+        } catch (Exception e) {
+            logger.warn(
+                    "Unable to inspect FFmpeg muxers for executable '{}'. Falling back to empty muxer list. {}",
+                    ffmpegExecutable,
+                    e.getMessage()
+            );
+            return Set.of();
+        }
+    }
+
     private Process startValidatedProcess(List<String> command) throws IOException {
         // nosemgrep: java.lang.security.audit.command-injection-process-builder.command-injection-process-builder
         return new ProcessBuilder(List.copyOf(command))
@@ -264,6 +317,26 @@ public class MediaFfmpegService {
         return encoders;
     }
 
+    private Set<String> parseAvailableMuxers(String output) {
+        if (output == null || output.isBlank()) {
+            return Set.of();
+        }
+
+        Set<String> muxers = new LinkedHashSet<>();
+        for (String line : output.split("\\R")) {
+            String trimmed = line.trim();
+            if (trimmed.isBlank() || trimmed.startsWith("--") || trimmed.startsWith("Muxers:")) {
+                continue;
+            }
+            String[] parts = trimmed.split("\\s+", 3);
+            if (parts.length < 2) {
+                continue;
+            }
+            muxers.add(parts[1]);
+        }
+        return muxers;
+    }
+
     private String truncate(String output) {
         if (output == null || output.isBlank()) {
             return "";

backend/src/main/java/com/printcalculator/service/media/MediaStorageService.java

@@ -21,7 +21,7 @@ public class MediaStorageService {
     private final String frontendBaseUrl;
 
     public MediaStorageService(@Value("${media.storage.root:storage_media}") String storageRoot,
-                               @Value("${app.frontend.base-url:${APP_FRONTEND_BASE_URL:http://localhost:8080}}") String frontendBaseUrl) {
+                               @Value("${app.frontend.base-url:${APP_FRONTEND_BASE_URL:http://localhost:8081}}") String frontendBaseUrl) {
         this.normalizedRootLocation = Paths.get(storageRoot).toAbsolutePath().normalize();
         this.originalRootLocation = normalizedRootLocation.resolve("original").normalize();
         this.publicRootLocation = normalizedRootLocation.resolve("public").normalize();
@@ -131,8 +131,11 @@ public class MediaStorageService {
 
     private String buildMediaBaseUrl() {
         String normalized = frontendBaseUrl != null ? frontendBaseUrl.trim() : "";
+        if (normalized.contains("localhost")){
+            return "http://localhost:8081";
+        }
         if (normalized.isBlank()) {
-            normalized = "http://localhost:4200";
+            normalized = "http://localhost:8081";
         }
         if (normalized.endsWith("/")) {
             normalized = normalized.substring(0, normalized.length() - 1);

backend/src/main/java/com/printcalculator/service/order/AdminOrderControllerService.java

@@ -280,11 +280,19 @@ public class AdminOrderControllerService {
             itemDto.setShopProductName(item.getShopProductName());
             itemDto.setShopVariantLabel(item.getShopVariantLabel());
             itemDto.setShopVariantColorName(item.getShopVariantColorName());
+            itemDto.setShopVariantColorLabelIt(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelIt() : null);
+            itemDto.setShopVariantColorLabelEn(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelEn() : null);
+            itemDto.setShopVariantColorLabelDe(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelDe() : null);
+            itemDto.setShopVariantColorLabelFr(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelFr() : null);
             itemDto.setShopVariantColorHex(item.getShopVariantColorHex());
             if (item.getFilamentVariant() != null) {
                 itemDto.setFilamentVariantId(item.getFilamentVariant().getId());
                 itemDto.setFilamentVariantDisplayName(item.getFilamentVariant().getVariantDisplayName());
                 itemDto.setFilamentColorName(item.getFilamentVariant().getColorName());
+                itemDto.setFilamentColorLabelIt(item.getFilamentVariant().getColorLabelIt());
+                itemDto.setFilamentColorLabelEn(item.getFilamentVariant().getColorLabelEn());
+                itemDto.setFilamentColorLabelDe(item.getFilamentVariant().getColorLabelDe());
+                itemDto.setFilamentColorLabelFr(item.getFilamentVariant().getColorLabelFr());
                 itemDto.setFilamentColorHex(item.getFilamentVariant().getColorHex());
             }
             itemDto.setQuality(item.getQuality());

backend/src/main/java/com/printcalculator/service/order/OrderControllerService.java

@@ -334,11 +334,19 @@ public class OrderControllerService {
             itemDto.setShopProductName(item.getShopProductName());
             itemDto.setShopVariantLabel(item.getShopVariantLabel());
             itemDto.setShopVariantColorName(item.getShopVariantColorName());
+            itemDto.setShopVariantColorLabelIt(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelIt() : null);
+            itemDto.setShopVariantColorLabelEn(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelEn() : null);
+            itemDto.setShopVariantColorLabelDe(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelDe() : null);
+            itemDto.setShopVariantColorLabelFr(item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelFr() : null);
             itemDto.setShopVariantColorHex(item.getShopVariantColorHex());
             if (item.getFilamentVariant() != null) {
                 itemDto.setFilamentVariantId(item.getFilamentVariant().getId());
                 itemDto.setFilamentVariantDisplayName(item.getFilamentVariant().getVariantDisplayName());
                 itemDto.setFilamentColorName(item.getFilamentVariant().getColorName());
+                itemDto.setFilamentColorLabelIt(item.getFilamentVariant().getColorLabelIt());
+                itemDto.setFilamentColorLabelEn(item.getFilamentVariant().getColorLabelEn());
+                itemDto.setFilamentColorLabelDe(item.getFilamentVariant().getColorLabelDe());
+                itemDto.setFilamentColorLabelFr(item.getFilamentVariant().getColorLabelFr());
                 itemDto.setFilamentColorHex(item.getFilamentVariant().getColorHex());
             }
             itemDto.setQuality(item.getQuality());

backend/src/main/java/com/printcalculator/service/quote/QuoteSessionResponseAssembler.java

@@ -81,7 +81,15 @@ public class QuoteSessionResponseAssembler {
         dto.put("shopProductName", item.getShopProductName());
         dto.put("shopVariantLabel", item.getShopVariantLabel());
         dto.put("shopVariantColorName", item.getShopVariantColorName());
+        dto.put("shopVariantColorLabelIt", item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelIt() : null);
+        dto.put("shopVariantColorLabelEn", item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelEn() : null);
+        dto.put("shopVariantColorLabelDe", item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelDe() : null);
+        dto.put("shopVariantColorLabelFr", item.getShopProductVariant() != null ? item.getShopProductVariant().getColorLabelFr() : null);
         dto.put("shopVariantColorHex", item.getShopVariantColorHex());
+        dto.put("filamentColorLabelIt", item.getFilamentVariant() != null ? item.getFilamentVariant().getColorLabelIt() : null);
+        dto.put("filamentColorLabelEn", item.getFilamentVariant() != null ? item.getFilamentVariant().getColorLabelEn() : null);
+        dto.put("filamentColorLabelDe", item.getFilamentVariant() != null ? item.getFilamentVariant().getColorLabelDe() : null);
+        dto.put("filamentColorLabelFr", item.getFilamentVariant() != null ? item.getFilamentVariant().getColorLabelFr() : null);
         dto.put("materialCode", item.getMaterialCode());
         dto.put("quality", item.getQuality());
         dto.put("nozzleDiameterMm", item.getNozzleDiameterMm());

backend/src/main/java/com/printcalculator/service/shop/PublicShopCatalogService.java

@@ -9,10 +9,12 @@ import com.printcalculator.dto.ShopProductDetailDto;
 import com.printcalculator.dto.ShopProductModelDto;
 import com.printcalculator.dto.ShopProductSummaryDto;
 import com.printcalculator.dto.ShopProductVariantOptionDto;
+import com.printcalculator.entity.FilamentVariant;
 import com.printcalculator.entity.ShopCategory;
 import com.printcalculator.entity.ShopProduct;
 import com.printcalculator.entity.ShopProductModelAsset;
 import com.printcalculator.entity.ShopProductVariant;
+import com.printcalculator.repository.FilamentVariantRepository;
 import com.printcalculator.repository.ShopCategoryRepository;
 import com.printcalculator.repository.ShopProductModelAssetRepository;
 import com.printcalculator.repository.ShopProductRepository;
@@ -31,6 +33,7 @@ import java.util.Collection;
 import java.util.Comparator;
 import java.util.LinkedHashMap;
 import java.util.List;
+import java.util.Locale;
 import java.util.Map;
 import java.util.Objects;
 import java.util.UUID;
@@ -46,6 +49,7 @@ public class PublicShopCatalogService {
     private final ShopProductRepository shopProductRepository;
     private final ShopProductVariantRepository shopProductVariantRepository;
     private final ShopProductModelAssetRepository shopProductModelAssetRepository;
+    private final FilamentVariantRepository filamentVariantRepository;
     private final PublicMediaQueryService publicMediaQueryService;
     private final ShopStorageService shopStorageService;
 
@@ -53,19 +57,21 @@ public class PublicShopCatalogService {
                                     ShopProductRepository shopProductRepository,
                                     ShopProductVariantRepository shopProductVariantRepository,
                                     ShopProductModelAssetRepository shopProductModelAssetRepository,
+                                    FilamentVariantRepository filamentVariantRepository,
                                     PublicMediaQueryService publicMediaQueryService,
                                     ShopStorageService shopStorageService) {
         this.shopCategoryRepository = shopCategoryRepository;
         this.shopProductRepository = shopProductRepository;
         this.shopProductVariantRepository = shopProductVariantRepository;
         this.shopProductModelAssetRepository = shopProductModelAssetRepository;
+        this.filamentVariantRepository = filamentVariantRepository;
         this.publicMediaQueryService = publicMediaQueryService;
         this.shopStorageService = shopStorageService;
     }
 
     public List<ShopCategoryTreeDto> getCategories(String language) {
         CategoryContext categoryContext = loadCategoryContext(language);
-        return buildCategoryTree(null, categoryContext);
+        return buildCategoryTree(null, categoryContext, language);
     }
 
     public ShopCategoryDetailDto getCategory(String slug, String language) {
@@ -77,7 +83,7 @@ public class PublicShopCatalogService {
             throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Category not found");
         }
 
-        return buildCategoryDetail(category, categoryContext);
+        return buildCategoryDetail(category, categoryContext, language);
     }
 
     public ShopProductCatalogResponseDto getProductCatalog(String categorySlug, Boolean featuredOnly, String language) {
@@ -99,11 +105,16 @@ public class PublicShopCatalogService {
         List<ShopProductSummaryDto> products = productContext.entries().stream()
                 .filter(entry -> allowedCategoryIds.contains(entry.product().getCategory().getId()))
                 .filter(entry -> !Boolean.TRUE.equals(featuredOnly) || Boolean.TRUE.equals(entry.product().getIsFeatured()))
-                .map(entry -> toProductSummaryDto(entry, productContext.productMediaBySlug(), language))
+                .map(entry -> toProductSummaryDto(
+                        entry,
+                        productContext.productMediaBySlug(),
+                        productContext.variantColorHexByMaterialAndColor(),
+                        language
+                ))
                 .toList();
 
         ShopCategoryDetailDto selectedCategoryDetail = selectedCategory != null
-                ? buildCategoryDetail(selectedCategory, categoryContext)
+                ? buildCategoryDetail(selectedCategory, categoryContext, language)
                 : null;
 
         return new ShopProductCatalogResponseDto(
@@ -128,7 +139,12 @@ public class PublicShopCatalogService {
             throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
         }
 
-        return toProductDetailDto(entry, productContext.productMediaBySlug(), language);
+        return toProductDetailDto(
+                entry,
+                productContext.productMediaBySlug(),
+                productContext.variantColorHexByMaterialAndColor(),
+                language
+        );
     }
 
     public ProductModelDownload getProductModelDownload(String slug) {
@@ -187,11 +203,32 @@ public class PublicShopCatalogService {
                 entries.stream().map(entry -> productMediaUsageKey(entry.product())).toList(),
                 language
         );
+        Map<String, String> variantColorHexByMaterialAndColor = buildFilamentVariantColorHexMap();
 
         Map<String, ProductEntry> entriesBySlug = entries.stream()
                 .collect(Collectors.toMap(entry -> entry.product().getSlug(), entry -> entry, (left, right) -> left, LinkedHashMap::new));
 
-        return new PublicProductContext(entries, entriesBySlug, productMediaBySlug);
+        return new PublicProductContext(entries, entriesBySlug, productMediaBySlug, variantColorHexByMaterialAndColor);
+    }
+
+    private Map<String, String> buildFilamentVariantColorHexMap() {
+        Map<String, String> colorsByMaterialAndColor = new LinkedHashMap<>();
+        for (FilamentVariant variant : filamentVariantRepository.findByIsActiveTrue()) {
+            String materialCode = variant.getFilamentMaterialType() != null
+                    ? variant.getFilamentMaterialType().getMaterialCode()
+                    : null;
+            String key = toMaterialAndColorKey(materialCode, variant.getColorName());
+            if (key == null) {
+                continue;
+            }
+
+            String colorHex = trimToNull(variant.getColorHex());
+            if (colorHex == null) {
+                continue;
+            }
+            colorsByMaterialAndColor.putIfAbsent(key, colorHex);
+        }
+        return colorsByMaterialAndColor;
     }
 
     private List<ProductEntry> loadPublicProducts(Collection<UUID> activeCategoryIds) {
@@ -279,53 +316,63 @@ public class PublicShopCatalogService {
         return total;
     }
 
-    private List<ShopCategoryTreeDto> buildCategoryTree(UUID parentId, CategoryContext categoryContext) {
+    private List<ShopCategoryTreeDto> buildCategoryTree(UUID parentId,
+                                                        CategoryContext categoryContext,
+                                                        String language) {
         return categoryContext.childrenByParentId().getOrDefault(parentId, List.of()).stream()
                 .map(category -> new ShopCategoryTreeDto(
                         category.getId(),
                         category.getParentCategory() != null ? category.getParentCategory().getId() : null,
                         category.getSlug(),
-                        category.getName(),
+                        category.getNameForLanguage(language),
-                        category.getDescription(),
+                        category.getDescriptionForLanguage(language),
-                        category.getSeoTitle(),
+                        category.getSeoTitleForLanguage(language),
-                        category.getSeoDescription(),
+                        category.getSeoDescriptionForLanguage(language),
                         category.getOgTitle(),
                         category.getOgDescription(),
                         category.getIndexable(),
                         category.getSortOrder(),
                         categoryContext.descendantProductCounts().getOrDefault(category.getId(), 0),
                         selectPrimaryMedia(categoryContext.categoryMediaBySlug().get(categoryMediaUsageKey(category))),
-                        buildCategoryTree(category.getId(), categoryContext)
+                        buildCategoryTree(category.getId(), categoryContext, language)
                 ))
                 .toList();
     }
 
-    private ShopCategoryDetailDto buildCategoryDetail(ShopCategory category, CategoryContext categoryContext) {
+    private ShopCategoryDetailDto buildCategoryDetail(ShopCategory category,
+                                                      CategoryContext categoryContext,
+                                                      String language) {
         List<PublicMediaUsageDto> images = categoryContext.categoryMediaBySlug().getOrDefault(categoryMediaUsageKey(category), List.of());
+        String localizedSeoTitle = category.getSeoTitleForLanguage(language);
+        String localizedSeoDescription = category.getSeoDescriptionForLanguage(language);
         return new ShopCategoryDetailDto(
                 category.getId(),
                 category.getSlug(),
-                category.getName(),
+                category.getNameForLanguage(language),
-                category.getDescription(),
+                category.getDescriptionForLanguage(language),
-                category.getSeoTitle(),
+                localizedSeoTitle,
-                category.getSeoDescription(),
+                localizedSeoDescription,
                 category.getOgTitle(),
                 category.getOgDescription(),
                 category.getIndexable(),
                 category.getSortOrder(),
                 categoryContext.descendantProductCounts().getOrDefault(category.getId(), 0),
-                buildCategoryBreadcrumbs(category),
+                buildCategoryBreadcrumbs(category, language),
                 selectPrimaryMedia(images),
                 images,
-                buildCategoryTree(category.getId(), categoryContext)
+                buildCategoryTree(category.getId(), categoryContext, language)
         );
     }
 
-    private List<ShopCategoryRefDto> buildCategoryBreadcrumbs(ShopCategory category) {
+    private List<ShopCategoryRefDto> buildCategoryBreadcrumbs(ShopCategory category, String language) {
         List<ShopCategoryRefDto> breadcrumbs = new ArrayList<>();
         ShopCategory current = category;
         while (current != null) {
-            breadcrumbs.add(new ShopCategoryRefDto(current.getId(), current.getSlug(), current.getName()));
+            breadcrumbs.add(new ShopCategoryRefDto(
+                    current.getId(),
+                    current.getSlug(),
+                    current.getNameForLanguage(language)
+            ));
             current = current.getParentCategory();
         }
         java.util.Collections.reverse(breadcrumbs);
@@ -349,6 +396,7 @@ public class PublicShopCatalogService {
 
     private ShopProductSummaryDto toProductSummaryDto(ProductEntry entry,
                                                       Map<String, List<PublicMediaUsageDto>> productMediaBySlug,
+                                                      Map<String, String> variantColorHexByMaterialAndColor,
                                                       String language) {
         List<PublicMediaUsageDto> images = productMediaBySlug.getOrDefault(productMediaUsageKey(entry.product()), List.of());
         return new ShopProductSummaryDto(
@@ -361,11 +409,11 @@ public class PublicShopCatalogService {
                 new ShopCategoryRefDto(
                         entry.product().getCategory().getId(),
                         entry.product().getCategory().getSlug(),
-                        entry.product().getCategory().getName()
+                        entry.product().getCategory().getNameForLanguage(language)
                 ),
                 resolvePriceFrom(entry.variants()),
                 resolvePriceTo(entry.variants()),
-                toVariantDto(entry.defaultVariant(), entry.defaultVariant()),
+                toVariantDto(entry.defaultVariant(), entry.defaultVariant(), variantColorHexByMaterialAndColor, language),
                 selectPrimaryMedia(images),
                 toProductModelDto(entry)
         );
@@ -373,32 +421,35 @@ public class PublicShopCatalogService {
 
     private ShopProductDetailDto toProductDetailDto(ProductEntry entry,
                                                     Map<String, List<PublicMediaUsageDto>> productMediaBySlug,
+                                                    Map<String, String> variantColorHexByMaterialAndColor,
                                                     String language) {
         List<PublicMediaUsageDto> images = productMediaBySlug.getOrDefault(productMediaUsageKey(entry.product()), List.of());
+        String localizedSeoTitle = entry.product().getSeoTitleForLanguage(language);
+        String localizedSeoDescription = entry.product().getSeoDescriptionForLanguage(language);
         return new ShopProductDetailDto(
                 entry.product().getId(),
                 entry.product().getSlug(),
                 entry.product().getNameForLanguage(language),
                 entry.product().getExcerptForLanguage(language),
                 entry.product().getDescriptionForLanguage(language),
-                entry.product().getSeoTitle(),
+                localizedSeoTitle,
-                entry.product().getSeoDescription(),
+                localizedSeoDescription,
-                entry.product().getOgTitle(),
+                localizedSeoTitle,
-                entry.product().getOgDescription(),
+                localizedSeoDescription,
                 entry.product().getIndexable(),
                 entry.product().getIsFeatured(),
                 entry.product().getSortOrder(),
                 new ShopCategoryRefDto(
                         entry.product().getCategory().getId(),
                         entry.product().getCategory().getSlug(),
-                        entry.product().getCategory().getName()
+                        entry.product().getCategory().getNameForLanguage(language)
                 ),
-                buildCategoryBreadcrumbs(entry.product().getCategory()),
+                buildCategoryBreadcrumbs(entry.product().getCategory(), language),
                 resolvePriceFrom(entry.variants()),
                 resolvePriceTo(entry.variants()),
-                toVariantDto(entry.defaultVariant(), entry.defaultVariant()),
+                toVariantDto(entry.defaultVariant(), entry.defaultVariant(), variantColorHexByMaterialAndColor, language),
                 entry.variants().stream()
-                        .map(variant -> toVariantDto(variant, entry.defaultVariant()))
+                        .map(variant -> toVariantDto(variant, entry.defaultVariant(), variantColorHexByMaterialAndColor, language))
                         .toList(),
                 selectPrimaryMedia(images),
                 images,
@@ -406,21 +457,63 @@ public class PublicShopCatalogService {
         );
     }
 
-    private ShopProductVariantOptionDto toVariantDto(ShopProductVariant variant, ShopProductVariant defaultVariant) {
+    private ShopProductVariantOptionDto toVariantDto(ShopProductVariant variant,
+                                                     ShopProductVariant defaultVariant,
+                                                     Map<String, String> variantColorHexByMaterialAndColor,
+                                                     String language) {
         if (variant == null) {
             return null;
         }
+        String colorHex = trimToNull(variant.getColorHex());
+        if (colorHex == null) {
+            String key = toMaterialAndColorKey(variant.getInternalMaterialCode(), variant.getColorName());
+            colorHex = key != null ? variantColorHexByMaterialAndColor.get(key) : null;
+        }
         return new ShopProductVariantOptionDto(
                 variant.getId(),
                 variant.getSku(),
                 variant.getVariantLabel(),
                 variant.getColorName(),
-                variant.getColorHex(),
+                variant.getColorLabelForLanguage(language),
+                colorHex,
                 variant.getPriceChf(),
                 defaultVariant != null && Objects.equals(defaultVariant.getId(), variant.getId())
         );
     }
 
+    private String toMaterialAndColorKey(String materialCode, String colorName) {
+        String normalizedMaterialCode = normalizeMaterialCode(materialCode);
+        String normalizedColorName = normalizeColorName(colorName);
+        if (normalizedMaterialCode == null || normalizedColorName == null) {
+            return null;
+        }
+        return normalizedMaterialCode + "|" + normalizedColorName;
+    }
+
+    private String normalizeMaterialCode(String materialCode) {
+        String raw = trimToNull(materialCode);
+        if (raw == null) {
+            return null;
+        }
+        return raw.toUpperCase(Locale.ROOT);
+    }
+
+    private String normalizeColorName(String colorName) {
+        String raw = trimToNull(colorName);
+        if (raw == null) {
+            return null;
+        }
+        return raw.toLowerCase(Locale.ROOT);
+    }
+
+    private String trimToNull(String value) {
+        String raw = String.valueOf(value == null ? "" : value).trim();
+        if (raw.isEmpty()) {
+            return null;
+        }
+        return raw;
+    }
+
     private ShopProductModelDto toProductModelDto(ProductEntry entry) {
         if (entry.modelAsset() == null) {
             return null;
@@ -492,7 +585,8 @@ public class PublicShopCatalogService {
     private record PublicProductContext(
             List<ProductEntry> entries,
             Map<String, ProductEntry> entriesBySlug,
-            Map<String, List<PublicMediaUsageDto>> productMediaBySlug
+            Map<String, List<PublicMediaUsageDto>> productMediaBySlug,
+            Map<String, String> variantColorHexByMaterialAndColor
     ) {
     }
 

backend/src/main/java/com/printcalculator/service/shop/ShopSitemapService.java

@@ -0,0 +1,258 @@
+package com.printcalculator.service.shop;
+
+import com.printcalculator.entity.ShopCategory;
+import com.printcalculator.entity.ShopProduct;
+import com.printcalculator.repository.ShopCategoryRepository;
+import com.printcalculator.repository.ShopProductRepository;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.net.URLEncoder;
+import java.nio.charset.StandardCharsets;
+import java.text.Normalizer;
+import java.time.Clock;
+import java.time.Duration;
+import java.time.Instant;
+import java.time.OffsetDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Set;
+import java.util.UUID;
+import java.util.stream.Collectors;
+
+@Service
+@Transactional(readOnly = true)
+public class ShopSitemapService {
+    private static final List<String> SUPPORTED_LANGUAGES = ShopProduct.SUPPORTED_LANGUAGES;
+    private static final String DEFAULT_LANGUAGE = "it";
+    private static final DateTimeFormatter LASTMOD_FORMATTER = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
+
+    private final ShopCategoryRepository shopCategoryRepository;
+    private final ShopProductRepository shopProductRepository;
+    private final String frontendBaseUrl;
+    private final Duration cacheTtl;
+    private final Clock clock;
+
+    private volatile CachedSitemap cachedSitemap;
+
+    @Autowired
+    public ShopSitemapService(ShopCategoryRepository shopCategoryRepository,
+                              ShopProductRepository shopProductRepository,
+                              @Value("${app.frontend.base-url:http://localhost:4200}") String frontendBaseUrl,
+                              @Value("${app.sitemap.shop.cache-seconds:3600}") long cacheSeconds) {
+        this(shopCategoryRepository, shopProductRepository, frontendBaseUrl, cacheSeconds, Clock.systemUTC());
+    }
+
+    ShopSitemapService(ShopCategoryRepository shopCategoryRepository,
+                       ShopProductRepository shopProductRepository,
+                       String frontendBaseUrl,
+                       long cacheSeconds,
+                       Clock clock) {
+        this.shopCategoryRepository = shopCategoryRepository;
+        this.shopProductRepository = shopProductRepository;
+        this.frontendBaseUrl = normalizeBaseUrl(frontendBaseUrl);
+        this.cacheTtl = cacheSeconds > 0 ? Duration.ofSeconds(cacheSeconds) : Duration.ZERO;
+        this.clock = clock;
+    }
+
+    public String getShopSitemapXml() {
+        Instant now = Instant.now(clock);
+        CachedSitemap current = cachedSitemap;
+        if (current != null && now.isBefore(current.expiresAt())) {
+            return current.xml();
+        }
+
+        synchronized (this) {
+            current = cachedSitemap;
+            now = Instant.now(clock);
+            if (current != null && now.isBefore(current.expiresAt())) {
+                return current.xml();
+            }
+
+            String xml = buildSitemapXml();
+            Instant expiresAt = cacheTtl.isZero() ? now : now.plus(cacheTtl);
+            cachedSitemap = new CachedSitemap(xml, expiresAt);
+            return xml;
+        }
+    }
+
+    private String buildSitemapXml() {
+        List<ShopCategory> activeCategories = shopCategoryRepository.findAllByIsActiveTrueOrderBySortOrderAscNameAsc();
+        Set<UUID> activeCategoryIds = activeCategories.stream()
+                .map(ShopCategory::getId)
+                .collect(Collectors.toSet());
+
+        List<ShopProduct> activeProducts = shopProductRepository.findAllByIsActiveTrueOrderByIsFeaturedDescSortOrderAscNameAsc();
+
+        StringBuilder xml = new StringBuilder(16_384);
+        xml.append("<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
+        xml.append("<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\" ");
+        xml.append("xmlns:xhtml=\"http://www.w3.org/1999/xhtml\">\n");
+
+        appendCategoryUrls(xml, activeCategories);
+        appendProductUrls(xml, activeProducts, activeCategoryIds);
+
+        xml.append("</urlset>\n");
+        return xml.toString();
+    }
+
+    private void appendCategoryUrls(StringBuilder xml, List<ShopCategory> categories) {
+        for (ShopCategory category : categories) {
+            if (!Boolean.TRUE.equals(category.getIndexable())) {
+                continue;
+            }
+
+            String encodedSlug = pathEncodeSegment(category.getSlug());
+            Map<String, String> hrefByLanguage = new LinkedHashMap<>();
+            for (String language : SUPPORTED_LANGUAGES) {
+                hrefByLanguage.put(language, frontendBaseUrl + "/" + language + "/shop/" + encodedSlug);
+            }
+
+            appendUrlEntry(xml, hrefByLanguage, category.getUpdatedAt());
+        }
+    }
+
+    private void appendProductUrls(StringBuilder xml,
+                                   List<ShopProduct> products,
+                                   Set<UUID> activeCategoryIds) {
+        for (ShopProduct product : products) {
+            if (!Boolean.TRUE.equals(product.getIndexable())) {
+                continue;
+            }
+            if (product.getCategory() == null || !activeCategoryIds.contains(product.getCategory().getId())) {
+                continue;
+            }
+
+            Map<String, String> hrefByLanguage = new LinkedHashMap<>();
+            for (String language : SUPPORTED_LANGUAGES) {
+                String publicSegment = localizedProductPathSegment(product, language);
+                hrefByLanguage.put(language, frontendBaseUrl + "/" + language + "/shop/p/" + pathEncodeSegment(publicSegment));
+            }
+
+            appendUrlEntry(xml, hrefByLanguage, product.getUpdatedAt());
+        }
+    }
+
+    private void appendUrlEntry(StringBuilder xml,
+                                Map<String, String> hrefByLanguage,
+                                OffsetDateTime lastmod) {
+        String defaultHref = hrefByLanguage.get(DEFAULT_LANGUAGE);
+        if (defaultHref == null || defaultHref.isBlank()) {
+            return;
+        }
+
+        for (String locLanguage : SUPPORTED_LANGUAGES) {
+            String locHref = hrefByLanguage.get(locLanguage);
+            if (locHref == null || locHref.isBlank()) {
+                continue;
+            }
+            appendLocalizedUrlEntry(xml, locHref, hrefByLanguage, defaultHref, lastmod);
+        }
+    }
+
+    private void appendLocalizedUrlEntry(StringBuilder xml,
+                                         String locHref,
+                                         Map<String, String> hrefByLanguage,
+                                         String defaultHref,
+                                         OffsetDateTime lastmod) {
+        xml.append("  <url>\n");
+        xml.append("    <loc>").append(xmlEscape(locHref)).append("</loc>\n");
+
+        for (String language : SUPPORTED_LANGUAGES) {
+            String href = hrefByLanguage.get(language);
+            if (href == null || href.isBlank()) {
+                continue;
+            }
+            xml.append("    <xhtml:link rel=\"alternate\" hreflang=\"")
+                    .append(language)
+                    .append("\" href=\"")
+                    .append(xmlEscape(href))
+                    .append("\" />\n");
+        }
+
+        xml.append("    <xhtml:link rel=\"alternate\" hreflang=\"x-default\" href=\"")
+                .append(xmlEscape(defaultHref))
+                .append("\" />\n");
+
+        if (lastmod != null) {
+            xml.append("    <lastmod>").append(LASTMOD_FORMATTER.format(lastmod)).append("</lastmod>\n");
+        }
+
+        xml.append("  </url>\n");
+    }
+
+    private String localizedProductPathSegment(ShopProduct product, String language) {
+        String localizedName = product.getNameForLanguage(language);
+        String idPrefix = productIdPrefix(product.getId());
+        String tail = firstNonBlank(slugify(localizedName), slugify(product.getSlug()), "product");
+        return idPrefix.isBlank() ? tail : idPrefix + "-" + tail;
+    }
+
+    private String productIdPrefix(UUID productId) {
+        if (productId == null) {
+            return "";
+        }
+        String raw = productId.toString().trim().toLowerCase(Locale.ROOT);
+        int dashIndex = raw.indexOf('-');
+        if (dashIndex > 0) {
+            return raw.substring(0, dashIndex);
+        }
+        return raw.length() >= 8 ? raw.substring(0, 8) : raw;
+    }
+
+    static String slugify(String rawValue) {
+        String safeValue = rawValue == null ? "" : rawValue;
+        String normalized = Normalizer.normalize(safeValue, Normalizer.Form.NFD)
+                .replaceAll("\\p{M}+", "")
+                .toLowerCase(Locale.ROOT)
+                .replaceAll("[^a-z0-9]+", "-")
+                .replaceAll("^-+|-+$", "")
+                .replaceAll("-{2,}", "-");
+        return normalized;
+    }
+
+    private String firstNonBlank(String... values) {
+        if (values == null) {
+            return null;
+        }
+        for (String value : values) {
+            if (value != null && !value.isBlank()) {
+                return value;
+            }
+        }
+        return null;
+    }
+
+    private String pathEncodeSegment(String rawSegment) {
+        String safeSegment = rawSegment == null ? "" : rawSegment;
+        return URLEncoder.encode(safeSegment, StandardCharsets.UTF_8).replace("+", "%20");
+    }
+
+    private String xmlEscape(String value) {
+        return String.valueOf(value)
+                .replace("&", "&amp;")
+                .replace("<", "&lt;")
+                .replace(">", "&gt;")
+                .replace("\"", "&quot;")
+                .replace("'", "&apos;");
+    }
+
+    private String normalizeBaseUrl(String baseUrl) {
+        String normalized = (baseUrl == null ? "" : baseUrl).trim();
+        if (normalized.isBlank()) {
+            return "http://localhost:4200";
+        }
+        while (normalized.endsWith("/")) {
+            normalized = normalized.substring(0, normalized.length() - 1);
+        }
+        return normalized;
+    }
+
+    private record CachedSitemap(String xml, Instant expiresAt) {
+    }
+}

backend/src/main/resources/application.properties

@@ -56,6 +56,13 @@ app.mail.contact-request.admin.enabled=${APP_MAIL_CONTACT_REQUEST_ADMIN_ENABLED:
 app.mail.contact-request.admin.address=${APP_MAIL_CONTACT_REQUEST_ADMIN_ADDRESS:info@3d-fab.ch}
 app.mail.contact-request.customer.enabled=${APP_MAIL_CONTACT_REQUEST_CUSTOMER_ENABLED:true}
 app.frontend.base-url=${APP_FRONTEND_BASE_URL:http://localhost:4200}
+app.sitemap.shop.cache-seconds=${APP_SITEMAP_SHOP_CACHE_SECONDS:3600}
+openai.translation.api-key=${OPENAI_API_KEY:}
+openai.translation.base-url=${OPENAI_BASE_URL:https://api.openai.com/v1}
+openai.translation.model=${OPENAI_TRANSLATION_MODEL:gpt-5.4}
+openai.translation.timeout-seconds=${OPENAI_TRANSLATION_TIMEOUT_SECONDS:45}
+openai.translation.prompt-cache-key-prefix=${OPENAI_TRANSLATION_PROMPT_CACHE_KEY_PREFIX:printcalc-shop-product-translation-v1}
+openai.translation.business-context=${OPENAI_TRANSLATION_BUSINESS_CONTEXT:}
 
 # Admin back-office authentication
 admin.password=${ADMIN_PASSWORD}

backend/src/test/java/com/printcalculator/controller/admin/AdminShopProductControllerSecurityTest.java

@@ -0,0 +1,149 @@
+package com.printcalculator.controller.admin;
+
+import com.printcalculator.config.SecurityConfig;
+import com.printcalculator.dto.AdminTranslateShopProductResponse;
+import com.printcalculator.service.admin.AdminShopProductControllerService;
+import com.printcalculator.service.admin.AdminShopProductTranslationService;
+import com.printcalculator.security.AdminLoginThrottleService;
+import com.printcalculator.security.AdminSessionAuthenticationFilter;
+import com.printcalculator.security.AdminSessionService;
+import jakarta.servlet.http.Cookie;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.test.context.TestConfiguration;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Import;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.test.context.TestPropertySource;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.MvcResult;
+import org.springframework.transaction.PlatformTransactionManager;
+import org.springframework.transaction.TransactionDefinition;
+import org.springframework.transaction.support.AbstractPlatformTransactionManager;
+import org.springframework.transaction.support.DefaultTransactionStatus;
+
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.Mockito.when;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+@WebMvcTest(controllers = {AdminAuthController.class, AdminShopProductController.class})
+@Import({
+        SecurityConfig.class,
+        AdminSessionAuthenticationFilter.class,
+        AdminSessionService.class,
+        AdminLoginThrottleService.class,
+        AdminShopProductControllerSecurityTest.TransactionTestConfig.class
+})
+@TestPropertySource(properties = {
+        "admin.password=test-admin-password",
+        "admin.session.secret=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+        "admin.session.ttl-minutes=60"
+})
+class AdminShopProductControllerSecurityTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @MockitoBean
+    private AdminShopProductControllerService adminShopProductControllerService;
+
+    @MockitoBean
+    private AdminShopProductTranslationService adminShopProductTranslationService;
+
+    @Test
+    void translateProduct_withoutAdminCookie_shouldReturn401() throws Exception {
+        mockMvc.perform(post("/api/admin/shop/products/translate")
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"sourceLanguage\":\"it\",\"names\":{\"it\":\"Supporto cavo\"}}"))
+                .andExpect(status().isUnauthorized());
+    }
+
+    @Test
+    void translateProduct_withAdminCookie_shouldReturnTranslations() throws Exception {
+        AdminTranslateShopProductResponse response = new AdminTranslateShopProductResponse();
+        response.setSourceLanguage("it");
+        response.setTargetLanguages(List.of("en", "de", "fr"));
+        response.setNames(Map.of("en", "Desk cable clip"));
+        response.setExcerpts(Map.of());
+        response.setDescriptions(Map.of());
+        response.setSeoTitles(Map.of());
+        response.setSeoDescriptions(Map.of());
+
+        when(adminShopProductTranslationService.translateProduct(org.mockito.ArgumentMatchers.any()))
+                .thenReturn(response);
+
+        mockMvc.perform(post("/api/admin/shop/products/translate")
+                        .cookie(loginAndExtractCookie())
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("""
+                                {
+                                  "sourceLanguage":"it",
+                                  "overwriteExisting":false,
+                                  "materialCodes":["PLA"],
+                                  "names":{"it":"Supporto cavo"},
+                                  "excerpts":{"it":"Accessorio tecnico"},
+                                  "descriptions":{"it":"<p>Descrizione</p>"},
+                                  "seoTitles":{"it":"SEO IT"},
+                                  "seoDescriptions":{"it":"SEO description IT"}
+                                }
+                                """))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.sourceLanguage").value("it"))
+                .andExpect(jsonPath("$.targetLanguages[0]").value("en"))
+                .andExpect(jsonPath("$.names.en").value("Desk cable clip"));
+    }
+
+    private Cookie loginAndExtractCookie() throws Exception {
+        MvcResult login = mockMvc.perform(post("/api/admin/auth/login")
+                        .with(req -> {
+                            req.setRemoteAddr("10.0.0.44");
+                            return req;
+                        })
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"password\":\"test-admin-password\"}"))
+                .andExpect(status().isOk())
+                .andReturn();
+
+        String setCookie = login.getResponse().getHeader(HttpHeaders.SET_COOKIE);
+        assertNotNull(setCookie);
+        String[] parts = setCookie.split(";", 2);
+        String[] keyValue = parts[0].split("=", 2);
+        return new Cookie(keyValue[0], keyValue.length > 1 ? keyValue[1] : "");
+    }
+
+    @TestConfiguration
+    static class TransactionTestConfig {
+        @Bean
+        PlatformTransactionManager transactionManager() {
+            return new AbstractPlatformTransactionManager() {
+                @Override
+                protected Object doGetTransaction() {
+                    return new Object();
+                }
+
+                @Override
+                protected void doBegin(Object transaction, TransactionDefinition definition) {
+                    // No-op transaction manager for WebMvc security tests.
+                }
+
+                @Override
+                protected void doCommit(DefaultTransactionStatus status) {
+                    // No-op transaction manager for WebMvc security tests.
+                }
+
+                @Override
+                protected void doRollback(DefaultTransactionStatus status) {
+                    // No-op transaction manager for WebMvc security tests.
+                }
+            };
+        }
+    }
+}

backend/src/test/java/com/printcalculator/entity/FilamentVariantTest.java

@@ -0,0 +1,31 @@
+package com.printcalculator.entity;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class FilamentVariantTest {
+
+    @Test
+    void getColorLabelForLanguageShouldReturnLocalizedValue() {
+        FilamentVariant variant = new FilamentVariant();
+        variant.setColorName("Orange");
+        variant.setColorLabelIt("Arancione");
+        variant.setColorLabelEn("Orange");
+        variant.setColorLabelDe("Orange");
+        variant.setColorLabelFr("Orange");
+
+        assertEquals("Arancione", variant.getColorLabelForLanguage("it"));
+        assertEquals("Orange", variant.getColorLabelForLanguage("en"));
+        assertEquals("Orange", variant.getColorLabelForLanguage("de-CH"));
+    }
+
+    @Test
+    void getColorLabelForLanguageShouldFallbackToColorName() {
+        FilamentVariant variant = new FilamentVariant();
+        variant.setColorName("Orange");
+
+        assertEquals("Orange", variant.getColorLabelForLanguage("it"));
+        assertEquals("Orange", variant.getColorLabelForLanguage("fr"));
+    }
+}

backend/src/test/java/com/printcalculator/entity/ShopCategoryTest.java

@@ -0,0 +1,55 @@
+package com.printcalculator.entity;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class ShopCategoryTest {
+
+    @Test
+    void localizedAccessorsShouldReturnLanguageSpecificValues() {
+        ShopCategory category = new ShopCategory();
+        category.setName("Desk accessories");
+        category.setNameIt("Accessori da scrivania");
+        category.setNameEn("Desk accessories");
+        category.setNameDe("Schreibtischzubehor");
+        category.setNameFr("Accessoires de bureau");
+        category.setDescription("Legacy description");
+        category.setDescriptionIt("Organizer e accessori stampati per la scrivania.");
+        category.setDescriptionEn("Printed desk organizers and accessories.");
+        category.setDescriptionDe("Gedruckte Organizer und Zubehor fur den Schreibtisch.");
+        category.setDescriptionFr("Accessoires et organiseurs imprimes pour le bureau.");
+        category.setSeoTitle("Legacy SEO title");
+        category.setSeoTitleIt("Accessori da scrivania stampati in 3D");
+        category.setSeoTitleEn("3D printed desk accessories");
+        category.setSeoTitleDe("3D-gedruckte Schreibtischaccessoires");
+        category.setSeoTitleFr("Accessoires de bureau imprimes en 3D");
+        category.setSeoDescription("Legacy SEO description");
+        category.setSeoDescriptionIt("Accessori da scrivania personalizzati e funzionali.");
+        category.setSeoDescriptionEn("Functional custom desk accessories.");
+        category.setSeoDescriptionDe("Funktionale personalisierte Schreibtischaccessoires.");
+        category.setSeoDescriptionFr("Accessoires de bureau fonctionnels et personnalises.");
+
+        assertEquals("Accessori da scrivania", category.getNameForLanguage("it"));
+        assertEquals("Desk accessories", category.getNameForLanguage("en"));
+        assertEquals("Schreibtischzubehor", category.getNameForLanguage("de"));
+        assertEquals("Accessoires de bureau", category.getNameForLanguage("fr"));
+        assertEquals("Gedruckte Organizer und Zubehor fur den Schreibtisch.", category.getDescriptionForLanguage("de"));
+        assertEquals("3D printed desk accessories", category.getSeoTitleForLanguage("en"));
+        assertEquals("Accessoires de bureau fonctionnels et personnalises.", category.getSeoDescriptionForLanguage("fr"));
+    }
+
+    @Test
+    void localizedAccessorsShouldFallbackToLegacyValues() {
+        ShopCategory category = new ShopCategory();
+        category.setName("Desk accessories");
+        category.setDescription("Printed desk organizers and accessories.");
+        category.setSeoTitle("3D printed desk accessories");
+        category.setSeoDescription("Functional custom desk accessories.");
+
+        assertEquals("Desk accessories", category.getNameForLanguage("it"));
+        assertEquals("Printed desk organizers and accessories.", category.getDescriptionForLanguage("de"));
+        assertEquals("3D printed desk accessories", category.getSeoTitleForLanguage("fr-CH"));
+        assertEquals("Functional custom desk accessories.", category.getSeoDescriptionForLanguage("en-US"));
+    }
+}

backend/src/test/java/com/printcalculator/entity/ShopProductVariantTest.java

@@ -0,0 +1,32 @@
+package com.printcalculator.entity;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class ShopProductVariantTest {
+
+    @Test
+    void getColorLabelForLanguageShouldReturnLocalizedValue() {
+        ShopProductVariant variant = new ShopProductVariant();
+        variant.setColorName("Gray");
+        variant.setColorLabelIt("Grigio");
+        variant.setColorLabelEn("Gray");
+        variant.setColorLabelDe("Grau");
+        variant.setColorLabelFr("Gris");
+
+        assertEquals("Grigio", variant.getColorLabelForLanguage("it"));
+        assertEquals("Gray", variant.getColorLabelForLanguage("en"));
+        assertEquals("Grau", variant.getColorLabelForLanguage("de"));
+        assertEquals("Gris", variant.getColorLabelForLanguage("fr-CH"));
+    }
+
+    @Test
+    void getColorLabelForLanguageShouldFallbackToColorName() {
+        ShopProductVariant variant = new ShopProductVariant();
+        variant.setColorName("Gray");
+
+        assertEquals("Gray", variant.getColorLabelForLanguage("it"));
+        assertEquals("Gray", variant.getColorLabelForLanguage("de"));
+    }
+}

backend/src/test/java/com/printcalculator/service/OrderServiceTest.java

@@ -40,10 +40,13 @@ import java.util.Optional;
 import java.util.UUID;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.ArgumentMatchers.isNull;
+import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
@@ -217,6 +220,210 @@ class OrderServiceTest {
         verify(eventPublisher).publishEvent(any(OrderCreatedEvent.class));
     }
 
+    @Test
+    void createOrderFromQuote_withShopProductMissingSourceFile_shouldNotFail() throws Exception {
+        UUID sessionId = UUID.randomUUID();
+        UUID orderId = UUID.randomUUID();
+        UUID orderItemId = UUID.randomUUID();
+
+        QuoteSession session = new QuoteSession();
+        session.setId(sessionId);
+        session.setStatus("ACTIVE");
+        session.setSessionType("SHOP_CART");
+        session.setMaterialCode("SHOP");
+        session.setPricingVersion("v1");
+        session.setSetupCostChf(BigDecimal.ZERO);
+        session.setExpiresAt(OffsetDateTime.now().plusDays(30));
+
+        ShopCategory category = new ShopCategory();
+        category.setId(UUID.randomUUID());
+        category.setSlug("desk");
+        category.setName("Desk");
+
+        ShopProduct product = new ShopProduct();
+        product.setId(UUID.randomUUID());
+        product.setCategory(category);
+        product.setSlug("organizer");
+        product.setName("Organizer");
+
+        ShopProductVariant variant = new ShopProductVariant();
+        variant.setId(UUID.randomUUID());
+        variant.setProduct(product);
+        variant.setVariantLabel("PLA");
+        variant.setColorName("Orange");
+        variant.setColorHex("#ff8a00");
+        variant.setInternalMaterialCode("PLA");
+        variant.setPriceChf(new BigDecimal("18.00"));
+
+        Path missingSource = Path.of("storage_quotes")
+                .toAbsolutePath()
+                .normalize()
+                .resolve(sessionId.toString())
+                .resolve("missing-shop-item.stl");
+
+        QuoteLineItem qItem = new QuoteLineItem();
+        qItem.setId(UUID.randomUUID());
+        qItem.setQuoteSession(session);
+        qItem.setStatus("READY");
+        qItem.setLineItemType("SHOP_PRODUCT");
+        qItem.setOriginalFilename("organizer.stl");
+        qItem.setDisplayName("Organizer");
+        qItem.setQuantity(1);
+        qItem.setColorCode("Orange");
+        qItem.setMaterialCode("PLA");
+        qItem.setShopProduct(product);
+        qItem.setShopProductVariant(variant);
+        qItem.setShopProductSlug(product.getSlug());
+        qItem.setShopProductName(product.getName());
+        qItem.setShopVariantLabel("PLA");
+        qItem.setShopVariantColorName("Orange");
+        qItem.setShopVariantColorHex("#ff8a00");
+        qItem.setUnitPriceChf(new BigDecimal("18.00"));
+        qItem.setStoredPath(missingSource.toString());
+
+        when(quoteSessionRepo.findById(sessionId)).thenReturn(Optional.of(session));
+        when(customerRepo.findByEmail("buyer@example.com")).thenReturn(Optional.empty());
+        when(customerRepo.save(any(Customer.class))).thenAnswer(invocation -> {
+            Customer saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(UUID.randomUUID());
+            }
+            return saved;
+        });
+        when(quoteLineItemRepo.findByQuoteSessionId(sessionId)).thenReturn(List.of(qItem));
+        when(quoteSessionTotalsService.compute(eq(session), eq(List.of(qItem)))).thenReturn(
+                new QuoteSessionTotalsService.QuoteSessionTotals(
+                        new BigDecimal("18.00"),
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        new BigDecimal("18.00"),
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        new BigDecimal("18.00"),
+                        BigDecimal.ZERO
+                )
+        );
+        when(orderRepo.save(any(Order.class))).thenAnswer(invocation -> {
+            Order saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(orderId);
+            }
+            return saved;
+        });
+        when(orderItemRepo.save(any(OrderItem.class))).thenAnswer(invocation -> {
+            OrderItem saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(orderItemId);
+            }
+            return saved;
+        });
+        when(qrBillService.generateQrBillSvg(any(Order.class))).thenReturn("<svg/>".getBytes(StandardCharsets.UTF_8));
+        when(invoiceService.generateDocumentPdf(any(Order.class), any(List.class), eq(true), eq(qrBillService), isNull()))
+                .thenReturn("pdf".getBytes(StandardCharsets.UTF_8));
+        when(paymentService.getOrCreatePaymentForOrder(any(Order.class), eq("OTHER"))).thenReturn(new Payment());
+
+        Order order = service.createOrderFromQuote(sessionId, buildRequest());
+
+        assertEquals(orderId, order.getId());
+        assertEquals("CONVERTED", session.getStatus());
+
+        ArgumentCaptor<OrderItem> itemCaptor = ArgumentCaptor.forClass(OrderItem.class);
+        verify(orderItemRepo, times(2)).save(itemCaptor.capture());
+        OrderItem savedItem = itemCaptor.getAllValues().getLast();
+        assertEquals("PENDING", savedItem.getStoredRelativePath());
+        assertNull(savedItem.getFileSizeBytes());
+
+        verify(storageService, never()).store(eq(missingSource), any(Path.class));
+        verify(paymentService).getOrCreatePaymentForOrder(order, "OTHER");
+    }
+
+    @Test
+    void createOrderFromQuote_withCalculatorItemMissingSourceFile_shouldFail() {
+        UUID sessionId = UUID.randomUUID();
+        UUID orderId = UUID.randomUUID();
+        UUID orderItemId = UUID.randomUUID();
+
+        QuoteSession session = new QuoteSession();
+        session.setId(sessionId);
+        session.setStatus("ACTIVE");
+        session.setSessionType("QUOTE");
+        session.setMaterialCode("PLA");
+        session.setPricingVersion("v1");
+        session.setSetupCostChf(BigDecimal.ZERO);
+        session.setExpiresAt(OffsetDateTime.now().plusDays(30));
+
+        Path missingSource = Path.of("storage_quotes")
+                .toAbsolutePath()
+                .normalize()
+                .resolve(sessionId.toString())
+                .resolve("missing-calculator-item.stl");
+
+        QuoteLineItem qItem = new QuoteLineItem();
+        qItem.setId(UUID.randomUUID());
+        qItem.setQuoteSession(session);
+        qItem.setStatus("READY");
+        qItem.setLineItemType("PRINT_FILE");
+        qItem.setOriginalFilename("part.stl");
+        qItem.setDisplayName("part.stl");
+        qItem.setQuantity(1);
+        qItem.setMaterialCode("PLA");
+        qItem.setUnitPriceChf(new BigDecimal("9.50"));
+        qItem.setStoredPath(missingSource.toString());
+
+        when(quoteSessionRepo.findById(sessionId)).thenReturn(Optional.of(session));
+        when(customerRepo.findByEmail("buyer@example.com")).thenReturn(Optional.empty());
+        when(customerRepo.save(any(Customer.class))).thenAnswer(invocation -> {
+            Customer saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(UUID.randomUUID());
+            }
+            return saved;
+        });
+        when(quoteLineItemRepo.findByQuoteSessionId(sessionId)).thenReturn(List.of(qItem));
+        when(quoteSessionTotalsService.compute(eq(session), eq(List.of(qItem)))).thenReturn(
+                new QuoteSessionTotalsService.QuoteSessionTotals(
+                        new BigDecimal("9.50"),
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        new BigDecimal("9.50"),
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        BigDecimal.ZERO,
+                        new BigDecimal("9.50"),
+                        BigDecimal.ZERO
+                )
+        );
+        when(orderRepo.save(any(Order.class))).thenAnswer(invocation -> {
+            Order saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(orderId);
+            }
+            return saved;
+        });
+        when(orderItemRepo.save(any(OrderItem.class))).thenAnswer(invocation -> {
+            OrderItem saved = invocation.getArgument(0);
+            if (saved.getId() == null) {
+                saved.setId(orderItemId);
+            }
+            return saved;
+        });
+
+        IllegalStateException exception = assertThrows(
+                IllegalStateException.class,
+                () -> service.createOrderFromQuote(sessionId, buildRequest())
+        );
+
+        assertEquals(
+                "Source file not available for quote line item " + qItem.getId(),
+                exception.getMessage()
+        );
+        verify(paymentService, never()).getOrCreatePaymentForOrder(any(Order.class), eq("OTHER"));
+        verify(eventPublisher, never()).publishEvent(any(OrderCreatedEvent.class));
+    }
+
     private CreateOrderRequest buildRequest() {
         CustomerDto customer = new CustomerDto();
         customer.setEmail("buyer@example.com");

backend/src/test/java/com/printcalculator/service/admin/AdminShopProductControllerServiceTest.java

@@ -0,0 +1,137 @@
+package com.printcalculator.service.admin;
+
+import com.printcalculator.entity.ShopProduct;
+import com.printcalculator.entity.ShopProductModelAsset;
+import com.printcalculator.entity.ShopProductVariant;
+import com.printcalculator.repository.OrderItemRepository;
+import com.printcalculator.repository.QuoteLineItemRepository;
+import com.printcalculator.repository.ShopCategoryRepository;
+import com.printcalculator.repository.ShopProductModelAssetRepository;
+import com.printcalculator.repository.ShopProductRepository;
+import com.printcalculator.repository.ShopProductVariantRepository;
+import com.printcalculator.service.SlicerService;
+import com.printcalculator.service.media.PublicMediaQueryService;
+import com.printcalculator.service.shop.ShopStorageService;
+import com.printcalculator.service.storage.ClamAVService;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InOrder;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import java.nio.file.Path;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.inOrder;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class AdminShopProductControllerServiceTest {
+
+    @Mock
+    private ShopProductRepository shopProductRepository;
+    @Mock
+    private ShopCategoryRepository shopCategoryRepository;
+    @Mock
+    private ShopProductVariantRepository shopProductVariantRepository;
+    @Mock
+    private ShopProductModelAssetRepository shopProductModelAssetRepository;
+    @Mock
+    private QuoteLineItemRepository quoteLineItemRepository;
+    @Mock
+    private OrderItemRepository orderItemRepository;
+    @Mock
+    private PublicMediaQueryService publicMediaQueryService;
+    @Mock
+    private AdminMediaControllerService adminMediaControllerService;
+    @Mock
+    private ShopStorageService shopStorageService;
+    @Mock
+    private SlicerService slicerService;
+    @Mock
+    private ClamAVService clamAVService;
+
+    private AdminShopProductControllerService service;
+
+    @BeforeEach
+    void setUp() {
+        service = new AdminShopProductControllerService(
+                shopProductRepository,
+                shopCategoryRepository,
+                shopProductVariantRepository,
+                shopProductModelAssetRepository,
+                quoteLineItemRepository,
+                orderItemRepository,
+                publicMediaQueryService,
+                adminMediaControllerService,
+                shopStorageService,
+                slicerService,
+                clamAVService,
+                104857600L
+        );
+    }
+
+    @Test
+    void deleteProduct_shouldDeleteManagedDependenciesBeforeDeletingProduct() {
+        UUID productId = UUID.randomUUID();
+        UUID variantId = UUID.randomUUID();
+
+        ShopProduct product = new ShopProduct();
+        product.setId(productId);
+
+        ShopProductVariant variant = new ShopProductVariant();
+        variant.setId(variantId);
+        variant.setProduct(product);
+
+        ShopProductModelAsset asset = new ShopProductModelAsset();
+        asset.setId(UUID.randomUUID());
+        asset.setProduct(product);
+        asset.setStoredRelativePath("products/" + productId + "/model.stl");
+
+        when(shopProductRepository.findById(productId)).thenReturn(Optional.of(product));
+        when(quoteLineItemRepository.existsByShopProduct_Id(productId)).thenReturn(false);
+        when(orderItemRepository.existsByShopProduct_Id(productId)).thenReturn(false);
+        when(shopProductVariantRepository.findByProduct_IdOrderBySortOrderAscColorNameAsc(productId)).thenReturn(List.of(variant));
+        when(quoteLineItemRepository.existsByShopProductVariant_Id(variantId)).thenReturn(false);
+        when(orderItemRepository.existsByShopProductVariant_Id(variantId)).thenReturn(false);
+        when(shopProductModelAssetRepository.findByProduct_Id(productId)).thenReturn(Optional.of(asset));
+        when(shopStorageService.resolveStoredProductPath(asset.getStoredRelativePath(), productId))
+                .thenReturn(Path.of("/tmp/shop-model.stl"));
+
+        service.deleteProduct(productId);
+
+        InOrder inOrder = inOrder(shopProductModelAssetRepository, shopProductVariantRepository, shopProductRepository);
+        inOrder.verify(shopProductModelAssetRepository).delete(asset);
+        inOrder.verify(shopProductVariantRepository).deleteAll(List.of(variant));
+        inOrder.verify(shopProductRepository).delete(product);
+
+        verify(shopStorageService).resolveStoredProductPath(asset.getStoredRelativePath(), productId);
+    }
+
+    @Test
+    void deleteProduct_shouldSkipDependencyDeletesWhenNothingIsAttached() {
+        UUID productId = UUID.randomUUID();
+
+        ShopProduct product = new ShopProduct();
+        product.setId(productId);
+
+        when(shopProductRepository.findById(productId)).thenReturn(Optional.of(product));
+        when(quoteLineItemRepository.existsByShopProduct_Id(productId)).thenReturn(false);
+        when(orderItemRepository.existsByShopProduct_Id(productId)).thenReturn(false);
+        when(shopProductVariantRepository.findByProduct_IdOrderBySortOrderAscColorNameAsc(productId)).thenReturn(List.of());
+        when(shopProductModelAssetRepository.findByProduct_Id(productId)).thenReturn(Optional.empty());
+
+        service.deleteProduct(productId);
+
+        verify(shopProductRepository).delete(product);
+        verify(shopProductVariantRepository, never()).deleteAll(any());
+        verify(shopProductModelAssetRepository, never()).delete(any());
+    }
+}

backend/src/test/java/com/printcalculator/service/admin/AdminShopProductTranslationServiceTest.java

@@ -0,0 +1,226 @@
+package com.printcalculator.service.admin;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.printcalculator.dto.AdminTranslateShopProductRequest;
+import com.printcalculator.dto.AdminTranslateShopProductResponse;
+import com.printcalculator.repository.ShopCategoryRepository;
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpServer;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.net.InetSocketAddress;
+import java.nio.charset.StandardCharsets;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.UUID;
+import java.util.concurrent.CopyOnWriteArrayList;
+import java.util.concurrent.atomic.AtomicInteger;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class AdminShopProductTranslationServiceTest {
+
+    @Mock
+    private ShopCategoryRepository shopCategoryRepository;
+
+    private HttpServer server;
+
+    @AfterEach
+    void tearDown() {
+        if (server != null) {
+            server.stop(0);
+        }
+    }
+
+    @Test
+    void translateProduct_shouldCallOpenAiTwiceAndReturnReviewedTranslations() throws Exception {
+        ObjectMapper objectMapper = new ObjectMapper();
+        List<JsonNode> capturedRequests = new CopyOnWriteArrayList<>();
+        AtomicInteger requestCounter = new AtomicInteger();
+        server = HttpServer.create(new InetSocketAddress(0), 0);
+        server.createContext("/v1/responses", exchange -> {
+            capturedRequests.add(readBody(objectMapper, exchange));
+            int currentRequest = requestCounter.incrementAndGet();
+            String functionName = currentRequest == 1
+                    ? "generate_product_translations"
+                    : "review_product_translations";
+            String body = functionResponse(
+                    objectMapper,
+                    functionName,
+                    Map.of(
+                            "en", localized("Desk cable clip", "Technical desk accessory", "<p>Desk cable clip for clean cable routing.</p>", "Desk cable clip | 3D fab", "Technical 3D printed desk cable clip for clean cable routing."),
+                            "de", localized("Schreibtisch-Kabelhalter", "Technisches Schreibtisch-Zubehor", "<p>Kabelhalter fur einen aufgeraumten Schreibtisch.</p>", "Schreibtisch-Kabelhalter | 3D fab", "Technischer 3D-gedruckter Kabelhalter fur einen aufgeraumten Schreibtisch."),
+                            "fr", localized("Support de cable de bureau", "Accessoire technique de bureau", "<p>Support de cable pour un bureau ordonne.</p>", "Support de cable de bureau | 3D fab", "Support de cable de bureau imprime en 3D pour garder un espace ordonne.")
+                    )
+            );
+            writeJsonResponse(exchange, body);
+        });
+        server.start();
+
+        when(shopCategoryRepository.findById(UUID.fromString("00000000-0000-0000-0000-000000000001")))
+                .thenReturn(Optional.empty());
+
+        AdminShopProductTranslationService service = new AdminShopProductTranslationService(
+                shopCategoryRepository,
+                objectMapper,
+                "test-key",
+                "http://127.0.0.1:" + server.getAddress().getPort() + "/v1",
+                "gpt-5.4",
+                20,
+                "test-cache-key",
+                "Use concise ecommerce wording."
+        );
+
+        AdminTranslateShopProductRequest payload = new AdminTranslateShopProductRequest();
+        payload.setCategoryId(UUID.fromString("00000000-0000-0000-0000-000000000001"));
+        payload.setSourceLanguage("it");
+        payload.setOverwriteExisting(false);
+        payload.setMaterialCodes(List.of("pla", "petg"));
+        payload.setNames(Map.of(
+                "it", "Supporto cavo scrivania",
+                "en", "",
+                "de", "",
+                "fr", ""
+        ));
+        payload.setExcerpts(Map.of(
+                "it", "Accessorio tecnico",
+                "en", "",
+                "de", "",
+                "fr", ""
+        ));
+        payload.setDescriptions(Map.of(
+                "it", "<p>Supporto per tenere i cavi ordinati sulla scrivania.</p>",
+                "en", "",
+                "de", "",
+                "fr", ""
+        ));
+        payload.setSeoTitles(Map.of(
+                "it", "Supporto cavo scrivania | 3D fab",
+                "en", "",
+                "de", "",
+                "fr", ""
+        ));
+        payload.setSeoDescriptions(Map.of(
+                "it", "Supporto tecnico stampato in 3D per tenere i cavi in ordine sulla scrivania.",
+                "en", "",
+                "de", "",
+                "fr", ""
+        ));
+
+        AdminTranslateShopProductResponse response = service.translateProduct(payload);
+
+        assertEquals(List.of("en", "de", "fr"), response.getTargetLanguages());
+        assertEquals("Desk cable clip", response.getNames().get("en"));
+        assertTrue(response.getDescriptions().get("en").contains("<p>"));
+        assertEquals(2, capturedRequests.size());
+        assertEquals("required", capturedRequests.get(0).path("tool_choice").asText());
+        assertEquals("test-cache-key:generate", capturedRequests.get(0).path("prompt_cache_key").asText());
+        assertEquals("test-cache-key:review", capturedRequests.get(1).path("prompt_cache_key").asText());
+    }
+
+    @Test
+    void translateProduct_shouldSkipOpenAiWhenNoTargetLanguageNeedsUpdates() {
+        ObjectMapper objectMapper = new ObjectMapper();
+        AdminShopProductTranslationService service = new AdminShopProductTranslationService(
+                shopCategoryRepository,
+                objectMapper,
+                "test-key",
+                "http://127.0.0.1:65535/v1",
+                "gpt-5.4",
+                20,
+                "test-cache-key",
+                ""
+        );
+
+        AdminTranslateShopProductRequest payload = new AdminTranslateShopProductRequest();
+        payload.setSourceLanguage("it");
+        payload.setOverwriteExisting(false);
+        payload.setNames(Map.of(
+                "it", "Supporto cavo scrivania",
+                "en", "Desk cable clip",
+                "de", "Schreibtisch-Kabelhalter",
+                "fr", "Support de cable de bureau"
+        ));
+        payload.setExcerpts(Map.of(
+                "it", "Accessorio tecnico",
+                "en", "Technical desk accessory",
+                "de", "Technisches Schreibtisch-Zubehor",
+                "fr", "Accessoire technique de bureau"
+        ));
+        payload.setDescriptions(Map.of(
+                "it", "<p>Descrizione</p>",
+                "en", "<p>Description</p>",
+                "de", "<p>Beschreibung</p>",
+                "fr", "<p>Description</p>"
+        ));
+        payload.setSeoTitles(Map.of(
+                "it", "SEO IT",
+                "en", "SEO EN",
+                "de", "SEO DE",
+                "fr", "SEO FR"
+        ));
+        payload.setSeoDescriptions(Map.of(
+                "it", "SEO description IT",
+                "en", "SEO description EN",
+                "de", "SEO description DE",
+                "fr", "SEO description FR"
+        ));
+
+        AdminTranslateShopProductResponse response = service.translateProduct(payload);
+        assertTrue(response.getTargetLanguages().isEmpty());
+    }
+
+    private JsonNode readBody(ObjectMapper objectMapper, HttpExchange exchange) throws IOException {
+        return objectMapper.readTree(exchange.getRequestBody());
+    }
+
+    private void writeJsonResponse(HttpExchange exchange, String body) throws IOException {
+        byte[] bytes = body.getBytes(StandardCharsets.UTF_8);
+        exchange.getResponseHeaders().set("Content-Type", "application/json");
+        exchange.sendResponseHeaders(200, bytes.length);
+        try (OutputStream outputStream = exchange.getResponseBody()) {
+            outputStream.write(bytes);
+        }
+    }
+
+    private String functionResponse(ObjectMapper objectMapper,
+                                    String functionName,
+                                    Map<String, Map<String, String>> translations) throws IOException {
+        Map<String, Object> arguments = Map.of("translations", translations);
+        Map<String, Object> item = Map.of(
+                "type", "function_call",
+                "name", functionName,
+                "arguments", objectMapper.writeValueAsString(arguments)
+        );
+        Map<String, Object> response = Map.of(
+                "id", "resp_test",
+                "output", List.of(item)
+        );
+        return objectMapper.writeValueAsString(response);
+    }
+
+    private Map<String, String> localized(String name,
+                                          String excerpt,
+                                          String description,
+                                          String seoTitle,
+                                          String seoDescription) {
+        return Map.of(
+                "name", name,
+                "excerpt", excerpt,
+                "description", description,
+                "seoTitle", seoTitle,
+                "seoDescription", seoDescription
+        );
+    }
+}

backend/src/test/java/com/printcalculator/service/media/MediaFfmpegServiceTest.java

@@ -10,6 +10,7 @@ import java.nio.file.attribute.PosixFilePermission;
 import java.util.Set;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 
@@ -80,6 +81,12 @@ class MediaFfmpegServiceTest {
                         EOF
                           exit 0
                         fi
+                        if [ "$1" = "-hide_banner" ] && [ "$2" = "-muxers" ]; then
+                          cat <<'EOF'
+                         E avif
+                        EOF
+                          exit 0
+                        fi
 
                         for arg in "$@"; do
                           if [ "$arg" = "-still-picture" ]; then
@@ -117,4 +124,42 @@ class MediaFfmpegServiceTest {
         assertTrue(Files.exists(target));
         assertEquals("ok", Files.readString(target));
     }
+
+    @Test
+    void canEncode_avifShouldRequireMuxerAvailability() throws Exception {
+        Path fakeFfmpeg = tempDir.resolve("fake-ffmpeg-no-avif-muxer.sh");
+        Files.writeString(
+                fakeFfmpeg,
+                """
+                        #!/bin/sh
+                        if [ "$1" = "-hide_banner" ] && [ "$2" = "-encoders" ]; then
+                          cat <<'EOF'
+                         V..... mjpeg
+                         V..... libaom-av1
+                        EOF
+                          exit 0
+                        fi
+                        if [ "$1" = "-hide_banner" ] && [ "$2" = "-muxers" ]; then
+                          cat <<'EOF'
+                         E mp4
+                        EOF
+                          exit 0
+                        fi
+                        exit 0
+                        """
+        );
+        Files.setPosixFilePermissions(
+                fakeFfmpeg,
+                Set.of(
+                        PosixFilePermission.OWNER_READ,
+                        PosixFilePermission.OWNER_WRITE,
+                        PosixFilePermission.OWNER_EXECUTE
+                )
+        );
+
+        MediaFfmpegService service = new MediaFfmpegService(fakeFfmpeg.toString());
+
+        assertTrue(service.canEncode("JPEG"));
+        assertFalse(service.canEncode("AVIF"));
+    }
 }

backend/src/test/java/com/printcalculator/service/shop/ShopSitemapServiceTest.java

@@ -0,0 +1,122 @@
+package com.printcalculator.service.shop;
+
+import com.printcalculator.entity.ShopCategory;
+import com.printcalculator.entity.ShopProduct;
+import com.printcalculator.repository.ShopCategoryRepository;
+import com.printcalculator.repository.ShopProductRepository;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import java.time.Clock;
+import java.time.Instant;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
+import java.util.List;
+import java.util.UUID;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class ShopSitemapServiceTest {
+
+    @Mock
+    private ShopCategoryRepository shopCategoryRepository;
+    @Mock
+    private ShopProductRepository shopProductRepository;
+
+    private ShopSitemapService service;
+
+    @BeforeEach
+    void setUp() {
+        Clock fixedClock = Clock.fixed(Instant.parse("2026-03-11T10:00:00Z"), ZoneOffset.UTC);
+        service = new ShopSitemapService(
+                shopCategoryRepository,
+                shopProductRepository,
+                "https://3d-fab.ch/",
+                900,
+                fixedClock
+        );
+    }
+
+    @Test
+    void getShopSitemapXml_shouldGenerateLocalizedCategoryAndProductEntries() {
+        ShopCategory visibleCategory = new ShopCategory();
+        visibleCategory.setId(UUID.fromString("21111111-1111-1111-1111-111111111111"));
+        visibleCategory.setSlug("accessori");
+        visibleCategory.setIndexable(true);
+        visibleCategory.setIsActive(true);
+        visibleCategory.setUpdatedAt(OffsetDateTime.parse("2026-03-10T08:00:00Z"));
+
+        ShopCategory hiddenCategory = new ShopCategory();
+        hiddenCategory.setId(UUID.fromString("22222222-2222-2222-2222-222222222222"));
+        hiddenCategory.setSlug("bozza");
+        hiddenCategory.setIndexable(false);
+        hiddenCategory.setIsActive(true);
+        hiddenCategory.setUpdatedAt(OffsetDateTime.parse("2026-03-10T09:00:00Z"));
+
+        ShopProduct indexedProduct = new ShopProduct();
+        indexedProduct.setId(UUID.fromString("123e4567-e89b-12d3-a456-426614174000"));
+        indexedProduct.setCategory(visibleCategory);
+        indexedProduct.setSlug("supporto-bici");
+        indexedProduct.setNameIt("Supporto bici");
+        indexedProduct.setNameEn("Bike Holder");
+        indexedProduct.setNameDe("Fahrrad Halter");
+        indexedProduct.setNameFr("Support velo");
+        indexedProduct.setIndexable(true);
+        indexedProduct.setIsActive(true);
+        indexedProduct.setUpdatedAt(OffsetDateTime.parse("2026-03-11T07:30:00Z"));
+
+        ShopProduct hiddenProduct = new ShopProduct();
+        hiddenProduct.setId(UUID.fromString("33333333-3333-3333-3333-333333333333"));
+        hiddenProduct.setCategory(visibleCategory);
+        hiddenProduct.setSlug("draft");
+        hiddenProduct.setIndexable(false);
+        hiddenProduct.setIsActive(true);
+        hiddenProduct.setUpdatedAt(OffsetDateTime.parse("2026-03-11T08:00:00Z"));
+
+        when(shopCategoryRepository.findAllByIsActiveTrueOrderBySortOrderAscNameAsc())
+                .thenReturn(List.of(visibleCategory, hiddenCategory));
+        when(shopProductRepository.findAllByIsActiveTrueOrderByIsFeaturedDescSortOrderAscNameAsc())
+                .thenReturn(List.of(indexedProduct, hiddenProduct));
+
+        String xml = service.getShopSitemapXml();
+
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/it/shop/accessori</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/en/shop/accessori</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/de/shop/accessori</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/fr/shop/accessori</loc>"));
+        assertTrue(xml.contains("hreflang=\"en\" href=\"https://3d-fab.ch/en/shop/accessori\""));
+        assertFalse(xml.contains("https://3d-fab.ch/it/shop/bozza"));
+
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/it/shop/p/123e4567-supporto-bici</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/en/shop/p/123e4567-bike-holder</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/de/shop/p/123e4567-fahrrad-halter</loc>"));
+        assertTrue(xml.contains("<loc>https://3d-fab.ch/fr/shop/p/123e4567-support-velo</loc>"));
+        assertTrue(xml.contains("hreflang=\"en\" href=\"https://3d-fab.ch/en/shop/p/123e4567-bike-holder\""));
+        assertTrue(xml.contains("hreflang=\"de\" href=\"https://3d-fab.ch/de/shop/p/123e4567-fahrrad-halter\""));
+        assertTrue(xml.contains("hreflang=\"x-default\" href=\"https://3d-fab.ch/it/shop/p/123e4567-supporto-bici\""));
+        assertTrue(xml.contains("<lastmod>2026-03-11T07:30:00Z</lastmod>"));
+        assertFalse(xml.contains("33333333-draft"));
+    }
+
+    @Test
+    void getShopSitemapXml_shouldServeCachedPayloadWithinTtl() {
+        when(shopCategoryRepository.findAllByIsActiveTrueOrderBySortOrderAscNameAsc()).thenReturn(List.of());
+        when(shopProductRepository.findAllByIsActiveTrueOrderByIsFeaturedDescSortOrderAscNameAsc()).thenReturn(List.of());
+
+        String firstXml = service.getShopSitemapXml();
+        String secondXml = service.getShopSitemapXml();
+
+        assertTrue(firstXml.contains("<urlset"));
+        assertTrue(secondXml.contains("<urlset"));
+        verify(shopCategoryRepository, times(1)).findAllByIsActiveTrueOrderBySortOrderAscNameAsc();
+        verify(shopProductRepository, times(1)).findAllByIsActiveTrueOrderByIsFeaturedDescSortOrderAscNameAsc();
+    }
+}

db.sql

@@ -44,6 +44,10 @@ create table filament_variant
 
     variant_display_name      text           not null, -- es: "PLA Nero Opaco BrandX"
     color_name                text           not null, -- Nero, Bianco, ecc.
+    color_label_it            text,
+    color_label_en            text,
+    color_label_de            text,
+    color_label_fr            text,
     color_hex                 text,
     finish_type               text           not null default 'GLOSSY'
         check (finish_type in ('GLOSSY', 'MATTE', 'MARBLE', 'SILK', 'TRANSLUCENT', 'SPECIAL')),
@@ -70,6 +74,22 @@ select filament_variant_id,
        (stock_spools * spool_net_kg) as stock_kg
 from filament_variant;
 
+alter table filament_variant
+    add column if not exists color_label_it text,
+    add column if not exists color_label_en text,
+    add column if not exists color_label_de text,
+    add column if not exists color_label_fr text;
+
+update filament_variant
+set color_label_it = coalesce(nullif(btrim(color_label_it), ''), color_name),
+    color_label_en = coalesce(nullif(btrim(color_label_en), ''), color_name),
+    color_label_de = coalesce(nullif(btrim(color_label_de), ''), color_name),
+    color_label_fr = coalesce(nullif(btrim(color_label_fr), ''), color_name)
+where nullif(btrim(color_label_it), '') is null
+   or nullif(btrim(color_label_en), '') is null
+   or nullif(btrim(color_label_de), '') is null
+   or nullif(btrim(color_label_fr), '') is null;
+
 create table printer_machine_profile
 (
     printer_machine_profile_id bigserial primary key,
@@ -1013,9 +1033,25 @@ CREATE TABLE IF NOT EXISTS shop_category
     parent_category_id  uuid REFERENCES shop_category (shop_category_id) ON DELETE SET NULL,
     slug                text        NOT NULL UNIQUE,
     name                text        NOT NULL,
+    name_it             text,
+    name_en             text,
+    name_de             text,
+    name_fr             text,
     description         text,
+    description_it      text,
+    description_en      text,
+    description_de      text,
+    description_fr      text,
     seo_title           text,
+    seo_title_it        text,
+    seo_title_en        text,
+    seo_title_de        text,
+    seo_title_fr        text,
     seo_description     text,
+    seo_description_it  text,
+    seo_description_en  text,
+    seo_description_de  text,
+    seo_description_fr  text,
     og_title            text,
     og_description      text,
     indexable           boolean     NOT NULL DEFAULT true,
@@ -1034,6 +1070,66 @@ CREATE INDEX IF NOT EXISTS ix_shop_category_parent_sort
 CREATE INDEX IF NOT EXISTS ix_shop_category_active_sort
     ON shop_category (is_active, sort_order, created_at DESC);
 
+ALTER TABLE shop_category
+    ADD COLUMN IF NOT EXISTS name_it text,
+    ADD COLUMN IF NOT EXISTS name_en text,
+    ADD COLUMN IF NOT EXISTS name_de text,
+    ADD COLUMN IF NOT EXISTS name_fr text,
+    ADD COLUMN IF NOT EXISTS description_it text,
+    ADD COLUMN IF NOT EXISTS description_en text,
+    ADD COLUMN IF NOT EXISTS description_de text,
+    ADD COLUMN IF NOT EXISTS description_fr text,
+    ADD COLUMN IF NOT EXISTS seo_title_it text,
+    ADD COLUMN IF NOT EXISTS seo_title_en text,
+    ADD COLUMN IF NOT EXISTS seo_title_de text,
+    ADD COLUMN IF NOT EXISTS seo_title_fr text,
+    ADD COLUMN IF NOT EXISTS seo_description_it text,
+    ADD COLUMN IF NOT EXISTS seo_description_en text,
+    ADD COLUMN IF NOT EXISTS seo_description_de text,
+    ADD COLUMN IF NOT EXISTS seo_description_fr text;
+
+UPDATE shop_category
+SET
+    name_it = COALESCE(NULLIF(btrim(name_it), ''), name),
+    name_en = COALESCE(NULLIF(btrim(name_en), ''), name),
+    name_de = COALESCE(NULLIF(btrim(name_de), ''), name),
+    name_fr = COALESCE(NULLIF(btrim(name_fr), ''), name),
+    description_it = COALESCE(NULLIF(btrim(description_it), ''), description),
+    description_en = COALESCE(NULLIF(btrim(description_en), ''), description),
+    description_de = COALESCE(NULLIF(btrim(description_de), ''), description),
+    description_fr = COALESCE(NULLIF(btrim(description_fr), ''), description),
+    seo_title_it = COALESCE(NULLIF(btrim(seo_title_it), ''), seo_title),
+    seo_title_en = COALESCE(NULLIF(btrim(seo_title_en), ''), seo_title),
+    seo_title_de = COALESCE(NULLIF(btrim(seo_title_de), ''), seo_title),
+    seo_title_fr = COALESCE(NULLIF(btrim(seo_title_fr), ''), seo_title),
+    seo_description_it = COALESCE(NULLIF(btrim(seo_description_it), ''), seo_description),
+    seo_description_en = COALESCE(NULLIF(btrim(seo_description_en), ''), seo_description),
+    seo_description_de = COALESCE(NULLIF(btrim(seo_description_de), ''), seo_description),
+    seo_description_fr = COALESCE(NULLIF(btrim(seo_description_fr), ''), seo_description)
+WHERE
+    NULLIF(btrim(name_it), '') IS NULL
+    OR NULLIF(btrim(name_en), '') IS NULL
+    OR NULLIF(btrim(name_de), '') IS NULL
+    OR NULLIF(btrim(name_fr), '') IS NULL
+    OR (description IS NOT NULL AND (
+        NULLIF(btrim(description_it), '') IS NULL
+        OR NULLIF(btrim(description_en), '') IS NULL
+        OR NULLIF(btrim(description_de), '') IS NULL
+        OR NULLIF(btrim(description_fr), '') IS NULL
+    ))
+    OR (seo_title IS NOT NULL AND (
+        NULLIF(btrim(seo_title_it), '') IS NULL
+        OR NULLIF(btrim(seo_title_en), '') IS NULL
+        OR NULLIF(btrim(seo_title_de), '') IS NULL
+        OR NULLIF(btrim(seo_title_fr), '') IS NULL
+    ))
+    OR (seo_description IS NOT NULL AND (
+        NULLIF(btrim(seo_description_it), '') IS NULL
+        OR NULLIF(btrim(seo_description_en), '') IS NULL
+        OR NULLIF(btrim(seo_description_de), '') IS NULL
+        OR NULLIF(btrim(seo_description_fr), '') IS NULL
+    ));
+
 CREATE TABLE IF NOT EXISTS shop_product
 (
     shop_product_id     uuid PRIMARY KEY     DEFAULT gen_random_uuid(),
@@ -1055,7 +1151,15 @@ CREATE TABLE IF NOT EXISTS shop_product
     description_de      text,
     description_fr      text,
     seo_title           text,
+    seo_title_it        text,
+    seo_title_en        text,
+    seo_title_de        text,
+    seo_title_fr        text,
     seo_description     text,
+    seo_description_it  text,
+    seo_description_en  text,
+    seo_description_de  text,
+    seo_description_fr  text,
     og_title            text,
     og_description      text,
     indexable           boolean     NOT NULL DEFAULT true,
@@ -1066,6 +1170,16 @@ CREATE TABLE IF NOT EXISTS shop_product
     updated_at          timestamptz NOT NULL DEFAULT now()
 );
 
+ALTER TABLE shop_product
+    ADD COLUMN IF NOT EXISTS seo_title_it text,
+    ADD COLUMN IF NOT EXISTS seo_title_en text,
+    ADD COLUMN IF NOT EXISTS seo_title_de text,
+    ADD COLUMN IF NOT EXISTS seo_title_fr text,
+    ADD COLUMN IF NOT EXISTS seo_description_it text,
+    ADD COLUMN IF NOT EXISTS seo_description_en text,
+    ADD COLUMN IF NOT EXISTS seo_description_de text,
+    ADD COLUMN IF NOT EXISTS seo_description_fr text;
+
 CREATE INDEX IF NOT EXISTS ix_shop_product_category_active_sort
     ON shop_product (shop_category_id, is_active, sort_order, created_at DESC);
 
@@ -1147,6 +1261,10 @@ CREATE TABLE IF NOT EXISTS shop_product_variant
     sku                     text UNIQUE,
     variant_label           text        NOT NULL,
     color_name              text        NOT NULL,
+    color_label_it          text,
+    color_label_en          text,
+    color_label_de          text,
+    color_label_fr          text,
     color_hex               text,
     internal_material_code  text        NOT NULL,
     price_chf               numeric(12, 2) NOT NULL DEFAULT 0.00 CHECK (price_chf >= 0),
@@ -1163,6 +1281,22 @@ CREATE INDEX IF NOT EXISTS ix_shop_product_variant_product_active_sort
 CREATE INDEX IF NOT EXISTS ix_shop_product_variant_sku
     ON shop_product_variant (sku);
 
+ALTER TABLE shop_product_variant
+    ADD COLUMN IF NOT EXISTS color_label_it text,
+    ADD COLUMN IF NOT EXISTS color_label_en text,
+    ADD COLUMN IF NOT EXISTS color_label_de text,
+    ADD COLUMN IF NOT EXISTS color_label_fr text;
+
+UPDATE shop_product_variant
+SET color_label_it = COALESCE(NULLIF(btrim(color_label_it), ''), color_name),
+    color_label_en = COALESCE(NULLIF(btrim(color_label_en), ''), color_name),
+    color_label_de = COALESCE(NULLIF(btrim(color_label_de), ''), color_name),
+    color_label_fr = COALESCE(NULLIF(btrim(color_label_fr), ''), color_name)
+WHERE NULLIF(btrim(color_label_it), '') IS NULL
+   OR NULLIF(btrim(color_label_en), '') IS NULL
+   OR NULLIF(btrim(color_label_de), '') IS NULL
+   OR NULLIF(btrim(color_label_fr), '') IS NULL;
+
 CREATE TABLE IF NOT EXISTS shop_product_model_asset
 (
     shop_product_model_asset_id uuid PRIMARY KEY     DEFAULT gen_random_uuid(),

docker-compose.deploy.yml

@@ -29,11 +29,17 @@ services:
       - ADMIN_PASSWORD=${ADMIN_PASSWORD}
       - ADMIN_SESSION_SECRET=${ADMIN_SESSION_SECRET}
       - ADMIN_SESSION_TTL_MINUTES=${ADMIN_SESSION_TTL_MINUTES:-480}
+      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
+      - OPENAI_BASE_URL=${OPENAI_BASE_URL:-}
+      - OPENAI_TRANSLATION_MODEL=${OPENAI_TRANSLATION_MODEL:-}
+      - OPENAI_TRANSLATION_TIMEOUT_SECONDS=${OPENAI_TRANSLATION_TIMEOUT_SECONDS:-}
+      - OPENAI_TRANSLATION_PROMPT_CACHE_KEY_PREFIX=${OPENAI_TRANSLATION_PROMPT_CACHE_KEY_PREFIX:-}
+      - OPENAI_TRANSLATION_BUSINESS_CONTEXT=${OPENAI_TRANSLATION_BUSINESS_CONTEXT:-}
       - TEMP_DIR=/app/temp
       - PROFILES_DIR=/app/profiles
       - MEDIA_STORAGE_ROOT=${MEDIA_STORAGE_ROOT:-/app/storage_media}
       - SHOP_STORAGE_ROOT=${SHOP_STORAGE_ROOT:-/app/storage_shop}
-      - MEDIA_FFMPEG_PATH=${MEDIA_FFMPEG_PATH:-ffmpeg}
+      - MEDIA_FFMPEG_PATH=${MEDIA_FFMPEG_PATH:-/usr/local/bin/ffmpeg-media}
       - MEDIA_UPLOAD_MAX_FILE_SIZE_BYTES=${MEDIA_UPLOAD_MAX_FILE_SIZE_BYTES:-26214400}
     restart: always
     logging:

frontend/Dockerfile

@@ -1,14 +1,13 @@
-# Stage 1: Build
+FROM node:22-alpine
-FROM node:20 as build
 
 WORKDIR /app
 COPY package*.json ./
-RUN npm install
+RUN npm ci --legacy-peer-deps
 COPY . .
-RUN npm run build --configuration=production
+RUN npm run build -- --configuration=production
 
-# Stage 2: Serve
+ENV NODE_ENV=production
-FROM nginx:alpine
+ENV PORT=80
-COPY --from=build /app/dist/frontend/browser /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
 EXPOSE 80
+
+CMD ["node", "dist/frontend/server/server.mjs"]

frontend/Dockerfile.dev

@@ -1,15 +1,15 @@
-# Stage 1: Build
+FROM node:22-alpine
-FROM node:20 as build
 
 WORKDIR /app
 COPY package*.json ./
-RUN npm install
+RUN npm ci --legacy-peer-deps
 COPY . .
+
 # Use development configuration to pick up environment.ts (localhost)
 RUN npm run build -- --configuration=development
 
-# Stage 2: Serve
+ENV NODE_ENV=development
-FROM nginx:alpine
+ENV PORT=80
-COPY --from=build /app/dist/frontend/browser /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
 EXPOSE 80
+
+CMD ["node", "dist/frontend/server/server.mjs"]

frontend/angular.json

@@ -36,7 +36,12 @@
               "@angular/material/prebuilt-themes/azure-blue.css",
               "src/styles.scss"
             ],
-            "scripts": []
+            "scripts": [],
+            "server": "src/main.server.ts",
+            "prerender": false,
+            "ssr": {
+              "entry": "src/server.ts"
+            }
           },
           "configurations": {
             "production": {
@@ -56,13 +61,13 @@
               "budgets": [
                 {
                   "type": "initial",
-                  "maximumWarning": "500kB",
+                  "maximumWarning": "600kB",
-                  "maximumError": "1MB"
+                  "maximumError": "1.2MB"
                 },
                 {
                   "type": "anyComponentStyle",
-                  "maximumWarning": "4kB",
+                  "maximumWarning": "10kB",
-                  "maximumError": "8kB"
+                  "maximumError": "14kB"
                 }
               ]
             },

frontend/package.json

@@ -6,35 +6,41 @@
     "start": "ng serve",
     "build": "ng build",
     "watch": "ng build --watch --configuration development",
-    "test": "ng test"
+    "test": "ng test",
+    "serve:ssr:frontend": "node dist/frontend/server/server.mjs"
   },
   "private": true,
   "engines": {
     "node": "^22.0.0"
   },
   "dependencies": {
-    "@angular/cdk": "^19.2.19",
+    "@angular/cdk": "19.2.19",
-    "@angular/common": "^19.2.18",
+    "@angular/common": "19.2.19",
-    "@angular/compiler": "^19.2.18",
+    "@angular/compiler": "19.2.19",
-    "@angular/core": "^19.2.18",
+    "@angular/core": "19.2.19",
-    "@angular/forms": "^19.2.18",
+    "@angular/forms": "19.2.19",
-    "@angular/material": "^19.2.19",
+    "@angular/material": "19.2.19",
-    "@angular/platform-browser": "^19.2.18",
+    "@angular/platform-browser": "19.2.19",
-    "@angular/platform-browser-dynamic": "^19.2.18",
+    "@angular/platform-browser-dynamic": "19.2.19",
-    "@angular/router": "^19.2.18",
+    "@angular/platform-server": "19.2.19",
+    "@angular/router": "19.2.19",
+    "@angular/ssr": "19.2.19",
     "@ngx-translate/core": "^17.0.0",
     "@ngx-translate/http-loader": "^17.0.0",
     "@types/three": "^0.182.0",
+    "express": "^4.18.2",
     "rxjs": "~7.8.0",
     "three": "^0.182.0",
     "tslib": "^2.3.0",
     "zone.js": "~0.15.0"
   },
   "devDependencies": {
-    "@angular-devkit/build-angular": "^19.2.19",
+    "@angular-devkit/build-angular": "19.2.19",
-    "@angular/cli": "^19.2.19",
+    "@angular/cli": "19.2.19",
-    "@angular/compiler-cli": "^19.2.18",
+    "@angular/compiler-cli": "19.2.19",
+    "@types/express": "^4.17.17",
     "@types/jasmine": "~5.1.0",
+    "@types/node": "^18.18.0",
     "jasmine-core": "~5.6.0",
     "karma": "~6.4.0",
     "karma-chrome-launcher": "~3.2.0",

frontend/public/robots.txt

@@ -5,17 +5,19 @@ Disallow: /admin
 Disallow: /admin/
 Disallow: /*/admin
 Disallow: /*/admin/
+Disallow: /order
 Disallow: /order/
+Disallow: /*/order
 Disallow: /*/order/
+Disallow: /co$
 Disallow: /co/
+Disallow: /*/co$
 Disallow: /*/co/
 Disallow: /checkout
 Disallow: /checkout/
+Disallow: /checkout/cad
 Disallow: /*/checkout
 Disallow: /*/checkout/
-Disallow: /shop
+Disallow: /*/checkout/cad
-Disallow: /shop/
-Disallow: /*/shop
-Disallow: /*/shop/
 
 Sitemap: https://3d-fab.ch/sitemap.xml

frontend/public/sitemap-static.xml

@@ -0,0 +1,330 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
+  <url>
+    <loc>https://3d-fab.ch/it</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/calculator/basic</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/basic" />
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/calculator/basic</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/basic" />
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/calculator/basic</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/basic" />
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/calculator/basic</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/basic" />
+    <changefreq>weekly</changefreq>
+    <priority>0.9</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/calculator/advanced</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/advanced" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/calculator/advanced</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/advanced" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/calculator/advanced</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/advanced" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/calculator/advanced</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/calculator/advanced" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/shop</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/shop" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/shop" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/shop</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/shop" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/shop" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/shop</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/shop" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/shop" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/shop</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/shop" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/shop" />
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/about</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/about" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/about" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/about</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/about" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/about" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/about</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/about" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/about" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/about</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/about" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/about" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/contact</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/contact" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/contact" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/contact</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/contact" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/contact" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/contact</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/contact" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/contact" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/contact</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/contact" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/contact" />
+    <changefreq>monthly</changefreq>
+    <priority>0.7</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/privacy</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/privacy" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/privacy" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/privacy</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/privacy" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/privacy" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/privacy</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/privacy" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/privacy" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/privacy</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/privacy" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/privacy" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+
+  <url>
+    <loc>https://3d-fab.ch/it/terms</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/terms" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/terms" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/en/terms</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/terms" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/terms" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de/terms</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/terms" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/terms" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr/terms</loc>
+    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/terms" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/terms" />
+    <changefreq>yearly</changefreq>
+    <priority>0.4</priority>
+  </url>
+</urlset>

frontend/public/sitemap.xml

@@ -1,144 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<urlset
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-  xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+  <sitemap>
-  xmlns:xhtml="http://www.w3.org/1999/xhtml"
+    <loc>https://3d-fab.ch/sitemap-static.xml</loc>
->
+  </sitemap>
-  <url>
+  <sitemap>
-    <loc>https://3d-fab.ch/it</loc>
+    <loc>https://3d-fab.ch/api/sitemap-shop.xml</loc>
-    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it" />
+  </sitemap>
-    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en" />
+</sitemapindex>
-    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de" />
-    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr" />
-    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it" />
-    <changefreq>weekly</changefreq>
-    <priority>1.0</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/calculator/basic</loc>
-    <xhtml:link
-      rel="alternate"
-      hreflang="it"
-      href="https://3d-fab.ch/it/calculator/basic"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="en"
-      href="https://3d-fab.ch/en/calculator/basic"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="de"
-      href="https://3d-fab.ch/de/calculator/basic"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="fr"
-      href="https://3d-fab.ch/fr/calculator/basic"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="x-default"
-      href="https://3d-fab.ch/it/calculator/basic"
-    />
-    <changefreq>weekly</changefreq>
-    <priority>0.9</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/calculator/advanced</loc>
-    <xhtml:link
-      rel="alternate"
-      hreflang="it"
-      href="https://3d-fab.ch/it/calculator/advanced"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="en"
-      href="https://3d-fab.ch/en/calculator/advanced"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="de"
-      href="https://3d-fab.ch/de/calculator/advanced"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="fr"
-      href="https://3d-fab.ch/fr/calculator/advanced"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="x-default"
-      href="https://3d-fab.ch/it/calculator/advanced"
-    />
-    <changefreq>weekly</changefreq>
-    <priority>0.8</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/about</loc>
-    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/about" />
-    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/about" />
-    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/about" />
-    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/about" />
-    <xhtml:link
-      rel="alternate"
-      hreflang="x-default"
-      href="https://3d-fab.ch/it/about"
-    />
-    <changefreq>monthly</changefreq>
-    <priority>0.7</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/contact</loc>
-    <xhtml:link
-      rel="alternate"
-      hreflang="it"
-      href="https://3d-fab.ch/it/contact"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="en"
-      href="https://3d-fab.ch/en/contact"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="de"
-      href="https://3d-fab.ch/de/contact"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="fr"
-      href="https://3d-fab.ch/fr/contact"
-    />
-    <xhtml:link
-      rel="alternate"
-      hreflang="x-default"
-      href="https://3d-fab.ch/it/contact"
-    />
-    <changefreq>monthly</changefreq>
-    <priority>0.7</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/privacy</loc>
-    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/privacy" />
-    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/privacy" />
-    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/privacy" />
-    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/privacy" />
-    <xhtml:link
-      rel="alternate"
-      hreflang="x-default"
-      href="https://3d-fab.ch/it/privacy"
-    />
-    <changefreq>yearly</changefreq>
-    <priority>0.4</priority>
-  </url>
-  <url>
-    <loc>https://3d-fab.ch/it/terms</loc>
-    <xhtml:link rel="alternate" hreflang="it" href="https://3d-fab.ch/it/terms" />
-    <xhtml:link rel="alternate" hreflang="en" href="https://3d-fab.ch/en/terms" />
-    <xhtml:link rel="alternate" hreflang="de" href="https://3d-fab.ch/de/terms" />
-    <xhtml:link rel="alternate" hreflang="fr" href="https://3d-fab.ch/fr/terms" />
-    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/it/terms" />
-    <changefreq>yearly</changefreq>
-    <priority>0.4</priority>
-  </url>
-</urlset>

frontend/src/app/app.config.server.ts

@@ -0,0 +1,9 @@
+import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
+import { provideServerRendering } from '@angular/platform-server';
+import { appConfig } from './app.config';
+
+const serverConfig: ApplicationConfig = {
+  providers: [provideServerRendering()],
+};
+
+export const config = mergeApplicationConfig(appConfig, serverConfig);

frontend/src/app/app.config.ts

@@ -1,22 +1,48 @@
 import {
   ApplicationConfig,
+  provideAppInitializer,
   provideZoneChangeDetection,
   importProvidersFrom,
+  inject,
+  REQUEST,
 } from '@angular/core';
 import {
   provideRouter,
   withComponentInputBinding,
   withInMemoryScrolling,
   withViewTransitions,
+  Router,
 } from '@angular/router';
 import { routes } from './app.routes';
 import { provideHttpClient, withInterceptors } from '@angular/common/http';
-import { TranslateModule, TranslateLoader } from '@ngx-translate/core';
 import {
-  provideTranslateHttpLoader,
+  TranslateLoader,
-  TranslateHttpLoader,
+  TranslateModule,
-} from '@ngx-translate/http-loader';
+  TranslateService,
+} from '@ngx-translate/core';
 import { adminAuthInterceptor } from './core/interceptors/admin-auth.interceptor';
+import {
+  provideClientHydration,
+  withEventReplay,
+} from '@angular/platform-browser';
+import { serverOriginInterceptor } from './core/interceptors/server-origin.interceptor';
+import { catchError, firstValueFrom, of } from 'rxjs';
+import { StaticTranslateLoader } from './core/i18n/static-translate.loader';
+
+type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+const SUPPORTED_LANGS: readonly SupportedLang[] = ['it', 'en', 'de', 'fr'];
+
+function resolveLangFromUrl(url: string): SupportedLang {
+  const firstSegment = (url || '/')
+    .split('?')[0]
+    .split('#')[0]
+    .split('/')
+    .filter(Boolean)[0]
+    ?.toLowerCase();
+  return SUPPORTED_LANGS.includes(firstSegment as SupportedLang)
+    ? (firstSegment as SupportedLang)
+    : 'it';
+}
 
 export const appConfig: ApplicationConfig = {
   providers: [
@@ -29,19 +55,44 @@ export const appConfig: ApplicationConfig = {
         scrollPositionRestoration: 'top',
       }),
     ),
-    provideHttpClient(withInterceptors([adminAuthInterceptor])),
+    provideHttpClient(
-    provideTranslateHttpLoader({
+      withInterceptors([serverOriginInterceptor, adminAuthInterceptor]),
-      prefix: './assets/i18n/',
+    ),
-      suffix: '.json',
-    }),
     importProvidersFrom(
       TranslateModule.forRoot({
-        defaultLanguage: 'it',
+        fallbackLang: 'it',
         loader: {
           provide: TranslateLoader,
-          useClass: TranslateHttpLoader,
+          useClass: StaticTranslateLoader,
         },
       }),
     ),
+    provideAppInitializer(() => {
+      const translate = inject(TranslateService);
+      const router = inject(Router);
+      const request = inject(REQUEST, { optional: true }) as {
+        url?: string;
+      } | null;
+
+      translate.addLangs([...SUPPORTED_LANGS]);
+      translate.setFallbackLang('it');
+      const requestedUrl =
+        (typeof request?.url === 'string' && request.url) || router.url || '/';
+      const lang = resolveLangFromUrl(requestedUrl);
+
+      return firstValueFrom(
+        translate.use(lang).pipe(
+          catchError((error) => {
+            console.error('[i18n] Failed to preload language for SSR', {
+              lang,
+              requestedUrl,
+              error,
+            });
+            return of({});
+          }),
+        ),
+      ).then(() => undefined);
+    }),
+    provideClientHydration(withEventReplay()),
   ],
 };

frontend/src/app/app.routes.ts

@@ -1,4 +1,13 @@
-import { Routes } from '@angular/router';
+import { CanMatchFn, Routes } from '@angular/router';
+
+const SUPPORTED_LANGS = new Set(['it', 'en', 'de', 'fr']);
+
+const langPrefixCanMatch: CanMatchFn = (_route, segments) => {
+  if (segments.length === 0) {
+    return false;
+  }
+  return SUPPORTED_LANGS.has(segments[0].path.toLowerCase());
+};
 
 const appChildRoutes: Routes = [
   {
@@ -6,9 +15,8 @@ const appChildRoutes: Routes = [
     loadComponent: () =>
       import('./features/home/home.component').then((m) => m.HomeComponent),
     data: {
-      seoTitle: '3D fab | Stampa 3D su misura',
+      seoTitleKey: 'SEO.ROUTES.HOME.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.HOME.DESCRIPTION',
-        'Servizio di stampa 3D con preventivo online immediato per prototipi, piccole serie e pezzi personalizzati.',
     },
   },
   {
@@ -18,9 +26,8 @@ const appChildRoutes: Routes = [
         (m) => m.CALCULATOR_ROUTES,
       ),
     data: {
-      seoTitle: 'Calcolatore preventivo stampa 3D | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.DESCRIPTION',
-        'Carica il file 3D e ottieni prezzo e tempi in pochi secondi con slicing reale.',
     },
   },
   {
@@ -28,9 +35,8 @@ const appChildRoutes: Routes = [
     loadChildren: () =>
       import('./features/shop/shop.routes').then((m) => m.SHOP_ROUTES),
     data: {
-      seoTitle: 'Shop 3D fab',
+      seoTitleKey: 'SEO.ROUTES.SHOP.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.SHOP.DESCRIPTION',
-        'Catalogo prodotti stampati in 3D e soluzioni tecniche pronte all uso.',
     },
   },
   {
@@ -38,19 +44,28 @@ const appChildRoutes: Routes = [
     loadChildren: () =>
       import('./features/about/about.routes').then((m) => m.ABOUT_ROUTES),
     data: {
-      seoTitle: 'Chi siamo | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.ABOUT.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.ABOUT.DESCRIPTION',
-        'Scopri il team 3D fab e il laboratorio di stampa 3D con sedi in Ticino e Bienne.',
     },
   },
+  /* {
+    path: 'materials',
+    loadComponent: () =>
+      import('./features/materials/materials-page.component').then(
+        (m) => m.MaterialsPageComponent,
+      ),
+    data: {
+      seoTitleKey: 'SEO.ROUTES.MATERIALS.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.MATERIALS.DESCRIPTION',
+    },
+  },*/
   {
     path: 'contact',
     loadChildren: () =>
       import('./features/contact/contact.routes').then((m) => m.CONTACT_ROUTES),
     data: {
-      seoTitle: 'Contatti | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CONTACT.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.CONTACT.DESCRIPTION',
-        'Contatta 3D fab per preventivi, supporto tecnico e richieste personalizzate di stampa 3D.',
     },
   },
   {
@@ -60,7 +75,8 @@ const appChildRoutes: Routes = [
         (m) => m.CheckoutComponent,
       ),
     data: {
-      seoTitle: 'Checkout | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CHECKOUT.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CHECKOUT.DESCRIPTION',
       seoRobots: 'noindex, nofollow',
     },
   },
@@ -71,7 +87,8 @@ const appChildRoutes: Routes = [
         (m) => m.CheckoutComponent,
       ),
     data: {
-      seoTitle: 'Checkout | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CHECKOUT.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CHECKOUT.DESCRIPTION',
       seoRobots: 'noindex, nofollow',
     },
   },
@@ -80,7 +97,8 @@ const appChildRoutes: Routes = [
     loadComponent: () =>
       import('./features/order/order.component').then((m) => m.OrderComponent),
     data: {
-      seoTitle: 'Ordine | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.ORDER.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.ORDER.DESCRIPTION',
       seoRobots: 'noindex, nofollow',
     },
   },
@@ -89,7 +107,8 @@ const appChildRoutes: Routes = [
     loadComponent: () =>
       import('./features/order/order.component').then((m) => m.OrderComponent),
     data: {
-      seoTitle: 'Ordine | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.ORDER.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.ORDER.DESCRIPTION',
       seoRobots: 'noindex, nofollow',
     },
   },
@@ -103,7 +122,8 @@ const appChildRoutes: Routes = [
     loadChildren: () =>
       import('./features/admin/admin.routes').then((m) => m.ADMIN_ROUTES),
     data: {
-      seoTitle: 'Admin | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.ADMIN.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.ADMIN.DESCRIPTION',
       seoRobots: 'noindex, nofollow',
     },
   },
@@ -116,6 +136,7 @@ const appChildRoutes: Routes = [
 export const routes: Routes = [
   {
     path: ':lang',
+    canMatch: [langPrefixCanMatch],
     loadComponent: () =>
       import('./core/layout/layout.component').then((m) => m.LayoutComponent),
     children: appChildRoutes,

frontend/src/app/core/constants/colors.const.ts

@@ -11,6 +11,8 @@ export interface ColorCategory {
   colors: ColorOption[];
 }
 
+const DEFAULT_BRAND_COLOR = '#facf0a';
+
 export const PRODUCT_COLORS: ColorCategory[] = [
   {
     name: 'COLOR.CATEGORY_GLOSSY',
@@ -38,10 +40,81 @@ export const PRODUCT_COLORS: ColorCategory[] = [
   },
 ];
 
-export function getColorHex(value: string): string {
+export function normalizeColorValue(value: string | null | undefined): string {
-  for (const cat of PRODUCT_COLORS) {
+  return String(value ?? '')
-    const found = cat.colors.find((c) => c.value === value);
+    .trim()
-    if (found) return found.hex;
+    .toLowerCase()
-  }
+    .replace(/ß/g, 'ss')
-  return '#facf0a'; // Default Brand Color if not found
+    .normalize('NFD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .replace(/[_-]+/g, ' ')
+    .replace(/\s+/g, ' ');
+}
+
+export function findColorHex(value: string | null | undefined): string | null {
+  const normalized = normalizeColorValue(value);
+  if (!normalized) {
+    return null;
+  }
+
+  for (const category of PRODUCT_COLORS) {
+    const match = category.colors.find(
+      (color) => normalizeColorValue(color.value) === normalized,
+    );
+    if (match) {
+      return match.hex;
+    }
+  }
+
+  return null;
+}
+
+export interface LocalizedColorLabelSet {
+  fallback?: string | null;
+  it?: string | null;
+  en?: string | null;
+  de?: string | null;
+  fr?: string | null;
+}
+
+export function resolveLocalizedColorLabel(
+  language: string | null | undefined,
+  labels: LocalizedColorLabelSet,
+): string | null {
+  const normalizedLanguage = String(language ?? '')
+    .trim()
+    .toLowerCase()
+    .split('-')[0];
+
+  const preferred =
+    normalizedLanguage === 'it'
+      ? labels.it
+      : normalizedLanguage === 'en'
+        ? labels.en
+        : normalizedLanguage === 'de'
+          ? labels.de
+          : normalizedLanguage === 'fr'
+            ? labels.fr
+            : null;
+
+  return (
+    firstNonBlank(preferred, labels.fallback) ??
+    firstNonBlank(labels.it, labels.en, labels.de, labels.fr)
+  );
+}
+
+function firstNonBlank(
+  ...values: Array<string | null | undefined>
+): string | null {
+  for (const value of values) {
+    const normalized = String(value ?? '').trim();
+    if (normalized) {
+      return normalized;
+    }
+  }
+  return null;
+}
+
+export function getColorHex(value: string): string {
+  return findColorHex(value) ?? DEFAULT_BRAND_COLOR;
 }

frontend/src/app/core/i18n/static-translate.loader.ts

@@ -0,0 +1,89 @@
+import { isPlatformBrowser, isPlatformServer } from '@angular/common';
+import {
+  Injectable,
+  PLATFORM_ID,
+  TransferState,
+  inject,
+  makeStateKey,
+} from '@angular/core';
+import { TranslateLoader, TranslationObject } from '@ngx-translate/core';
+import { from, Observable } from 'rxjs';
+
+type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+
+const FALLBACK_LANG: SupportedLang = 'it';
+const translationCache = new Map<SupportedLang, Promise<TranslationObject>>();
+
+const translationLoaders: Record<SupportedLang, () => Promise<TranslationObject>> = {
+  it: () =>
+    import('../../../assets/i18n/it.json').then(
+      (module) => module.default as TranslationObject,
+    ),
+  en: () =>
+    import('../../../assets/i18n/en.json').then(
+      (module) => module.default as TranslationObject,
+    ),
+  de: () =>
+    import('../../../assets/i18n/de.json').then(
+      (module) => module.default as TranslationObject,
+    ),
+  fr: () =>
+    import('../../../assets/i18n/fr.json').then(
+      (module) => module.default as TranslationObject,
+    ),
+};
+
+@Injectable()
+export class StaticTranslateLoader implements TranslateLoader {
+  private readonly platformId = inject(PLATFORM_ID);
+  private readonly transferState = inject(TransferState);
+
+  getTranslation(lang: string): Observable<TranslationObject> {
+    const normalized = this.normalizeLanguage(lang);
+    return from(this.loadTranslation(normalized));
+  }
+
+  private normalizeLanguage(lang: string): SupportedLang {
+    const normalized = String(lang || FALLBACK_LANG).toLowerCase();
+    return normalized in translationLoaders
+      ? (normalized as SupportedLang)
+      : FALLBACK_LANG;
+  }
+
+  private loadTranslation(lang: SupportedLang): Promise<TranslationObject> {
+    const transferStateKey =
+      makeStateKey<TranslationObject>(`i18n:${lang.toLowerCase()}`);
+    if (
+      isPlatformBrowser(this.platformId) &&
+      this.transferState.hasKey(transferStateKey)
+    ) {
+      const transferred = this.transferState.get(transferStateKey, {});
+      this.transferState.remove(transferStateKey);
+      return Promise.resolve(transferred);
+    }
+
+    const cached = translationCache.get(lang);
+    if (cached) {
+      return cached;
+    }
+
+    const pending = translationLoaders[lang]()
+      .then((translation) => {
+        if (
+          isPlatformServer(this.platformId) &&
+          !this.transferState.hasKey(transferStateKey)
+        ) {
+          this.transferState.set(transferStateKey, translation);
+        }
+        return translation;
+      })
+      .catch(() =>
+        lang === FALLBACK_LANG
+          ? Promise.resolve({})
+          : this.loadTranslation(FALLBACK_LANG),
+      );
+
+    translationCache.set(lang, pending);
+    return pending;
+  }
+}

frontend/src/app/core/interceptors/server-origin.interceptor.ts

@@ -0,0 +1,30 @@
+import { HttpInterceptorFn } from '@angular/common/http';
+import { inject, REQUEST } from '@angular/core';
+import {
+  RequestLike,
+  resolveRequestOrigin,
+} from '../../../core/request-origin';
+
+function isAbsoluteUrl(url: string): boolean {
+  return /^[a-z][a-z\d+\-.]*:/i.test(url) || url.startsWith('//');
+}
+
+function normalizeRelativePath(url: string): string {
+  const withoutDot = url.replace(/^\.\//, '');
+  return withoutDot.startsWith('/') ? withoutDot : `/${withoutDot}`;
+}
+
+export const serverOriginInterceptor: HttpInterceptorFn = (req, next) => {
+  if (isAbsoluteUrl(req.url)) {
+    return next(req);
+  }
+
+  const request = inject(REQUEST, { optional: true }) as RequestLike | null;
+  const origin = resolveRequestOrigin(request);
+  if (!origin) {
+    return next(req);
+  }
+
+  const absoluteUrl = `${origin}${normalizeRelativePath(req.url)}`;
+  return next(req.clone({ url: absoluteUrl }));
+};

frontend/src/app/core/layout/footer.component.html

@@ -6,9 +6,15 @@
     </div>
 
     <div class="col links">
-      <a routerLink="/privacy">{{ "FOOTER.PRIVACY" | translate }}</a>
+      <a [routerLink]="languageService.localizedPath('/privacy')">{{
-      <a routerLink="/terms">{{ "FOOTER.TERMS" | translate }}</a>
+        "FOOTER.PRIVACY" | translate
-      <a routerLink="/contact">{{ "FOOTER.CONTACT" | translate }}</a>
+      }}</a>
+      <a [routerLink]="languageService.localizedPath('/terms')">{{
+        "FOOTER.TERMS" | translate
+      }}</a>
+      <a [routerLink]="languageService.localizedPath('/contact')">{{
+        "FOOTER.CONTACT" | translate
+      }}</a>
     </div>
 
     <div class="col social">

frontend/src/app/core/layout/footer.component.ts

@@ -1,6 +1,7 @@
-import { Component } from '@angular/core';
+import { Component, inject } from '@angular/core';
 import { TranslateModule } from '@ngx-translate/core';
 import { RouterLink } from '@angular/router';
+import { LanguageService } from '../services/language.service';
 
 @Component({
   selector: 'app-footer',
@@ -9,4 +10,6 @@ import { RouterLink } from '@angular/router';
   templateUrl: './footer.component.html',
   styleUrls: ['./footer.component.scss'],
 })
-export class FooterComponent {}
+export class FooterComponent {
+  readonly languageService = inject(LanguageService);
+}

frontend/src/app/core/layout/navbar.component.html

@@ -1,6 +1,8 @@
 <header class="navbar">
   <div class="container navbar-inner">
-    <a routerLink="/" class="brand">3D <span class="highlight">fab</span></a>
+    <a [routerLink]="langService.localizedPath('/')" class="brand"
+      >3D <span class="highlight">fab</span></a
+    >
 
     <div
       class="mobile-toggle"
@@ -14,27 +16,33 @@
 
     <nav class="nav-links" [class.open]="isMenuOpen">
       <a
-        routerLink="/"
+        [routerLink]="langService.localizedPath('/')"
         routerLinkActive="active"
         [routerLinkActiveOptions]="{ exact: true }"
         (click)="closeMenu()"
         >{{ "NAV.HOME" | translate }}</a
       >
       <a
-        routerLink="/calculator/basic"
+        [routerLink]="langService.localizedPath('/calculator/basic')"
         routerLinkActive="active"
         [routerLinkActiveOptions]="{ exact: false }"
         (click)="closeMenu()"
         >{{ "NAV.CALCULATOR" | translate }}</a
       >
-      <a routerLink="/shop" routerLinkActive="active" (click)="closeMenu()">{{
-        "NAV.SHOP" | translate
-      }}</a>
-      <a routerLink="/about" routerLinkActive="active" (click)="closeMenu()">{{
-        "NAV.ABOUT" | translate
-      }}</a>
       <a
-        routerLink="/contact"
+        [routerLink]="langService.localizedPath('/shop')"
+        routerLinkActive="active"
+        (click)="closeMenu()"
+        >{{ "NAV.SHOP" | translate }}</a
+      >
+      <a
+        [routerLink]="langService.localizedPath('/about')"
+        routerLinkActive="active"
+        (click)="closeMenu()"
+        >{{ "NAV.ABOUT" | translate }}</a
+      >
+      <a
+        [routerLink]="langService.localizedPath('/contact')"
         routerLinkActive="active"
         (click)="closeMenu()"
         >{{ "NAV.CONTACT" | translate }}</a
@@ -82,7 +90,10 @@
         }
       </select>
 
-      <div class="icon-placeholder" routerLink="/admin">
+      <div
+        class="icon-placeholder"
+        [routerLink]="langService.localizedPath('/admin')"
+      >
         <svg
           xmlns="http://www.w3.org/2000/svg"
           width="20"
@@ -130,7 +141,9 @@
                 <div class="cart-line-copy">
                   <strong>{{ cartItemName(item) }}</strong>
                   @if (cartItemVariant(item); as variant) {
-                    <span class="cart-line-meta">{{ variant }}</span>
+                    <span class="cart-line-meta">{{
+                      variant | translate
+                    }}</span>
                   }
                   @if (cartItemColor(item); as color) {
                     <span class="cart-line-color">
@@ -138,7 +151,7 @@
                         class="color-dot"
                         [style.background-color]="cartItemColorHex(item)"
                       ></span>
-                      <span>{{ color }}</span>
+                      <span>{{ color | translate }}</span>
                     </span>
                   }
                 </div>

frontend/src/app/core/layout/navbar.component.ts

@@ -1,5 +1,12 @@
 import { CommonModule } from '@angular/common';
-import { Component, DestroyRef, computed, inject, signal } from '@angular/core';
+import {
+  afterNextRender,
+  Component,
+  DestroyRef,
+  computed,
+  inject,
+  signal,
+} from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import {
   NavigationStart,
@@ -15,6 +22,10 @@ import {
   ShopService,
 } from '../../features/shop/services/shop.service';
 import { finalize } from 'rxjs';
+import {
+  findColorHex,
+  resolveLocalizedColorLabel,
+} from '../constants/colors.const';
 
 @Component({
   selector: 'app-navbar',
@@ -54,16 +65,9 @@ export class NavbarComponent {
   ];
 
   constructor(public langService: LanguageService) {
-    if (!this.shopService.cartLoaded()) {
+    afterNextRender(() => {
-      this.shopService
+      this.scheduleCartWarmup();
-        .loadCart()
-        .pipe(takeUntilDestroyed(this.destroyRef))
-        .subscribe({
-          error: () => {
-            this.shopService.cart.set(null);
-          },
     });
-    }
 
     this.router.events
       .pipe(takeUntilDestroyed(this.destroyRef))
@@ -92,6 +96,9 @@ export class NavbarComponent {
   toggleCart(): void {
     this.closeMenu();
     this.isCartOpen.update((open) => !open);
+    if (this.isCartOpen()) {
+      this.loadCartIfNeeded();
+    }
   }
 
   closeCart(): void {
@@ -129,7 +136,7 @@ export class NavbarComponent {
     }
 
     this.closeCart();
-    this.router.navigate(['/checkout'], {
+    this.router.navigate(['/', this.langService.selectedLang(), 'checkout'], {
       queryParams: {
         session: sessionId,
       },
@@ -143,15 +150,30 @@ export class NavbarComponent {
   }
 
   cartItemVariant(item: ShopCartItem): string | null {
-    return item.shopVariantLabel || item.shopVariantColorName || null;
+    return item.shopVariantLabel || this.cartItemColor(item);
   }
 
   cartItemColor(item: ShopCartItem): string | null {
-    return item.shopVariantColorName || item.colorCode || null;
+    return (
+      resolveLocalizedColorLabel(this.langService.selectedLang(), {
+        fallback: item.shopVariantColorName ?? item.colorCode,
+        it: item.shopVariantColorLabelIt,
+        en: item.shopVariantColorLabelEn,
+        de: item.shopVariantColorLabelDe,
+        fr: item.shopVariantColorLabelFr,
+      }) ??
+      item.shopVariantColorName ??
+      item.colorCode
+    );
   }
 
   cartItemColorHex(item: ShopCartItem): string {
-    return item.shopVariantColorHex || '#c9ced6';
+    return (
+      item.shopVariantColorHex ||
+      findColorHex(item.shopVariantColorName) ||
+      findColorHex(item.colorCode) ||
+      '#c9ced6'
+    );
   }
 
   trackByCartItem(_index: number, item: ShopCartItem): string {
@@ -173,5 +195,44 @@ export class NavbarComponent {
       .subscribe();
   }
 
+  private scheduleCartWarmup(): void {
+    if (typeof window === 'undefined') {
+      this.loadCartIfNeeded();
+      return;
+    }
+
+    const warmup = () => this.loadCartIfNeeded();
+    const idleCallback = (
+      window as Window & {
+        requestIdleCallback?: (
+          callback: IdleRequestCallback,
+          options?: IdleRequestOptions,
+        ) => number;
+      }
+    ).requestIdleCallback;
+
+    if (typeof idleCallback === 'function') {
+      idleCallback(() => warmup(), { timeout: 1500 });
+      return;
+    }
+
+    window.setTimeout(warmup, 300);
+  }
+
+  private loadCartIfNeeded(): void {
+    if (this.shopService.cartLoaded() || this.shopService.cartLoading()) {
+      return;
+    }
+
+    this.shopService
+      .loadCart()
+      .pipe(takeUntilDestroyed(this.destroyRef))
+      .subscribe({
+        error: () => {
+          this.shopService.cart.set(null);
+        },
+      });
+  }
+
   protected readonly routes = routes;
 }

frontend/src/app/core/services/language.service.spec.ts

@@ -9,7 +9,7 @@ describe('LanguageService', () => {
     const translate = {
       currentLang: '',
       addLangs: jasmine.createSpy('addLangs'),
-      setDefaultLang: jasmine.createSpy('setDefaultLang'),
+      setFallbackLang: jasmine.createSpy('setFallbackLang'),
       use: jasmine.createSpy('use').and.callFake((lang: string) => {
         translate.currentLang = lang;
         onLangChange.next({ lang });
@@ -75,6 +75,7 @@ describe('LanguageService', () => {
     const service = new LanguageService(translate, router);
 
     expect(translate.use).toHaveBeenCalledWith('it');
+    expect((translate as any).setFallbackLang).toHaveBeenCalledWith('it');
     expect(navigateSpy).toHaveBeenCalledTimes(1);
 
     const firstCall = navigateSpy.calls.mostRecent();
@@ -103,4 +104,15 @@ describe('LanguageService', () => {
       '/de/calculator?session=abc&mode=advanced',
     );
   });
+
+  it('builds localized paths for internal links while preserving query and hash', () => {
+    const translate = createTranslateMock();
+    const router = createRouterMock('/de/shop');
+    const service = new LanguageService(translate, router);
+
+    expect(service.localizedPath('/privacy')).toBe('/de/privacy');
+    expect(service.localizedPath('/it/contact?topic=seo#form')).toBe(
+      '/de/contact?topic=seo#form',
+    );
+  });
 });

frontend/src/app/core/services/language.service.ts

@@ -24,7 +24,7 @@ export class LanguageService {
     private router: Router,
   ) {
     this.translate.addLangs(this.supportedLangs);
-    this.translate.setDefaultLang('it');
+    this.translate.setFallbackLang('it');
     this.translate.onLangChange.subscribe((event) => {
       const lang =
         typeof event.lang === 'string' ? event.lang.toLowerCase() : null;
@@ -85,6 +85,31 @@ export class LanguageService {
     return this.isSupportedLang(activeLang) ? activeLang : this.currentLang();
   }
 
+  localizedPath(path: string): string {
+    const lang = this.selectedLang();
+    const rawValue = String(path ?? '').trim();
+    const normalized = rawValue || '/';
+    const match = normalized.match(/^([^?#]*)([?#].*)?$/);
+    const rawPath = match?.[1] || '/';
+    const suffix = match?.[2] || '';
+    const segments = rawPath.split('/').filter(Boolean);
+
+    if (segments.length === 0) {
+      return `/${lang}${suffix}`;
+    }
+
+    if (this.isSupportedLang(segments[0])) {
+      segments[0] = lang;
+      return `/${segments.join('/')}${suffix}`;
+    }
+
+    if (this.looksLikeLangToken(segments[0])) {
+      return `/${[lang, ...segments.slice(1)].join('/')}${suffix}`;
+    }
+
+    return `/${[lang, ...segments].join('/')}${suffix}`;
+  }
+
   private ensureLanguageInPath(urlTree: UrlTree): void {
     const segments = this.getPrimarySegments(urlTree);
 

frontend/src/app/core/services/seo.service.spec.ts

@@ -0,0 +1,135 @@
+import { ActivatedRouteSnapshot, Router } from '@angular/router';
+import { Meta, Title } from '@angular/platform-browser';
+import { Subject } from 'rxjs';
+import { TranslateService } from '@ngx-translate/core';
+import { SeoService } from './seo.service';
+
+describe('SeoService', () => {
+  function createSnapshot(
+    data: Record<string, unknown>,
+    firstChild: ActivatedRouteSnapshot | null = null,
+  ): ActivatedRouteSnapshot {
+    return {
+      data,
+      firstChild,
+    } as unknown as ActivatedRouteSnapshot;
+  }
+
+  function cleanupSeoDom(): void {
+    document.head
+      .querySelectorAll(
+        'link[rel="canonical"], link[rel="alternate"][data-seo-managed="true"], meta[property="og:locale:alternate"][data-seo-managed="true"]',
+      )
+      .forEach((node) => node.remove());
+    document.documentElement.removeAttribute('lang');
+  }
+
+  function createService(options: {
+    url: string;
+    data: Record<string, unknown>;
+    translations: Record<string, string>;
+  }): {
+    meta: jasmine.SpyObj<Meta>;
+    title: jasmine.SpyObj<Title>;
+  } {
+    const events$ = new Subject<unknown>();
+    const title = jasmine.createSpyObj<Title>('Title', ['setTitle']);
+    const meta = jasmine.createSpyObj<Meta>('Meta', ['updateTag']);
+    const translate = {
+      instant: (key: string) => options.translations[key] ?? key,
+    } as TranslateService;
+    const router = {
+      url: options.url,
+      events: events$.asObservable(),
+      routerState: {
+        snapshot: {
+          root: createSnapshot(options.data),
+        },
+      },
+    } as unknown as Router;
+
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const service = new SeoService(router, title, meta, translate, document);
+
+    return { meta, title };
+  }
+
+  beforeEach(() => {
+    cleanupSeoDom();
+  });
+
+  afterEach(() => {
+    cleanupSeoDom();
+  });
+
+  it('adds the language prefix to canonical and hreflang URLs', () => {
+    const { meta, title } = createService({
+      url: '/privacy?utm=test',
+      data: {
+        seoTitleKey: 'SEO.ROUTES.LEGAL.PRIVACY.TITLE',
+        seoDescriptionKey: 'SEO.ROUTES.LEGAL.PRIVACY.DESCRIPTION',
+      },
+      translations: {
+        'SEO.ROUTES.LEGAL.PRIVACY.TITLE': 'Privacy Policy | 3D fab',
+        'SEO.ROUTES.LEGAL.PRIVACY.DESCRIPTION': 'Privacy description',
+      },
+    });
+
+    expect(title.setTitle).toHaveBeenCalledWith('Privacy Policy | 3D fab');
+
+    const canonical = document.head.querySelector(
+      'link[rel="canonical"]',
+    ) as HTMLLinkElement | null;
+    expect(canonical?.getAttribute('href')).toBe(
+      `${document.location.origin}/it/privacy`,
+    );
+
+    const alternates = Array.from(
+      document.head.querySelectorAll(
+        'link[rel="alternate"][data-seo-managed="true"]',
+      ),
+    ).map((node) => ({
+      hreflang: node.getAttribute('hreflang'),
+      href: node.getAttribute('href'),
+    }));
+
+    expect(alternates).toContain({
+      hreflang: 'en',
+      href: `${document.location.origin}/en/privacy`,
+    });
+    expect(alternates).toContain({
+      hreflang: 'x-default',
+      href: `${document.location.origin}/it/privacy`,
+    });
+    expect(document.documentElement.lang).toBe('it');
+
+    const ogUrlCall = meta.updateTag.calls
+      .allArgs()
+      .find(([tag]) => tag.property === 'og:url');
+    expect(ogUrlCall?.[0].content).toBe(
+      `${document.location.origin}/it/privacy`,
+    );
+  });
+
+  it('resolves translated route metadata for the active language', () => {
+    const { meta, title } = createService({
+      url: '/en/about',
+      data: {
+        seoTitleKey: 'SEO.ROUTES.ABOUT.TITLE',
+        seoDescriptionKey: 'SEO.ROUTES.ABOUT.DESCRIPTION',
+      },
+      translations: {
+        'SEO.ROUTES.ABOUT.TITLE': 'About Us | 3D fab',
+        'SEO.ROUTES.ABOUT.DESCRIPTION': 'About description',
+      },
+    });
+
+    expect(title.setTitle).toHaveBeenCalledWith('About Us | 3D fab');
+
+    const descriptionCall = meta.updateTag.calls
+      .allArgs()
+      .find(([tag]) => tag.name === 'description');
+    expect(descriptionCall?.[0].content).toBe('About description');
+    expect(document.documentElement.lang).toBe('en');
+  });
+});

frontend/src/app/core/services/seo.service.ts

@@ -2,29 +2,66 @@ import { DOCUMENT } from '@angular/common';
 import { Inject, Injectable } from '@angular/core';
 import { Title, Meta } from '@angular/platform-browser';
 import { ActivatedRouteSnapshot, NavigationEnd, Router } from '@angular/router';
+import { TranslateService } from '@ngx-translate/core';
 import { filter } from 'rxjs/operators';
 
 export interface PageSeoOverride {
   title?: string | null;
+  titleKey?: string | null;
   description?: string | null;
+  descriptionKey?: string | null;
   robots?: string | null;
   ogTitle?: string | null;
+  ogTitleKey?: string | null;
   ogDescription?: string | null;
+  ogDescriptionKey?: string | null;
 }
 
+type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+type SeoMap = Partial<Record<SupportedLang, string>>;
+type SeoTextDataKey =
+  | 'seoTitle'
+  | 'seoDescription'
+  | 'ogTitle'
+  | 'ogDescription';
+
 @Injectable({
   providedIn: 'root',
 })
 export class SeoService {
-  private readonly defaultTitle = '3D fab | Stampa 3D su misura';
+  private readonly defaultTitleByLang: Record<SupportedLang, string> = {
-  private readonly defaultDescription =
+    it: '3D fab | Stampa 3D su misura',
-    'Stampa 3D su misura con preventivo online immediato. Carica il file, scegli materiale e qualità, ricevi prezzo e tempi in pochi secondi.';
+    en: '3D fab | Custom 3D Printing',
-  private readonly supportedLangs = new Set(['it', 'en', 'de', 'fr']);
+    de: '3D fab | 3D-Druck nach Maß',
+    fr: '3D fab | Impression 3D sur mesure',
+  };
+  private readonly defaultDescriptionByLang: Record<SupportedLang, string> = {
+    it: 'Servizio di stampa 3D su misura, shop tecnico e supporto CAD per prototipi, ricambi e piccole serie.',
+    en: 'Custom 3D printing service, technical shop and CAD support for prototypes, spare parts and short runs.',
+    de: '3D-Druckservice nach Maß, technischer Shop und CAD-Support für Prototypen, Ersatzteile und Kleinserien.',
+    fr: "Service d'impression 3D sur mesure, boutique technique et support CAD pour prototypes, pièces et petites séries.",
+  };
+  private readonly supportedLangs: readonly SupportedLang[] = [
+    'it',
+    'en',
+    'de',
+    'fr',
+  ];
+  private readonly supportedLangSet = new Set<SupportedLang>(
+    this.supportedLangs,
+  );
+  private readonly ogLocaleByLang: Record<SupportedLang, string> = {
+    it: 'it_IT',
+    en: 'en_US',
+    de: 'de_DE',
+    fr: 'fr_FR',
+  };
 
   constructor(
     private router: Router,
     private titleService: Title,
     private metaService: Meta,
+    private translate: TranslateService,
     @Inject(DOCUMENT) private document: Document,
   ) {
     this.applyRouteSeo(this.router.routerState.snapshot.root);
@@ -40,27 +77,61 @@ export class SeoService {
   }
 
   applyPageSeo(override: PageSeoOverride): void {
-    const title = this.asString(override.title) ?? this.defaultTitle;
+    const cleanPath = this.getCleanPath(this.router.url);
+    const lang = this.resolveLangFromPath(cleanPath);
+    const title =
+      this.resolveOverrideSeoText(override.title, override.titleKey) ??
+      this.defaultTitle(lang);
     const description =
-      this.asString(override.description) ?? this.defaultDescription;
+      this.resolveOverrideSeoText(
+        override.description,
+        override.descriptionKey,
+      ) ?? this.defaultDescription(lang);
     const robots = this.asString(override.robots) ?? 'index, follow';
-    const ogTitle = this.asString(override.ogTitle) ?? title;
+    const ogTitle =
-    const ogDescription = this.asString(override.ogDescription) ?? description;
+      this.resolveOverrideSeoText(override.ogTitle, override.ogTitleKey) ??
+      title;
+    const ogDescription =
+      this.resolveOverrideSeoText(
+        override.ogDescription,
+        override.ogDescriptionKey,
+      ) ?? description;
 
-    this.applySeoValues(title, description, robots, ogTitle, ogDescription);
+    this.applySeoValues(
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+      cleanPath,
+      lang,
+    );
   }
 
   private applyRouteSeo(rootSnapshot: ActivatedRouteSnapshot): void {
     const mergedData = this.getMergedRouteData(rootSnapshot);
-    const title = this.asString(mergedData['seoTitle']) ?? this.defaultTitle;
+    const cleanPath = this.getCleanPath(this.router.url);
+    const lang = this.resolveLangFromPath(cleanPath);
+    const title =
+      this.resolveSeoText(mergedData, 'seoTitle', lang) ??
+      this.defaultTitle(lang);
     const description =
-      this.asString(mergedData['seoDescription']) ?? this.defaultDescription;
+      this.resolveSeoText(mergedData, 'seoDescription', lang) ??
+      this.defaultDescription(lang);
     const robots = this.asString(mergedData['seoRobots']) ?? 'index, follow';
-    const ogTitle = this.asString(mergedData['ogTitle']) ?? title;
+    const ogTitle = this.resolveSeoText(mergedData, 'ogTitle', lang) ?? title;
     const ogDescription =
-      this.asString(mergedData['ogDescription']) ?? description;
+      this.resolveSeoText(mergedData, 'ogDescription', lang) ?? description;
 
-    this.applySeoValues(title, description, robots, ogTitle, ogDescription);
+    this.applySeoValues(
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+      cleanPath,
+      lang,
+    );
   }
 
   private applySeoValues(
@@ -69,6 +140,8 @@ export class SeoService {
     robots: string,
     ogTitle: string,
     ogDescription: string,
+    cleanPath: string,
+    lang: SupportedLang,
   ): void {
     this.titleService.setTitle(title);
     this.metaService.updateTag({ name: 'description', content: description });
@@ -79,13 +152,20 @@ export class SeoService {
       content: ogDescription,
     });
     this.metaService.updateTag({ property: 'og:type', content: 'website' });
+    this.metaService.updateTag({ property: 'og:site_name', content: '3D fab' });
     this.metaService.updateTag({ name: 'twitter:card', content: 'summary' });
+    this.metaService.updateTag({ name: 'twitter:title', content: ogTitle });
+    this.metaService.updateTag({
+      name: 'twitter:description',
+      content: ogDescription,
+    });
 
-    const cleanPath = this.getCleanPath(this.router.url);
+    const canonicalPath = this.buildLocalizedPath(cleanPath, lang);
-    const canonical = `${this.document.location.origin}${cleanPath}`;
+    const canonical = `${this.document.location.origin}${canonicalPath}`;
     this.metaService.updateTag({ property: 'og:url', content: canonical });
     this.updateCanonicalTag(canonical);
-    this.updateLangAndAlternates(cleanPath);
+    this.updateOpenGraphLocales(lang);
+    this.updateLangAndAlternates(canonicalPath, lang);
   }
 
   private getMergedRouteData(
@@ -104,11 +184,97 @@ export class SeoService {
     return typeof value === 'string' ? value : undefined;
   }
 
+  private resolveOverrideSeoText(
+    value: string | null | undefined,
+    key: string | null | undefined,
+  ): string | undefined {
+    return this.asString(value) ?? this.resolveTranslation(key);
+  }
+
+  private resolveSeoText(
+    routeData: Record<string, unknown>,
+    key: SeoTextDataKey,
+    lang: SupportedLang,
+  ): string | undefined {
+    const mapKey = `${key}ByLang`;
+    const localized = routeData[mapKey];
+    if (
+      localized &&
+      typeof localized === 'object' &&
+      !Array.isArray(localized)
+    ) {
+      const mapped = localized as SeoMap;
+      const byLang = this.asString(mapped[lang]);
+      if (byLang) {
+        return byLang;
+      }
+    }
+    const translated = this.resolveTranslation(routeData[`${key}Key`]);
+    if (translated) {
+      return translated;
+    }
+    return this.asString(routeData[key]);
+  }
+
+  private resolveTranslation(value: unknown): string | undefined {
+    const key = this.asString(value)?.trim();
+    if (!key) {
+      return undefined;
+    }
+    const translated = this.translate.instant(key);
+    return typeof translated === 'string' && translated !== key
+      ? translated
+      : undefined;
+  }
+
+  private defaultTitle(lang: SupportedLang): string {
+    return (
+      this.resolveTranslation('SEO.DEFAULT.TITLE') ??
+      this.defaultTitleByLang[lang]
+    );
+  }
+
+  private defaultDescription(lang: SupportedLang): string {
+    return (
+      this.resolveTranslation('SEO.DEFAULT.DESCRIPTION') ??
+      this.defaultDescriptionByLang[lang]
+    );
+  }
+
   private getCleanPath(url: string): string {
     const path = (url || '/').split('?')[0].split('#')[0];
     return path || '/';
   }
 
+  private resolveLangFromPath(path: string): SupportedLang {
+    const firstSegment = path.split('/').filter(Boolean)[0]?.toLowerCase();
+    if (
+      firstSegment &&
+      this.supportedLangSet.has(firstSegment as SupportedLang)
+    ) {
+      return firstSegment as SupportedLang;
+    }
+    return 'it';
+  }
+
+  private buildLocalizedPath(path: string, lang: SupportedLang): string {
+    const segments = path.split('/').filter(Boolean);
+    if (segments.length === 0) {
+      return `/${lang}`;
+    }
+
+    const firstSegment = segments[0]?.toLowerCase();
+    if (
+      firstSegment &&
+      this.supportedLangSet.has(firstSegment as SupportedLang)
+    ) {
+      segments[0] = lang;
+      return `/${segments.join('/')}`;
+    }
+
+    return `/${[lang, ...segments].join('/')}`;
+  }
+
   private updateCanonicalTag(url: string): void {
     let link = this.document.head.querySelector(
       'link[rel="canonical"]',
@@ -121,14 +287,31 @@ export class SeoService {
     link.setAttribute('href', url);
   }
 
-  private updateLangAndAlternates(path: string): void {
+  private updateOpenGraphLocales(lang: SupportedLang): void {
-    const segments = path.split('/').filter(Boolean);
+    this.metaService.updateTag({
-    const firstSegment = segments[0]?.toLowerCase();
+      property: 'og:locale',
-    const hasLang = Boolean(
+      content: this.ogLocaleByLang[lang],
-      firstSegment && this.supportedLangs.has(firstSegment),
+    });
-    );
+
-    const lang = hasLang ? firstSegment : 'it';
+    this.document.head
-    const suffixSegments = hasLang ? segments.slice(1) : segments;
+      .querySelectorAll(
+        'meta[property="og:locale:alternate"][data-seo-managed="true"]',
+      )
+      .forEach((node) => node.remove());
+
+    for (const alternateLang of this.supportedLangs) {
+      if (alternateLang === lang) {
+        continue;
+      }
+      this.appendOgLocaleAlternate(this.ogLocaleByLang[alternateLang]);
+    }
+  }
+
+  private updateLangAndAlternates(
+    localizedPath: string,
+    lang: SupportedLang,
+  ): void {
+    const suffixSegments = localizedPath.split('/').filter(Boolean).slice(1);
     const suffix =
       suffixSegments.length > 0 ? `/${suffixSegments.join('/')}` : '';
 
@@ -138,7 +321,7 @@ export class SeoService {
       .querySelectorAll('link[rel="alternate"][data-seo-managed="true"]')
       .forEach((node) => node.remove());
 
-    for (const alt of ['it', 'en', 'de', 'fr']) {
+    for (const alt of this.supportedLangs) {
       this.appendAlternateLink(
         alt,
         `${this.document.location.origin}/${alt}${suffix}`,
@@ -158,4 +341,12 @@ export class SeoService {
     link.setAttribute('data-seo-managed', 'true');
     this.document.head.appendChild(link);
   }
+
+  private appendOgLocaleAlternate(locale: string): void {
+    const meta = this.document.createElement('meta');
+    meta.setAttribute('property', 'og:locale:alternate');
+    meta.setAttribute('content', locale);
+    meta.setAttribute('data-seo-managed', 'true');
+    this.document.head.appendChild(meta);
+  }
 }

frontend/src/app/features/about/about.routes.ts

@@ -6,9 +6,8 @@ export const ABOUT_ROUTES: Routes = [
     path: '',
     component: AboutPageComponent,
     data: {
-      seoTitle: 'Chi siamo | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.ABOUT.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.ABOUT.DESCRIPTION',
-        'Siamo un laboratorio di stampa 3D orientato a prototipi, ricambi e produzioni su misura.',
     },
   },
 ];

frontend/src/app/features/admin/pages/admin-cad-invoices.component.ts

@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
-import { Component, OnInit, inject } from '@angular/core';
+import { Component, OnInit, PLATFORM_ID, inject } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
   AdminCadInvoice,
@@ -16,6 +16,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
   styleUrl: './admin-cad-invoices.component.scss',
 })
 export class AdminCadInvoicesComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private readonly adminOperationsService = inject(AdminOperationsService);
   private readonly adminOrdersService = inject(AdminOrdersService);
 
@@ -112,11 +113,17 @@ export class AdminCadInvoicesComponent implements OnInit {
   }
 
   openCheckout(path: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
     const url = this.toCheckoutUrl(path);
     window.open(url, '_blank');
   }
 
   copyCheckout(path: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
     const url = this.toCheckoutUrl(path);
     navigator.clipboard?.writeText(url);
     this.successMessage = 'Link checkout CAD copiato negli appunti.';
@@ -126,6 +133,9 @@ export class AdminCadInvoicesComponent implements OnInit {
     if (!orderId) return;
     this.adminOrdersService.downloadOrderInvoice(orderId).subscribe({
       next: (blob) => {
+        if (!this.isBrowser) {
+          return;
+        }
         const url = window.URL.createObjectURL(blob);
         const a = document.createElement('a');
         a.href = url;
@@ -142,10 +152,16 @@ export class AdminCadInvoicesComponent implements OnInit {
   private toCheckoutUrl(path: string): string {
     const safePath = path.startsWith('/') ? path : `/${path}`;
     const lang = this.resolveLang();
+    if (!this.isBrowser) {
+      return `/${lang}${safePath}`;
+    }
     return `${window.location.origin}/${lang}${safePath}`;
   }
 
   private resolveLang(): string {
+    if (!this.isBrowser) {
+      return 'it';
+    }
     const firstSegment = window.location.pathname
       .split('/')
       .filter(Boolean)

frontend/src/app/features/admin/pages/admin-contact-requests.component.ts

@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
   AdminContactRequest,
@@ -17,6 +17,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
   styleUrl: './admin-contact-requests.component.scss',
 })
 export class AdminContactRequestsComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private readonly adminOperationsService = inject(AdminOperationsService);
 
   readonly statusOptions = ['NEW', 'PENDING', 'IN_PROGRESS', 'DONE', 'CLOSED'];
@@ -171,6 +172,9 @@ export class AdminContactRequestsComponent implements OnInit {
   }
 
   private downloadBlob(blob: Blob, filename: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
     const url = window.URL.createObjectURL(blob);
     const a = document.createElement('a');
     a.href = url;

frontend/src/app/features/admin/pages/admin-dashboard.component.html

@@ -104,7 +104,6 @@
               <td>
                 <span
                   class="order-type-badge"
-                  [class.order-type-badge--shop]="orderKind(order) === 'SHOP'"
                   [class.order-type-badge--mixed]="orderKind(order) === 'MIXED'"
                 >
                   {{ orderKindLabel(order) }}
@@ -133,7 +132,6 @@
           <h2>Dettaglio ordine {{ selectedOrder.orderNumber }}</h2>
           <span
             class="order-type-badge"
-            [class.order-type-badge--shop]="orderKind(selectedOrder) === 'SHOP'"
             [class.order-type-badge--mixed]="
               orderKind(selectedOrder) === 'MIXED'
             "
@@ -259,10 +257,7 @@
               <p class="file-name">
                 <strong>{{ itemDisplayName(item) }}</strong>
               </p>
-              <span
+              <span class="item-kind-badge">
-                class="item-kind-badge"
-                [class.item-kind-badge--shop]="isShopItem(item)"
-              >
                 {{ isShopItem(item) ? "Shop" : "Calcolatore" }}
               </span>
             </div>

frontend/src/app/features/admin/pages/admin-dashboard.component.scss

@@ -224,12 +224,6 @@ tbody tr.no-results:hover {
   white-space: nowrap;
 }
 
-.order-type-badge--shop,
-.item-kind-badge--shop {
-  background: color-mix(in srgb, var(--color-brand) 12%, white);
-  color: var(--color-brand);
-}
-
 .order-type-badge--mixed {
   background: color-mix(in srgb, #f59e0b 16%, white);
   color: #9a5b00;

frontend/src/app/features/admin/pages/admin-dashboard.component.ts

@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import {
   AdminOrder,
@@ -16,6 +16,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
   styleUrl: './admin-dashboard.component.scss',
 })
 export class AdminDashboardComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private readonly adminOrdersService = inject(AdminOrdersService);
 
   orders: AdminOrder[] = [];
@@ -498,6 +499,9 @@ export class AdminDashboardComponent implements OnInit {
   }
 
   private downloadBlob(blob: Blob, filename: string): void {
+    if (!this.isBrowser) {
+      return;
+    }
     const url = window.URL.createObjectURL(blob);
     const a = document.createElement('a');
     a.href = url;

frontend/src/app/features/admin/pages/admin-filament-stock.component.html

@@ -101,6 +101,22 @@
                   placeholder="Nero, Bianco..."
                 />
               </label>
+              <label class="form-field">
+                <span>Label IT</span>
+                <input type="text" [(ngModel)]="newVariant.colorLabelIt" />
+              </label>
+              <label class="form-field">
+                <span>Label EN</span>
+                <input type="text" [(ngModel)]="newVariant.colorLabelEn" />
+              </label>
+              <label class="form-field">
+                <span>Label DE</span>
+                <input type="text" [(ngModel)]="newVariant.colorLabelDe" />
+              </label>
+              <label class="form-field">
+                <span>Label FR</span>
+                <input type="text" [(ngModel)]="newVariant.colorLabelFr" />
+              </label>
               <label class="form-field">
                 <span>Hex colore</span>
                 <input
@@ -229,7 +245,7 @@
                     class="color-dot"
                     [style.background-color]="getVariantColorHex(variant)"
                   ></span>
-                  {{ variant.colorName || "N/D" }}
+                  {{ variant.colorLabelIt || variant.colorName || "N/D" }}
                 </span>
                 <span
                   >Stock spools:
@@ -290,6 +306,22 @@
               <span>Colore</span>
               <input type="text" [(ngModel)]="variant.colorName" />
             </label>
+            <label class="form-field">
+              <span>Label IT</span>
+              <input type="text" [(ngModel)]="variant.colorLabelIt" />
+            </label>
+            <label class="form-field">
+              <span>Label EN</span>
+              <input type="text" [(ngModel)]="variant.colorLabelEn" />
+            </label>
+            <label class="form-field">
+              <span>Label DE</span>
+              <input type="text" [(ngModel)]="variant.colorLabelDe" />
+            </label>
+            <label class="form-field">
+              <span>Label FR</span>
+              <input type="text" [(ngModel)]="variant.colorLabelFr" />
+            </label>
             <label class="form-field">
               <span>Hex colore</span>
               <input type="text" [(ngModel)]="variant.colorHex" />

frontend/src/app/features/admin/pages/admin-filament-stock.component.ts

@@ -47,6 +47,10 @@ export class AdminFilamentStockComponent implements OnInit {
     materialTypeId: 0,
     variantDisplayName: '',
     colorName: '',
+    colorLabelIt: '',
+    colorLabelEn: '',
+    colorLabelDe: '',
+    colorLabelFr: '',
     colorHex: '',
     finishType: 'GLOSSY',
     brand: '',
@@ -206,6 +210,10 @@ export class AdminFilamentStockComponent implements OnInit {
             this.newVariant.materialTypeId || this.materials[0]?.id || 0,
           variantDisplayName: '',
           colorName: '',
+          colorLabelIt: '',
+          colorLabelEn: '',
+          colorLabelDe: '',
+          colorLabelFr: '',
           colorHex: '',
           finishType: 'GLOSSY',
           brand: '',
@@ -359,6 +367,10 @@ export class AdminFilamentStockComponent implements OnInit {
       materialTypeId: Number(source.materialTypeId),
       variantDisplayName: (source.variantDisplayName || '').trim(),
       colorName: (source.colorName || '').trim(),
+      colorLabelIt: (source.colorLabelIt || '').trim() || undefined,
+      colorLabelEn: (source.colorLabelEn || '').trim() || undefined,
+      colorLabelDe: (source.colorLabelDe || '').trim() || undefined,
+      colorLabelFr: (source.colorLabelFr || '').trim() || undefined,
       colorHex: (source.colorHex || '').trim() || undefined,
       finishType: (source.finishType || 'GLOSSY').trim().toUpperCase(),
       brand: (source.brand || '').trim() || undefined,

frontend/src/app/features/admin/pages/admin-home-media.component.html

@@ -130,7 +130,7 @@
                     <button
                       *ngFor="let language of mediaLanguages"
                       type="button"
-                      class="language-toggle-btn ui-language-toolbar__button"
+                      class="ui-language-toolbar__button image-language-button"
                       [class.active]="
                         getFormState(section.usageKey).activeLanguage ===
                         language
@@ -139,11 +139,28 @@
                         isLanguageComplete(section.usageKey, language)
                       "
                       [class.incomplete]="
-                        !isLanguageComplete(section.usageKey, language)
+                        isLanguageIncomplete(section.usageKey, language)
+                      "
+                      [class.empty]="
+                        !isLanguageStarted(section.usageKey, language)
                       "
                       (click)="setActiveLanguage(section.usageKey, language)"
                     >
+                      <span class="image-language-button__label">
                         {{ mediaLanguageLabels[language] }}
+                      </span>
+                      <span
+                        class="image-language-button__state"
+                        *ngIf="isLanguageComplete(section.usageKey, language)"
+                      >
+                        OK
+                      </span>
+                      <span
+                        class="image-language-button__state"
+                        *ngIf="isLanguageIncomplete(section.usageKey, language)"
+                      >
+                        ...
+                      </span>
                     </button>
                   </div>
                 </div>

frontend/src/app/features/admin/pages/admin-home-media.component.scss

@@ -27,6 +27,62 @@
   gap: var(--space-1);
 }
 
+.image-language-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  min-width: 3.15rem;
+  background: #ffffff;
+  color: var(--color-text-muted);
+}
+
+.image-language-button.empty {
+  opacity: 0.76;
+}
+
+.image-language-button.complete {
+  border-color: #b8ddc2;
+}
+
+.image-language-button.incomplete {
+  border-color: #e8c8c2;
+}
+
+.image-language-button.active {
+  background: #fff5b8;
+  border-color: var(--color-brand);
+  color: var(--color-text);
+  opacity: 1;
+}
+
+.image-language-button__label {
+  line-height: 1;
+}
+
+.image-language-button__state {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 1rem;
+  height: 1rem;
+  padding: 0 0.2rem;
+  border-radius: 999px;
+  background: rgba(0, 0, 0, 0.08);
+  font-size: 0.62rem;
+  font-weight: 800;
+  line-height: 1;
+}
+
+.image-language-button.complete .image-language-button__state {
+  background: #dcefdc;
+  color: #25603b;
+}
+
+.image-language-button.incomplete .image-language-button__state {
+  background: #f7ddd7;
+  color: #944329;
+}
+
 .form-field--wide {
   grid-column: 1 / -1;
 }

frontend/src/app/features/admin/pages/admin-home-media.component.ts

@@ -1,5 +1,11 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
-import { Component, inject, OnDestroy, OnInit } from '@angular/core';
+import {
+  Component,
+  PLATFORM_ID,
+  inject,
+  OnDestroy,
+  OnInit,
+} from '@angular/core';
 import { FormsModule } from '@angular/forms';
 import { of, switchMap } from 'rxjs';
 import {
@@ -17,12 +23,16 @@ type HomeSectionKey =
   | 'capability-prototyping'
   | 'capability-custom-parts'
   | 'capability-small-series'
-  | 'capability-cad';
+  | 'capability-cad'
+  | 'joe'
+  | 'matteo';
+
+type HomeMediaUsageType = 'HOME_SECTION' | 'ABOUT_MEMBER';
 
 interface HomeMediaSectionConfig {
-  usageType: 'HOME_SECTION';
+  usageType: HomeMediaUsageType;
   usageKey: HomeSectionKey;
-  groupId: 'galleries' | 'capabilities';
+  groupId: 'galleries' | 'capabilities' | 'about-members';
   title: string;
   preferredVariantName: 'card' | 'hero';
 }
@@ -81,6 +91,7 @@ const MEDIA_LANGUAGE_LABELS: Readonly<Record<AdminMediaLanguage, string>> = {
   styleUrl: './admin-home-media.component.scss',
 })
 export class AdminHomeMediaComponent implements OnInit, OnDestroy {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private readonly adminMediaService = inject(AdminMediaService);
   readonly mediaLanguages = SUPPORTED_MEDIA_LANGUAGES;
   readonly mediaLanguageLabels = MEDIA_LANGUAGE_LABELS;
@@ -94,6 +105,10 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
       id: 'capabilities',
       title: 'Cosa puoi ottenere',
     },
+    {
+      id: 'about-members',
+      title: 'Chi siamo',
+    },
   ];
 
   readonly sectionConfigs: readonly HomeMediaSectionConfig[] = [
@@ -139,6 +154,20 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
       title: 'Home: consulenza e CAD',
       preferredVariantName: 'card',
     },
+    {
+      usageType: 'ABOUT_MEMBER',
+      usageKey: 'joe',
+      groupId: 'about-members',
+      title: 'Chi siamo: Joe',
+      preferredVariantName: 'card',
+    },
+    {
+      usageType: 'ABOUT_MEMBER',
+      usageKey: 'matteo',
+      groupId: 'about-members',
+      title: 'Chi siamo: Matteo',
+      preferredVariantName: 'card',
+    },
   ];
 
   sections: HomeMediaSectionView[] = [];
@@ -155,6 +184,8 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
       'capability-custom-parts': this.createEmptyFormState(),
       'capability-small-series': this.createEmptyFormState(),
       'capability-cad': this.createEmptyFormState(),
+      joe: this.createEmptyFormState(),
+      matteo: this.createEmptyFormState(),
     };
 
   get configuredSectionCount(): number {
@@ -219,7 +250,8 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
 
     this.revokePreviewUrl(formState.previewUrl);
     formState.file = file;
-    formState.previewUrl = file ? URL.createObjectURL(file) : null;
+    formState.previewUrl =
+      file && this.isBrowser ? URL.createObjectURL(file) : null;
 
     if (file && this.areAllTitlesBlank(formState.translations)) {
       const nextTitle = this.deriveDefaultTitle(file.name);
@@ -432,6 +464,25 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
     );
   }
 
+  isLanguageStarted(
+    sectionKey: HomeSectionKey,
+    language: AdminMediaLanguage,
+  ): boolean {
+    return this.isTranslationStarted(
+      this.getFormState(sectionKey).translations[language],
+    );
+  }
+
+  isLanguageIncomplete(
+    sectionKey: HomeSectionKey,
+    language: AdminMediaLanguage,
+  ): boolean {
+    return (
+      this.isLanguageStarted(sectionKey, language) &&
+      !this.isLanguageComplete(sectionKey, language)
+    );
+  }
+
   getItemTranslation(
     item: HomeMediaItem,
     language: AdminMediaLanguage,
@@ -540,6 +591,9 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
   }
 
   private revokePreviewUrl(previewUrl: string | null): void {
+    if (!this.isBrowser) {
+      return;
+    }
     if (!previewUrl?.startsWith('blob:')) {
       return;
     }
@@ -619,6 +673,10 @@ export class AdminHomeMediaComponent implements OnInit, OnDestroy {
     return !!translation.title.trim() && !!translation.altText.trim();
   }
 
+  private isTranslationStarted(translation: AdminMediaTranslation): boolean {
+    return !!translation.title.trim() || !!translation.altText.trim();
+  }
+
   private validateTranslations(
     translations: Record<AdminMediaLanguage, AdminMediaTranslation>,
   ): string | null {

frontend/src/app/features/admin/pages/admin-sessions.component.ts

@@ -1,5 +1,5 @@
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
-import { Component, inject, OnInit } from '@angular/core';
+import { Component, PLATFORM_ID, inject, OnInit } from '@angular/core';
 import {
   AdminOperationsService,
   AdminQuoteSession,
@@ -15,6 +15,7 @@ import { CopyOnClickDirective } from '../../../shared/directives/copy-on-click.d
   styleUrl: './admin-sessions.component.scss',
 })
 export class AdminSessionsComponent implements OnInit {
+  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));
   private readonly adminOperationsService = inject(AdminOperationsService);
 
   sessions: AdminQuoteSession[] = [];
@@ -51,7 +52,9 @@ export class AdminSessionsComponent implements OnInit {
       return;
     }
 
-    const confirmed = window.confirm(
+    const confirmed =
+      this.isBrowser &&
+      window.confirm(
         `Vuoi eliminare la sessione ${session.id}? Questa azione non si puo annullare.`,
       );
     if (!confirmed) {

frontend/src/app/features/admin/pages/admin-shop.component.html

@@ -8,7 +8,8 @@
       </p>
     </div>
 
-    <div class="header-actions">
+    <div class="header-side ui-stack ui-stack--dense">
+      <div class="header-stats ui-row ui-row--wrap ui-row--end">
         <article class="ui-stat-chip">
           <strong>{{ products.length }}</strong>
           <span>prodotti</span>
@@ -17,6 +18,8 @@
           <strong>{{ categories.length }}</strong>
           <span>categorie</span>
         </article>
+      </div>
+      <div class="header-actions ui-row ui-row--wrap ui-row--end">
         <button
           type="button"
           class="ui-button ui-button--ghost"
@@ -28,6 +31,7 @@
           Nuovo prodotto
         </button>
       </div>
+    </div>
   </header>
 
   <p class="ui-banner ui-banner--error" *ngIf="errorMessage">
@@ -202,17 +206,6 @@
                 />
               </label>
 
-              <label class="ui-form-field">
-                <span class="ui-form-caption">Nome categoria</span>
-                <input
-                  class="ui-form-control"
-                  type="text"
-                  [(ngModel)]="categoryForm.name"
-                  name="categoryName"
-                  placeholder="Desk accessories"
-                />
-              </label>
-
               <label class="ui-form-field">
                 <span class="ui-form-caption">Slug</span>
                 <div class="input-with-action">
@@ -233,36 +226,6 @@
                 </div>
               </label>
 
-              <label class="ui-form-field form-field--wide">
-                <span class="ui-form-caption">Descrizione</span>
-                <textarea
-                  class="ui-form-control textarea-control"
-                  [(ngModel)]="categoryForm.description"
-                  name="categoryDescription"
-                  rows="3"
-                ></textarea>
-              </label>
-
-              <label class="ui-form-field">
-                <span class="ui-form-caption">SEO title</span>
-                <input
-                  class="ui-form-control"
-                  type="text"
-                  [(ngModel)]="categoryForm.seoTitle"
-                  name="categorySeoTitle"
-                />
-              </label>
-
-              <label class="ui-form-field">
-                <span class="ui-form-caption">SEO description</span>
-                <input
-                  class="ui-form-control"
-                  type="text"
-                  [(ngModel)]="categoryForm.seoDescription"
-                  name="categorySeoDescription"
-                />
-              </label>
-
               <label class="ui-form-field">
                 <span class="ui-form-caption">OG title</span>
                 <input
@@ -284,6 +247,141 @@
               </label>
             </div>
 
+            <div class="ui-language-toolbar">
+              <div class="ui-language-toolbar__copy">
+                <span>Lingua contenuti categoria</span>
+                <p>IT / EN / DE / FR</p>
+              </div>
+              <div class="ui-language-toolbar__toggle">
+                <button
+                  *ngFor="let language of shopLanguages"
+                  type="button"
+                  class="ui-language-toolbar__button image-language-button"
+                  [class.active]="activeContentLanguage === language"
+                  [class.complete]="isCategoryContentLanguageComplete(language)"
+                  [class.incomplete]="
+                    isCategoryContentLanguageIncomplete(language)
+                  "
+                  [class.empty]="!isCategoryContentLanguageStarted(language)"
+                  (click)="setActiveContentLanguage(language)"
+                >
+                  <span class="image-language-button__label">
+                    {{ languageLabels[language] }}
+                  </span>
+                  <span
+                    class="image-language-button__state"
+                    *ngIf="isCategoryContentLanguageComplete(language)"
+                  >
+                    OK
+                  </span>
+                  <span
+                    class="image-language-button__state"
+                    *ngIf="isCategoryContentLanguageIncomplete(language)"
+                  >
+                    ...
+                  </span>
+                </button>
+              </div>
+            </div>
+
+            <div class="ui-form-grid ui-form-grid--two">
+              <label class="ui-form-field">
+                <span class="ui-form-caption">
+                  Nome categoria {{ languageLabels[activeContentLanguage] }}
+                </span>
+                <input
+                  class="ui-form-control"
+                  type="text"
+                  [(ngModel)]="categoryForm.names[activeContentLanguage]"
+                  [name]="'category-name-' + activeContentLanguage"
+                  placeholder="Desk accessories"
+                />
+              </label>
+
+              <label class="ui-form-field form-field--wide">
+                <span class="ui-form-caption">
+                  Descrizione {{ languageLabels[activeContentLanguage] }}
+                </span>
+                <textarea
+                  class="ui-form-control textarea-control"
+                  [(ngModel)]="categoryForm.descriptions[activeContentLanguage]"
+                  [name]="'category-description-' + activeContentLanguage"
+                  rows="3"
+                ></textarea>
+              </label>
+            </div>
+
+            <div class="ui-language-toolbar">
+              <div class="ui-language-toolbar__copy">
+                <span>Lingua SEO categoria</span>
+                <p>Stessa lingua attiva dell'editor</p>
+              </div>
+              <div class="ui-language-toolbar__toggle">
+                <button
+                  *ngFor="let language of shopLanguages"
+                  type="button"
+                  class="ui-language-toolbar__button image-language-button"
+                  [class.active]="activeContentLanguage === language"
+                  [class.complete]="isCategorySeoLanguageComplete(language)"
+                  [class.incomplete]="isCategorySeoLanguageIncomplete(language)"
+                  [class.empty]="!isCategorySeoLanguageStarted(language)"
+                  (click)="setActiveContentLanguage(language)"
+                >
+                  <span class="image-language-button__label">
+                    {{ languageLabels[language] }}
+                  </span>
+                  <span
+                    class="image-language-button__state"
+                    *ngIf="isCategorySeoLanguageComplete(language)"
+                  >
+                    OK
+                  </span>
+                  <span
+                    class="image-language-button__state"
+                    *ngIf="isCategorySeoLanguageIncomplete(language)"
+                  >
+                    ...
+                  </span>
+                </button>
+              </div>
+            </div>
+
+            <div class="ui-form-grid ui-form-grid--two">
+              <label class="ui-form-field">
+                <span class="ui-form-caption">
+                  SEO title {{ languageLabels[activeContentLanguage] }}
+                </span>
+                <input
+                  class="ui-form-control"
+                  type="text"
+                  [(ngModel)]="categoryForm.seoTitles[activeContentLanguage]"
+                  [name]="'category-seo-title-' + activeContentLanguage"
+                />
+              </label>
+
+              <label class="ui-form-field form-field--wide">
+                <span class="ui-form-caption">
+                  SEO description {{ languageLabels[activeContentLanguage] }}
+                </span>
+                <textarea
+                  class="ui-form-control"
+                  [(ngModel)]="
+                    categoryForm.seoDescriptions[activeContentLanguage]
+                  "
+                  [name]="'category-seo-description-' + activeContentLanguage"
+                  rows="3"
+                ></textarea>
+                <span
+                  class="seo-counter"
+                  [class.seo-counter--danger]="
+                    categorySeoDescriptionLength(activeContentLanguage) > 160
+                  "
+                >
+                  {{ categorySeoDescriptionLength(activeContentLanguage) }}/160
+                </span>
+              </label>
+            </div>
+
             <div class="toggle-row">
               <label class="ui-checkbox">
                 <input
@@ -473,7 +571,7 @@
       </div>
 
       <form class="detail-stack" (submit)="$event.preventDefault()">
-        <section class="form-section">
+        <section class="form-section ui-subpanel">
           <div class="panel-heading">
             <div>
               <h3>Dati base</h3>
@@ -565,14 +663,36 @@
           </div>
         </section>
 
-        <section class="form-section">
+        <section class="form-section ui-subpanel">
           <div class="panel-heading">
             <div>
               <h3>Contenuti localizzati</h3>
               <p>
-                Nome obbligatorio in tutte le lingue. Descrizioni opzionali.
+                Nome obbligatorio in tutte le lingue. Descrizioni opzionali. La
+                traduzione usa la lingua editor come sorgente e compila il form
+                senza salvare.
               </p>
             </div>
+            <button
+              type="button"
+              class="ui-button ui-button--ghost"
+              (click)="translateProductFromCurrentLanguage()"
+              [disabled]="!canTranslateProductFromCurrentLanguage()"
+            >
+              {{ translatingProduct ? "Traduco..." : "Traduci" }}
+            </button>
+          </div>
+
+          <div class="toggle-row toggle-row--compact">
+            <label class="ui-checkbox">
+              <input
+                type="checkbox"
+                [(ngModel)]="overwriteExistingTranslations"
+                name="productOverwriteExistingTranslations"
+              />
+              <span class="ui-checkbox__mark" aria-hidden="true"></span>
+              <span>Sovrascrivi traduzioni esistenti</span>
+            </label>
           </div>
 
           <div class="ui-language-toolbar">
@@ -584,13 +704,28 @@
               <button
                 *ngFor="let language of shopLanguages"
                 type="button"
-                class="ui-language-toolbar__button"
+                class="ui-language-toolbar__button image-language-button"
                 [class.active]="activeContentLanguage === language"
                 [class.complete]="isContentLanguageComplete(language)"
-                [class.incomplete]="!isContentLanguageComplete(language)"
+                [class.incomplete]="isContentLanguageIncomplete(language)"
+                [class.empty]="!isContentLanguageStarted(language)"
                 (click)="setActiveContentLanguage(language)"
               >
+                <span class="image-language-button__label">
                   {{ languageLabels[language] }}
+                </span>
+                <span
+                  class="image-language-button__state"
+                  *ngIf="isContentLanguageComplete(language)"
+                >
+                  OK
+                </span>
+                <span
+                  class="image-language-button__state"
+                  *ngIf="isContentLanguageIncomplete(language)"
+                >
+                  ...
+                </span>
               </button>
             </div>
           </div>
@@ -620,120 +755,232 @@
               />
             </label>
 
-            <label class="ui-form-field form-field--wide">
+            <div class="ui-form-field form-field--wide">
               <span class="ui-form-caption">
                 Descrizione {{ languageLabels[activeContentLanguage] }}
               </span>
-              <textarea
+              <div class="rich-text-field">
-                class="ui-form-control textarea-control textarea-control--large"
+                <div class="rich-text-toolbar" role="toolbar">
-                [(ngModel)]="productForm.descriptions[activeContentLanguage]"
+                  <button
-                [name]="'product-description-' + activeContentLanguage"
+                    type="button"
-                rows="6"
+                    class="rich-text-toolbar__button"
-              ></textarea>
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
-            </label>
+                    (click)="formatDescription('bold')"
+                    title="Grassetto"
+                    aria-label="Grassetto"
+                  >
+                    <strong>B</strong>
+                  </button>
+                  <button
+                    type="button"
+                    class="rich-text-toolbar__button"
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
+                    (click)="formatDescription('italic')"
+                    title="Corsivo"
+                    aria-label="Corsivo"
+                  >
+                    <em>I</em>
+                  </button>
+                  <button
+                    type="button"
+                    class="rich-text-toolbar__button"
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
+                    (click)="formatDescription('underline')"
+                    title="Sottolineato"
+                    aria-label="Sottolineato"
+                  >
+                    <u>U</u>
+                  </button>
+                  <button
+                    type="button"
+                    class="rich-text-toolbar__button"
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
+                    (click)="formatDescriptionList('unordered')"
+                    title="Lista puntata"
+                    aria-label="Lista puntata"
+                  >
+                    • Lista
+                  </button>
+                  <button
+                    type="button"
+                    class="rich-text-toolbar__button"
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
+                    (click)="formatDescriptionList('ordered')"
+                    title="Lista numerata"
+                    aria-label="Lista numerata"
+                  >
+                    1. Lista
+                  </button>
+                  <button
+                    type="button"
+                    class="rich-text-toolbar__button"
+                    (mousedown)="preventRichTextToolbarMouseDown($event)"
+                    (click)="clearDescriptionFormatting()"
+                    title="Rimuovi formattazione"
+                    aria-label="Rimuovi formattazione"
+                  >
+                    Tx
+                  </button>
+                </div>
+                <div
+                  #descriptionEditorRef
+                  class="ui-form-control textarea-control textarea-control--large rich-text-editor"
+                  contenteditable="true"
+                  role="textbox"
+                  aria-multiline="true"
+                  [attr.aria-label]="
+                    'Descrizione ' + languageLabels[activeContentLanguage]
+                  "
+                  (input)="onDescriptionEditorInput($event)"
+                  (blur)="onDescriptionEditorBlur($event)"
+                ></div>
+              </div>
+              <span class="ui-form-caption">
+                Supporta grassetto, corsivo, liste puntate e numerate.
+              </span>
+            </div>
           </div>
         </section>
 
-        <section class="form-section">
+        <section class="form-section ui-subpanel">
           <div class="panel-heading">
             <div>
-              <h3>SEO e social</h3>
+              <h3>SEO localizzata</h3>
-              <p>Metadati globali per risultato organico e preview.</p>
+              <p>
+                I campi seguono la lingua attiva. Open Graph usa gli stessi
+                valori della SEO.
+              </p>
+            </div>
+          </div>
+
+          <div class="ui-language-toolbar">
+            <div class="ui-language-toolbar__copy">
+              <span>Lingua SEO</span>
+              <p>Stessa lingua attiva dell'editor contenuti</p>
+            </div>
+            <div class="ui-language-toolbar__toggle">
+              <button
+                *ngFor="let language of shopLanguages"
+                type="button"
+                class="ui-language-toolbar__button image-language-button"
+                [class.active]="activeContentLanguage === language"
+                [class.complete]="isSeoLanguageComplete(language)"
+                [class.incomplete]="isSeoLanguageIncomplete(language)"
+                [class.empty]="!isSeoLanguageStarted(language)"
+                (click)="setActiveContentLanguage(language)"
+              >
+                <span class="image-language-button__label">
+                  {{ languageLabels[language] }}
+                </span>
+                <span
+                  class="image-language-button__state"
+                  *ngIf="isSeoLanguageComplete(language)"
+                >
+                  OK
+                </span>
+                <span
+                  class="image-language-button__state"
+                  *ngIf="isSeoLanguageIncomplete(language)"
+                >
+                  ...
+                </span>
+              </button>
             </div>
           </div>
 
           <div class="ui-form-grid ui-form-grid--two">
             <label class="ui-form-field">
-              <span class="ui-form-caption">SEO title</span>
+              <span class="ui-form-caption">
+                SEO title {{ languageLabels[activeContentLanguage] }}
+              </span>
               <input
                 class="ui-form-control"
                 type="text"
-                [(ngModel)]="productForm.seoTitle"
+                [(ngModel)]="productForm.seoTitles[activeContentLanguage]"
-                name="productSeoTitle"
+                [name]="'product-seo-title-' + activeContentLanguage"
               />
             </label>
 
-            <label class="ui-form-field">
+            <label class="ui-form-field form-field--wide">
-              <span class="ui-form-caption">SEO description</span>
+              <span class="ui-form-caption">
-              <input
+                SEO description {{ languageLabels[activeContentLanguage] }}
+              </span>
+              <textarea
                 class="ui-form-control"
-                type="text"
+                [(ngModel)]="productForm.seoDescriptions[activeContentLanguage]"
-                [(ngModel)]="productForm.seoDescription"
+                [name]="'product-seo-description-' + activeContentLanguage"
-                name="productSeoDescription"
+                rows="3"
-              />
+              ></textarea>
-            </label>
+              <span
-
+                class="seo-counter"
-            <label class="ui-form-field">
+                [class.seo-counter--danger]="
-              <span class="ui-form-caption">OG title</span>
+                  seoDescriptionLength(activeContentLanguage) > 160
-              <input
+                "
-                class="ui-form-control"
+              >
-                type="text"
+                {{ seoDescriptionLength(activeContentLanguage) }}/160
-                [(ngModel)]="productForm.ogTitle"
+              </span>
-                name="productOgTitle"
-              />
-            </label>
-
-            <label class="ui-form-field">
-              <span class="ui-form-caption">OG description</span>
-              <input
-                class="ui-form-control"
-                type="text"
-                [(ngModel)]="productForm.ogDescription"
-                name="productOgDescription"
-              />
             </label>
           </div>
         </section>
 
-        <section class="form-section">
+        <section class="form-section ui-subpanel">
           <div class="panel-heading">
             <div>
-              <h3>Varianti</h3>
+              <h3>Materiali e prezzi</h3>
-              <p>Colori, materiale interno, SKU e prezzi.</p>
+              <p>
+                Scegli i materiali disponibili a stock. I colori vengono presi
+                automaticamente dai filamenti attivi a magazzino.
+              </p>
             </div>
             <button
               type="button"
               class="ui-button ui-button--ghost"
-              (click)="addVariant()"
+              (click)="addMaterial()"
+              [disabled]="
+                productForm.materials.length >= stockMaterialCodes().length
+              "
             >
-              Aggiungi variante
+              Aggiungi materiale
             </button>
           </div>
 
+          <div class="locked-panel" *ngIf="stockMaterialCodes().length === 0">
+            Nessun materiale attivo con stock disponibile.
+          </div>
+
           <div class="variant-stack">
             <article
               class="variant-card"
               *ngFor="
-                let variant of productForm.variants;
+                let material of productForm.materials;
                 let index = index;
-                trackBy: trackVariant
+                trackBy: trackMaterial
               "
             >
               <div class="variant-card__header">
                 <div>
                   <h4>
-                    {{
+                    {{ material.materialCode || "Nuovo materiale" }}
-                      variant.variantLabel ||
-                        variant.colorName ||
-                        "Nuova variante"
-                    }}
                   </h4>
-                  <p>Ordine {{ variant.sortOrder }}</p>
+                  <p>
+                    {{ materialColorCount(material.materialCode) }} colori da
+                    stock · ordine {{ material.sortOrder }}
+                  </p>
                 </div>
                 <div class="variant-card__actions">
                   <button
                     type="button"
                     class="ui-button ui-button--ghost"
-                    (click)="setDefaultVariant(index)"
+                    (click)="setDefaultMaterial(index)"
-                    [disabled]="variant.isDefault"
+                    [disabled]="material.isDefault"
                   >
-                    {{ variant.isDefault ? "Default" : "Rendi default" }}
+                    {{ material.isDefault ? "Default" : "Rendi default" }}
                   </button>
                   <button
                     type="button"
                     class="ui-button ui-button--ghost-danger"
-                    (click)="removeVariant(index)"
+                    (click)="removeMaterial(index)"
-                    [disabled]="productForm.variants.length <= 1"
+                    [disabled]="productForm.materials.length <= 1"
                   >
                     Rimuovi
                   </button>
@@ -742,62 +989,25 @@
 
               <div class="ui-form-grid ui-form-grid--two">
                 <label class="ui-form-field">
-                  <span class="ui-form-caption">Nome variante</span>
+                  <span class="ui-form-caption">Materiale</span>
-                  <input
+                  <select
                     class="ui-form-control"
-                    type="text"
+                    [(ngModel)]="material.materialCode"
-                    [(ngModel)]="variant.variantLabel"
+                    [name]="'material-code-' + index"
-                    [name]="'variant-label-' + index"
+                    (ngModelChange)="onMaterialCodeChange(index, $event)"
-                  />
+                  >
-                </label>
+                    <option [ngValue]="''" disabled>Seleziona materiale</option>
-
+                    <option
-                <label class="ui-form-field">
+                      *ngFor="
-                  <span class="ui-form-caption">SKU</span>
+                        let materialCode of availableMaterialChoices(
-                  <input
+                          material.materialCode
-                    class="ui-form-control"
+                        )
-                    type="text"
+                      "
-                    [(ngModel)]="variant.sku"
+                      [ngValue]="materialCode"
-                    [name]="'variant-sku-' + index"
+                    >
-                    autocomplete="off"
+                      {{ materialCode }}
-                    autocapitalize="off"
+                    </option>
-                    spellcheck="false"
+                  </select>
-                  />
-                </label>
-
-                <label class="ui-form-field">
-                  <span class="ui-form-caption">Colore</span>
-                  <input
-                    class="ui-form-control"
-                    type="text"
-                    [(ngModel)]="variant.colorName"
-                    [name]="'variant-color-name-' + index"
-                  />
-                </label>
-
-                <label class="ui-form-field">
-                  <span class="ui-form-caption">HEX colore</span>
-                  <input
-                    class="ui-form-control"
-                    type="text"
-                    [(ngModel)]="variant.colorHex"
-                    [name]="'variant-color-hex-' + index"
-                    placeholder="#1A1A1A"
-                    (blur)="onColorHexBlur(variant)"
-                    autocomplete="off"
-                    autocapitalize="off"
-                    spellcheck="false"
-                  />
-                </label>
-
-                <label class="ui-form-field">
-                  <span class="ui-form-caption">Materiale interno</span>
-                  <input
-                    class="ui-form-control"
-                    type="text"
-                    [(ngModel)]="variant.internalMaterialCode"
-                    [name]="'variant-material-' + index"
-                    placeholder="PLA, PETG, TPU"
-                  />
                 </label>
 
                 <label class="ui-form-field">
@@ -807,8 +1017,8 @@
                     type="number"
                     min="0"
                     step="0.01"
-                    [(ngModel)]="variant.priceChf"
+                    [(ngModel)]="material.priceChf"
-                    [name]="'variant-price-' + index"
+                    [name]="'material-price-' + index"
                   />
                 </label>
 
@@ -817,18 +1027,42 @@
                   <input
                     class="ui-form-control"
                     type="number"
-                    [(ngModel)]="variant.sortOrder"
+                    [(ngModel)]="material.sortOrder"
-                    [name]="'variant-sort-order-' + index"
+                    [name]="'material-sort-order-' + index"
                   />
                 </label>
 
+                <label class="ui-form-field" *ngIf="material.isDefault">
+                  <span class="ui-form-caption">Colore default</span>
+                  <select
+                    class="ui-form-control"
+                    [(ngModel)]="material.defaultColorKey"
+                    [name]="'material-default-color-' + index"
+                    [disabled]="materialColorCount(material.materialCode) === 0"
+                  >
+                    <option [ngValue]="''" disabled>
+                      Seleziona colore default
+                    </option>
+                    <option
+                      *ngFor="
+                        let option of materialColorOptions(
+                          material.materialCode
+                        )
+                      "
+                      [ngValue]="option.key"
+                    >
+                      {{ option.label }}
+                    </option>
+                  </select>
+                </label>
+
                 <div class="toggle-row toggle-row--compact">
                   <label class="ui-checkbox">
                     <input
                       type="checkbox"
-                      [(ngModel)]="variant.isDefault"
+                      [(ngModel)]="material.isDefault"
-                      [name]="'variant-default-' + index"
+                      [name]="'material-default-' + index"
-                      (ngModelChange)="setDefaultVariant(index)"
+                      (ngModelChange)="setDefaultMaterial(index)"
                     />
                     <span class="ui-checkbox__mark" aria-hidden="true"></span>
                     <span>Default</span>
@@ -837,19 +1071,34 @@
                   <label class="ui-checkbox">
                     <input
                       type="checkbox"
-                      [(ngModel)]="variant.isActive"
+                      [(ngModel)]="material.isActive"
-                      [name]="'variant-active-' + index"
+                      [name]="'material-active-' + index"
                     />
                     <span class="ui-checkbox__mark" aria-hidden="true"></span>
                     <span>Attiva</span>
                   </label>
                 </div>
               </div>
+
+              <div class="material-stock-summary" *ngIf="material.materialCode">
+                <strong>Colori disponibili:</strong>
+                <span *ngIf="materialColorCount(material.materialCode) > 0">
+                  {{ materialColorPreview(material.materialCode).join(", ") }}
+                  <ng-container
+                    *ngIf="materialColorCount(material.materialCode) > 6"
+                  >
+                    +{{ materialColorCount(material.materialCode) - 6 }} altri
+                  </ng-container>
+                </span>
+                <span *ngIf="materialColorCount(material.materialCode) === 0">
+                  Nessun colore disponibile attualmente a stock.
+                </span>
+              </div>
             </article>
           </div>
         </section>
 
-        <section class="form-section">
+        <section class="form-section ui-subpanel">
           <div class="panel-heading">
             <div>
               <h3>Immagini e modello 3D</h3>
@@ -914,15 +1163,30 @@
                     <button
                       *ngFor="let language of mediaLanguages"
                       type="button"
-                      class="ui-language-toolbar__button"
+                      class="ui-language-toolbar__button image-language-button"
                       [class.active]="
                         imageUploadState.activeLanguage === language
                       "
                       [class.complete]="isImageLanguageComplete(language)"
-                      [class.incomplete]="!isImageLanguageComplete(language)"
+                      [class.incomplete]="isImageLanguageIncomplete(language)"
+                      [class.empty]="!isImageLanguageStarted(language)"
                       (click)="setActiveImageLanguage(language)"
                     >
+                      <span class="image-language-button__label">
                         {{ languageLabels[language] }}
+                      </span>
+                      <span
+                        class="image-language-button__state"
+                        *ngIf="isImageLanguageComplete(language)"
+                      >
+                        OK
+                      </span>
+                      <span
+                        class="image-language-button__state"
+                        *ngIf="isImageLanguageIncomplete(language)"
+                      >
+                        ...
+                      </span>
                     </button>
                   </div>
                 </div>

frontend/src/app/features/admin/pages/admin-shop.component.scss

@@ -4,6 +4,62 @@
   gap: var(--space-5);
 }
 
+.admin-shop .image-language-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  min-width: 3.15rem;
+  background: #ffffff;
+  color: var(--color-text-muted);
+}
+
+.admin-shop .image-language-button.empty {
+  opacity: 0.76;
+}
+
+.admin-shop .image-language-button.complete {
+  border-color: #b8ddc2;
+}
+
+.admin-shop .image-language-button.incomplete {
+  border-color: #e8c8c2;
+}
+
+.admin-shop .image-language-button.active {
+  background: #fff5b8;
+  border-color: var(--color-brand);
+  color: var(--color-text);
+  opacity: 1;
+}
+
+.image-language-button__label {
+  line-height: 1;
+}
+
+.image-language-button__state {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 1rem;
+  height: 1rem;
+  padding: 0 0.2rem;
+  border-radius: 999px;
+  background: rgba(0, 0, 0, 0.08);
+  font-size: 0.62rem;
+  font-weight: 800;
+  line-height: 1;
+}
+
+.admin-shop .image-language-button.complete .image-language-button__state {
+  background: #dcefdc;
+  color: #25603b;
+}
+
+.admin-shop .image-language-button.incomplete .image-language-button__state {
+  background: #f7ddd7;
+  color: #944329;
+}
+
 .section-header {
   display: flex;
   justify-content: space-between;
@@ -24,13 +80,6 @@
   color: var(--color-text-muted);
 }
 
-.header-actions {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: flex-end;
-  gap: var(--space-2);
-}
-
 .workspace {
   align-items: start;
 }
@@ -61,7 +110,6 @@
 .category-manager,
 .category-editor,
 .detail-stack,
-.form-section,
 .variant-stack,
 .image-stack,
 .media-grid,
@@ -71,6 +119,12 @@
   gap: var(--space-3);
 }
 
+.form-section {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2);
+}
+
 .panel-heading {
   display: flex;
   justify-content: space-between;
@@ -191,6 +245,62 @@
   min-height: 136px;
 }
 
+.rich-text-field {
+  display: grid;
+  gap: var(--space-2);
+}
+
+.rich-text-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+}
+
+.admin-shop .rich-text-toolbar__button {
+  border: 1px solid var(--color-border) !important;
+  border-radius: var(--radius-sm) !important;
+  background: #fff !important;
+  color: var(--color-text) !important;
+  min-height: 2rem;
+  padding: 0.28rem 0.56rem !important;
+  font-size: 0.82rem;
+}
+
+.admin-shop .rich-text-toolbar__button:hover:not(:disabled) {
+  border-color: #cbb88a !important;
+  background: #fffdf4 !important;
+}
+
+.rich-text-editor {
+  overflow-y: auto;
+  padding: 0.62rem 0.72rem;
+  line-height: 1.62;
+}
+
+.rich-text-editor:focus-visible {
+  outline: none;
+}
+
+.rich-text-editor:empty::before {
+  content: "Scrivi la descrizione del prodotto...";
+  color: var(--color-text-muted);
+}
+
+.rich-text-editor p,
+.rich-text-editor div {
+  margin: 0 0 0.62rem;
+}
+
+.rich-text-editor ul,
+.rich-text-editor ol {
+  margin: 0 0 0.62rem 1.25rem;
+  padding: 0;
+}
+
+.rich-text-editor li + li {
+  margin-top: 0.22rem;
+}
+
 .toggle-row {
   display: flex;
   flex-wrap: wrap;
@@ -211,6 +321,17 @@
   gap: var(--space-2);
 }
 
+.seo-counter {
+  justify-self: end;
+  font-size: 0.72rem;
+  font-weight: 700;
+  color: var(--color-text-muted);
+}
+
+.seo-counter--danger {
+  color: var(--color-danger-500);
+}
+
 .product-cell {
   display: grid;
   gap: 4px;
@@ -224,10 +345,6 @@ tbody tr.selected {
   background: #fff4c0;
 }
 
-.detail-panel {
-  gap: var(--space-4);
-}
-
 .detail-panel .ui-meta-item {
   padding: var(--space-2);
 }
@@ -277,15 +394,16 @@ tbody tr.selected {
 }
 
 .detail-stack {
-  gap: var(--space-4);
+  gap: var(--space-3);
 }
 
 .variant-card,
 .image-item {
   border: 1px solid var(--color-border);
   border-radius: var(--radius-md);
-  background: linear-gradient(180deg, #fcfcfb 0%, #ffffff 100%);
+  background: var(--color-bg-card);
   padding: var(--space-3);
+  box-shadow: var(--shadow-sm);
 }
 
 .variant-card {
@@ -316,6 +434,19 @@ tbody tr.selected {
   justify-content: flex-end;
 }
 
+.material-stock-summary {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-2);
+  align-items: baseline;
+  color: var(--color-text-muted);
+  font-size: 0.95rem;
+}
+
+.material-stock-summary strong {
+  color: var(--color-text);
+}
+
 .locked-panel,
 .loading-state,
 .image-fallback {

frontend/src/app/features/admin/services/admin-operations.service.ts

@@ -32,6 +32,10 @@ export interface AdminFilamentVariant {
   materialTechnicalTypeLabel?: string;
   variantDisplayName: string;
   colorName: string;
+  colorLabelIt: string;
+  colorLabelEn: string;
+  colorLabelDe: string;
+  colorLabelFr: string;
   colorHex?: string;
   finishType?: string;
   brand?: string;
@@ -57,6 +61,10 @@ export interface AdminUpsertFilamentVariantPayload {
   materialTypeId: number;
   variantDisplayName: string;
   colorName: string;
+  colorLabelIt?: string;
+  colorLabelEn?: string;
+  colorLabelDe?: string;
+  colorLabelFr?: string;
   colorHex?: string;
   finishType?: string;
   brand?: string;

frontend/src/app/features/admin/services/admin-shop.service.spec.ts

@@ -0,0 +1,93 @@
+import { TestBed } from '@angular/core/testing';
+import {
+  HttpClientTestingModule,
+  HttpTestingController,
+} from '@angular/common/http/testing';
+import {
+  AdminShopService,
+  AdminTranslateShopProductPayload,
+} from './admin-shop.service';
+
+describe('AdminShopService', () => {
+  let service: AdminShopService;
+  let httpMock: HttpTestingController;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [HttpClientTestingModule],
+      providers: [AdminShopService],
+    });
+
+    service = TestBed.inject(AdminShopService);
+    httpMock = TestBed.inject(HttpTestingController);
+  });
+
+  afterEach(() => {
+    httpMock.verify();
+  });
+
+  it('posts product translation requests with credentials', () => {
+    const payload: AdminTranslateShopProductPayload = {
+      categoryId: 'category-1',
+      sourceLanguage: 'it',
+      overwriteExisting: false,
+      materialCodes: ['PLA', 'PETG'],
+      names: {
+        it: 'Supporto cavo scrivania',
+        en: '',
+        de: '',
+        fr: '',
+      },
+      excerpts: {
+        it: 'Accessorio tecnico',
+        en: '',
+        de: '',
+        fr: '',
+      },
+      descriptions: {
+        it: '<p>Descrizione prodotto</p>',
+        en: '',
+        de: '',
+        fr: '',
+      },
+      seoTitles: {
+        it: 'Supporto cavo scrivania | 3D fab',
+        en: '',
+        de: '',
+        fr: '',
+      },
+      seoDescriptions: {
+        it: 'Supporto tecnico stampato in 3D per scrivania.',
+        en: '',
+        de: '',
+        fr: '',
+      },
+    };
+
+    service.translateProduct(payload).subscribe((response) => {
+      expect(response.targetLanguages).toEqual(['en', 'de', 'fr']);
+      expect(response.names.en).toBe('Desk cable clip');
+    });
+
+    const request = httpMock.expectOne(
+      'http://localhost:8000/api/admin/shop/products/translate',
+    );
+    expect(request.request.method).toBe('POST');
+    expect(request.request.withCredentials).toBeTrue();
+    expect(request.request.body).toEqual(payload);
+
+    request.flush({
+      sourceLanguage: 'it',
+      targetLanguages: ['en', 'de', 'fr'],
+      names: {
+        en: 'Desk cable clip',
+        de: 'Schreibtisch-Kabelhalter',
+        fr: 'Support de cable de bureau',
+      },
+      excerpts: {},
+      descriptions: {},
+      seoTitles: {},
+      seoDescriptions: {},
+    });
+  });
+});

frontend/src/app/features/admin/services/admin-shop.service.ts

@@ -18,6 +18,8 @@ export interface AdminMediaTextTranslation {
   altText: string;
 }
 
+export type AdminShopLanguage = 'it' | 'en' | 'de' | 'fr';
+
 export interface AdminShopCategoryRef {
   id: string;
   slug: string;
@@ -30,9 +32,25 @@ export interface AdminShopCategory {
   parentCategoryName: string | null;
   slug: string;
   name: string;
+  nameIt: string;
+  nameEn: string;
+  nameDe: string;
+  nameFr: string;
   description: string | null;
+  descriptionIt: string | null;
+  descriptionEn: string | null;
+  descriptionDe: string | null;
+  descriptionFr: string | null;
   seoTitle: string | null;
+  seoTitleIt: string | null;
+  seoTitleEn: string | null;
+  seoTitleDe: string | null;
+  seoTitleFr: string | null;
   seoDescription: string | null;
+  seoDescriptionIt: string | null;
+  seoDescriptionEn: string | null;
+  seoDescriptionDe: string | null;
+  seoDescriptionFr: string | null;
   ogTitle: string | null;
   ogDescription: string | null;
   indexable: boolean;
@@ -54,9 +72,25 @@ export interface AdminUpsertShopCategoryPayload {
   parentCategoryId?: string | null;
   slug: string;
   name: string;
+  nameIt: string;
+  nameEn: string;
+  nameDe: string;
+  nameFr: string;
   description?: string;
+  descriptionIt?: string;
+  descriptionEn?: string;
+  descriptionDe?: string;
+  descriptionFr?: string;
   seoTitle?: string;
+  seoTitleIt?: string;
+  seoTitleEn?: string;
+  seoTitleDe?: string;
+  seoTitleFr?: string;
   seoDescription?: string;
+  seoDescriptionIt?: string;
+  seoDescriptionEn?: string;
+  seoDescriptionDe?: string;
+  seoDescriptionFr?: string;
   ogTitle?: string;
   ogDescription?: string;
   indexable: boolean;
@@ -69,6 +103,10 @@ export interface AdminShopProductVariant {
   sku: string | null;
   variantLabel: string;
   colorName: string;
+  colorLabelIt: string;
+  colorLabelEn: string;
+  colorLabelDe: string;
+  colorLabelFr: string;
   colorHex: string | null;
   internalMaterialCode: string;
   priceChf: number;
@@ -131,7 +169,15 @@ export interface AdminShopProduct {
   descriptionDe: string | null;
   descriptionFr: string | null;
   seoTitle: string | null;
+  seoTitleIt: string | null;
+  seoTitleEn: string | null;
+  seoTitleDe: string | null;
+  seoTitleFr: string | null;
   seoDescription: string | null;
+  seoDescriptionIt: string | null;
+  seoDescriptionEn: string | null;
+  seoDescriptionDe: string | null;
+  seoDescriptionFr: string | null;
   ogTitle: string | null;
   ogDescription: string | null;
   indexable: boolean;
@@ -162,6 +208,10 @@ export interface AdminUpsertShopProductVariantPayload {
   sku?: string;
   variantLabel?: string;
   colorName: string;
+  colorLabelIt?: string;
+  colorLabelEn?: string;
+  colorLabelDe?: string;
+  colorLabelFr?: string;
   colorHex?: string;
   internalMaterialCode: string;
   priceChf: number;
@@ -189,7 +239,15 @@ export interface AdminUpsertShopProductPayload {
   descriptionDe?: string;
   descriptionFr?: string;
   seoTitle?: string;
+  seoTitleIt?: string;
+  seoTitleEn?: string;
+  seoTitleDe?: string;
+  seoTitleFr?: string;
   seoDescription?: string;
+  seoDescriptionIt?: string;
+  seoDescriptionEn?: string;
+  seoDescriptionDe?: string;
+  seoDescriptionFr?: string;
   ogTitle?: string;
   ogDescription?: string;
   indexable: boolean;
@@ -199,6 +257,28 @@ export interface AdminUpsertShopProductPayload {
   variants: AdminUpsertShopProductVariantPayload[];
 }
 
+export interface AdminTranslateShopProductPayload {
+  categoryId?: string;
+  sourceLanguage: AdminShopLanguage;
+  overwriteExisting: boolean;
+  materialCodes: string[];
+  names: Record<AdminShopLanguage, string>;
+  excerpts: Record<AdminShopLanguage, string>;
+  descriptions: Record<AdminShopLanguage, string>;
+  seoTitles: Record<AdminShopLanguage, string>;
+  seoDescriptions: Record<AdminShopLanguage, string>;
+}
+
+export interface AdminTranslateShopProductResponse {
+  sourceLanguage: AdminShopLanguage;
+  targetLanguages: AdminShopLanguage[];
+  names: Partial<Record<AdminShopLanguage, string>>;
+  excerpts: Partial<Record<AdminShopLanguage, string>>;
+  descriptions: Partial<Record<AdminShopLanguage, string>>;
+  seoTitles: Partial<Record<AdminShopLanguage, string>>;
+  seoDescriptions: Partial<Record<AdminShopLanguage, string>>;
+}
+
 @Injectable({
   providedIn: 'root',
 })
@@ -295,6 +375,18 @@ export class AdminShopService {
     });
   }
 
+  translateProduct(
+    payload: AdminTranslateShopProductPayload,
+  ): Observable<AdminTranslateShopProductResponse> {
+    return this.http.post<AdminTranslateShopProductResponse>(
+      `${this.productsBaseUrl}/translate`,
+      payload,
+      {
+        withCredentials: true,
+      },
+    );
+  }
+
   uploadProductModel(
     productId: string,
     file: File,

frontend/src/app/features/calculator/calculator-page.component.ts

@@ -4,9 +4,12 @@ import {
   signal,
   ViewChild,
   ElementRef,
+  Inject,
   OnInit,
+  Optional,
+  PLATFORM_ID,
 } from '@angular/core';
-import { CommonModule } from '@angular/common';
+import { CommonModule, isPlatformBrowser } from '@angular/common';
 import { TranslateModule } from '@ngx-translate/core';
 import { forkJoin, of } from 'rxjs';
 import { catchError, map } from 'rxjs/operators';
@@ -53,6 +56,7 @@ type TrackedPrintSettings = {
   styleUrl: './calculator-page.component.scss',
 })
 export class CalculatorPageComponent implements OnInit {
+  private readonly isBrowser: boolean;
   mode = signal<'easy' | 'advanced'>('easy');
   step = signal<'upload' | 'quote' | 'details' | 'success'>('upload');
 
@@ -85,7 +89,10 @@ export class CalculatorPageComponent implements OnInit {
     private router: Router,
     private route: ActivatedRoute,
     private languageService: LanguageService,
-  ) {}
+    @Optional() @Inject(PLATFORM_ID) platformId?: Object,
+  ) {
+    this.isBrowser = isPlatformBrowser(platformId ?? 'browser');
+  }
 
   ngOnInit() {
     this.route.data.subscribe((data) => {
@@ -260,7 +267,7 @@ export class CalculatorPageComponent implements OnInit {
 
     // Auto-scroll on mobile to make analysis visible
     setTimeout(() => {
-      if (this.resultCol && window.innerWidth < 768) {
+      if (this.isBrowser && this.resultCol && window.innerWidth < 768) {
         this.resultCol.nativeElement.scrollIntoView({
           behavior: 'smooth',
           block: 'start',

frontend/src/app/features/calculator/calculator.routes.ts

@@ -8,9 +8,8 @@ export const CALCULATOR_ROUTES: Routes = [
     component: CalculatorPageComponent,
     data: {
       mode: 'easy',
-      seoTitle: 'Calcolatore stampa 3D base | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.BASIC.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.BASIC.DESCRIPTION',
-        'Calcola rapidamente il prezzo della tua stampa 3D in modalita base.',
     },
   },
   {
@@ -18,9 +17,8 @@ export const CALCULATOR_ROUTES: Routes = [
     component: CalculatorPageComponent,
     data: {
       mode: 'advanced',
-      seoTitle: 'Calcolatore stampa 3D avanzato | 3D fab',
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.ADVANCED.TITLE',
-      seoDescription:
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.ADVANCED.DESCRIPTION',
-        'Configura parametri avanzati e ottieni un preventivo preciso con slicing reale.',
     },
   },
 ];

frontend/src/app/features/calculator/components/upload-form/upload-form.component.html

@@ -101,9 +101,11 @@
 
       <p class="upload-privacy-note">
         {{ "LEGAL.CONSENT.UPLOAD_NOTICE_PREFIX" | translate }}
-        <a href="/privacy" target="_blank" rel="noopener">{{
+        <a
-          "LEGAL.CONSENT.UPLOAD_NOTICE_LINK" | translate
+          [href]="languageService.localizedPath('/privacy')"
-        }}</a
+          target="_blank"
+          rel="noopener"
+          >{{ "LEGAL.CONSENT.UPLOAD_NOTICE_LINK" | translate }}</a
         >.
       </p>
 

frontend/src/app/features/calculator/components/upload-form/upload-form.component.ts

@@ -30,6 +30,7 @@ import {
   VariantOption,
 } from '../../services/quote-estimator.service';
 import { getColorHex } from '../../../../core/constants/colors.const';
+import { LanguageService } from '../../../../core/services/language.service';
 
 interface FormItem {
   file: File;
@@ -106,6 +107,7 @@ export class UploadFormComponent implements OnInit {
   private estimator = inject(QuoteEstimatorService);
   private fb = inject(FormBuilder);
   private translate = inject(TranslateService);
+  readonly languageService = inject(LanguageService);
 
   form: FormGroup;
 

frontend/src/app/features/calculator/components/user-details/user-details.component.html

@@ -120,13 +120,18 @@
               <input type="checkbox" formControlName="acceptLegal" />
               <span>
                 {{ "LEGAL.CONSENT.LABEL_PREFIX" | translate }}
-                <a href="/terms" target="_blank" rel="noopener">{{
+                <a
-                  "LEGAL.CONSENT.TERMS_LINK" | translate
+                  [href]="languageService.localizedPath('/terms')"
-                }}</a>
+                  target="_blank"
+                  rel="noopener"
+                  >{{ "LEGAL.CONSENT.TERMS_LINK" | translate }}</a
+                >
                 {{ "LEGAL.CONSENT.AND" | translate }}
-                <a href="/privacy" target="_blank" rel="noopener">{{
+                <a
-                  "LEGAL.CONSENT.PRIVACY_LINK" | translate
+                  [href]="languageService.localizedPath('/privacy')"
-                }}</a
+                  target="_blank"
+                  rel="noopener"
+                  >{{ "LEGAL.CONSENT.PRIVACY_LINK" | translate }}</a
                 >.
               </span>
             </label>

frontend/src/app/features/calculator/components/user-details/user-details.component.ts

@@ -1,4 +1,4 @@
-import { Component, input, output, signal } from '@angular/core';
+import { Component, inject, input, output, signal } from '@angular/core';
 import { CommonModule } from '@angular/common';
 import {
   ReactiveFormsModule,
@@ -11,6 +11,7 @@ import { AppCardComponent } from '../../../../shared/components/app-card/app-car
 import { AppInputComponent } from '../../../../shared/components/app-input/app-input.component';
 import { AppButtonComponent } from '../../../../shared/components/app-button/app-button.component';
 import { QuoteResult } from '../../services/quote-estimator.service';
+import { LanguageService } from '../../../../core/services/language.service';
 
 @Component({
   selector: 'app-user-details',
@@ -30,6 +31,7 @@ export class UserDetailsComponent {
   quote = input<QuoteResult>();
   submitOrder = output<any>();
   cancel = output<void>();
+  readonly languageService = inject(LanguageService);
 
   form: FormGroup;
   submitting = signal(false);

frontend/src/app/features/calculator/services/quote-estimator.service.ts

@@ -75,6 +75,10 @@ export interface VariantOption {
   id: number;
   name: string;
   colorName: string;
+  colorLabelIt?: string;
+  colorLabelEn?: string;
+  colorLabelDe?: string;
+  colorLabelFr?: string;
   hexColor: string;
   finishType: string;
   stockSpools: number;

frontend/src/app/features/checkout/checkout.component.html

@@ -1,10 +1,10 @@
 <div class="checkout-page">
-  <div class="container ui-page-hero">
+  <div class="container ui-page-hero ui-page-hero--spacious checkout-hero">
     <h1 class="ui-page-title">{{ "CHECKOUT.TITLE" | translate }}</h1>
     <p class="ui-page-subtitle cad-subtitle" *ngIf="isCadSession()">
-      Servizio CAD
+      {{ "CHECKOUT.CAD_SERVICE" | translate }}
       <ng-container *ngIf="cadRequestId()">
-        riferito alla richiesta contatto #{{ cadRequestId() }}
+        {{ "CHECKOUT.CAD_REQUEST_REF" | translate: { id: cadRequestId() } }}
       </ng-container>
     </p>
   </div>
@@ -204,13 +204,18 @@
               <span class="ui-checkbox__mark"></span>
               <span>
                 {{ "LEGAL.CONSENT.LABEL_PREFIX" | translate }}
-                <a href="/terms" target="_blank" rel="noopener">{{
+                <a
-                  "LEGAL.CONSENT.TERMS_LINK" | translate
+                  [href]="languageService.localizedPath('/terms')"
-                }}</a>
+                  target="_blank"
+                  rel="noopener"
+                  >{{ "LEGAL.CONSENT.TERMS_LINK" | translate }}</a
+                >
                 {{ "LEGAL.CONSENT.AND" | translate }}
-                <a href="/privacy" target="_blank" rel="noopener">{{
+                <a
-                  "LEGAL.CONSENT.PRIVACY_LINK" | translate
+                  [href]="languageService.localizedPath('/privacy')"
-                }}</a
+                  target="_blank"
+                  rel="noopener"
+                  >{{ "LEGAL.CONSENT.PRIVACY_LINK" | translate }}</a
                 >.
               </span>
             </label>
@@ -265,14 +270,16 @@
                   </span>
                   <span *ngIf="itemVariantLabel(item) as variantLabel">
                     {{ "SHOP.VARIANT" | translate }}:
-                    {{ variantLabel }}
+                    {{ variantLabel | translate }}
                   </span>
                   <span class="item-color" *ngIf="itemColorLabel(item) !== '-'">
                     <span
                       class="color-dot"
                       [style.background-color]="itemColorSwatch(item)"
                     ></span>
-                    <span class="color-name">{{ itemColorLabel(item) }}</span>
+                    <span class="color-name">{{
+                      itemColorLabel(item) | translate
+                    }}</span>
                   </span>
                 </div>
                 <div class="item-specs-sub" *ngIf="showItemPrintMetrics(item)">
@@ -327,7 +334,9 @@
             </div>
             <div class="summary-item cad-summary-item" *ngIf="cadTotal() > 0">
               <div class="item-details">
-                <span class="item-name">Servizio CAD</span>
+                <span class="item-name">{{
+                  "CHECKOUT.CAD_SERVICE" | translate
+                }}</span>
                 <div class="item-specs-sub">{{ cadHours() }}h</div>
               </div>
               <div class="item-price">