feat(front-end): linkedin logo

Reviewed-on: #54

.gitea/workflows/deploy.yaml

@@ -217,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

@@ -111,3 +111,6 @@ Verifica che `MEDIA_FFMPEG_PATH` punti a un `ffmpeg` con supporto JPEG, WebP e A
 
 ### 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/src/main/java/com/printcalculator/config/AllowedOriginService.java

@@ -0,0 +1,88 @@
+package com.printcalculator.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+
+import java.net.URI;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Set;
+
+@Service
+public class AllowedOriginService {
+
+    private final List<String> allowedOrigins;
+
+    public AllowedOriginService(
+            @Value("${app.frontend.base-url:http://localhost:4200}") String frontendBaseUrl,
+            @Value("${app.cors.additional-allowed-origins:}") String additionalAllowedOrigins
+    ) {
+        LinkedHashSet<String> configuredOrigins = new LinkedHashSet<>();
+        addConfiguredOrigin(configuredOrigins, frontendBaseUrl, "app.frontend.base-url");
+
+        for (String rawOrigin : additionalAllowedOrigins.split(",")) {
+            addConfiguredOrigin(configuredOrigins, rawOrigin, "app.cors.additional-allowed-origins");
+        }
+
+        if (configuredOrigins.isEmpty()) {
+            throw new IllegalStateException("At least one allowed origin must be configured.");
+        }
+        this.allowedOrigins = List.copyOf(configuredOrigins);
+    }
+
+    public List<String> getAllowedOrigins() {
+        return allowedOrigins;
+    }
+
+    public boolean isAllowed(String rawOriginOrUrl) {
+        String normalizedOrigin = normalizeRequestOrigin(rawOriginOrUrl);
+        return normalizedOrigin != null && allowedOrigins.contains(normalizedOrigin);
+    }
+
+    private void addConfiguredOrigin(Set<String> configuredOrigins, String rawOriginOrUrl, String propertyName) {
+        if (rawOriginOrUrl == null || rawOriginOrUrl.isBlank()) {
+            return;
+        }
+
+        String normalizedOrigin = normalizeRequestOrigin(rawOriginOrUrl);
+        if (normalizedOrigin == null) {
+            throw new IllegalStateException(propertyName + " must contain absolute http(s) URLs.");
+        }
+        configuredOrigins.add(normalizedOrigin);
+    }
+
+    private String normalizeRequestOrigin(String rawOriginOrUrl) {
+        if (rawOriginOrUrl == null || rawOriginOrUrl.isBlank()) {
+            return null;
+        }
+
+        try {
+            URI uri = URI.create(rawOriginOrUrl.trim());
+            String scheme = uri.getScheme();
+            String host = uri.getHost();
+            if (scheme == null || host == null) {
+                return null;
+            }
+
+            String normalizedScheme = scheme.toLowerCase(Locale.ROOT);
+            if (!"http".equals(normalizedScheme) && !"https".equals(normalizedScheme)) {
+                return null;
+            }
+
+            String normalizedHost = host.toLowerCase(Locale.ROOT);
+            int port = uri.getPort();
+            if (isDefaultPort(normalizedScheme, port) || port < 0) {
+                return normalizedScheme + "://" + normalizedHost;
+            }
+            return normalizedScheme + "://" + normalizedHost + ":" + port;
+        } catch (IllegalArgumentException ignored) {
+            return null;
+        }
+    }
+
+    private boolean isDefaultPort(String scheme, int port) {
+        return ("http".equals(scheme) && port == 80)
+                || ("https".equals(scheme) && port == 443);
+    }
+}

backend/src/main/java/com/printcalculator/config/CorsConfig.java

@@ -1,27 +1,27 @@
 package com.printcalculator.config;
 
+import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Profile;
-import org.springframework.web.servlet.config.annotation.CorsRegistry;
-import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.CorsConfigurationSource;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+
+import java.util.List;
 
 @Configuration
-public class CorsConfig implements WebMvcConfigurer {
+public class CorsConfig {
 
-    @Override
-    public void addCorsMappings(CorsRegistry registry) {
-        registry.addMapping("/**")
-                .allowedOrigins(
-                        "http://localhost",
-                        "http://localhost:4200",
-                        "http://localhost:80",
-                        "http://127.0.0.1",
-                        "https://dev.3d-fab.ch",
-                        "https://int.3d-fab.ch",
-                        "https://3d-fab.ch"
-                )
-                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH")
-                .allowedHeaders("*")
-                .allowCredentials(true);
+    @Bean
+    public CorsConfigurationSource corsConfigurationSource(AllowedOriginService allowedOriginService) {
+        CorsConfiguration configuration = new CorsConfiguration();
+        configuration.setAllowedOrigins(allowedOriginService.getAllowedOrigins());
+        configuration.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE", "OPTIONS", "PATCH"));
+        configuration.setAllowedHeaders(List.of("*"));
+        configuration.setAllowCredentials(true);
+        configuration.setMaxAge(3600L);
+
+        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+        source.registerCorsConfiguration("/**", configuration);
+        return source;
     }
 }

backend/src/main/java/com/printcalculator/config/SecurityConfig.java

@@ -1,5 +1,6 @@
 package com.printcalculator.config;
 
+import com.printcalculator.security.AdminCsrfProtectionFilter;
 import com.printcalculator.security.AdminSessionAuthenticationFilter;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -18,6 +19,7 @@ public class SecurityConfig {
     @Bean
     public SecurityFilterChain securityFilterChain(
             HttpSecurity http,
+            AdminCsrfProtectionFilter adminCsrfProtectionFilter,
             AdminSessionAuthenticationFilter adminSessionAuthenticationFilter
     ) throws Exception {
         http
@@ -40,7 +42,8 @@ public class SecurityConfig {
                     response.setContentType(MediaType.APPLICATION_JSON_VALUE);
                     response.getWriter().write("{\"error\":\"UNAUTHORIZED\"}");
                 }))
-                .addFilterBefore(adminSessionAuthenticationFilter, UsernamePasswordAuthenticationFilter.class);
+                .addFilterBefore(adminCsrfProtectionFilter, UsernamePasswordAuthenticationFilter.class)
+                .addFilterAfter(adminSessionAuthenticationFilter, AdminCsrfProtectionFilter.class);
 
         return http.build();
     }

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/PublicShopController.java

@@ -56,6 +56,18 @@ public class PublicShopController {
         return ResponseEntity.ok(publicShopCatalogService.getProduct(slug, lang));
     }
 
+    @GetMapping("/products/by-path/{publicPath}")
+    public ResponseEntity<ShopProductDetailDto> getProductByPublicPath(@PathVariable String publicPath,
+                                                                       @RequestParam(required = false) String lang) {
+        return ResponseEntity.ok(publicShopCatalogService.getProductByPublicPath(publicPath, lang));
+    }
+
+    @GetMapping("/products/by-id-prefix/{idPrefix}")
+    public ResponseEntity<ShopProductDetailDto> getProductByIdPrefix(@PathVariable String idPrefix,
+                                                                     @RequestParam(required = false) String lang) {
+        return ResponseEntity.ok(publicShopCatalogService.getProductByIdPrefix(idPrefix, lang));
+    }
+
     @GetMapping("/products/{slug}/model")
     public ResponseEntity<Resource> getProductModel(@PathVariable String slug) throws IOException {
         PublicShopCatalogService.ProductModelDownload model = publicShopCatalogService.getProductModelDownload(slug);

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

@@ -18,6 +18,7 @@ import java.math.BigDecimal;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.HashMap;
+import java.util.Locale;
 import java.util.Map;
 
 import static org.springframework.http.HttpStatus.BAD_REQUEST;
@@ -124,6 +125,9 @@ public class QuoteController {
         if (file.isEmpty()) {
             return ResponseEntity.badRequest().build();
         }
+        if (!isSupportedInputFile(file)) {
+            throw new ResponseStatusException(BAD_REQUEST, "Unsupported file type. Allowed: stl, 3mf");
+        }
 
         // Scan for virus
         clamAVService.scan(file.getInputStream());
@@ -153,4 +157,14 @@ public class QuoteController {
             Files.deleteIfExists(tempInput);
         }
     }
+
+    private boolean isSupportedInputFile(MultipartFile file) {
+        String originalFilename = file.getOriginalFilename();
+        if (originalFilename == null || originalFilename.isBlank()) {
+            return false;
+        }
+
+        String normalized = originalFilename.toLowerCase(Locale.ROOT);
+        return normalized.endsWith(".stl") || normalized.endsWith(".3mf");
+    }
 }

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/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/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/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/ShopProductDetailDto.java

@@ -2,6 +2,7 @@ package com.printcalculator.dto;
 
 import java.math.BigDecimal;
 import java.util.List;
+import java.util.Map;
 import java.util.UUID;
 
 public record ShopProductDetailDto(
@@ -25,6 +26,8 @@ public record ShopProductDetailDto(
         List<ShopProductVariantOptionDto> variants,
         PublicMediaUsageDto primaryImage,
         List<PublicMediaUsageDto> images,
-        ShopProductModelDto model3d
+        ShopProductModelDto model3d,
+        String publicPath,
+        Map<String, String> localizedPaths
 ) {
 }

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

@@ -1,6 +1,7 @@
 package com.printcalculator.dto;
 
 import java.math.BigDecimal;
+import java.util.Map;
 import java.util.UUID;
 
 public record ShopProductSummaryDto(
@@ -15,6 +16,8 @@ public record ShopProductSummaryDto(
         BigDecimal priceToChf,
         ShopProductVariantOptionDto defaultVariant,
         PublicMediaUsageDto primaryImage,
-        ShopProductModelDto model3d
+        ShopProductModelDto model3d,
+        String publicPath,
+        Map<String, String> localizedPaths
 ) {
 }

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/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/event/listener/OrderEmailListener.java

@@ -223,10 +223,15 @@ public class OrderEmailListener {
                 order.getCreatedAt().format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM).withLocale(locale))
         );
         templateData.put("totalCost", currencyFormatter.format(order.getTotalChf()));
+        templateData.put("logoUrl", buildLogoUrl());
         templateData.put("currentYear", Year.now().getValue());
         return templateData;
     }
 
+    private String buildLogoUrl() {
+        return frontendBaseUrl.replaceAll("/+$", "") + "/assets/images/brand-logo-yellow.svg";
+    }
+
     private String applyOrderConfirmationTexts(Map<String, Object> templateData, String language, String orderNumber) {
         return switch (language) {
             case "en" -> {

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/security/AdminCsrfProtectionFilter.java

@@ -0,0 +1,60 @@
+package com.printcalculator.security;
+
+import com.printcalculator.config.AllowedOriginService;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.stereotype.Component;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+import java.io.IOException;
+import java.util.Locale;
+import java.util.Set;
+
+@Component
+public class AdminCsrfProtectionFilter extends OncePerRequestFilter {
+
+    private static final Set<String> SAFE_METHODS = Set.of("GET", "HEAD", "OPTIONS", "TRACE");
+
+    private final AllowedOriginService allowedOriginService;
+
+    public AdminCsrfProtectionFilter(AllowedOriginService allowedOriginService) {
+        this.allowedOriginService = allowedOriginService;
+    }
+
+    @Override
+    protected boolean shouldNotFilter(HttpServletRequest request) {
+        String path = resolvePath(request);
+        String method = request.getMethod() == null ? "" : request.getMethod().toUpperCase(Locale.ROOT);
+        return !path.startsWith("/api/admin/") || SAFE_METHODS.contains(method);
+    }
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request,
+                                    HttpServletResponse response,
+                                    FilterChain filterChain) throws ServletException, IOException {
+        String origin = request.getHeader(HttpHeaders.ORIGIN);
+        String referer = request.getHeader(HttpHeaders.REFERER);
+
+        if (allowedOriginService.isAllowed(origin) || allowedOriginService.isAllowed(referer)) {
+            filterChain.doFilter(request, response);
+            return;
+        }
+
+        response.setStatus(HttpServletResponse.SC_FORBIDDEN);
+        response.setContentType(MediaType.APPLICATION_JSON_VALUE);
+        response.getWriter().write("{\"error\":\"CSRF_INVALID\"}");
+    }
+
+    private String resolvePath(HttpServletRequest request) {
+        String path = request.getRequestURI();
+        String contextPath = request.getContextPath();
+        if (contextPath != null && !contextPath.isEmpty() && path.startsWith(contextPath)) {
+            return path.substring(contextPath.length());
+        }
+        return path;
+    }
+}

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/AdminShopCategoryControllerService.java

@@ -67,13 +67,13 @@ public class AdminShopCategoryControllerService {
     @Transactional
     public AdminShopCategoryDto createCategory(AdminUpsertShopCategoryRequest payload) {
         ensurePayload(payload);
-        String normalizedName = normalizeRequiredName(payload.getName());
-        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), normalizedName);
+        LocalizedCategoryContent localizedContent = normalizeLocalizedCategoryContent(payload);
+        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());
-        String normalizedSlug = normalizeAndValidateSlug(payload.getSlug(), normalizedName);
+        LocalizedCategoryContent localizedContent = normalizeLocalizedCategoryContent(payload);
+        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.setDescription(normalizeOptional(payload.getDescription()));
-        category.setSeoTitle(normalizeOptional(payload.getSeoTitle()));
-        category.setSeoDescription(normalizeOptional(payload.getSeoDescription()));
+        category.setName(localizedContent.defaultName());
+        category.setNameIt(localizedContent.names().get("it"));
+        category.setNameEn(localizedContent.names().get("en"));
+        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

@@ -353,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"
@@ -380,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);
@@ -531,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());

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/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/QuoteSessionItemService.java

@@ -72,10 +72,14 @@ public class QuoteSessionItemService {
             throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Cannot modify a converted session");
         }
 
+        String ext = quoteStorageService.getSafeExtension(file.getOriginalFilename(), "");
+        if (ext.isBlank()) {
+            throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "Unsupported file type. Allowed: stl, 3mf");
+        }
+
         clamAVService.scan(file.getInputStream());
 
         Path sessionStorageDir = quoteStorageService.sessionStorageDir(session.getId());
-        String ext = quoteStorageService.getSafeExtension(file.getOriginalFilename(), "stl");
         String storedFilename = UUID.randomUUID() + "." + ext;
         Path persistentPath = quoteStorageService.resolveSessionPath(sessionStorageDir, storedFilename);
 

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/quote/QuoteStorageService.java

@@ -54,7 +54,6 @@ public class QuoteStorageService {
         return switch (ext) {
             case "stl" -> "stl";
             case "3mf" -> "3mf";
-            case "step", "stp" -> "step";
             default -> fallback;
         };
     }

backend/src/main/java/com/printcalculator/service/request/CustomQuoteRequestNotificationService.java

@@ -30,6 +30,9 @@ public class CustomQuoteRequestNotificationService {
     @Value("${app.mail.contact-request.customer.enabled:true}")
     private boolean contactRequestCustomerMailEnabled;
 
+    @Value("${app.frontend.base-url:http://localhost:4200}")
+    private String frontendBaseUrl;
+
     public CustomQuoteRequestNotificationService(EmailNotificationService emailNotificationService,
                                                  ContactRequestLocalizationService localizationService) {
         this.emailNotificationService = emailNotificationService;
@@ -63,6 +66,7 @@ public class CustomQuoteRequestNotificationService {
         templateData.put("phone", safeValue(request.getPhone()));
         templateData.put("message", safeValue(request.getMessage()));
         templateData.put("attachmentsCount", attachmentsCount);
+        templateData.put("logoUrl", buildLogoUrl());
         templateData.put("currentYear", Year.now().getValue());
 
         emailNotificationService.sendEmail(
@@ -101,6 +105,7 @@ public class CustomQuoteRequestNotificationService {
         templateData.put("phone", safeValue(request.getPhone()));
         templateData.put("message", safeValue(request.getMessage()));
         templateData.put("attachmentsCount", attachmentsCount);
+        templateData.put("logoUrl", buildLogoUrl());
         templateData.put("currentYear", Year.now().getValue());
 
         String subject = localizationService.applyCustomerContactRequestTexts(templateData, language, request.getId());
@@ -119,4 +124,11 @@ public class CustomQuoteRequestNotificationService {
         }
         return value;
     }
+
+    private String buildLogoUrl() {
+        String baseUrl = frontendBaseUrl == null || frontendBaseUrl.isBlank()
+                ? "http://localhost:4200"
+                : frontendBaseUrl;
+        return baseUrl.replaceAll("/+$", "") + "/assets/images/brand-logo-yellow.svg";
+    }
 }

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

@@ -71,7 +71,7 @@ public class PublicShopCatalogService {
 
     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) {
@@ -83,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) {
@@ -114,7 +114,7 @@ public class PublicShopCatalogService {
                 .toList();
 
         ShopCategoryDetailDto selectedCategoryDetail = selectedCategory != null
-                ? buildCategoryDetail(selectedCategory, categoryContext)
+                ? buildCategoryDetail(selectedCategory, categoryContext, language)
                 : null;
 
         return new ShopProductCatalogResponseDto(
@@ -126,24 +126,62 @@ public class PublicShopCatalogService {
     }
 
     public ShopProductDetailDto getProduct(String slug, String language) {
-        CategoryContext categoryContext = loadCategoryContext(language);
-        PublicProductContext productContext = loadPublicProductContext(categoryContext, language);
+        String normalizedLanguage = normalizeLanguage(language);
+        CategoryContext categoryContext = loadCategoryContext(normalizedLanguage);
+        PublicProductContext productContext = loadPublicProductContext(categoryContext, normalizedLanguage);
+        ProductEntry entry = requirePublicProductEntry(
+                productContext.entriesBySlug().get(slug),
+                categoryContext
+        );
+        return toProductDetailDto(
+                entry,
+                productContext.productMediaBySlug(),
+                productContext.variantColorHexByMaterialAndColor(),
+                normalizedLanguage
+        );
+    }
 
-        ProductEntry entry = productContext.entriesBySlug().get(slug);
-        if (entry == null) {
+    public ShopProductDetailDto getProductByPublicPath(String publicPathSegment, String language) {
+        String normalizedLanguage = normalizeLanguage(language);
+        String normalizedPublicPath = normalizePublicPathSegment(publicPathSegment);
+        if (normalizedPublicPath == null) {
             throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
         }
 
-        ShopCategory category = entry.product().getCategory();
-        if (category == null || !categoryContext.categoriesById().containsKey(category.getId())) {
-            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
-        }
+        CategoryContext categoryContext = loadCategoryContext(normalizedLanguage);
+        PublicProductContext productContext = loadPublicProductContext(categoryContext, normalizedLanguage);
+        ProductEntry entry = requirePublicProductEntry(
+                productContext.entriesByPublicPath().get(normalizedPublicPath),
+                categoryContext
+        );
 
         return toProductDetailDto(
                 entry,
                 productContext.productMediaBySlug(),
                 productContext.variantColorHexByMaterialAndColor(),
-                language
+                normalizedLanguage
+        );
+    }
+
+    public ShopProductDetailDto getProductByIdPrefix(String idPrefix, String language) {
+        String normalizedLanguage = normalizeLanguage(language);
+        String normalizedIdPrefix = normalizeProductIdPrefix(idPrefix);
+        if (normalizedIdPrefix == null) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
+        }
+
+        CategoryContext categoryContext = loadCategoryContext(normalizedLanguage);
+        PublicProductContext productContext = loadPublicProductContext(categoryContext, normalizedLanguage);
+        ProductEntry entry = requirePublicProductEntry(
+                productContext.entriesByIdPrefix().get(normalizedIdPrefix),
+                categoryContext
+        );
+
+        return toProductDetailDto(
+                entry,
+                productContext.productMediaBySlug(),
+                productContext.variantColorHexByMaterialAndColor(),
+                normalizedLanguage
         );
     }
 
@@ -197,6 +235,7 @@ public class PublicShopCatalogService {
     }
 
     private PublicProductContext loadPublicProductContext(CategoryContext categoryContext, String language) {
+        String normalizedLanguage = normalizeLanguage(language);
         List<ProductEntry> entries = loadPublicProducts(categoryContext.categoriesById().keySet());
         Map<String, List<PublicMediaUsageDto>> productMediaBySlug = publicMediaQueryService.getUsageMediaMap(
                 SHOP_PRODUCT_MEDIA_USAGE_TYPE,
@@ -207,8 +246,29 @@ public class PublicShopCatalogService {
 
         Map<String, ProductEntry> entriesBySlug = entries.stream()
                 .collect(Collectors.toMap(entry -> entry.product().getSlug(), entry -> entry, (left, right) -> left, LinkedHashMap::new));
+        Map<String, ProductEntry> entriesByPublicPath = entries.stream()
+                .collect(Collectors.toMap(
+                        entry -> normalizePublicPathSegment(ShopPublicPathSupport.buildProductPathSegment(entry.product(), normalizedLanguage)),
+                        entry -> entry,
+                        (left, right) -> left,
+                        LinkedHashMap::new
+                ));
+        Map<String, ProductEntry> entriesByIdPrefix = entries.stream()
+                .collect(Collectors.toMap(
+                        entry -> normalizeProductIdPrefix(ShopPublicPathSupport.productIdPrefix(entry.product().getId())),
+                        entry -> entry,
+                        (left, right) -> left,
+                        LinkedHashMap::new
+                ));
 
-        return new PublicProductContext(entries, entriesBySlug, productMediaBySlug, variantColorHexByMaterialAndColor);
+        return new PublicProductContext(
+                entries,
+                entriesBySlug,
+                entriesByPublicPath,
+                entriesByIdPrefix,
+                productMediaBySlug,
+                variantColorHexByMaterialAndColor
+        );
     }
 
     private Map<String, String> buildFilamentVariantColorHexMap() {
@@ -316,53 +376,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.getDescription(),
-                        category.getSeoTitle(),
-                        category.getSeoDescription(),
+                        category.getNameForLanguage(language),
+                        category.getDescriptionForLanguage(language),
+                        category.getSeoTitleForLanguage(language),
+                        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.getDescription(),
-                category.getSeoTitle(),
-                category.getSeoDescription(),
+                category.getNameForLanguage(language),
+                category.getDescriptionForLanguage(language),
+                localizedSeoTitle,
+                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);
@@ -389,6 +459,9 @@ public class PublicShopCatalogService {
                                                       Map<String, String> variantColorHexByMaterialAndColor,
                                                       String language) {
         List<PublicMediaUsageDto> images = productMediaBySlug.getOrDefault(productMediaUsageKey(entry.product()), List.of());
+        String normalizedLanguage = normalizeLanguage(language);
+        String publicPathSegment = ShopPublicPathSupport.buildProductPathSegment(entry.product(), normalizedLanguage);
+        Map<String, String> localizedPaths = ShopPublicPathSupport.buildLocalizedProductPaths(entry.product());
         return new ShopProductSummaryDto(
                 entry.product().getId(),
                 entry.product().getSlug(),
@@ -399,13 +472,15 @@ 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(), variantColorHexByMaterialAndColor),
+                toVariantDto(entry.defaultVariant(), entry.defaultVariant(), variantColorHexByMaterialAndColor, language),
                 selectPrimaryMedia(images),
-                toProductModelDto(entry)
+                toProductModelDto(entry),
+                publicPathSegment,
+                localizedPaths
         );
     }
 
@@ -416,8 +491,10 @@ public class PublicShopCatalogService {
         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(),
+        String normalizedLanguage = normalizeLanguage(language);
+        String publicPathSegment = ShopPublicPathSupport.buildProductPathSegment(entry.product(), normalizedLanguage);
+        Map<String, String> localizedPaths = ShopPublicPathSupport.buildLocalizedProductPaths(entry.product());
+        return new ShopProductDetailDto(entry.product().getId(),
                 entry.product().getSlug(),
                 entry.product().getNameForLanguage(language),
                 entry.product().getExcerptForLanguage(language),
@@ -432,24 +509,27 @@ public class PublicShopCatalogService {
                 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(), variantColorHexByMaterialAndColor),
+                toVariantDto(entry.defaultVariant(), entry.defaultVariant(), variantColorHexByMaterialAndColor, language),
                 entry.variants().stream()
-                        .map(variant -> toVariantDto(variant, entry.defaultVariant(), variantColorHexByMaterialAndColor))
+                        .map(variant -> toVariantDto(variant, entry.defaultVariant(), variantColorHexByMaterialAndColor, language))
                         .toList(),
                 selectPrimaryMedia(images),
                 images,
-                toProductModelDto(entry)
+                toProductModelDto(entry),
+                publicPathSegment,
+                localizedPaths
         );
     }
 
     private ShopProductVariantOptionDto toVariantDto(ShopProductVariant variant,
                                                      ShopProductVariant defaultVariant,
-                                                     Map<String, String> variantColorHexByMaterialAndColor) {
+                                                     Map<String, String> variantColorHexByMaterialAndColor,
+                                                     String language) {
         if (variant == null) {
             return null;
         }
@@ -463,6 +543,7 @@ public class PublicShopCatalogService {
                 variant.getSku(),
                 variant.getVariantLabel(),
                 variant.getColorName(),
+                variant.getColorLabelForLanguage(language),
                 colorHex,
                 variant.getPriceChf(),
                 defaultVariant != null && Objects.equals(defaultVariant.getId(), variant.getId())
@@ -494,6 +575,36 @@ public class PublicShopCatalogService {
         return raw.toLowerCase(Locale.ROOT);
     }
 
+    private ProductEntry requirePublicProductEntry(ProductEntry entry, CategoryContext categoryContext) {
+        if (entry == null) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
+        }
+
+        ShopCategory category = entry.product().getCategory();
+        if (category == null || !categoryContext.categoriesById().containsKey(category.getId())) {
+            throw new ResponseStatusException(HttpStatus.NOT_FOUND, "Product not found");
+        }
+
+        return entry;
+    }
+
+    private String normalizePublicPathSegment(String publicPathSegment) {
+        String normalized = trimToNull(publicPathSegment);
+        if (normalized == null) {
+            return null;
+        }
+        return normalized.toLowerCase(Locale.ROOT);
+    }
+
+    private String normalizeProductIdPrefix(String idPrefix) {
+        String normalized = trimToNull(idPrefix);
+        if (normalized == null) {
+            return null;
+        }
+        normalized = normalized.toLowerCase(Locale.ROOT);
+        return normalized.matches("^[0-9a-f]{8}$") ? normalized : null;
+    }
+
     private String trimToNull(String value) {
         String raw = String.valueOf(value == null ? "" : value).trim();
         if (raw.isEmpty()) {
@@ -502,6 +613,22 @@ public class PublicShopCatalogService {
         return raw;
     }
 
+    private String normalizeLanguage(String language) {
+        String normalized = trimToNull(language);
+        if (normalized == null) {
+            return "it";
+        }
+        normalized = normalized.toLowerCase(Locale.ROOT);
+        int separatorIndex = normalized.indexOf('-');
+        if (separatorIndex > 0) {
+            normalized = normalized.substring(0, separatorIndex);
+        }
+        return switch (normalized) {
+            case "en", "de", "fr" -> normalized;
+            default -> "it";
+        };
+    }
+
     private ShopProductModelDto toProductModelDto(ProductEntry entry) {
         if (entry.modelAsset() == null) {
             return null;
@@ -573,6 +700,8 @@ public class PublicShopCatalogService {
     private record PublicProductContext(
             List<ProductEntry> entries,
             Map<String, ProductEntry> entriesBySlug,
+            Map<String, ProductEntry> entriesByPublicPath,
+            Map<String, ProductEntry> entriesByIdPrefix,
             Map<String, List<PublicMediaUsageDto>> productMediaBySlug,
             Map<String, String> variantColorHexByMaterialAndColor
     ) {

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

@@ -0,0 +1,66 @@
+package com.printcalculator.service.shop;
+
+import com.printcalculator.entity.ShopProduct;
+
+import java.text.Normalizer;
+import java.util.LinkedHashMap;
+import java.util.Locale;
+import java.util.Map;
+import java.util.UUID;
+
+final class ShopPublicPathSupport {
+    private static final String PRODUCT_ROUTE_PREFIX = "/shop/p/";
+
+    private ShopPublicPathSupport() {
+    }
+
+    static String buildProductPathSegment(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;
+    }
+
+    static Map<String, String> buildLocalizedProductPaths(ShopProduct product) {
+        Map<String, String> localizedPaths = new LinkedHashMap<>();
+        for (String language : ShopProduct.SUPPORTED_LANGUAGES) {
+            localizedPaths.put(language, "/" + language + PRODUCT_ROUTE_PREFIX + buildProductPathSegment(product, language));
+        }
+        return localizedPaths;
+    }
+
+    static 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 static 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/service/shop/ShopSitemapService.java

@@ -11,7 +11,6 @@ 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;
@@ -19,7 +18,6 @@ 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;
@@ -31,6 +29,12 @@ 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 static final Map<String, String> HREFLANG_BY_LANGUAGE = Map.of(
+            "it", "it-CH",
+            "en", "en-CH",
+            "de", "de-CH",
+            "fr", "fr-CH"
+    );
 
     private final ShopCategoryRepository shopCategoryRepository;
     private final ShopProductRepository shopProductRepository;
@@ -130,7 +134,7 @@ public class ShopSitemapService {
 
             Map<String, String> hrefByLanguage = new LinkedHashMap<>();
             for (String language : SUPPORTED_LANGUAGES) {
-                String publicSegment = localizedProductPathSegment(product, language);
+                String publicSegment = ShopPublicPathSupport.buildProductPathSegment(product, language);
                 hrefByLanguage.put(language, frontendBaseUrl + "/" + language + "/shop/p/" + pathEncodeSegment(publicSegment));
             }
 
@@ -146,8 +150,22 @@ public class ShopSitemapService {
             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(defaultHref)).append("</loc>\n");
+        xml.append("    <loc>").append(xmlEscape(locHref)).append("</loc>\n");
 
         for (String language : SUPPORTED_LANGUAGES) {
             String href = hrefByLanguage.get(language);
@@ -155,7 +173,7 @@ public class ShopSitemapService {
                 continue;
             }
             xml.append("    <xhtml:link rel=\"alternate\" hreflang=\"")
-                    .append(language)
+                    .append(HREFLANG_BY_LANGUAGE.getOrDefault(language, language))
                     .append("\" href=\"")
                     .append(xmlEscape(href))
                     .append("\" />\n");
@@ -172,48 +190,6 @@ public class ShopSitemapService {
         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");

backend/src/main/resources/application.properties

@@ -56,7 +56,14 @@ 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.cors.additional-allowed-origins=${APP_CORS_ADDITIONAL_ALLOWED_ORIGINS:}
 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/main/resources/templates/email/contact-request-admin.html

@@ -25,6 +25,21 @@
             color: #222222;
         }
 
+        .header {
+            text-align: center;
+            border-bottom: 1px solid #eeeeee;
+            padding-bottom: 20px;
+            margin-bottom: 20px;
+        }
+
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         p {
             color: #444444;
             line-height: 1.5;
@@ -63,7 +78,10 @@
 </head>
 <body>
 <div class="container">
+    <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1>Nuova richiesta di contatto</h1>
+    </div>
     <p>E' stata ricevuta una nuova richiesta dal form contatti/su misura.</p>
 
     <table>

backend/src/main/resources/templates/email/contact-request-customer.html

@@ -25,6 +25,21 @@
             color: #222222;
         }
 
+        .header {
+            text-align: center;
+            border-bottom: 1px solid #eeeeee;
+            padding-bottom: 20px;
+            margin-bottom: 20px;
+        }
+
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         h2 {
             margin-top: 18px;
             color: #222222;
@@ -69,7 +84,10 @@
 </head>
 <body>
 <div class="container">
+    <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1 th:text="${headlineText}">We received your contact request</h1>
+    </div>
     <p th:text="${greetingText}">Hi customer,</p>
     <p th:text="${introText}">Thank you for contacting us. Our team will reply as soon as possible.</p>
     <p>

backend/src/main/resources/templates/email/order-confirmation.html

@@ -27,8 +27,17 @@
             margin-bottom: 20px;
         }
 
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         .header h1 {
             color: #333333;
+            margin: 0;
         }
 
         .content {
@@ -67,6 +76,7 @@
 <body>
 <div class="container">
     <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1 th:text="${headlineText}">Thank you for your order #00000000</h1>
     </div>
 

backend/src/main/resources/templates/email/order-shipped.html

@@ -27,8 +27,17 @@
             margin-bottom: 20px;
         }
 
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         .header h1 {
             color: #333333;
+            margin: 0;
         }
 
         .content {
@@ -70,6 +79,7 @@
 <body>
 <div class="container">
     <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1 th:text="${headlineText}">Your order #00000000 has been shipped</h1>
     </div>
 

backend/src/main/resources/templates/email/payment-confirmed.html

@@ -27,8 +27,17 @@
             margin-bottom: 20px;
         }
 
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         .header h1 {
             color: #333333;
+            margin: 0;
         }
 
         .content {
@@ -70,6 +79,7 @@
 <body>
 <div class="container">
     <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1 th:text="${headlineText}">Payment confirmed for order #00000000</h1>
     </div>
 

backend/src/main/resources/templates/email/payment-reported.html

@@ -27,8 +27,17 @@
             margin-bottom: 20px;
         }
 
+        .brand-logo {
+            display: block;
+            width: 220px;
+            max-width: 220px;
+            height: auto;
+            margin: 0 auto 16px;
+        }
+
         .header h1 {
             color: #333333;
+            margin: 0;
         }
 
         .content {
@@ -70,6 +79,7 @@
 <body>
 <div class="container">
     <div class="header">
+        <img class="brand-logo" th:src="${logoUrl}" src="https://example.com/assets/images/brand-logo-yellow.svg" alt="3D-Fab">
         <h1 th:text="${headlineText}">Payment reported for order #00000000</h1>
     </div>
 

backend/src/test/java/com/printcalculator/controller/AdminAuthSecurityTest.java

@@ -1,7 +1,10 @@
 package com.printcalculator.controller;
 
+import com.printcalculator.config.AllowedOriginService;
+import com.printcalculator.config.CorsConfig;
 import com.printcalculator.config.SecurityConfig;
 import com.printcalculator.controller.admin.AdminAuthController;
+import com.printcalculator.security.AdminCsrfProtectionFilter;
 import com.printcalculator.security.AdminLoginThrottleService;
 import com.printcalculator.security.AdminSessionAuthenticationFilter;
 import com.printcalculator.security.AdminSessionService;
@@ -19,13 +22,18 @@ import org.springframework.test.web.servlet.MvcResult;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.options;
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
 
 @WebMvcTest(controllers = AdminAuthController.class)
 @Import({
+        CorsConfig.class,
+        AllowedOriginService.class,
         SecurityConfig.class,
+        AdminCsrfProtectionFilter.class,
         AdminSessionAuthenticationFilter.class,
         AdminSessionService.class,
         AdminLoginThrottleService.class
@@ -37,6 +45,8 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
 })
 class AdminAuthSecurityTest {
 
+    private static final String ALLOWED_ORIGIN = "http://localhost:4200";
+
     @Autowired
     private MockMvc mockMvc;
 
@@ -47,6 +57,7 @@ class AdminAuthSecurityTest {
                             req.setRemoteAddr("10.0.0.1");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"test-admin-password\"}"))
                 .andExpect(status().isOk())
@@ -69,6 +80,7 @@ class AdminAuthSecurityTest {
                             req.setRemoteAddr("10.0.0.2");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"wrong-password\"}"))
                 .andExpect(status().isUnauthorized())
@@ -83,6 +95,7 @@ class AdminAuthSecurityTest {
                             req.setRemoteAddr("10.0.0.3");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"wrong-password\"}"))
                 .andExpect(status().isUnauthorized())
@@ -93,12 +106,36 @@ class AdminAuthSecurityTest {
                             req.setRemoteAddr("10.0.0.3");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"wrong-password\"}"))
                 .andExpect(status().isTooManyRequests())
                 .andExpect(jsonPath("$.authenticated").value(false));
     }
 
+    @Test
+    void loginWithoutTrustedOrigin_ShouldReturnForbidden() throws Exception {
+        mockMvc.perform(post("/api/admin/auth/login")
+                        .with(req -> {
+                            req.setRemoteAddr("10.0.0.30");
+                            return req;
+                        })
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"password\":\"test-admin-password\"}"))
+                .andExpect(status().isForbidden())
+                .andExpect(jsonPath("$.error").value("CSRF_INVALID"));
+    }
+
+    @Test
+    void preflightFromAllowedOrigin_ShouldExposeCorsHeaders() throws Exception {
+        mockMvc.perform(options("/api/admin/auth/login")
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
+                        .header(HttpHeaders.ACCESS_CONTROL_REQUEST_METHOD, "POST"))
+                .andExpect(status().isOk())
+                .andExpect(header().string(HttpHeaders.ACCESS_CONTROL_ALLOW_ORIGIN, ALLOWED_ORIGIN))
+                .andExpect(header().string(HttpHeaders.ACCESS_CONTROL_ALLOW_CREDENTIALS, "true"));
+    }
+
     @Test
     void adminAccessWithoutCookie_ShouldReturn401() throws Exception {
         mockMvc.perform(get("/api/admin/auth/me"))
@@ -112,6 +149,7 @@ class AdminAuthSecurityTest {
                             req.setRemoteAddr("10.0.0.4");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"test-admin-password\"}"))
                 .andExpect(status().isOk())

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

@@ -1,7 +1,10 @@
 package com.printcalculator.controller.admin;
 
+import com.printcalculator.config.AllowedOriginService;
+import com.printcalculator.config.CorsConfig;
 import com.printcalculator.config.SecurityConfig;
 import com.printcalculator.service.order.AdminOrderControllerService;
+import com.printcalculator.security.AdminCsrfProtectionFilter;
 import com.printcalculator.security.AdminLoginThrottleService;
 import com.printcalculator.security.AdminSessionAuthenticationFilter;
 import com.printcalculator.security.AdminSessionService;
@@ -35,7 +38,10 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
 
 @WebMvcTest(controllers = {AdminAuthController.class, AdminOrderController.class})
 @Import({
+        CorsConfig.class,
+        AllowedOriginService.class,
         SecurityConfig.class,
+        AdminCsrfProtectionFilter.class,
         AdminSessionAuthenticationFilter.class,
         AdminSessionService.class,
         AdminLoginThrottleService.class,
@@ -48,6 +54,8 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
 })
 class AdminOrderControllerSecurityTest {
 
+    private static final String ALLOWED_ORIGIN = "http://localhost:4200";
+
     @Autowired
     private MockMvc mockMvc;
 
@@ -96,6 +104,7 @@ class AdminOrderControllerSecurityTest {
                             req.setRemoteAddr("10.0.0.44");
                             return req;
                         })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
                         .contentType(MediaType.APPLICATION_JSON)
                         .content("{\"password\":\"test-admin-password\"}"))
                 .andExpect(status().isOk())

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

@@ -0,0 +1,170 @@
+package com.printcalculator.controller.admin;
+
+import com.printcalculator.config.AllowedOriginService;
+import com.printcalculator.config.CorsConfig;
+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.AdminCsrfProtectionFilter;
+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({
+        CorsConfig.class,
+        AllowedOriginService.class,
+        SecurityConfig.class,
+        AdminCsrfProtectionFilter.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 {
+
+    private static final String ALLOWED_ORIGIN = "http://localhost:4200";
+
+    @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")
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"sourceLanguage\":\"it\",\"names\":{\"it\":\"Supporto cavo\"}}"))
+                .andExpect(status().isUnauthorized());
+    }
+
+    @Test
+    void translateProduct_withAdminCookieAndMissingOrigin_shouldReturn403() throws Exception {
+        mockMvc.perform(post("/api/admin/shop/products/translate")
+                        .cookie(loginAndExtractCookie())
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .content("{\"sourceLanguage\":\"it\",\"names\":{\"it\":\"Supporto cavo\"}}"))
+                .andExpect(status().isForbidden())
+                .andExpect(jsonPath("$.error").value("CSRF_INVALID"));
+    }
+
+    @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())
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
+                        .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;
+                        })
+                        .header(HttpHeaders.ORIGIN, ALLOWED_ORIGIN)
+                        .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/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/shop/PublicShopCatalogServiceTest.java

@@ -0,0 +1,191 @@
+package com.printcalculator.service.shop;
+
+import com.printcalculator.dto.ShopProductCatalogResponseDto;
+import com.printcalculator.dto.ShopProductDetailDto;
+import com.printcalculator.entity.ShopCategory;
+import com.printcalculator.entity.ShopProduct;
+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;
+import com.printcalculator.repository.ShopProductVariantRepository;
+import com.printcalculator.service.media.PublicMediaQueryService;
+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 org.springframework.web.server.ResponseStatusException;
+
+import java.math.BigDecimal;
+import java.util.List;
+import java.util.Map;
+import java.util.UUID;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.anyList;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class PublicShopCatalogServiceTest {
+
+    @Mock
+    private ShopCategoryRepository shopCategoryRepository;
+    @Mock
+    private ShopProductRepository shopProductRepository;
+    @Mock
+    private ShopProductVariantRepository shopProductVariantRepository;
+    @Mock
+    private ShopProductModelAssetRepository shopProductModelAssetRepository;
+    @Mock
+    private FilamentVariantRepository filamentVariantRepository;
+    @Mock
+    private PublicMediaQueryService publicMediaQueryService;
+    @Mock
+    private ShopStorageService shopStorageService;
+
+    private PublicShopCatalogService service;
+
+    @BeforeEach
+    void setUp() {
+        service = new PublicShopCatalogService(
+                shopCategoryRepository,
+                shopProductRepository,
+                shopProductVariantRepository,
+                shopProductModelAssetRepository,
+                filamentVariantRepository,
+                publicMediaQueryService,
+                shopStorageService
+        );
+    }
+
+    @Test
+    void getProductCatalog_shouldExposePublicPathAsSegment() {
+        ShopCategory category = buildCategory();
+        ShopProduct product = buildProduct(category);
+        ShopProductVariant variant = buildVariant(product);
+
+        stubPublicCatalog(category, product, variant);
+
+        ShopProductCatalogResponseDto response = service.getProductCatalog(null, false, "en");
+
+        assertEquals(1, response.products().size());
+        assertEquals("12345678-bike-wall-hanger", response.products().getFirst().publicPath());
+        assertEquals("/en/shop/p/12345678-bike-wall-hanger", response.products().getFirst().localizedPaths().get("en"));
+        assertEquals("/it/shop/p/12345678-supporto-bici", response.products().getFirst().localizedPaths().get("it"));
+    }
+
+    @Test
+    void getProduct_shouldExposePublicPathAsSegment() {
+        ShopCategory category = buildCategory();
+        ShopProduct product = buildProduct(category);
+        ShopProductVariant variant = buildVariant(product);
+
+        stubPublicCatalog(category, product, variant);
+
+        ShopProductDetailDto response = service.getProduct("bike-wall-hanger", "en");
+
+        assertEquals("12345678-bike-wall-hanger", response.publicPath());
+        assertEquals("/en/shop/p/12345678-bike-wall-hanger", response.localizedPaths().get("en"));
+        assertEquals("/it/shop/p/12345678-supporto-bici", response.localizedPaths().get("it"));
+    }
+
+    @Test
+    void getProductByPublicPath_shouldResolveLocalizedSegment() {
+        ShopCategory category = buildCategory();
+        ShopProduct product = buildProduct(category);
+        ShopProductVariant variant = buildVariant(product);
+
+        stubPublicCatalog(category, product, variant);
+
+        ShopProductDetailDto response = service.getProductByPublicPath("12345678-bike-wall-hanger", "en");
+
+        assertEquals("bike-wall-hanger", response.slug());
+        assertEquals("12345678-bike-wall-hanger", response.publicPath());
+        assertEquals("/en/shop/p/12345678-bike-wall-hanger", response.localizedPaths().get("en"));
+    }
+
+    @Test
+    void getProductByIdPrefix_shouldResolveLocalizedProduct() {
+        ShopCategory category = buildCategory();
+        ShopProduct product = buildProduct(category);
+        ShopProductVariant variant = buildVariant(product);
+
+        stubPublicCatalog(category, product, variant);
+
+        ShopProductDetailDto response = service.getProductByIdPrefix("12345678", "de");
+
+        assertEquals("bike-wall-hanger", response.slug());
+        assertEquals("12345678-bike-wall-hanger", response.publicPath());
+        assertEquals("/de/shop/p/12345678-bike-wall-hanger", response.localizedPaths().get("de"));
+    }
+
+    @Test
+    void getProductByPublicPath_shouldRejectNonCanonicalSegment() {
+        ShopCategory category = buildCategory();
+        ShopProduct product = buildProduct(category);
+        ShopProductVariant variant = buildVariant(product);
+
+        stubPublicCatalog(category, product, variant);
+
+        ResponseStatusException exception = assertThrows(
+                ResponseStatusException.class,
+                () -> service.getProductByPublicPath("12345678-wrong-tail", "en")
+        );
+
+        assertEquals(404, exception.getStatusCode().value());
+    }
+
+    private void stubPublicCatalog(ShopCategory category, ShopProduct product, ShopProductVariant variant) {
+        when(shopCategoryRepository.findAllByIsActiveTrueOrderBySortOrderAscNameAsc()).thenReturn(List.of(category));
+        when(shopProductRepository.findAllByIsActiveTrueOrderByIsFeaturedDescSortOrderAscNameAsc()).thenReturn(List.of(product));
+        when(shopProductVariantRepository.findByProduct_IdInAndIsActiveTrueOrderBySortOrderAscColorNameAsc(anyList()))
+                .thenReturn(List.of(variant));
+        when(shopProductModelAssetRepository.findByProduct_IdIn(anyList())).thenReturn(List.of());
+        when(filamentVariantRepository.findByIsActiveTrue()).thenReturn(List.of());
+        when(publicMediaQueryService.getUsageMediaMap(anyString(), anyList(), anyString())).thenReturn(Map.of());
+    }
+
+    private ShopCategory buildCategory() {
+        ShopCategory category = new ShopCategory();
+        category.setId(UUID.fromString("21111111-1111-1111-1111-111111111111"));
+        category.setSlug("accessori");
+        category.setName("Accessori");
+        category.setNameIt("Accessori");
+        category.setNameEn("Accessories");
+        category.setIsActive(true);
+        category.setSortOrder(0);
+        return category;
+    }
+
+    private ShopProduct buildProduct(ShopCategory category) {
+        ShopProduct product = new ShopProduct();
+        product.setId(UUID.fromString("12345678-abcd-4abc-9abc-1234567890ab"));
+        product.setCategory(category);
+        product.setSlug("bike-wall-hanger");
+        product.setName("Bike Wall-Hanger");
+        product.setNameIt("Supporto bici");
+        product.setNameEn("Bike Wall-Hanger");
+        product.setIsActive(true);
+        product.setIsFeatured(true);
+        product.setSortOrder(0);
+        return product;
+    }
+
+    private ShopProductVariant buildVariant(ShopProduct product) {
+        ShopProductVariant variant = new ShopProductVariant();
+        variant.setId(UUID.fromString("aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"));
+        variant.setProduct(product);
+        variant.setVariantLabel("PLA");
+        variant.setColorName("Grigio");
+        variant.setInternalMaterialCode("PLA");
+        variant.setPriceChf(new BigDecimal("29.90"));
+        variant.setIsActive(true);
+        variant.setIsDefault(true);
+        variant.setSortOrder(0);
+        return variant;
+    }
+}

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

@@ -89,12 +89,18 @@ class ShopSitemapServiceTest {
         String xml = service.getShopSitemapXml();
 
         assertTrue(xml.contains("<loc>https://3d-fab.ch/it/shop/accessori</loc>"));
-        assertTrue(xml.contains("hreflang=\"en\" href=\"https://3d-fab.ch/en/shop/accessori\""));
+        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-CH\" 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("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("<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-CH\" href=\"https://3d-fab.ch/en/shop/p/123e4567-bike-holder\""));
+        assertTrue(xml.contains("hreflang=\"de-CH\" 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"));

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(),
@@ -1165,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),
@@ -1181,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,6 +29,12 @@ 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}
@@ -56,6 +62,8 @@ services:
     container_name: print-calculator-frontend-${ENV}
     ports:
       - "${FRONTEND_PORT}:80"
+    environment:
+      - SSR_INTERNAL_API_ORIGIN=http://backend:8000
     depends_on:
       - backend
     restart: always

frontend/angular.json

@@ -61,13 +61,13 @@
               "budgets": [
                 {
                   "type": "initial",
-                  "maximumWarning": "500kB",
-                  "maximumError": "1MB"
+                  "maximumWarning": "600kB",
+                  "maximumError": "1.2MB"
                 },
                 {
                   "type": "anyComponentStyle",
-                  "maximumWarning": "4kB",
-                  "maximumError": "8kB"
+                  "maximumWarning": "10kB",
+                  "maximumError": "14kB"
                 }
               ]
             },

frontend/public/robots.txt

@@ -9,9 +9,9 @@ Disallow: /order
 Disallow: /order/
 Disallow: /*/order
 Disallow: /*/order/
-Disallow: /co
+Disallow: /co$
 Disallow: /co/
-Disallow: /*/co
+Disallow: /*/co$
 Disallow: /*/co/
 Disallow: /checkout
 Disallow: /checkout/

frontend/public/site.webmanifest

@@ -0,0 +1,23 @@
+{
+  "name": "3D fab",
+  "short_name": "3D fab",
+  "description": "Stampa 3D su misura con preventivo online immediato.",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#ffffff",
+  "icons": [
+    {
+      "src": "/assets/images/Fav-icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/assets/images/Fav-icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any"
+    }
+  ]
+}

frontend/public/sitemap-static.xml

@@ -1,152 +1,328 @@
 <?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"
->
+<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" />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/" />
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
+  <url>
+    <loc>https://3d-fab.ch/en</loc>
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/de</loc>
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/" />
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://3d-fab.ch/fr</loc>
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" href="https://3d-fab.ch/fr" />
+    <xhtml:link rel="alternate" hreflang="x-default" href="https://3d-fab.ch/" />
+    <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"
-    />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/basic" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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"
-    />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/calculator/advanced" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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="it-CH" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/shop" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/shop" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/shop" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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"
-    />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/about" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/about" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/about" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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"
-    />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/contact" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/contact" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/contact" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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"
-    />
+    <xhtml:link rel="alternate" hreflang="it-CH" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/privacy" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/privacy" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/privacy" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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="it-CH" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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-CH" href="https://3d-fab.ch/it/terms" />
+    <xhtml:link rel="alternate" hreflang="en-CH" href="https://3d-fab.ch/en/terms" />
+    <xhtml:link rel="alternate" hreflang="de-CH" href="https://3d-fab.ch/de/terms" />
+    <xhtml:link rel="alternate" hreflang="fr-CH" 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>

frontend/src/app/app.component.html

@@ -1 +1,14 @@
 <router-outlet></router-outlet>
+
+@if (siteIntroState() !== "hidden") {
+  <div
+    class="site-intro"
+    [class.site-intro--closing]="siteIntroState() === 'closing'"
+    aria-hidden="true"
+  >
+    <app-brand-animation-logo
+      class="site-intro__logo"
+      variant="site-intro"
+    ></app-brand-animation-logo>
+  </div>
+}

frontend/src/app/app.component.scss

@@ -0,0 +1,40 @@
+.site-intro {
+  position: fixed;
+  inset: 0;
+  z-index: 2000;
+  display: grid;
+  place-items: center;
+  background: var(--color-bg);
+  pointer-events: none;
+  opacity: 1;
+  transition: opacity 0.24s ease-out;
+}
+
+.site-intro--closing {
+  opacity: 0;
+}
+
+.site-intro__logo {
+  width: min(calc(100vw - 2rem), 23rem);
+  --brand-animation-width: 23rem;
+  --brand-animation-height: 7.1rem;
+  --brand-animation-letter-width: 3.75rem;
+  --brand-animation-scale: 0.88;
+  --brand-animation-width-mobile: 16.8rem;
+  --brand-animation-height-mobile: 5.3rem;
+  --brand-animation-letter-width-mobile: 2.8rem;
+  --brand-animation-scale-mobile: 0.68;
+  --brand-animation-site-intro-duration: 1.05s;
+  justify-self: center;
+  align-self: center;
+  opacity: 1;
+  transform: scale(1);
+  transition:
+    opacity 0.24s ease-out,
+    transform 0.24s ease-out;
+}
+
+.site-intro--closing .site-intro__logo {
+  opacity: 0;
+  transform: scale(0.985);
+}

frontend/src/app/app.component.ts

@@ -1,14 +1,50 @@
-import { Component, inject } from '@angular/core';
+import {
+  afterNextRender,
+  Component,
+  DestroyRef,
+  Inject,
+  Optional,
+  PLATFORM_ID,
+  inject,
+  signal,
+} from '@angular/core';
+import { isPlatformBrowser } from '@angular/common';
 import { RouterOutlet } from '@angular/router';
 import { SeoService } from './core/services/seo.service';
+import { BrandAnimationLogoComponent } from './shared/components/brand-animation-logo/brand-animation-logo.component';
 
 @Component({
   selector: 'app-root',
   standalone: true,
-  imports: [RouterOutlet],
+  imports: [RouterOutlet, BrandAnimationLogoComponent],
   templateUrl: './app.component.html',
   styleUrl: './app.component.scss',
 })
 export class AppComponent {
   private readonly seoService = inject(SeoService);
+  private readonly destroyRef = inject(DestroyRef);
+  readonly siteIntroState = signal<'hidden' | 'active' | 'closing'>('hidden');
+
+  constructor(@Optional() @Inject(PLATFORM_ID) platformId?: Object) {
+    if (!isPlatformBrowser(platformId ?? 'browser')) {
+      return;
+    }
+
+    afterNextRender(() => {
+      this.siteIntroState.set('active');
+
+      const closeTimeoutId = window.setTimeout(() => {
+        this.siteIntroState.set('closing');
+      }, 1020);
+
+      const hideTimeoutId = window.setTimeout(() => {
+        this.siteIntroState.set('hidden');
+      }, 1280);
+
+      this.destroyRef.onDestroy(() => {
+        window.clearTimeout(closeTimeoutId);
+        window.clearTimeout(hideTimeoutId);
+      });
+    });
+  }
 }

frontend/src/app/app.config.ts

@@ -28,21 +28,12 @@ import {
 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';
-}
+import {
+  getNavigatorLanguagePreferences,
+  parseAcceptLanguage,
+  resolveInitialLanguage,
+  SUPPORTED_LANGS,
+} from './core/i18n/language-resolution';
 
 export const appConfig: ApplicationConfig = {
   providers: [
@@ -52,7 +43,7 @@ export const appConfig: ApplicationConfig = {
       withComponentInputBinding(),
       withViewTransitions(),
       withInMemoryScrolling({
-        scrollPositionRestoration: 'top',
+        scrollPositionRestoration: 'enabled',
       }),
     ),
     provideHttpClient(
@@ -60,7 +51,7 @@ export const appConfig: ApplicationConfig = {
     ),
     importProvidersFrom(
       TranslateModule.forRoot({
-        defaultLanguage: 'it',
+        fallbackLang: 'it',
         loader: {
           provide: TranslateLoader,
           useClass: StaticTranslateLoader,
@@ -72,13 +63,21 @@ export const appConfig: ApplicationConfig = {
       const router = inject(Router);
       const request = inject(REQUEST, { optional: true }) as {
         url?: string;
+        headers?: Record<string, string | string[] | undefined>;
       } | null;
 
       translate.addLangs([...SUPPORTED_LANGS]);
-      translate.setDefaultLang('it');
+      translate.setFallbackLang('it');
       const requestedUrl =
         (typeof request?.url === 'string' && request.url) || router.url || '/';
-      const lang = resolveLangFromUrl(requestedUrl);
+      const lang = resolveInitialLanguage({
+        url: requestedUrl,
+        preferredLanguages: request
+          ? parseAcceptLanguage(readRequestHeader(request, 'accept-language'))
+          : getNavigatorLanguagePreferences(
+              typeof navigator === 'undefined' ? null : navigator,
+            ),
+      });
 
       return firstValueFrom(
         translate.use(lang).pipe(
@@ -96,3 +95,21 @@ export const appConfig: ApplicationConfig = {
     provideClientHydration(withEventReplay()),
   ],
 };
+
+function readRequestHeader(
+  request: {
+    headers?: Record<string, string | string[] | undefined>;
+  } | null,
+  headerName: string,
+): string | null {
+  if (!request?.headers) {
+    return null;
+  }
+
+  const headerValue = request.headers[headerName.toLowerCase()];
+  if (Array.isArray(headerValue)) {
+    return headerValue[0] ?? null;
+  }
+
+  return typeof headerValue === 'string' ? headerValue : null;
+}

frontend/src/app/app.routes.ts

@@ -15,9 +15,8 @@ const appChildRoutes: Routes = [
     loadComponent: () =>
       import('./features/home/home.component').then((m) => m.HomeComponent),
     data: {
-      seoTitle: '3D fab | Stampa 3D su misura',
-      seoDescription:
-        'Servizio di stampa 3D con preventivo online immediato per prototipi, piccole serie e pezzi personalizzati.',
+      seoTitleKey: 'SEO.ROUTES.HOME.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.HOME.DESCRIPTION',
     },
   },
   {
@@ -27,9 +26,8 @@ const appChildRoutes: Routes = [
         (m) => m.CALCULATOR_ROUTES,
       ),
     data: {
-      seoTitle: 'Calcolatore preventivo stampa 3D | 3D fab',
-      seoDescription:
-        'Carica il file 3D e ottieni prezzo e tempi in pochi secondi con slicing reale.',
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.DESCRIPTION',
     },
   },
   {
@@ -37,9 +35,8 @@ const appChildRoutes: Routes = [
     loadChildren: () =>
       import('./features/shop/shop.routes').then((m) => m.SHOP_ROUTES),
     data: {
-      seoTitle: 'Shop 3D fab',
-      seoDescription:
-        'Catalogo prodotti stampati in 3D e soluzioni tecniche pronte all uso.',
+      seoTitleKey: 'SEO.ROUTES.SHOP.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.SHOP.DESCRIPTION',
     },
   },
   {
@@ -47,19 +44,28 @@ const appChildRoutes: Routes = [
     loadChildren: () =>
       import('./features/about/about.routes').then((m) => m.ABOUT_ROUTES),
     data: {
-      seoTitle: 'Chi siamo | 3D fab',
-      seoDescription:
-        'Scopri il team 3D fab e il laboratorio di stampa 3D con sedi in Ticino e Bienne.',
+      seoTitleKey: 'SEO.ROUTES.ABOUT.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.ABOUT.DESCRIPTION',
     },
   },
+  /* {
+    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',
-      seoDescription:
-        'Contatta 3D fab per preventivi, supporto tecnico e richieste personalizzate di stampa 3D.',
+      seoTitleKey: 'SEO.ROUTES.CONTACT.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CONTACT.DESCRIPTION',
     },
   },
   {
@@ -69,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',
     },
   },
@@ -80,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',
     },
   },
@@ -89,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',
     },
   },
@@ -98,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',
     },
   },
@@ -112,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',
     },
   },
@@ -123,6 +134,31 @@ const appChildRoutes: Routes = [
 ];
 
 export const routes: Routes = [
+  {
+    path: ':lang/calculator/animation-test',
+    canMatch: [langPrefixCanMatch],
+    loadComponent: () =>
+      import('./features/calculator/calculator-animation-test.component').then(
+        (m) => m.CalculatorAnimationTestComponent,
+      ),
+    data: {
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.DESCRIPTION',
+      seoRobots: 'noindex, nofollow',
+    },
+  },
+  {
+    path: 'calculator/animation-test',
+    loadComponent: () =>
+      import('./features/calculator/calculator-animation-test.component').then(
+        (m) => m.CalculatorAnimationTestComponent,
+      ),
+    data: {
+      seoTitleKey: 'SEO.ROUTES.CALCULATOR.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.CALCULATOR.DESCRIPTION',
+      seoRobots: 'noindex, nofollow',
+    },
+  },
   {
     path: ':lang',
     canMatch: [langPrefixCanMatch],

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 {
-  for (const cat of PRODUCT_COLORS) {
-    const found = cat.colors.find((c) => c.value === value);
-    if (found) return found.hex;
-  }
-  return '#facf0a'; // Default Brand Color if not found
+export function normalizeColorValue(value: string | null | undefined): string {
+  return String(value ?? '')
+    .trim()
+    .toLowerCase()
+    .replace(/ß/g, 'ss')
+    .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/language-resolution.ts

@@ -0,0 +1,135 @@
+export type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+
+export const SUPPORTED_LANGS: readonly SupportedLang[] = [
+  'it',
+  'en',
+  'de',
+  'fr',
+];
+
+type InitialLanguageOptions = {
+  url?: string | null;
+  preferredLanguages?: readonly string[] | null;
+  fallbackLang?: SupportedLang;
+};
+
+type NavigatorLike = {
+  language?: string;
+  languages?: readonly string[];
+};
+
+export function resolveInitialLanguage({
+  url,
+  preferredLanguages,
+  fallbackLang = 'it',
+}: InitialLanguageOptions): SupportedLang {
+  const explicitLang = resolveExplicitLanguageFromUrl(url);
+  if (explicitLang) {
+    return explicitLang;
+  }
+
+  for (const candidate of preferredLanguages ?? []) {
+    const normalized = normalizeSupportedLanguage(candidate);
+    if (normalized) {
+      return normalized;
+    }
+  }
+
+  return fallbackLang;
+}
+
+export function parseAcceptLanguage(
+  header: string | null | undefined,
+): string[] {
+  if (!header) {
+    return [];
+  }
+
+  return header
+    .split(',')
+    .map((entry, index) => {
+      const [rawTag, ...params] = entry.split(';').map((part) => part.trim());
+      if (!rawTag) {
+        return null;
+      }
+
+      const qualityParam = params.find((param) => param.startsWith('q='));
+      const quality = qualityParam
+        ? Number.parseFloat(qualityParam.slice(2))
+        : 1;
+      return {
+        tag: rawTag,
+        quality: Number.isFinite(quality) ? quality : 0,
+        index,
+      };
+    })
+    .filter(
+      (
+        entry,
+      ): entry is {
+        tag: string;
+        quality: number;
+        index: number;
+      } => entry !== null && entry.quality > 0,
+    )
+    .sort(
+      (left, right) => right.quality - left.quality || left.index - right.index,
+    )
+    .map((entry) => entry.tag);
+}
+
+export function getNavigatorLanguagePreferences(
+  navigatorLike: NavigatorLike | null | undefined,
+): string[] {
+  if (!navigatorLike) {
+    return [];
+  }
+
+  const orderedLanguages = [
+    ...(Array.isArray(navigatorLike.languages) ? navigatorLike.languages : []),
+  ];
+
+  if (
+    typeof navigatorLike.language === 'string' &&
+    navigatorLike.language &&
+    !orderedLanguages.includes(navigatorLike.language)
+  ) {
+    orderedLanguages.push(navigatorLike.language);
+  }
+
+  return orderedLanguages;
+}
+
+function resolveExplicitLanguageFromUrl(
+  url: string | null | undefined,
+): SupportedLang | null {
+  const normalizedUrl = String(url ?? '/');
+  const [pathAndQuery] = normalizedUrl.split('#', 1);
+  const [rawPath, rawQuery] = pathAndQuery.split('?', 2);
+  const firstSegment = rawPath.split('/').filter(Boolean)[0];
+  const pathLanguage = normalizeSupportedLanguage(firstSegment);
+  if (pathLanguage) {
+    return pathLanguage;
+  }
+
+  const queryLanguage = new URLSearchParams(rawQuery ?? '').get('lang');
+  return normalizeSupportedLanguage(queryLanguage);
+}
+
+function normalizeSupportedLanguage(
+  rawLanguage: string | null | undefined,
+): SupportedLang | null {
+  if (typeof rawLanguage !== 'string') {
+    return null;
+  }
+
+  const normalized = rawLanguage.trim().toLowerCase();
+  if (!normalized || normalized === '*') {
+    return null;
+  }
+
+  const [baseLanguage] = normalized.split('-', 1);
+  return SUPPORTED_LANGS.includes(baseLanguage as SupportedLang)
+    ? (baseLanguage as SupportedLang)
+    : null;
+}

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

@@ -1,22 +1,93 @@
-import { Injectable } from '@angular/core';
+import { isPlatformBrowser, isPlatformServer } from '@angular/common';
+import {
+  Injectable,
+  PLATFORM_ID,
+  TransferState,
+  inject,
+  makeStateKey,
+} from '@angular/core';
 import { TranslateLoader, TranslationObject } from '@ngx-translate/core';
-import { Observable, of } from 'rxjs';
-import de from '../../../assets/i18n/de.json';
-import en from '../../../assets/i18n/en.json';
-import fr from '../../../assets/i18n/fr.json';
-import it from '../../../assets/i18n/it.json';
+import { from, Observable } from 'rxjs';
 
-const TRANSLATIONS: Record<string, TranslationObject> = {
-  it: it as TranslationObject,
-  en: en as TranslationObject,
-  de: de as TranslationObject,
-  fr: fr as TranslationObject,
+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 = String(lang || 'it').toLowerCase();
-    return of(TRANSLATIONS[normalized] ?? TRANSLATIONS['it']);
+    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.spec.ts

@@ -0,0 +1,196 @@
+import { TestBed } from '@angular/core/testing';
+import { HttpClient } from '@angular/common/http';
+import {
+  HttpTestingController,
+  provideHttpClientTesting,
+} from '@angular/common/http/testing';
+import { REQUEST } from '@angular/core';
+import { provideHttpClient, withInterceptors } from '@angular/common/http';
+import { serverOriginInterceptor } from './server-origin.interceptor';
+
+type TestGlobal = typeof globalThis & {
+  __SSR_INTERNAL_API_ORIGIN__?: string;
+};
+
+describe('serverOriginInterceptor', () => {
+  let http: HttpClient;
+  let httpMock: HttpTestingController;
+  const testGlobal = globalThis as TestGlobal;
+  const originalInternalApiOrigin = testGlobal.__SSR_INTERNAL_API_ORIGIN__;
+
+  beforeEach(() => {
+    delete testGlobal.__SSR_INTERNAL_API_ORIGIN__;
+
+    TestBed.configureTestingModule({
+      providers: [
+        provideHttpClient(withInterceptors([serverOriginInterceptor])),
+        provideHttpClientTesting(),
+        {
+          provide: REQUEST,
+          useValue: {
+            protocol: 'https',
+            url: '/de/shop/p/91823f84-bike-wall-hanger',
+            headers: {
+              host: 'dev.3d-fab.ch',
+              authorization: 'Basic dGVzdDp0ZXN0',
+              cookie: 'session=abc123',
+              'accept-language': 'de-CH,de;q=0.9,en;q=0.8',
+            },
+          },
+        },
+      ],
+    });
+
+    http = TestBed.inject(HttpClient);
+    httpMock = TestBed.inject(HttpTestingController);
+  });
+
+  afterEach(() => {
+    httpMock.verify();
+    if (originalInternalApiOrigin) {
+      testGlobal.__SSR_INTERNAL_API_ORIGIN__ = originalInternalApiOrigin;
+      return;
+    }
+    delete testGlobal.__SSR_INTERNAL_API_ORIGIN__;
+  });
+
+  it('rewrites relative SSR URLs to the incoming origin and forwards auth headers', () => {
+    http.get('/api/shop/products/by-path/example?lang=de').subscribe();
+
+    const request = httpMock.expectOne(
+      'https://dev.3d-fab.ch/api/shop/products/by-path/example?lang=de',
+    );
+    expect(request.request.headers.get('authorization')).toBe(
+      'Basic dGVzdDp0ZXN0',
+    );
+    expect(request.request.headers.get('cookie')).toBe('session=abc123');
+    expect(request.request.headers.get('accept-language')).toBe(
+      'de-CH,de;q=0.9,en;q=0.8',
+    );
+    request.flush({});
+  });
+
+  it('does not overwrite explicit request headers', () => {
+    http
+      .get('/api/shop/products', {
+        headers: {
+          authorization: 'Bearer explicit-token',
+        },
+      })
+      .subscribe();
+
+    const request = httpMock.expectOne(
+      'https://dev.3d-fab.ch/api/shop/products',
+    );
+    expect(request.request.headers.get('authorization')).toBe(
+      'Bearer explicit-token',
+    );
+    expect(request.request.headers.get('cookie')).toBe('session=abc123');
+    request.flush({});
+  });
+
+  it('uses the internal SSR API origin for public shop discovery calls', () => {
+    testGlobal.__SSR_INTERNAL_API_ORIGIN__ = 'http://backend:8000/';
+
+    http.get('/api/shop/products/by-id-prefix/91823f84?lang=de').subscribe();
+
+    const request = httpMock.expectOne(
+      'http://backend:8000/api/shop/products/by-id-prefix/91823f84?lang=de',
+    );
+    expect(request.request.headers.get('authorization')).toBe(
+      'Basic dGVzdDp0ZXN0',
+    );
+    expect(request.request.headers.get('cookie')).toBe('session=abc123');
+    expect(request.request.headers.get('accept-language')).toBe(
+      'de-CH,de;q=0.9,en;q=0.8',
+    );
+    request.flush({});
+  });
+
+  it('bypasses the public origin even when the proxy strips authorization on shop SSR requests', () => {
+    testGlobal.__SSR_INTERNAL_API_ORIGIN__ = 'http://backend:8000/';
+
+    TestBed.resetTestingModule();
+    TestBed.configureTestingModule({
+      providers: [
+        provideHttpClient(withInterceptors([serverOriginInterceptor])),
+        provideHttpClientTesting(),
+        {
+          provide: REQUEST,
+          useValue: {
+            protocol: 'https',
+            url: '/de/shop/p/91823f84-bike-wall-hanger',
+            headers: {
+              host: 'dev.3d-fab.ch',
+              cookie: 'session=abc123',
+              'accept-language': 'de-CH,de;q=0.9,en;q=0.8',
+            },
+          },
+        },
+      ],
+    });
+
+    http = TestBed.inject(HttpClient);
+    httpMock = TestBed.inject(HttpTestingController);
+
+    http.get('/api/shop/products/by-id-prefix/91823f84?lang=de').subscribe();
+
+    const request = httpMock.expectOne(
+      'http://backend:8000/api/shop/products/by-id-prefix/91823f84?lang=de',
+    );
+    expect(request.request.headers.get('authorization')).toBeNull();
+    expect(request.request.headers.get('cookie')).toBe('session=abc123');
+    expect(request.request.headers.get('accept-language')).toBe(
+      'de-CH,de;q=0.9,en;q=0.8',
+    );
+    request.flush({});
+  });
+
+  it('keeps transactional shop API calls on the public origin', () => {
+    testGlobal.__SSR_INTERNAL_API_ORIGIN__ = 'http://backend:8000/';
+
+    http.get('/api/shop/cart').subscribe();
+
+    const request = httpMock.expectOne('https://dev.3d-fab.ch/api/shop/cart');
+    expect(request.request.headers.get('authorization')).toBe(
+      'Basic dGVzdDp0ZXN0',
+    );
+    request.flush({});
+  });
+
+  it('keeps non-shop pages on the public origin even for public shop APIs', () => {
+    testGlobal.__SSR_INTERNAL_API_ORIGIN__ = 'http://backend:8000/';
+
+    TestBed.resetTestingModule();
+    TestBed.configureTestingModule({
+      providers: [
+        provideHttpClient(withInterceptors([serverOriginInterceptor])),
+        provideHttpClientTesting(),
+        {
+          provide: REQUEST,
+          useValue: {
+            protocol: 'https',
+            url: '/de/checkout?session=abc',
+            headers: {
+              host: 'dev.3d-fab.ch',
+              cookie: 'session=abc123',
+              'accept-language': 'de-CH,de;q=0.9,en;q=0.8',
+            },
+          },
+        },
+      ],
+    });
+
+    http = TestBed.inject(HttpClient);
+    httpMock = TestBed.inject(HttpTestingController);
+
+    http.get('/api/shop/products/by-id-prefix/91823f84?lang=de').subscribe();
+
+    const request = httpMock.expectOne(
+      'https://dev.3d-fab.ch/api/shop/products/by-id-prefix/91823f84?lang=de',
+    );
+    expect(request.request.headers.get('authorization')).toBeNull();
+    expect(request.request.headers.get('cookie')).toBe('session=abc123');
+    request.flush({});
+  });
+});

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

@@ -1,63 +1,169 @@
 import { HttpInterceptorFn } from '@angular/common/http';
 import { inject, REQUEST } from '@angular/core';
+import {
+  RequestLike,
+  resolveRequestOrigin,
+} from '../../../core/request-origin';
 
-type RequestLike = {
-  protocol?: string;
-  get?: (name: string) => string | undefined;
-  headers?: Record<string, string | string[] | undefined>;
+type ServerRequestLike = RequestLike & {
+  originalUrl?: string;
+  url?: string;
 };
 
+const FORWARDED_REQUEST_HEADERS = [
+  'authorization',
+  'cookie',
+  'accept-language',
+] as const;
+
+const SHOP_DISCOVERY_API_PATTERNS = [
+  /^\/api\/shop\/categories(?:\/[^/?#]+)?$/i,
+  /^\/api\/shop\/products$/i,
+  /^\/api\/shop\/products\/by-id-prefix\/[^/?#]+$/i,
+  /^\/api\/shop\/products\/by-path\/[^/?#]+$/i,
+  /^\/api\/shop\/products\/[^/?#]+$/i,
+] as const;
+
+const SHOP_PAGE_PATH_PATTERN = /^\/(?:it|en|de|fr)\/shop(?:\/.*)?$/i;
+
 function isAbsoluteUrl(url: string): boolean {
   return /^[a-z][a-z\d+\-.]*:/i.test(url) || url.startsWith('//');
 }
 
-function firstHeaderValue(value: string | string[] | undefined): string | null {
-  if (Array.isArray(value)) {
-    return value[0] ?? null;
-  }
-  return typeof value === 'string' ? value : null;
-}
-
-function resolveOrigin(request: RequestLike | null): string | null {
-  if (!request) {
-    return null;
-  }
-
-  const host =
-    request.get?.('host') ??
-    firstHeaderValue(request.headers?.['host']) ??
-    firstHeaderValue(request.headers?.['x-forwarded-host']);
-  if (!host) {
-    return null;
-  }
-
-  const forwardedProtoRaw = firstHeaderValue(
-    request.headers?.['x-forwarded-proto'],
-  );
-  const forwardedProto = forwardedProtoRaw
-    ?.split(',')
-    .map((part) => part.trim().toLowerCase())
-    .find(Boolean);
-  const protocol = forwardedProto || request.protocol || 'http';
-  return `${protocol}://${host}`;
-}
-
 function normalizeRelativePath(url: string): string {
   const withoutDot = url.replace(/^\.\//, '');
   return withoutDot.startsWith('/') ? withoutDot : `/${withoutDot}`;
 }
 
+function stripQueryAndHash(url: string): string {
+  return String(url ?? '').split(/[?#]/, 1)[0] || '/';
+}
+
+function normalizeOrigin(origin: string): string {
+  return origin.replace(/\/+$/, '');
+}
+
+function readRequestHeader(
+  request: RequestLike | null,
+  name: (typeof FORWARDED_REQUEST_HEADERS)[number],
+): string | null {
+  const normalizedName = name.toLowerCase();
+  const headerValue =
+    request?.headers?.[normalizedName] ?? request?.get?.(normalizedName);
+  if (Array.isArray(headerValue)) {
+    return headerValue[0] ?? null;
+  }
+
+  return typeof headerValue === 'string' ? headerValue : null;
+}
+
+function readRequestPath(request: ServerRequestLike | null): string | null {
+  const rawPath =
+    (typeof request?.originalUrl === 'string' && request.originalUrl) ||
+    (typeof request?.url === 'string' && request.url) ||
+    null;
+  if (!rawPath) {
+    return null;
+  }
+
+  if (isAbsoluteUrl(rawPath)) {
+    try {
+      return stripQueryAndHash(new URL(rawPath).pathname || '/');
+    } catch {
+      return null;
+    }
+  }
+
+  return stripQueryAndHash(rawPath.startsWith('/') ? rawPath : `/${rawPath}`);
+}
+
+function isPublicShopPageRequest(request: ServerRequestLike | null): boolean {
+  const requestPath = readRequestPath(request);
+  return !!requestPath && SHOP_PAGE_PATH_PATTERN.test(requestPath);
+}
+
+function isPublicShopDiscoveryApi(url: string): boolean {
+  const normalizedPath = stripQueryAndHash(normalizeRelativePath(url));
+  return SHOP_DISCOVERY_API_PATTERNS.some((pattern) =>
+    pattern.test(normalizedPath),
+  );
+}
+
+function readInternalApiOrigin(): string | null {
+  const globalObject = globalThis as {
+    __SSR_INTERNAL_API_ORIGIN__?: string;
+    process?: {
+      env?: Record<string, string | undefined>;
+    };
+  };
+  const explicitOverride =
+    typeof globalObject.__SSR_INTERNAL_API_ORIGIN__ === 'string'
+      ? globalObject.__SSR_INTERNAL_API_ORIGIN__
+      : null;
+  const env = (
+    globalObject as {
+      process?: {
+        env?: Record<string, string | undefined>;
+      };
+    }
+  ).process?.env;
+  const rawValue = explicitOverride ?? env?.['SSR_INTERNAL_API_ORIGIN'];
+  if (typeof rawValue !== 'string') {
+    return null;
+  }
+
+  const normalized = rawValue.trim();
+  return normalized ? normalizeOrigin(normalized) : null;
+}
+
+function resolveApiOrigin(
+  request: ServerRequestLike | null,
+  relativeUrl: string,
+): string | null {
+  const internalOrigin = readInternalApiOrigin();
+  if (
+    internalOrigin &&
+    isPublicShopPageRequest(request) &&
+    isPublicShopDiscoveryApi(relativeUrl)
+  ) {
+    return internalOrigin;
+  }
+
+  return resolveRequestOrigin(request);
+}
+
 export const serverOriginInterceptor: HttpInterceptorFn = (req, next) => {
   if (isAbsoluteUrl(req.url)) {
     return next(req);
   }
 
-  const request = inject(REQUEST, { optional: true }) as RequestLike | null;
-  const origin = resolveOrigin(request);
+  const request = inject(REQUEST, {
+    optional: true,
+  }) as ServerRequestLike | null;
+  const origin = resolveApiOrigin(request, req.url);
   if (!origin) {
     return next(req);
   }
 
-  const absoluteUrl = `${origin}${normalizeRelativePath(req.url)}`;
-  return next(req.clone({ url: absoluteUrl }));
+  const absoluteUrl = `${normalizeOrigin(origin)}${normalizeRelativePath(req.url)}`;
+  const forwardedHeaders = FORWARDED_REQUEST_HEADERS.reduce<
+    Record<string, string>
+  >((headers, name) => {
+    if (req.headers.has(name)) {
+      return headers;
+    }
+
+    const value = readRequestHeader(request, name);
+    if (value) {
+      headers[name] = value;
+    }
+    return headers;
+  }, {});
+
+  return next(
+    req.clone({
+      url: absoluteUrl,
+      setHeaders: forwardedHeaders,
+    }),
+  );
 };

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

@@ -1,21 +1,51 @@
 <footer class="footer">
   <div class="container footer-inner">
     <div class="col">
-      <span class="brand">3D fab</span>
+      <img
+        class="brand"
+        src="/assets/images/brand-logo-white.svg"
+        alt="3D Fab"
+      />
       <p class="copyright">&copy; 2026 3D fab.</p>
     </div>
 
     <div class="col links">
-      <a routerLink="/privacy">{{ "FOOTER.PRIVACY" | translate }}</a>
-      <a routerLink="/terms">{{ "FOOTER.TERMS" | translate }}</a>
-      <a routerLink="/contact">{{ "FOOTER.CONTACT" | translate }}</a>
+      <a [routerLink]="languageService.localizedPath('/privacy')">{{
+        "FOOTER.PRIVACY" | translate
+      }}</a>
+      <a [routerLink]="languageService.localizedPath('/terms')">{{
+        "FOOTER.TERMS" | translate
+      }}</a>
+      <a [routerLink]="languageService.localizedPath('/contact')">{{
+        "FOOTER.CONTACT" | translate
+      }}</a>
     </div>
 
     <div class="col social">
-      <!-- Social Placeholders -->
-      <div class="social-icon"></div>
-      <div class="social-icon"></div>
-      <div class="social-icon"></div>
+      <div class="social-link-row">
+        <span class="social-name">Joe Küng:</span>
+        <a
+          class="social-icon-link"
+          href="https://www.linkedin.com/in/joe-k%C3%BCng-31831828b/"
+          target="_blank"
+          rel="noopener noreferrer"
+          aria-label="Joe Küng LinkedIn"
+        >
+          <span class="social-icon-linkedin" aria-hidden="true"></span>
+        </a>
+      </div>
+      <div class="social-link-row">
+        <span class="social-name">Matteo Caletti:</span>
+        <a
+          class="social-icon-link"
+          href="https://www.linkedin.com/in/matteo-caletti-94291a3b6/"
+          target="_blank"
+          rel="noopener noreferrer"
+          aria-label="Matteo Caletti LinkedIn"
+        >
+          <span class="social-icon-linkedin" aria-hidden="true"></span>
+        </a>
+      </div>
     </div>
   </div>
 </footer>

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

@@ -38,9 +38,10 @@
 }
 
 .brand {
-  font-weight: 700;
-  color: white;
   display: block;
+  width: auto;
+  height: 1.85rem;
+  max-width: min(9.25rem, 46vw);
   margin-bottom: var(--space-2);
 }
 .copyright {
@@ -65,11 +66,69 @@
 
 .social {
   display: flex;
+  flex-direction: column;
+  align-items: flex-start;
   gap: var(--space-3);
 }
-.social-icon {
-  width: 24px;
-  height: 24px;
-  background-color: var(--color-neutral-800);
-  border-radius: 50%;
+
+.social-link-row {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+}
+
+.social-name {
+  color: var(--color-neutral-200);
+  font-size: 0.875rem;
+}
+
+.social-icon-link {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  border-radius: 50%;
+  background-color: var(--color-neutral-50);
+  color: #0a66c2;
+  transition:
+    transform 0.2s ease,
+    background-color 0.2s ease,
+    color 0.2s ease;
+
+  &:hover {
+    background-color: #0a66c2;
+    color: var(--color-neutral-50);
+    transform: translateY(-1px);
+  }
+
+  &:focus-visible {
+    outline: 2px solid var(--color-secondary-500);
+    outline-offset: 2px;
+  }
+}
+
+.social-icon-linkedin {
+  display: block;
+  width: 1rem;
+  height: 1rem;
+  background-color: currentColor;
+  mask-image: url("/assets/images/SVG/linkedin-svgrepo-com.svg");
+  mask-repeat: no-repeat;
+  mask-position: center;
+  mask-size: contain;
+  -webkit-mask-image: url("/assets/images/SVG/linkedin-svgrepo-com.svg");
+  -webkit-mask-repeat: no-repeat;
+  -webkit-mask-position: center;
+  -webkit-mask-size: contain;
+}
+
+@media (max-width: 768px) {
+  .social {
+    align-items: center;
+  }
+
+  .social-link-row {
+    justify-content: center;
+  }
 }

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,15 @@
 <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">
+      <img
+        class="brand-logo"
+        ngSrc="/assets/images/Asset%202.svg"
+        alt="3D Fab"
+        width="380"
+        height="86"
+        priority
+      />
+    </a>
 
     <div
       class="mobile-toggle"
@@ -14,27 +23,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 +97,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 +148,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 +158,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.scss

@@ -14,13 +14,16 @@
   justify-content: space-between;
 }
 .brand {
-  font-size: 1.25rem;
-  font-weight: 700;
-  color: var(--color-text);
+  display: inline-flex;
+  align-items: center;
   text-decoration: none;
 }
-.highlight {
-  color: var(--color-brand);
+
+.brand-logo {
+  display: block;
+  width: auto;
+  height: 2.1rem;
+  max-width: min(11rem, 40vw);
 }
 
 .nav-links {

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 { CommonModule, NgOptimizedImage } from '@angular/common';
+import {
+  afterNextRender,
+  Component,
+  DestroyRef,
+  computed,
+  inject,
+  signal,
+} from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import {
   NavigationStart,
@@ -15,11 +22,21 @@ import {
   ShopService,
 } from '../../features/shop/services/shop.service';
 import { finalize } from 'rxjs';
+import {
+  findColorHex,
+  resolveLocalizedColorLabel,
+} from '../constants/colors.const';
 
 @Component({
   selector: 'app-navbar',
   standalone: true,
-  imports: [CommonModule, RouterLink, RouterLinkActive, TranslateModule],
+  imports: [
+    CommonModule,
+    RouterLink,
+    RouterLinkActive,
+    TranslateModule,
+    NgOptimizedImage,
+  ],
   templateUrl: './navbar.component.html',
   styleUrls: ['./navbar.component.scss'],
 })
@@ -54,16 +71,9 @@ export class NavbarComponent {
   ];
 
   constructor(public langService: LanguageService) {
-    if (!this.shopService.cartLoaded()) {
-      this.shopService
-        .loadCart()
-        .pipe(takeUntilDestroyed(this.destroyRef))
-        .subscribe({
-          error: () => {
-            this.shopService.cart.set(null);
-          },
+    afterNextRender(() => {
+      this.scheduleCartWarmup();
     });
-    }
 
     this.router.events
       .pipe(takeUntilDestroyed(this.destroyRef))
@@ -92,6 +102,9 @@ export class NavbarComponent {
   toggleCart(): void {
     this.closeMenu();
     this.isCartOpen.update((open) => !open);
+    if (this.isCartOpen()) {
+      this.loadCartIfNeeded();
+    }
   }
 
   closeCart(): void {
@@ -129,7 +142,7 @@ export class NavbarComponent {
     }
 
     this.closeCart();
-    this.router.navigate(['/checkout'], {
+    this.router.navigate(['/', this.langService.selectedLang(), 'checkout'], {
       queryParams: {
         session: sessionId,
       },
@@ -143,15 +156,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 +201,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

@@ -1,7 +1,13 @@
 import { Subject } from 'rxjs';
-import { DefaultUrlSerializer, Router, UrlTree } from '@angular/router';
+import {
+  DefaultUrlSerializer,
+  NavigationEnd,
+  Router,
+  UrlTree,
+} from '@angular/router';
 import { TranslateService } from '@ngx-translate/core';
 import { LanguageService } from './language.service';
+import { RequestLike } from '../../../core/request-origin';
 
 describe('LanguageService', () => {
   function createTranslateMock() {
@@ -9,7 +15,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 });
@@ -60,7 +66,14 @@ describe('LanguageService', () => {
       parseUrl: (url: string) => serializer.parse(url),
       createUrlTree,
       serializeUrl: (tree: UrlTree) => serializer.serialize(tree),
-      navigateByUrl: jasmine.createSpy('navigateByUrl'),
+      navigateByUrl: jasmine
+        .createSpy('navigateByUrl')
+        .and.callFake((tree: UrlTree) => {
+          const nextUrl = serializer.serialize(tree);
+          router.url = nextUrl;
+          events$.next(new NavigationEnd(1, nextUrl, nextUrl));
+          return Promise.resolve(true);
+        }),
     };
 
     return router as unknown as Router;
@@ -70,11 +83,17 @@ describe('LanguageService', () => {
     const translate = createTranslateMock();
     const router = createRouterMock('/calculator?session=abc');
     const navigateSpy = router.navigateByUrl as unknown as jasmine.Spy;
+    const request: RequestLike = {
+      headers: {
+        'accept-language': 'it-CH,it;q=0.9,en;q=0.8',
+      },
+    };
 
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const service = new LanguageService(translate, router);
+    const service = new LanguageService(translate, router, request);
 
     expect(translate.use).toHaveBeenCalledWith('it');
+    expect((translate as any).setFallbackLang).toHaveBeenCalledWith('it');
     expect(navigateSpy).toHaveBeenCalledTimes(1);
 
     const firstCall = navigateSpy.calls.mostRecent();
@@ -84,6 +103,48 @@ describe('LanguageService', () => {
     expect(navOptions.replaceUrl).toBeTrue();
   });
 
+  it('uses the preferred browser language on the root URL', () => {
+    const translate = createTranslateMock();
+    const router = createRouterMock('/');
+    const navigateSpy = router.navigateByUrl as unknown as jasmine.Spy;
+    const request: RequestLike = {
+      headers: {
+        'accept-language': 'de-CH,de;q=0.9,en;q=0.8,it;q=0.7',
+      },
+    };
+
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const service = new LanguageService(translate, router, request);
+
+    expect(translate.use).toHaveBeenCalledWith('de');
+    expect(navigateSpy).toHaveBeenCalledTimes(1);
+
+    const firstCall = navigateSpy.calls.mostRecent();
+    const tree = firstCall.args[0] as UrlTree;
+    expect(router.serializeUrl(tree)).toBe('/de');
+  });
+
+  it('uses the default language for non-root URLs without a language prefix', () => {
+    const translate = createTranslateMock();
+    const router = createRouterMock('/calculator?session=abc');
+    const navigateSpy = router.navigateByUrl as unknown as jasmine.Spy;
+    const request: RequestLike = {
+      headers: {
+        'accept-language': 'de-CH,de;q=0.9,en;q=0.8,it;q=0.7',
+      },
+    };
+
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const service = new LanguageService(translate, router, request);
+
+    expect(translate.use).toHaveBeenCalledWith('de');
+    expect(navigateSpy).toHaveBeenCalledTimes(1);
+
+    const firstCall = navigateSpy.calls.mostRecent();
+    const tree = firstCall.args[0] as UrlTree;
+    expect(router.serializeUrl(tree)).toBe('/it/calculator?session=abc');
+  });
+
   it('switches language while preserving path and query params', () => {
     const translate = createTranslateMock();
     const router = createRouterMock('/it/calculator?session=abc&mode=advanced');
@@ -103,4 +164,34 @@ 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',
+    );
+  });
+
+  it('switches product pages using the resolved localized route overrides', () => {
+    const translate = createTranslateMock();
+    const router = createRouterMock('/it/shop/p/12345678-supporto-cavo');
+    const navigateSpy = router.navigateByUrl as unknown as jasmine.Spy;
+    const service = new LanguageService(translate, router);
+
+    service.setLocalizedRouteOverrides({
+      it: '/it/shop/p/12345678-supporto-cavo',
+      de: '/de/shop/p/12345678-kabelhalter',
+    });
+    navigateSpy.calls.reset();
+
+    service.switchLang('de');
+
+    const call = navigateSpy.calls.mostRecent();
+    const tree = call.args[0] as UrlTree;
+    expect(router.serializeUrl(tree)).toBe('/de/shop/p/12345678-kabelhalter');
+  });
 });

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

@@ -1,4 +1,4 @@
-import { Injectable, signal } from '@angular/core';
+import { Inject, Injectable, Optional, REQUEST, signal } from '@angular/core';
 import { TranslateService } from '@ngx-translate/core';
 import {
   NavigationEnd,
@@ -6,25 +6,32 @@ import {
   Router,
   UrlTree,
 } from '@angular/router';
+import {
+  getNavigatorLanguagePreferences,
+  parseAcceptLanguage,
+  resolveInitialLanguage,
+} from '../i18n/language-resolution';
+import { RequestLike } from '../../../core/request-origin';
+
+type SupportedLang = 'it' | 'en' | 'de' | 'fr';
+type LocalizedRouteOverrides = Partial<Record<SupportedLang, string>>;
 
 @Injectable({
   providedIn: 'root',
 })
 export class LanguageService {
-  currentLang = signal<'it' | 'en' | 'de' | 'fr'>('it');
-  private readonly supportedLangs: Array<'it' | 'en' | 'de' | 'fr'> = [
-    'it',
-    'en',
-    'de',
-    'fr',
-  ];
+  currentLang = signal<SupportedLang>('it');
+  private readonly defaultLang: SupportedLang = 'it';
+  private readonly supportedLangs: SupportedLang[] = ['it', 'en', 'de', 'fr'];
+  private localizedRouteOverrides: LocalizedRouteOverrides | null = null;
 
   constructor(
     private translate: TranslateService,
     private router: Router,
+    @Optional() @Inject(REQUEST) private request: RequestLike | null = null,
   ) {
     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;
@@ -34,13 +41,14 @@ export class LanguageService {
     });
 
     const initialTree = this.router.parseUrl(this.router.url);
-    const initialSegments = this.getPrimarySegments(initialTree);
-    const queryLang = this.getQueryLang(initialTree);
-    const initialLang = this.isSupportedLang(initialSegments[0])
-      ? initialSegments[0]
-      : this.isSupportedLang(queryLang)
-        ? queryLang
-        : 'it';
+    const initialLang = resolveInitialLanguage({
+      url: this.router.url,
+      preferredLanguages: this.request
+        ? parseAcceptLanguage(this.readRequestHeader('accept-language'))
+        : getNavigatorLanguagePreferences(
+            typeof navigator === 'undefined' ? null : navigator,
+          ),
+    });
     this.applyLanguage(initialLang);
     this.ensureLanguageInPath(initialTree);
 
@@ -53,13 +61,21 @@ export class LanguageService {
     });
   }
 
-  switchLang(lang: 'it' | 'en' | 'de' | 'fr') {
+  switchLang(lang: SupportedLang) {
     if (!this.isSupportedLang(lang)) {
       return;
     }
-    this.applyLanguage(lang);
 
     const currentTree = this.router.parseUrl(this.router.url);
+    const localizedRoute = this.resolveLocalizedRouteOverride(
+      currentTree,
+      lang,
+    );
+    if (localizedRoute) {
+      this.navigateToLocalizedRoute(currentTree, localizedRoute);
+      return;
+    }
+
     const segments = this.getPrimarySegments(currentTree);
 
     let targetSegments: string[];
@@ -77,7 +93,7 @@ export class LanguageService {
     this.navigateIfChanged(currentTree, targetSegments);
   }
 
-  selectedLang(): 'it' | 'en' | 'de' | 'fr' {
+  selectedLang(): SupportedLang {
     const activeLang =
       typeof this.translate.currentLang === 'string'
         ? this.translate.currentLang.toLowerCase()
@@ -85,6 +101,41 @@ 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}`;
+  }
+
+  setLocalizedRouteOverrides(
+    paths: LocalizedRouteOverrides | null | undefined,
+  ): void {
+    this.localizedRouteOverrides = this.normalizeLocalizedRouteOverrides(paths);
+  }
+
+  clearLocalizedRouteOverrides(): void {
+    this.localizedRouteOverrides = null;
+  }
+
   private ensureLanguageInPath(urlTree: UrlTree): void {
     const segments = this.getPrimarySegments(urlTree);
 
@@ -93,23 +144,26 @@ export class LanguageService {
       return;
     }
 
+    if (segments.length === 0) {
       const queryLang = this.getQueryLang(urlTree);
-    const activeLang = this.isSupportedLang(queryLang)
+      const rootLang = this.isSupportedLang(queryLang)
         ? queryLang
         : this.currentLang();
-    if (activeLang !== this.currentLang()) {
-      this.applyLanguage(activeLang);
+      if (rootLang !== this.currentLang()) {
+        this.applyLanguage(rootLang);
+      }
+      this.navigateIfChanged(urlTree, [rootLang]);
+      return;
     }
-    let targetSegments: string[];
 
-    if (segments.length === 0) {
-      targetSegments = [activeLang];
-    } else if (this.looksLikeLangToken(segments[0])) {
-      targetSegments = [activeLang, ...segments.slice(1)];
-    } else {
-      targetSegments = [activeLang, ...segments];
+    if (this.currentLang() !== this.defaultLang) {
+      this.applyLanguage(this.defaultLang);
     }
 
+    const targetSegments = this.looksLikeLangToken(segments[0])
+      ? [this.defaultLang, ...segments.slice(1)]
+      : [this.defaultLang, ...segments];
+
     this.navigateIfChanged(urlTree, targetSegments);
   }
 
@@ -126,12 +180,23 @@ export class LanguageService {
     return typeof lang === 'string' ? lang.toLowerCase() : null;
   }
 
+  private readRequestHeader(headerName: string): string | null {
+    const headerValue =
+      this.request?.headers?.[headerName.toLowerCase()] ??
+      this.request?.get?.(headerName.toLowerCase());
+    if (Array.isArray(headerValue)) {
+      return headerValue[0] ?? null;
+    }
+
+    return typeof headerValue === 'string' ? headerValue : null;
+  }
+
   private isSupportedLang(
     lang: string | null | undefined,
-  ): lang is 'it' | 'en' | 'de' | 'fr' {
+  ): lang is SupportedLang {
     return (
       typeof lang === 'string' &&
-      this.supportedLangs.includes(lang as 'it' | 'en' | 'de' | 'fr')
+      this.supportedLangs.includes(lang as SupportedLang)
     );
   }
 
@@ -141,7 +206,7 @@ export class LanguageService {
     );
   }
 
-  private applyLanguage(lang: 'it' | 'en' | 'de' | 'fr'): void {
+  private applyLanguage(lang: SupportedLang): void {
     if (this.currentLang() === lang && this.translate.currentLang === lang) {
       return;
     }
@@ -149,6 +214,88 @@ export class LanguageService {
     this.currentLang.set(lang);
   }
 
+  private resolveLocalizedRouteOverride(
+    currentTree: UrlTree,
+    lang: SupportedLang,
+  ): string | null {
+    const overrides = this.localizedRouteOverrides;
+    if (!overrides) {
+      return null;
+    }
+
+    const currentPath = this.getCleanPath(
+      this.router.serializeUrl(currentTree),
+    );
+    const paths = Object.values(overrides)
+      .map((path) => this.normalizeLocalizedRoutePath(path))
+      .filter((path): path is string => !!path);
+    if (!paths.includes(currentPath)) {
+      return null;
+    }
+
+    return this.normalizeLocalizedRoutePath(overrides[lang]);
+  }
+
+  private normalizeLocalizedRouteOverrides(
+    paths: LocalizedRouteOverrides | null | undefined,
+  ): LocalizedRouteOverrides | null {
+    if (!paths) {
+      return null;
+    }
+
+    const normalized = this.supportedLangs.reduce<LocalizedRouteOverrides>(
+      (accumulator, lang) => {
+        const path = this.normalizeLocalizedRoutePath(paths[lang]);
+        if (path) {
+          accumulator[lang] = path;
+        }
+        return accumulator;
+      },
+      {},
+    );
+
+    return Object.keys(normalized).length > 0 ? normalized : null;
+  }
+
+  private normalizeLocalizedRoutePath(
+    path: string | null | undefined,
+  ): string | null {
+    const rawPath = String(path ?? '').trim();
+    if (!rawPath) {
+      return null;
+    }
+    const cleanPath = this.getCleanPath(rawPath);
+    return cleanPath.startsWith('/') ? cleanPath : null;
+  }
+
+  private navigateToLocalizedRoute(
+    currentTree: UrlTree,
+    localizedPath: string,
+  ): void {
+    const { lang: _unusedLang, ...queryParams } = currentTree.queryParams;
+    const targetTree = this.router.createUrlTree(
+      ['/', ...localizedPath.split('/').filter(Boolean)],
+      {
+        queryParams,
+        fragment: currentTree.fragment ?? undefined,
+      },
+    );
+
+    if (
+      this.router.serializeUrl(targetTree) ===
+      this.router.serializeUrl(currentTree)
+    ) {
+      return;
+    }
+
+    this.router.navigateByUrl(targetTree, { replaceUrl: true });
+  }
+
+  private getCleanPath(url: string): string {
+    const path = (url || '/').split('?')[0].split('#')[0];
+    return path || '/';
+  }
+
   private navigateIfChanged(
     currentTree: UrlTree,
     targetSegments: string[],

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

@@ -0,0 +1,217 @@
+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>;
+  }): {
+    service: SeoService;
+    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 { service, 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-CH',
+      href: `${document.location.origin}/en/privacy`,
+    });
+    expect(alternates).toContain({
+      hreflang: 'x-default',
+      href: `${document.location.origin}/it/privacy`,
+    });
+    expect(document.documentElement.lang).toBe('it-CH');
+
+    const ogUrlCall = meta.updateTag.calls
+      .allArgs()
+      .find(([tag]) => tag.property === 'og:url');
+    expect(ogUrlCall?.[0].content).toBe(
+      `${document.location.origin}/it/privacy`,
+    );
+
+    const ogLocaleCall = meta.updateTag.calls
+      .allArgs()
+      .find(([tag]) => tag.property === 'og:locale');
+    expect(ogLocaleCall?.[0].content).toBe('it_CH');
+  });
+
+  it('uses the locale-adaptive root as x-default for home pages', () => {
+    createService({
+      url: '/de',
+      data: {
+        seoTitleKey: 'SEO.ROUTES.HOME.TITLE',
+        seoDescriptionKey: 'SEO.ROUTES.HOME.DESCRIPTION',
+      },
+      translations: {
+        'SEO.ROUTES.HOME.TITLE': '3D-Druck in Zürich | 3D fab',
+        'SEO.ROUTES.HOME.DESCRIPTION': '3D-Druckservice in Zürich',
+      },
+    });
+
+    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: 'x-default',
+      href: `${document.location.origin}/`,
+    });
+  });
+
+  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-CH');
+  });
+
+  it('applies canonical and hreflang values resolved from localized paths', () => {
+    const { service } = createService({
+      url: '/it/shop/p/12345678-supporto-cavo-scrivania',
+      data: {},
+      translations: {},
+    });
+
+    service.applyResolvedSeo({
+      title: 'Supporto cavo scrivania | 3D fab',
+      description: 'Accessorio tecnico',
+      robots: 'index, follow',
+      ogTitle: 'Supporto cavo scrivania | 3D fab',
+      ogDescription: 'Accessorio tecnico',
+      canonicalPath: '/it/shop/p/12345678-supporto-cavo-scrivania',
+      alternates: {
+        it: '/it/shop/p/12345678-supporto-cavo-scrivania',
+        en: '/en/shop/p/12345678-desk-cable-clip',
+        de: '/de/shop/p/12345678-schreibtisch-kabelhalter',
+      },
+      xDefault: '/it/shop/p/12345678-supporto-cavo-scrivania',
+    });
+
+    const canonical = document.head.querySelector(
+      'link[rel="canonical"]',
+    ) as HTMLLinkElement | null;
+    expect(canonical?.getAttribute('href')).toBe(
+      `${document.location.origin}/it/shop/p/12345678-supporto-cavo-scrivania`,
+    );
+
+    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: 'de-CH',
+      href: `${document.location.origin}/de/shop/p/12345678-schreibtisch-kabelhalter`,
+    });
+    expect(alternates).toContain({
+      hreflang: 'x-default',
+      href: `${document.location.origin}/it/shop/p/12345678-supporto-cavo-scrivania`,
+    });
+  });
+});

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

@@ -2,29 +2,78 @@ 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;
 }
 
+export interface ResolvedPageSeo extends PageSeoOverride {
+  canonicalPath: string | null;
+  alternates?: SeoMap | null;
+  xDefault?: string | null;
+}
+
+export 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 defaultDescription =
-    'Stampa 3D su misura con preventivo online immediato. Carica il file, scegli materiale e qualità, ricevi prezzo e tempi in pochi secondi.';
-  private readonly supportedLangs = new Set(['it', 'en', 'de', 'fr']);
+  private readonly defaultTitleByLang: Record<SupportedLang, string> = {
+    it: '3D fab | Stampa 3D su misura',
+    en: '3D fab | Custom 3D Printing',
+    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_CH',
+    en: 'en_CH',
+    de: 'de_CH',
+    fr: 'fr_CH',
+  };
+  private readonly seoLocaleByLang: Record<SupportedLang, string> = {
+    it: 'it-CH',
+    en: 'en-CH',
+    de: 'de-CH',
+    fr: 'fr-CH',
+  };
 
   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 +89,81 @@ export class SeoService {
   }
 
   applyPageSeo(override: PageSeoOverride): void {
-    const title = this.asString(override.title) ?? this.defaultTitle;
-    const description =
-      this.asString(override.description) ?? this.defaultDescription;
-    const robots = this.asString(override.robots) ?? 'index, follow';
-    const ogTitle = this.asString(override.ogTitle) ?? title;
-    const ogDescription = this.asString(override.ogDescription) ?? description;
+    const cleanPath = this.getCleanPath(this.router.url);
+    const lang = this.resolveLangFromPath(cleanPath);
+    const { title, description, robots, ogTitle, ogDescription } =
+      this.resolvePageSeoOverride(override, lang);
+    const canonicalPath = this.buildLocalizedPath(cleanPath, lang);
+    const alternates = this.buildAlternatePaths(canonicalPath);
 
-    this.applySeoValues(title, description, robots, ogTitle, ogDescription);
+    this.applySeoValues(
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+      cleanPath,
+      canonicalPath,
+      alternates,
+      this.buildXDefaultPath(canonicalPath, alternates),
+      lang,
+    );
+  }
+
+  applyResolvedSeo(override: ResolvedPageSeo): void {
+    const cleanPath = this.getCleanPath(this.router.url);
+    const lang = this.resolveLangFromPath(cleanPath);
+    const { title, description, robots, ogTitle, ogDescription } =
+      this.resolvePageSeoOverride(override, lang);
+    const canonicalPath = this.normalizeSeoPath(override.canonicalPath);
+    const alternates = this.normalizeAlternatePaths(override.alternates);
+    const xDefault =
+      this.normalizeSeoPath(override.xDefault) ??
+      this.buildXDefaultPath(canonicalPath, alternates);
+
+    this.applySeoValues(
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+      cleanPath,
+      canonicalPath,
+      alternates,
+      xDefault,
+      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;
+    const canonicalPath = this.buildLocalizedPath(cleanPath, lang);
+    const alternates = this.buildAlternatePaths(canonicalPath);
 
-    this.applySeoValues(title, description, robots, ogTitle, ogDescription);
+    this.applySeoValues(
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+      cleanPath,
+      canonicalPath,
+      alternates,
+      this.buildXDefaultPath(canonicalPath, alternates),
+      lang,
+    );
   }
 
   private applySeoValues(
@@ -69,6 +172,11 @@ export class SeoService {
     robots: string,
     ogTitle: string,
     ogDescription: string,
+    cleanPath: string,
+    canonicalPath: string | null,
+    alternates: SeoMap | null,
+    xDefaultPath: string | null,
+    lang: SupportedLang,
   ): void {
     this.titleService.setTitle(title);
     this.metaService.updateTag({ name: 'description', content: description });
@@ -79,13 +187,21 @@ 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 canonical = `${this.document.location.origin}${cleanPath}`;
-    this.metaService.updateTag({ property: 'og:url', content: canonical });
-    this.updateCanonicalTag(canonical);
-    this.updateLangAndAlternates(cleanPath);
+    const ogUrl = this.toAbsoluteUrl(canonicalPath ?? cleanPath);
+    this.metaService.updateTag({ property: 'og:url', content: ogUrl });
+    this.updateCanonicalTag(
+      canonicalPath ? this.toAbsoluteUrl(canonicalPath) : null,
+    );
+    this.updateOpenGraphLocales(lang);
+    this.updateLangAndAlternates(alternates, xDefaultPath, lang);
   }
 
   private getMergedRouteData(
@@ -104,15 +220,206 @@ 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 resolvePageSeoOverride(
+    override: PageSeoOverride,
+    lang: SupportedLang,
+  ): {
+    title: string;
+    description: string;
+    robots: string;
+    ogTitle: string;
+    ogDescription: string;
+  } {
+    const title =
+      this.resolveOverrideSeoText(override.title, override.titleKey) ??
+      this.defaultTitle(lang);
+    const description =
+      this.resolveOverrideSeoText(
+        override.description,
+        override.descriptionKey,
+      ) ?? this.defaultDescription(lang);
+    const robots = this.asString(override.robots) ?? 'index, follow';
+    const ogTitle =
+      this.resolveOverrideSeoText(override.ogTitle, override.ogTitleKey) ??
+      title;
+    const ogDescription =
+      this.resolveOverrideSeoText(
+        override.ogDescription,
+        override.ogDescriptionKey,
+      ) ?? description;
+
+    return {
+      title,
+      description,
+      robots,
+      ogTitle,
+      ogDescription,
+    };
+  }
+
+  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 updateCanonicalTag(url: string): void {
+  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 buildAlternatePaths(canonicalPath: string): SeoMap {
+    const suffixSegments = canonicalPath.split('/').filter(Boolean).slice(1);
+    const suffix =
+      suffixSegments.length > 0 ? `/${suffixSegments.join('/')}` : '';
+
+    return this.supportedLangs.reduce<SeoMap>((accumulator, alt) => {
+      accumulator[alt] = `/${alt}${suffix}`;
+      return accumulator;
+    }, {});
+  }
+
+  private buildXDefaultPath(
+    canonicalPath: string | null,
+    alternates: SeoMap | null,
+  ): string | null {
+    if (canonicalPath && this.isLocalizedHomePath(canonicalPath)) {
+      return '/';
+    }
+
+    return alternates?.it ?? canonicalPath;
+  }
+
+  private isLocalizedHomePath(path: string): boolean {
+    const segments = path.split('/').filter(Boolean);
+    return (
+      segments.length === 1 &&
+      this.supportedLangSet.has(segments[0] as SupportedLang)
+    );
+  }
+
+  private normalizeAlternatePaths(
+    paths: SeoMap | null | undefined,
+  ): SeoMap | null {
+    if (!paths) {
+      return null;
+    }
+
+    const normalized = this.supportedLangs.reduce<SeoMap>(
+      (accumulator, lang) => {
+        const path = this.normalizeSeoPath(paths[lang]);
+        if (path) {
+          accumulator[lang] = path;
+        }
+        return accumulator;
+      },
+      {},
+    );
+
+    return Object.keys(normalized).length > 0 ? normalized : null;
+  }
+
+  private normalizeSeoPath(path: string | null | undefined): string | null {
+    const rawPath = String(path ?? '').trim();
+    if (!rawPath) {
+      return null;
+    }
+    const normalized = this.getCleanPath(rawPath);
+    return normalized.startsWith('/') ? normalized : null;
+  }
+
+  private toAbsoluteUrl(path: string): string {
+    return `${this.document.location.origin}${path}`;
+  }
+
+  private updateCanonicalTag(url: string | null): void {
     let link = this.document.head.querySelector(
       'link[rel="canonical"]',
     ) as HTMLLinkElement | null;
+    if (!url) {
+      link?.remove();
+      return;
+    }
     if (!link) {
       link = this.document.createElement('link');
       link.setAttribute('rel', 'canonical');
@@ -121,34 +428,55 @@ export class SeoService {
     link.setAttribute('href', url);
   }
 
-  private updateLangAndAlternates(path: string): void {
-    const segments = path.split('/').filter(Boolean);
-    const firstSegment = segments[0]?.toLowerCase();
-    const hasLang = Boolean(
-      firstSegment && this.supportedLangs.has(firstSegment),
-    );
-    const lang = hasLang ? firstSegment : 'it';
-    const suffixSegments = hasLang ? segments.slice(1) : segments;
-    const suffix =
-      suffixSegments.length > 0 ? `/${suffixSegments.join('/')}` : '';
+  private updateOpenGraphLocales(lang: SupportedLang): void {
+    this.metaService.updateTag({
+      property: 'og:locale',
+      content: this.ogLocaleByLang[lang],
+    });
 
-    this.document.documentElement.lang = lang;
+    this.document.head
+      .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(
+    alternates: SeoMap | null,
+    xDefaultPath: string | null,
+    lang: SupportedLang,
+  ): void {
+    this.document.documentElement.lang = this.seoLocaleByLang[lang];
 
     this.document.head
       .querySelectorAll('link[rel="alternate"][data-seo-managed="true"]')
       .forEach((node) => node.remove());
 
-    for (const alt of ['it', 'en', 'de', 'fr']) {
-      this.appendAlternateLink(
-        alt,
-        `${this.document.location.origin}/${alt}${suffix}`,
-      );
+    if (!alternates) {
+      return;
+    }
+
+    for (const alt of this.supportedLangs) {
+      const path = alternates[alt];
+      if (!path) {
+        continue;
       }
       this.appendAlternateLink(
-      'x-default',
-      `${this.document.location.origin}/it${suffix}`,
+        this.seoLocaleByLang[alt],
+        this.toAbsoluteUrl(path),
       );
     }
+    if (xDefaultPath) {
+      this.appendAlternateLink('x-default', this.toAbsoluteUrl(xDefaultPath));
+    }
+  }
 
   private appendAlternateLink(hreflang: string, href: string): void {
     const link = this.document.createElement('link');
@@ -158,4 +486,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',
-      seoDescription:
-        'Siamo un laboratorio di stampa 3D orientato a prototipi, ricambi e produzioni su misura.',
+      seoTitleKey: 'SEO.ROUTES.ABOUT.TITLE',
+      seoDescriptionKey: 'SEO.ROUTES.ABOUT.DESCRIPTION',
     },
   },
 ];

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-shop.component.html

@@ -206,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">
@@ -237,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
@@ -288,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
@@ -574,9 +668,31 @@
             <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">

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

@@ -18,6 +18,8 @@ import {
   AdminShopProductModel,
   AdminShopProductVariant,
   AdminShopService,
+  AdminTranslateShopProductPayload,
+  AdminTranslateShopProductResponse,
   AdminUpsertShopCategoryPayload,
   AdminUpsertShopProductPayload,
   AdminUpsertShopProductVariantPayload,
@@ -41,10 +43,10 @@ interface CategoryFormState {
   id: string | null;
   parentCategoryId: string | null;
   slug: string;
-  name: string;
-  description: string;
-  seoTitle: string;
-  seoDescription: string;
+  names: Record<ShopLanguage, string>;
+  descriptions: Record<ShopLanguage, string>;
+  seoTitles: Record<ShopLanguage, string>;
+  seoDescriptions: Record<ShopLanguage, string>;
   ogTitle: string;
   ogDescription: string;
   indexable: boolean;
@@ -174,6 +176,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   loading = false;
   detailLoading = false;
   savingProduct = false;
+  translatingProduct = false;
   deletingProduct = false;
   savingCategory = false;
   deletingCategory = false;
@@ -188,6 +191,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   productStatusFilter: ProductStatusFilter = 'ALL';
   showCategoryManager = false;
   activeContentLanguage: ShopLanguage = 'it';
+  overwriteExistingTranslations = false;
 
   errorMessage: string | null = null;
   successMessage: string | null = null;
@@ -554,7 +558,56 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   }
 
   slugifyCategoryFromName(): void {
-    this.categoryForm.slug = this.slugify(this.categoryForm.name);
+    const source =
+      this.categoryForm.names[this.activeContentLanguage] ||
+      this.categoryForm.names['it'];
+    this.categoryForm.slug = this.slugify(source);
+  }
+
+  translateProductFromCurrentLanguage(): void {
+    if (this.translatingProduct) {
+      return;
+    }
+
+    this.syncDescriptionFromEditor(this.descriptionEditorElement, true);
+
+    const sourceLanguage = this.activeContentLanguage;
+    if (!this.productForm.names[sourceLanguage].trim()) {
+      this.errorMessage = `Il nome prodotto ${this.languageLabels[sourceLanguage]} e obbligatorio per avviare la traduzione.`;
+      this.successMessage = null;
+      return;
+    }
+
+    const payload = this.buildProductTranslationPayload(sourceLanguage);
+    this.translatingProduct = true;
+    this.errorMessage = null;
+    this.successMessage = null;
+
+    this.adminShopService.translateProduct(payload).subscribe({
+      next: (response) => {
+        this.translatingProduct = false;
+        this.applyProductTranslation(response, payload.overwriteExisting);
+        this.successMessage = response.targetLanguages.length
+          ? `Traduzioni ${response.targetLanguages
+              .map((language) => this.languageLabels[language])
+              .join(' / ')} aggiornate nel form.`
+          : 'Nessun campo da tradurre.';
+      },
+      error: (error) => {
+        this.translatingProduct = false;
+        this.errorMessage = this.extractErrorMessage(
+          error,
+          'Traduzione prodotto non riuscita.',
+        );
+      },
+    });
+  }
+
+  canTranslateProductFromCurrentLanguage(): boolean {
+    return (
+      !this.translatingProduct &&
+      !!this.productForm.names[this.activeContentLanguage].trim()
+    );
   }
 
   setActiveContentLanguage(language: ShopLanguage): void {
@@ -603,6 +656,45 @@ export class AdminShopComponent implements OnInit, OnDestroy {
     );
   }
 
+  isCategoryContentLanguageComplete(language: ShopLanguage): boolean {
+    return !!this.categoryForm.names[language].trim();
+  }
+
+  isCategoryContentLanguageStarted(language: ShopLanguage): boolean {
+    return (
+      !!this.categoryForm.names[language].trim() ||
+      !!this.categoryForm.descriptions[language].trim()
+    );
+  }
+
+  isCategoryContentLanguageIncomplete(language: ShopLanguage): boolean {
+    return (
+      this.isCategoryContentLanguageStarted(language) &&
+      !this.isCategoryContentLanguageComplete(language)
+    );
+  }
+
+  isCategorySeoLanguageComplete(language: ShopLanguage): boolean {
+    return (
+      !!this.categoryForm.seoTitles[language].trim() &&
+      !!this.categoryForm.seoDescriptions[language].trim()
+    );
+  }
+
+  isCategorySeoLanguageStarted(language: ShopLanguage): boolean {
+    return (
+      !!this.categoryForm.seoTitles[language].trim() ||
+      !!this.categoryForm.seoDescriptions[language].trim()
+    );
+  }
+
+  isCategorySeoLanguageIncomplete(language: ShopLanguage): boolean {
+    return (
+      this.isCategorySeoLanguageStarted(language) &&
+      !this.isCategorySeoLanguageComplete(language)
+    );
+  }
+
   preventRichTextToolbarMouseDown(event: MouseEvent): void {
     event.preventDefault();
   }
@@ -1228,10 +1320,10 @@ export class AdminShopComponent implements OnInit, OnDestroy {
       id: null,
       parentCategoryId: null,
       slug: '',
-      name: '',
-      description: '',
-      seoTitle: '',
-      seoDescription: '',
+      names: this.createEmptyLocalizedTextRecord(),
+      descriptions: this.createEmptyLocalizedTextRecord(),
+      seoTitles: this.createEmptyLocalizedTextRecord(),
+      seoDescriptions: this.createEmptyLocalizedTextRecord(),
       ogTitle: '',
       ogDescription: '',
       indexable: true,
@@ -1241,6 +1333,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   }
 
   private resetCategoryForm(): void {
+    this.activeContentLanguage = 'it';
     Object.assign(this.categoryForm, this.createEmptyCategoryForm());
   }
 
@@ -1249,10 +1342,30 @@ export class AdminShopComponent implements OnInit, OnDestroy {
       id: category.id,
       parentCategoryId: category.parentCategoryId,
       slug: category.slug ?? '',
-      name: category.name ?? '',
-      description: category.description ?? '',
-      seoTitle: category.seoTitle ?? '',
-      seoDescription: category.seoDescription ?? '',
+      names: {
+        it: category.nameIt ?? category.name ?? '',
+        en: category.nameEn ?? category.name ?? '',
+        de: category.nameDe ?? category.name ?? '',
+        fr: category.nameFr ?? category.name ?? '',
+      },
+      descriptions: {
+        it: category.descriptionIt ?? category.description ?? '',
+        en: category.descriptionEn ?? category.description ?? '',
+        de: category.descriptionDe ?? category.description ?? '',
+        fr: category.descriptionFr ?? category.description ?? '',
+      },
+      seoTitles: {
+        it: category.seoTitleIt ?? category.seoTitle ?? '',
+        en: category.seoTitleEn ?? category.seoTitle ?? '',
+        de: category.seoTitleDe ?? category.seoTitle ?? '',
+        fr: category.seoTitleFr ?? category.seoTitle ?? '',
+      },
+      seoDescriptions: {
+        it: category.seoDescriptionIt ?? category.seoDescription ?? '',
+        en: category.seoDescriptionEn ?? category.seoDescription ?? '',
+        de: category.seoDescriptionDe ?? category.seoDescription ?? '',
+        fr: category.seoDescriptionFr ?? category.seoDescription ?? '',
+      },
       ogTitle: category.ogTitle ?? '',
       ogDescription: category.ogDescription ?? '',
       indexable: category.indexable,
@@ -1265,10 +1378,36 @@ export class AdminShopComponent implements OnInit, OnDestroy {
     return {
       parentCategoryId: this.categoryForm.parentCategoryId || null,
       slug: this.categoryForm.slug.trim(),
-      name: this.categoryForm.name.trim(),
-      description: this.categoryForm.description.trim(),
-      seoTitle: this.categoryForm.seoTitle.trim(),
-      seoDescription: this.categoryForm.seoDescription.trim(),
+      name: this.categoryForm.names['it'].trim(),
+      nameIt: this.categoryForm.names['it'].trim(),
+      nameEn: this.categoryForm.names['en'].trim(),
+      nameDe: this.categoryForm.names['de'].trim(),
+      nameFr: this.categoryForm.names['fr'].trim(),
+      description: this.optionalValue(this.categoryForm.descriptions['it']),
+      descriptionIt: this.optionalValue(this.categoryForm.descriptions['it']),
+      descriptionEn: this.optionalValue(this.categoryForm.descriptions['en']),
+      descriptionDe: this.optionalValue(this.categoryForm.descriptions['de']),
+      descriptionFr: this.optionalValue(this.categoryForm.descriptions['fr']),
+      seoTitle: this.optionalValue(this.categoryForm.seoTitles['it']),
+      seoTitleIt: this.optionalValue(this.categoryForm.seoTitles['it']),
+      seoTitleEn: this.optionalValue(this.categoryForm.seoTitles['en']),
+      seoTitleDe: this.optionalValue(this.categoryForm.seoTitles['de']),
+      seoTitleFr: this.optionalValue(this.categoryForm.seoTitles['fr']),
+      seoDescription: this.optionalValue(
+        this.categoryForm.seoDescriptions['it'],
+      ),
+      seoDescriptionIt: this.optionalValue(
+        this.categoryForm.seoDescriptions['it'],
+      ),
+      seoDescriptionEn: this.optionalValue(
+        this.categoryForm.seoDescriptions['en'],
+      ),
+      seoDescriptionDe: this.optionalValue(
+        this.categoryForm.seoDescriptions['de'],
+      ),
+      seoDescriptionFr: this.optionalValue(
+        this.categoryForm.seoDescriptions['fr'],
+      ),
       ogTitle: this.categoryForm.ogTitle.trim(),
       ogDescription: this.categoryForm.ogDescription.trim(),
       indexable: this.categoryForm.indexable,
@@ -1278,12 +1417,19 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   }
 
   private validateCategoryForm(): string | null {
-    if (!this.categoryForm.name.trim()) {
-      return 'Il nome categoria è obbligatorio.';
+    for (const language of this.shopLanguages) {
+      if (!this.categoryForm.names[language].trim()) {
+        return `Il nome categoria ${this.languageLabels[language]} è obbligatorio.`;
+      }
     }
     if (!this.categoryForm.slug.trim()) {
       return 'Lo slug categoria è obbligatorio.';
     }
+    for (const language of this.shopLanguages) {
+      if (this.categoryForm.seoDescriptions[language].trim().length > 160) {
+        return `La SEO description categoria ${this.languageLabels[language]} deve avere massimo 160 caratteri.`;
+      }
+    }
     return null;
   }
 
@@ -1573,6 +1719,98 @@ export class AdminShopComponent implements OnInit, OnDestroy {
     };
   }
 
+  private buildProductTranslationPayload(
+    sourceLanguage: ShopLanguage,
+  ): AdminTranslateShopProductPayload {
+    const materialCodes = Array.from(
+      new Set(
+        this.productForm.materials
+          .map((material) => material.materialCode.trim().toUpperCase())
+          .filter((materialCode) => !!materialCode),
+      ),
+    );
+
+    return {
+      categoryId: this.productForm.categoryId || undefined,
+      sourceLanguage,
+      overwriteExisting: this.overwriteExistingTranslations,
+      materialCodes,
+      names: { ...this.productForm.names },
+      excerpts: { ...this.productForm.excerpts },
+      descriptions: { ...this.productForm.descriptions },
+      seoTitles: { ...this.productForm.seoTitles },
+      seoDescriptions: { ...this.productForm.seoDescriptions },
+    };
+  }
+
+  private applyProductTranslation(
+    response: AdminTranslateShopProductResponse,
+    overwriteExisting: boolean,
+  ): void {
+    for (const language of response.targetLanguages) {
+      this.mergeLocalizedText(
+        this.productForm.names,
+        response.names,
+        language,
+        overwriteExisting,
+      );
+      this.mergeLocalizedText(
+        this.productForm.excerpts,
+        response.excerpts,
+        language,
+        overwriteExisting,
+      );
+      this.mergeLocalizedText(
+        this.productForm.descriptions,
+        response.descriptions,
+        language,
+        overwriteExisting,
+        true,
+      );
+      this.mergeLocalizedText(
+        this.productForm.seoTitles,
+        response.seoTitles,
+        language,
+        overwriteExisting,
+      );
+      this.mergeLocalizedText(
+        this.productForm.seoDescriptions,
+        response.seoDescriptions,
+        language,
+        overwriteExisting,
+      );
+    }
+
+    this.renderActiveDescriptionInEditor();
+  }
+
+  private mergeLocalizedText(
+    target: Record<ShopLanguage, string>,
+    translated:
+      | Partial<Record<ShopLanguage, string>>
+      | Record<ShopLanguage, string>
+      | undefined,
+    language: ShopLanguage,
+    overwriteExisting: boolean,
+    richText = false,
+  ): void {
+    const incoming = translated?.[language];
+    if (incoming === undefined) {
+      return;
+    }
+
+    const hasCurrentValue = richText
+      ? this.hasMeaningfulRichText(target[language] ?? '')
+      : !!target[language]?.trim();
+    if (hasCurrentValue && !overwriteExisting) {
+      return;
+    }
+
+    target[language] = richText
+      ? this.normalizeDescriptionForEditor(incoming)
+      : incoming.trim();
+  }
+
   private buildVariantsFromMaterials(): AdminUpsertShopProductVariantPayload[] {
     const existingVariantsByKey = new Map(
       (this.selectedProduct?.variants ?? []).map((variant) => [
@@ -1616,6 +1854,10 @@ export class AdminShopComponent implements OnInit, OnDestroy {
           sku: this.optionalValue(existingVariant?.sku ?? ''),
           variantLabel: materialCode,
           colorName: stockVariant.colorName.trim(),
+          colorLabelIt: this.optionalValue(stockVariant.colorLabelIt ?? ''),
+          colorLabelEn: this.optionalValue(stockVariant.colorLabelEn ?? ''),
+          colorLabelDe: this.optionalValue(stockVariant.colorLabelDe ?? ''),
+          colorLabelFr: this.optionalValue(stockVariant.colorLabelFr ?? ''),
           colorHex: this.optionalValue(
             stockVariant.colorHex ?? '',
           )?.toUpperCase(),
@@ -1714,7 +1956,7 @@ export class AdminShopComponent implements OnInit, OnDestroy {
   }
 
   private stockVariantLabel(variant: AdminFilamentVariant): string {
-    const colorName = variant.colorName.trim();
+    const colorName = (variant.colorLabelIt || variant.colorName).trim();
     const variantDisplayName = variant.variantDisplayName.trim();
     if (
       variantDisplayName &&
@@ -2193,6 +2435,19 @@ export class AdminShopComponent implements OnInit, OnDestroy {
     return this.productForm.seoDescriptions[language].trim().length;
   }
 
+  categorySeoDescriptionLength(language: ShopLanguage): number {
+    return this.categoryForm.seoDescriptions[language].trim().length;
+  }
+
+  private createEmptyLocalizedTextRecord(): Record<ShopLanguage, string> {
+    return {
+      it: '',
+      en: '',
+      de: '',
+      fr: '',
+    };
+  }
+
   private slugify(source: string): string {
     return source
       .normalize('NFD')

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;
@@ -170,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;
@@ -215,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',
 })
@@ -311,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-animation-test.component.html

@@ -0,0 +1,28 @@
+<section class="animation-test-page">
+  <div class="animation-toolbar" role="group" aria-label="Animation variants">
+    <button
+      type="button"
+      class="variant-toggle"
+      [class.active]="variant() === 'site-intro'"
+      (click)="setVariant('site-intro')"
+    >
+      Site intro
+    </button>
+    <button
+      type="button"
+      class="variant-toggle"
+      [class.active]="variant() === 'calculator-loader'"
+      (click)="setVariant('calculator-loader')"
+    >
+      Calculator loader
+    </button>
+  </div>
+
+  <div class="animation-stage" [attr.data-variant]="variant()">
+    <app-brand-animation-logo
+      [variant]="variant()"
+      [decorative]="false"
+      ariaLabel="3D fab animation test"
+    ></app-brand-animation-logo>
+  </div>
+</section>

frontend/src/app/features/calculator/calculator-animation-test.component.scss

@@ -0,0 +1,60 @@
+:host {
+  display: block;
+}
+
+.animation-test-page {
+  min-height: 100vh;
+  display: grid;
+  align-content: center;
+  justify-items: center;
+  gap: 1.5rem;
+  padding: 2rem 1.5rem 3rem;
+  background: #fff;
+}
+
+.animation-toolbar {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.35rem;
+  border: 1px solid rgba(16, 24, 32, 0.12);
+  border-radius: 999px;
+  background: #f7f5ef;
+}
+
+.variant-toggle {
+  min-height: 2.4rem;
+  padding: 0 1rem;
+  border: 0;
+  border-radius: 999px;
+  background: transparent;
+  color: var(--color-text-muted);
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+  transition:
+    background-color 0.18s ease,
+    color 0.18s ease,
+    box-shadow 0.18s ease;
+}
+
+.variant-toggle.active {
+  background: #fff;
+  color: var(--color-text);
+  box-shadow: 0 6px 16px rgba(16, 24, 32, 0.08);
+}
+
+.animation-stage {
+  width: min(100%, 26rem);
+}
+
+@media (max-width: 640px) {
+  .animation-toolbar {
+    flex-wrap: wrap;
+    justify-content: center;
+  }
+
+  .animation-stage {
+    width: min(100%, 19rem);
+  }
+}

frontend/src/app/features/calculator/calculator-animation-test.component.ts

@@ -0,0 +1,21 @@
+import { CommonModule } from '@angular/common';
+import { Component, signal } from '@angular/core';
+import {
+  BrandAnimationLogoComponent,
+  BrandAnimationVariant,
+} from '../../shared/components/brand-animation-logo/brand-animation-logo.component';
+
+@Component({
+  selector: 'app-calculator-animation-test',
+  standalone: true,
+  imports: [CommonModule, BrandAnimationLogoComponent],
+  templateUrl: './calculator-animation-test.component.html',
+  styleUrl: './calculator-animation-test.component.scss',
+})
+export class CalculatorAnimationTestComponent {
+  readonly variant = signal<BrandAnimationVariant>('site-intro');
+
+  setVariant(variant: BrandAnimationVariant): void {
+    this.variant.set(variant);
+  }
+}

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

@@ -57,7 +57,10 @@
       @if (loading()) {
         <app-card class="loading-state">
           <div class="loader-content">
-            <div class="spinner"></div>
+            <app-brand-animation-logo
+              class="loader-logo"
+              variant="calculator-loader"
+            ></app-brand-animation-logo>
             <h3 class="loading-title">
               {{ "CALC.ANALYZING_TITLE" | translate }}
             </h3>

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

@@ -93,7 +93,7 @@
 
 .loader-content {
   text-align: center;
-  max-width: 300px;
+  max-width: 22rem;
   margin: 0 auto;
 
   /* Center content vertically within the stretched card */
@@ -101,12 +101,14 @@
   display: flex;
   flex-direction: column;
   justify-content: center;
+  align-items: center;
+  gap: var(--space-3);
 }
 
 .loading-title {
   font-size: 1.1rem;
   font-weight: 600;
-  margin: var(--space-4) 0 var(--space-2);
+  margin: 0;
   color: var(--color-text);
 }
 
@@ -114,23 +116,21 @@
   font-size: 0.9rem;
   color: var(--color-text-muted);
   line-height: 1.5;
+  margin: 0;
 }
 
-.spinner {
-  border: 3px solid var(--color-neutral-200);
-  border-left-color: var(--color-brand);
-  border-radius: 50%;
-  width: 48px;
-  height: 48px;
-  animation: spin 1s linear infinite;
+.loader-logo {
+  display: block;
+  width: min(100%, 16rem);
   margin: 0 auto;
-}
-
-@keyframes spin {
-  0% {
-    transform: rotate(0deg);
-  }
-  100% {
-    transform: rotate(360deg);
-  }
+  --brand-animation-width: 16rem;
+  --brand-animation-height: 4.8rem;
+  --brand-animation-letter-width: 2.85rem;
+  --brand-animation-scale: 0.84;
+  --brand-animation-word-spacing: 0.97;
+  --brand-animation-width-mobile: 14rem;
+  --brand-animation-height-mobile: 4.1rem;
+  --brand-animation-letter-width-mobile: 2.45rem;
+  --brand-animation-scale-mobile: 0.84;
+  --brand-animation-loader-loop-duration: 2.65s;
 }