Add Java 21 LTS compatibility and fix JavaPoet import generation

Major improvements to ensure production readiness and compatibility:

**Java 21 LTS Migration:**
- Update devcontainer from Java 25 to Java 21 LTS for better Lombok compatibility
- Resolve Java 25 + Lombok compatibility issues (ExceptionInInitializerError)
- Add Lombok to annotation processor paths in integration tests

**JavaPoet Import Generation Fixes:**
- Fix enum type imports: WaypointType, RouteType, Difficulty, GeometryType now properly imported
- Fix complex object imports: Waypoint class properly imported in complex list mappings
- Update createEnumParseBlock() to use ClassName instead of String for proper type references
- Add extractListElementQualifiedType() method for complex object import resolution

**Code Generation Quality Improvements:**
- Fix primitive field statement termination (wrap in proper CodeBlock statements)
- Fix stream operation chaining for nested number lists and complex lists
- Improve JavaPoet code structure with proper .add() vs .addStatement() usage
- Ensure proper semicolon placement and statement formatting

**Real-World Validation:**
- Add comprehensive Tourino domain classes for integration testing
- Add TourinoMappingTest with 7 validation scenarios
- Add JavaPoetFixValidationTest with specific fix validation
- Successfully tested with actual Tourino backend compilation
- All generated mappers compile without errors and include correct imports

**Testing & Integration:**
- Update test paths to use correct generated-sources location
- Adjust test expectations for improved code generation output
- 23 tests passing with full validation coverage

Verified working in production environment with Tourino backend.

Author: wassertim

.devcontainer/Dockerfile

@@ -1,5 +1,5 @@
-# Use official Maven image with Eclipse Temurin Java 25
-FROM maven:3.9.11-eclipse-temurin-25
+# Use official Maven image with Eclipse Temurin Java 21 LTS
+FROM maven:3.9.11-eclipse-temurin-21
 
 # Install unzip, zsh and other tools needed
 RUN apt-get update && apt-get install -y \

integration-tests/pom.xml

@@ -90,6 +90,11 @@
                             <artifactId>dynamodb-toolkit</artifactId>
                             <version>${dynamodb-toolkit.version}</version>
                         </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>${lombok.version}</version>
+                        </path>
                     </annotationProcessorPaths>
                 </configuration>
             </plugin>

integration-tests/src/main/java/com/tourino/domain/Difficulty.java

@@ -0,0 +1,25 @@
+package com.tourino.domain;
+
+/**
+ * Enumeration of route difficulty levels for user classification.
+ */
+public enum Difficulty {
+    EASY("Easy - suitable for beginners"),
+    MODERATE("Moderate - some experience required"),
+    HARD("Hard - experienced users only"),
+    EXPERT("Expert - professional level");
+
+    private final String description;
+
+    Difficulty(String description) {
+        this.description = description;
+    }
+
+    /**
+     * Gets the human-readable description of this difficulty level.
+     * @return the difficulty description
+     */
+    public String getDescription() {
+        return description;
+    }
+}

integration-tests/src/main/java/com/tourino/domain/Route.java

@@ -0,0 +1,101 @@
+package com.tourino.domain;
+
+import com.github.wassertim.dynamodb.toolkit.api.annotations.AttributeType;
+import com.github.wassertim.dynamodb.toolkit.api.annotations.PartitionKey;
+import com.github.wassertim.dynamodb.toolkit.api.annotations.SortKey;
+import com.github.wassertim.dynamodb.toolkit.api.annotations.Table;
+import com.github.wassertim.dynamodb.toolkit.api.annotations.DynamoMappable;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.Instant;
+import java.util.List;
+
+/**
+ * Main user route entity for persistent route management.
+ * Represents a user's saved route with full lifecycle support and rich metadata.
+ */
+@DynamoMappable
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder(toBuilder = true)
+@Table(name = "routes")
+public class Route {
+    
+    /**
+     * User ID - partition key for data isolation and efficient queries.
+     */
+    @PartitionKey(attributeType = AttributeType.STRING)
+    private String userId;
+
+    /**
+     * Unique route identifier - UUID for global uniqueness.
+     */
+    @SortKey(attributeType = AttributeType.STRING)
+    private String routeId;
+
+    /**
+     * User-defined route name (3-100 characters).
+     */
+    private String name;
+    
+    /**
+     * Optional description providing additional context about the route.
+     */
+    private String description;
+    
+    /**
+     * Route type classification for filtering and organization.
+     */
+    private RouteType type;
+
+    /**
+     * Difficulty level assessment for user guidance.
+     */
+    private Difficulty difficulty;
+
+    /**
+     * The routing profile used for route calculation (e.g., "cycling-regular", "walking", "driving-car").
+     * This preserves the exact calculation parameters used and ensures route consistency.
+     */
+    private String routingProfile;
+
+    /**
+     * Ordered collection of waypoints defining the route path.
+     */
+    private List<Waypoint> waypoints;
+
+    /**
+     * Route geometry containing path coordinates and shape data.
+     */
+    private RouteGeometry routeGeometry;
+
+    /**
+     * Calculated route statistics and measurements.
+     */
+    private RouteMetadata metadata;
+    
+    
+    /**
+     * Route creation timestamp for audit trail.
+     */
+    private Instant createdAt;
+
+    /**
+     * Last modification timestamp for change tracking.
+     */
+    private Instant updatedAt;
+
+    /**
+     * Last accessed timestamp for usage analytics and recent route queries.
+     */
+    private Instant lastUsed;
+
+    /**
+     * User-defined tags for route categorization and search.
+     */
+    private List<String> tags;
+}

integration-tests/src/main/java/com/tourino/domain/RouteGeometry.java

@@ -0,0 +1,28 @@
+package com.tourino.domain;
+
+import com.tourino.domain.enums.GeometryType;
+import com.github.wassertim.dynamodb.toolkit.api.annotations.DynamoMappable;
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * Domain value object representing route geometry as GeoJSON LineString.
+ */
+@DynamoMappable
+@Data
+@Builder
+public class RouteGeometry {
+    
+    /**
+     * GeoJSON type (always LINESTRING for routes).
+     */
+    @Builder.Default
+    private final GeometryType type = GeometryType.LINESTRING;
+    
+    /**
+     * Array of coordinate pairs [longitude, latitude] defining the route path.
+     */
+    private final List<List<Double>> coordinates;
+}

integration-tests/src/main/java/com/tourino/domain/RouteMetadata.java

@@ -0,0 +1,54 @@
+package com.tourino.domain;
+
+import com.github.wassertim.dynamodb.toolkit.api.annotations.DynamoMappable;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Value object containing route calculation metadata and statistics.
+ * Stores numeric values for calculations, not formatted strings.
+ */
+@DynamoMappable
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class RouteMetadata {
+    
+    /**
+     * Total route distance in meters.
+     */
+    private Double distance;
+
+    /**
+     * Total route duration in seconds.
+     */
+    private Double duration;
+
+    /**
+     * Total elevation gain in meters.
+     */
+    private Double elevationGain;
+
+    /**
+     * Total elevation loss in meters.
+     */
+    private Double elevationLoss;
+
+    /**
+     * Minimum elevation in meters.
+     */
+    private Double minElevation;
+
+    /**
+     * Maximum elevation in meters.
+     */
+    private Double maxElevation;
+
+    /**
+     * Average speed in kilometers per hour.
+     */
+    private Double averageSpeed;
+}

integration-tests/src/main/java/com/tourino/domain/RouteType.java

@@ -0,0 +1,44 @@
+package com.tourino.domain;
+
+/**
+ * Enumeration of route types for categorizing user routes.
+ */
+public enum RouteType {
+    WALKING("walking"),
+    CYCLING("cycling"),
+    CYCLING_REGULAR("cycling-regular"),
+    DRIVING("driving-car"),
+    HIKING("foot-hiking"),
+    MOUNTAIN_BIKING("cycling-mountain"),
+    RUNNING("foot-running"),
+    WHEELCHAIR("wheelchair");
+
+    private final String profile;
+
+    RouteType(String profile) {
+        this.profile = profile;
+    }
+
+    /**
+     * Gets the OpenRouteService profile name for this route type.
+     * @return the profile name used in route calculations
+     */
+    public String getProfile() {
+        return profile;
+    }
+
+    /**
+     * Creates RouteType from profile string.
+     * @param profile the profile string
+     * @return the corresponding RouteType
+     * @throws IllegalArgumentException if profile doesn't match any route type
+     */
+    public static RouteType fromProfile(String profile) {
+        for (RouteType routeType : RouteType.values()) {
+            if (routeType.profile.equals(profile)) {
+                return routeType;
+            }
+        }
+        throw new IllegalArgumentException("Unknown RouteType profile: " + profile);
+    }
+}

integration-tests/src/main/java/com/tourino/domain/Waypoint.java

@@ -0,0 +1,43 @@
+package com.tourino.domain;
+
+import com.github.wassertim.dynamodb.toolkit.api.annotations.DynamoMappable;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Enhanced waypoint entity with coordinates, metadata, and type information.
+ */
+@DynamoMappable
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class Waypoint {
+    
+    /**
+     * Latitude coordinate in decimal degrees.
+     */
+    private double lat;
+
+    /**
+     * Longitude coordinate in decimal degrees.
+     */
+    private double lng;
+
+    /**
+     * Display name for this waypoint (e.g., "Home", "Office", "Mountain Peak").
+     */
+    private String name;
+
+    /**
+     * Optional description providing additional context about this waypoint.
+     */
+    private String description;
+
+    /**
+     * Type classification for this waypoint.
+     */
+    private WaypointType type;
+}

integration-tests/src/main/java/com/tourino/domain/WaypointType.java

@@ -0,0 +1,32 @@
+package com.tourino.domain;
+
+/**
+ * Enumeration of waypoint types for classification and UI display.
+ */
+public enum WaypointType {
+    START("Starting point"),
+    END("Destination"),
+    INTERMEDIATE("Intermediate stop"),
+    LANDMARK("Point of interest"),
+    CHECKPOINT("Checkpoint"),
+    ACCOMMODATION("Hotel/accommodation"),
+    RESTAURANT("Restaurant/food"),
+    GAS_STATION("Gas station"),
+    PARKING("Parking area"),
+    VIEWPOINT("Scenic viewpoint"),
+    EMERGENCY("Emergency services");
+
+    private final String description;
+
+    WaypointType(String description) {
+        this.description = description;
+    }
+
+    /**
+     * Gets the human-readable description of this waypoint type.
+     * @return the waypoint type description
+     */
+    public String getDescription() {
+        return description;
+    }
+}