From b26f235250627a235a2974a22f2317dbef27338d Mon Sep 17 00:00:00 2001
From: Patrick Baumgartner <contact@patbaumgartner.com>
Date: Sat, 4 Oct 2025 10:32:59 +0200
Subject: [PATCH 01/23] Update to current versions

Signed-off-by: Patrick Baumgartner <contact@patbaumgartner.com>
---
 .gitattributes                                |  3 +-
 .mvn/wrapper/maven-wrapper.properties         | 20 +------
 README.md                                     |  2 +-
 build.gradle                                  | 16 +++---
 docker-compose.yml                            |  2 +-
 gradle/wrapper/gradle-wrapper.properties      |  3 +-
 k8s/db.yml                                    |  2 +-
 mvnw                                          | 52 ++++++++++++++---
 mvnw.cmd                                      | 56 ++++++++++++++++---
 pom.xml                                       | 10 ++--
 .../static/resources/css/petclinic.css        |  6 +-
 11 files changed, 118 insertions(+), 54 deletions(-)

diff --git a/.gitattributes b/.gitattributes
index 31f1bf50b..8a09fad07 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,4 +1,5 @@
-mvnw            text eol=lf
+/mvnw           text eol=lf
+*.cmd           text eol=crlf
 *.java          text eol=lf
 
 /gradlew        text eol=lf
diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties
index 4bc659978..c0bcafe98 100644
--- a/.mvn/wrapper/maven-wrapper.properties
+++ b/.mvn/wrapper/maven-wrapper.properties
@@ -1,19 +1,3 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-wrapperVersion=3.3.2
+wrapperVersion=3.3.4
 distributionType=only-script
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.10/apache-maven-3.9.10-bin.zip
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip
diff --git a/README.md b/README.md
index 1f865c56f..c860ee0f2 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,7 @@ docker run -e MYSQL_USER=petclinic -e MYSQL_PASSWORD=petclinic -e MYSQL_ROOT_PAS
 or
 
 ```bash
-docker run -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -e POSTGRES_DB=petclinic -p 5432:5432 postgres:17.5
+docker run -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -e POSTGRES_DB=petclinic -p 5432:5432 postgres:18.0
 ```
 
 Further documentation is provided for [MySQL](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/db/mysql/petclinic_db_setup_mysql.txt)
diff --git a/build.gradle b/build.gradle
index d0cd5f587..401094108 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,11 +1,11 @@
 plugins {
   id 'java'
   id 'checkstyle'
-  id 'org.springframework.boot' version '3.5.0'
+  id 'org.springframework.boot' version '3.5.6'
   id 'io.spring.dependency-management' version '1.1.7'
-  id 'org.graalvm.buildtools.native' version '0.10.6'
-  id 'org.cyclonedx.bom' version '2.3.1'
-  id 'io.spring.javaformat' version '0.0.46'
+  id 'org.graalvm.buildtools.native' version '0.11.1'
+  id 'org.cyclonedx.bom' version '3.0.0'
+  id 'io.spring.javaformat' version '0.0.47'
   id "io.spring.nohttp" version "0.0.11"
 }
 
@@ -24,11 +24,11 @@ repositories {
   mavenCentral()
 }
 
-ext.checkstyleVersion = "10.25.0"
-ext.springJavaformatCheckstyleVersion = "0.0.46"
-ext.webjarsLocatorLiteVersion = "1.1.0"
+ext.checkstyleVersion = "11.1.0"
+ext.springJavaformatCheckstyleVersion = "0.0.47"
+ext.webjarsLocatorLiteVersion = "1.1.1"
 ext.webjarsFontawesomeVersion = "4.7.0"
-ext.webjarsBootstrapVersion = "5.3.6"
+ext.webjarsBootstrapVersion = "5.3.8"
 
 dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
diff --git a/docker-compose.yml b/docker-compose.yml
index e066d1237..50c731a91 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -12,7 +12,7 @@ services:
     volumes:
       - "./conf.d:/etc/mysql/conf.d:ro"
   postgres:
-    image: postgres:17.5
+    image: postgres:18.0
     ports:
       - "5432:5432"
     environment:
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index dbc089ed3..d4081da47 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,7 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionSha256Sum=ed1a8d686605fd7c23bdf62c7fc7add1c5b23b2bbc3721e661934ef4a4911d7c
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
diff --git a/k8s/db.yml b/k8s/db.yml
index 29d5ea4f8..c2c63037a 100644
--- a/k8s/db.yml
+++ b/k8s/db.yml
@@ -41,7 +41,7 @@ spec:
         app: demo-db
     spec:
       containers:
-        - image: postgres:17.5
+        - image: postgres:18.0
           name: postgresql
           env:
             - name: POSTGRES_USER
diff --git a/mvnw b/mvnw
index d7c358e5a..885f47143 100755
--- a/mvnw
+++ b/mvnw
@@ -19,7 +19,7 @@
 # ----------------------------------------------------------------------------
 
 # ----------------------------------------------------------------------------
-# Apache Maven Wrapper startup batch script, version 3.3.2
+# Apache Maven Wrapper startup batch script, version 3.3.4
 #
 # Optional ENV vars
 # -----------------
@@ -105,14 +105,17 @@ trim() {
   printf "%s" "${1}" | tr -d '[:space:]'
 }
 
+scriptDir="$(dirname "$0")"
+scriptName="$(basename "$0")"
+
 # parse distributionUrl and optional distributionSha256Sum, requires .mvn/wrapper/maven-wrapper.properties
 while IFS="=" read -r key value; do
   case "${key-}" in
   distributionUrl) distributionUrl=$(trim "${value-}") ;;
   distributionSha256Sum) distributionSha256Sum=$(trim "${value-}") ;;
   esac
-done <"${0%/*}/.mvn/wrapper/maven-wrapper.properties"
-[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in ${0%/*}/.mvn/wrapper/maven-wrapper.properties"
+done <"$scriptDir/.mvn/wrapper/maven-wrapper.properties"
+[ -n "${distributionUrl-}" ] || die "cannot read distributionUrl property in $scriptDir/.mvn/wrapper/maven-wrapper.properties"
 
 case "${distributionUrl##*/}" in
 maven-mvnd-*bin.*)
@@ -130,7 +133,7 @@ maven-mvnd-*bin.*)
   distributionUrl="${distributionUrl%-bin.*}-$distributionPlatform.zip"
   ;;
 maven-mvnd-*) MVN_CMD=mvnd.sh _MVNW_REPO_PATTERN=/maven/mvnd/ ;;
-*) MVN_CMD="mvn${0##*/mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
+*) MVN_CMD="mvn${scriptName#mvnw}" _MVNW_REPO_PATTERN=/org/apache/maven/ ;;
 esac
 
 # apply MVNW_REPOURL and calculate MAVEN_HOME
@@ -182,7 +185,7 @@ fi
 __MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
 [ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
 
-# normalize http auth
+# normalize https auth
 case "${MVNW_PASSWORD:+has-password}" in
 '') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
 has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
@@ -227,7 +230,7 @@ if [ -n "${distributionSha256Sum-}" ]; then
     echo "Please disable validation by removing 'distributionSha256Sum' from your maven-wrapper.properties." >&2
     exit 1
   elif command -v sha256sum >/dev/null; then
-    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c >/dev/null 2>&1; then
+    if echo "$distributionSha256Sum  $TMP_DOWNLOAD_DIR/$distributionUrlName" | sha256sum -c - >/dev/null 2>&1; then
       distributionSha256Result=true
     fi
   elif command -v shasum >/dev/null; then
@@ -252,8 +255,41 @@ if command -v unzip >/dev/null; then
 else
   tar xzf${__MVNW_QUIET_TAR:+"$__MVNW_QUIET_TAR"} "$TMP_DOWNLOAD_DIR/$distributionUrlName" -C "$TMP_DOWNLOAD_DIR" || die "failed to untar"
 fi
-printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/mvnw.url"
-mv -- "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+actualDistributionDir=""
+
+# First try the expected directory name (for regular distributions)
+if [ -d "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" ]; then
+  if [ -f "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain/bin/$MVN_CMD" ]; then
+    actualDistributionDir="$distributionUrlNameMain"
+  fi
+fi
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if [ -z "$actualDistributionDir" ]; then
+  # enable globbing to iterate over items
+  set +f
+  for dir in "$TMP_DOWNLOAD_DIR"/*; do
+    if [ -d "$dir" ]; then
+      if [ -f "$dir/bin/$MVN_CMD" ]; then
+        actualDistributionDir="$(basename "$dir")"
+        break
+      fi
+    fi
+  done
+  set -f
+fi
+
+if [ -z "$actualDistributionDir" ]; then
+  verbose "Contents of $TMP_DOWNLOAD_DIR:"
+  verbose "$(ls -la "$TMP_DOWNLOAD_DIR")"
+  die "Could not find Maven distribution directory in extracted archive"
+fi
+
+verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+printf %s\\n "$distributionUrl" >"$TMP_DOWNLOAD_DIR/$actualDistributionDir/mvnw.url"
+mv -- "$TMP_DOWNLOAD_DIR/$actualDistributionDir" "$MAVEN_HOME" || [ -d "$MAVEN_HOME" ] || die "fail to move MAVEN_HOME"
 
 clean || :
 exec_maven "$@"
diff --git a/mvnw.cmd b/mvnw.cmd
index 6f779cff2..bba35af22 100644
--- a/mvnw.cmd
+++ b/mvnw.cmd
@@ -19,7 +19,7 @@
 @REM ----------------------------------------------------------------------------
 
 @REM ----------------------------------------------------------------------------
-@REM Apache Maven Wrapper startup batch script, version 3.3.2
+@REM Apache Maven Wrapper startup batch script, version 3.3.4
 @REM
 @REM Optional ENV vars
 @REM   MVNW_REPOURL - repo url base for downloading maven distribution
@@ -40,7 +40,7 @@
 @SET __MVNW_ARG0_NAME__=
 @SET MVNW_USERNAME=
 @SET MVNW_PASSWORD=
-@IF NOT "%__MVNW_CMD__%"=="" (%__MVNW_CMD__% %*)
+@IF NOT "%__MVNW_CMD__%"=="" ("%__MVNW_CMD__%" %*)
 @echo Cannot start maven from wrapper >&2 && exit /b 1
 @GOTO :EOF
 : end batch / begin powershell #>
@@ -73,16 +73,30 @@ switch -wildcard -casesensitive ( $($distributionUrl -replace '^.*/','') ) {
 # apply MVNW_REPOURL and calculate MAVEN_HOME
 # maven home pattern: ~/.m2/wrapper/dists/{apache-maven-<version>,maven-mvnd-<version>-<platform>}/<hash>
 if ($env:MVNW_REPOURL) {
-  $MVNW_REPO_PATTERN = if ($USE_MVND) { "/org/apache/maven/" } else { "/maven/mvnd/" }
-  $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace '^.*'+$MVNW_REPO_PATTERN,'')"
+  $MVNW_REPO_PATTERN = if ($USE_MVND -eq $False) { "/org/apache/maven/" } else { "/maven/mvnd/" }
+  $distributionUrl = "$env:MVNW_REPOURL$MVNW_REPO_PATTERN$($distributionUrl -replace "^.*$MVNW_REPO_PATTERN",'')"
 }
 $distributionUrlName = $distributionUrl -replace '^.*/',''
 $distributionUrlNameMain = $distributionUrlName -replace '\.[^.]*$','' -replace '-bin$',''
-$MAVEN_HOME_PARENT = "$HOME/.m2/wrapper/dists/$distributionUrlNameMain"
+
+$MAVEN_M2_PATH = "$HOME/.m2"
 if ($env:MAVEN_USER_HOME) {
-  $MAVEN_HOME_PARENT = "$env:MAVEN_USER_HOME/wrapper/dists/$distributionUrlNameMain"
+  $MAVEN_M2_PATH = "$env:MAVEN_USER_HOME"
 }
-$MAVEN_HOME_NAME = ([System.Security.Cryptography.MD5]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
+
+if (-not (Test-Path -Path $MAVEN_M2_PATH)) {
+    New-Item -Path $MAVEN_M2_PATH -ItemType Directory | Out-Null
+}
+
+$MAVEN_WRAPPER_DISTS = $null
+if ((Get-Item $MAVEN_M2_PATH).Target[0] -eq $null) {
+  $MAVEN_WRAPPER_DISTS = "$MAVEN_M2_PATH/wrapper/dists"
+} else {
+  $MAVEN_WRAPPER_DISTS = (Get-Item $MAVEN_M2_PATH).Target[0] + "/wrapper/dists"
+}
+
+$MAVEN_HOME_PARENT = "$MAVEN_WRAPPER_DISTS/$distributionUrlNameMain"
+$MAVEN_HOME_NAME = ([System.Security.Cryptography.SHA256]::Create().ComputeHash([byte[]][char[]]$distributionUrl) | ForEach-Object {$_.ToString("x2")}) -join ''
 $MAVEN_HOME = "$MAVEN_HOME_PARENT/$MAVEN_HOME_NAME"
 
 if (Test-Path -Path "$MAVEN_HOME" -PathType Container) {
@@ -134,7 +148,33 @@ if ($distributionSha256Sum) {
 
 # unzip and move
 Expand-Archive "$TMP_DOWNLOAD_DIR/$distributionUrlName" -DestinationPath "$TMP_DOWNLOAD_DIR" | Out-Null
-Rename-Item -Path "$TMP_DOWNLOAD_DIR/$distributionUrlNameMain" -NewName $MAVEN_HOME_NAME | Out-Null
+
+# Find the actual extracted directory name (handles snapshots where filename != directory name)
+$actualDistributionDir = ""
+
+# First try the expected directory name (for regular distributions)
+$expectedPath = Join-Path "$TMP_DOWNLOAD_DIR" "$distributionUrlNameMain"
+$expectedMvnPath = Join-Path "$expectedPath" "bin/$MVN_CMD"
+if ((Test-Path -Path $expectedPath -PathType Container) -and (Test-Path -Path $expectedMvnPath -PathType Leaf)) {
+  $actualDistributionDir = $distributionUrlNameMain
+}
+
+# If not found, search for any directory with the Maven executable (for snapshots)
+if (!$actualDistributionDir) {
+  Get-ChildItem -Path "$TMP_DOWNLOAD_DIR" -Directory | ForEach-Object {
+    $testPath = Join-Path $_.FullName "bin/$MVN_CMD"
+    if (Test-Path -Path $testPath -PathType Leaf) {
+      $actualDistributionDir = $_.Name
+    }
+  }
+}
+
+if (!$actualDistributionDir) {
+  Write-Error "Could not find Maven distribution directory in extracted archive"
+}
+
+Write-Verbose "Found extracted Maven distribution directory: $actualDistributionDir"
+Rename-Item -Path "$TMP_DOWNLOAD_DIR/$actualDistributionDir" -NewName $MAVEN_HOME_NAME | Out-Null
 try {
   Move-Item -Path "$TMP_DOWNLOAD_DIR/$MAVEN_HOME_NAME" -Destination $MAVEN_HOME_PARENT | Out-Null
 } catch {
diff --git a/pom.xml b/pom.xml
index 8576c22ba..004709a9b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
-    <version>3.5.0</version>
+    <version>3.5.6</version>
     <relativePath></relativePath>
   </parent>
 
@@ -25,17 +25,17 @@
     <project.build.outputTimestamp>2024-11-28T14:37:52Z</project.build.outputTimestamp>
 
     <!-- Web dependencies -->
-    <webjars-locator.version>1.1.0</webjars-locator.version>
-    <webjars-bootstrap.version>5.3.6</webjars-bootstrap.version>
+    <webjars-locator.version>1.1.1</webjars-locator.version>
+    <webjars-bootstrap.version>5.3.8</webjars-bootstrap.version>
     <webjars-font-awesome.version>4.7.0</webjars-font-awesome.version>
 
-    <checkstyle.version>10.25.0</checkstyle.version>
+    <checkstyle.version>11.1.0</checkstyle.version>
     <jacoco.version>0.8.13</jacoco.version>
     <libsass.version>0.3.4</libsass.version>
     <lifecycle-mapping>1.0.0</lifecycle-mapping>
     <maven-checkstyle.version>3.6.0</maven-checkstyle.version>
     <nohttp-checkstyle.version>0.0.11</nohttp-checkstyle.version>
-    <spring-format.version>0.0.46</spring-format.version>
+    <spring-format.version>0.0.47</spring-format.version>
 
   </properties>
 
diff --git a/src/main/resources/static/resources/css/petclinic.css b/src/main/resources/static/resources/css/petclinic.css
index 22e3e50ea..4b701b13b 100644
--- a/src/main/resources/static/resources/css/petclinic.css
+++ b/src/main/resources/static/resources/css/petclinic.css
@@ -12,7 +12,7 @@
  * limitations under the License.
  */
 /*!
-   * Bootstrap  v5.3.6 (https://getbootstrap.com/)
+   * Bootstrap  v5.3.8 (https://getbootstrap.com/)
    * Copyright 2011-2025 The Bootstrap Authors
    * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)
    */
@@ -479,6 +479,9 @@ legend {
 [type="search"] {
   -webkit-appearance: textfield;
   outline-offset: -2px; }
+  [type="search"]::-webkit-search-cancel-button {
+    cursor: pointer;
+    filter: grayscale(1); }
 
 /* rtl:raw:
 [type="tel"],
@@ -5072,6 +5075,7 @@ textarea.form-control-lg {
 .spinner-grow,
 .spinner-border {
   display: inline-block;
+  flex-shrink: 0;
   width: var(--bs-spinner-width);
   height: var(--bs-spinner-height);
   vertical-align: var(--bs-spinner-vertical-align);

From 196e5aa4b086a047850db2b05976020e725f565a Mon Sep 17 00:00:00 2001
From: shjung1999 <shjung@aipark.ai>
Date: Sun, 12 Oct 2025 20:43:11 +0900
Subject: [PATCH 02/23] docs: capitalize 'JAR' in README for consistency

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c860ee0f2..59b71441f 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@
 
 ## Run Petclinic locally
 
-Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/). You can build a jar file and run it from the command line (it should work just as well with Java 17 or newer):
+Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/). You can build a JAR file and run it from the command line (it should work just as well with Java 17 or newer):
 
 ```bash
 git clone https://github.com/spring-projects/spring-petclinic.git

From cf2931f881cd80786fcd2fbe10d0f68a67f1d25a Mon Sep 17 00:00:00 2001
From: Philippe Marschall <philippe.marschall@gmail.com>
Date: Fri, 26 Sep 2025 15:39:55 +0200
Subject: [PATCH 03/23] Remove unused imports

Signed-off-by: Philippe Marschall <philippe.marschall@gmail.com>
---
 .../samples/petclinic/owner/OwnerRepository.java              | 2 --
 .../samples/petclinic/owner/PetTypeRepository.java            | 4 ----
 .../samples/petclinic/owner/PetControllerTests.java           | 2 --
 3 files changed, 8 deletions(-)

diff --git a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
index 9384b318e..d26bdb62f 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
@@ -15,14 +15,12 @@
  */
 package org.springframework.samples.petclinic.owner;
 
-import java.util.List;
 import java.util.Optional;
 
 import jakarta.annotation.Nonnull;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.jpa.repository.Query;
 
 /**
  * Repository class for <code>Owner</code> domain objects. All method names are compliant
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java b/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java
index 0412948eb..0b0d7bbd0 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/PetTypeRepository.java
@@ -17,11 +17,7 @@
 package org.springframework.samples.petclinic.owner;
 
 import java.util.List;
-import java.util.Optional;
 
-import jakarta.annotation.Nonnull;
-import org.springframework.data.domain.Page;
-import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.data.jpa.repository.Query;
 
diff --git a/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java b/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
index d60636f1f..5a78b2319 100644
--- a/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
@@ -24,8 +24,6 @@ import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
 import org.springframework.context.annotation.ComponentScan;
 import org.springframework.context.annotation.FilterType;
-import org.springframework.samples.petclinic.owner.PetTypeRepository;
-import org.springframework.samples.petclinic.owner.OwnerRepository;
 import org.springframework.test.context.aot.DisabledInAotMode;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;

From 438adfd4d8d9e0e9f46fe152b0a34c7d4c026cdb Mon Sep 17 00:00:00 2001
From: bansalbhumika13-beep <bansalbhumika13@gmail.com>
Date: Tue, 16 Sep 2025 17:12:38 +0530
Subject: [PATCH 04/23] docs: update README with note about legacy presentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Speakerdeck presentation linked in the README refers to a
pre–Spring Boot version of Petclinic. Added a note clarifying
that the slides are outdated and pointing readers to the
repository/docs for the current Spring Boot–based implementation.


Signed-off-by: bansalbhumika13-beep <bansalbhumika13@gmail.com>
---
 README.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 59b71441f..1b983ee96 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,12 @@
 
 ## Understanding the Spring Petclinic application with a few diagrams
 
-[See the presentation here](https://speakerdeck.com/michaelisvy/spring-petclinic-sample-application)
+See the presentation here:  
+[Spring Petclinic Sample Application (legacy slides)](https://speakerdeck.com/michaelisvy/spring-petclinic-sample-application?slide=20)
+
+> **Note:** These slides refer to a legacy, pre–Spring Boot version of Petclinic and may not reflect the current Spring Boot–based implementation.  
+> For up-to-date information, please refer to this repository and its documentation.
+
 
 ## Run Petclinic locally
 

From b2aee1d14ac2792be6bbd80f0fc6842227ae187b Mon Sep 17 00:00:00 2001
From: jang8584 <jang8584@gmail.com>
Date: Thu, 31 Jul 2025 16:03:40 +0900
Subject: [PATCH 05/23] feat: enhance error page with localized messages for
 status codes

Signed-off-by: jang8584 <jang8584@gmail.com>
---
 src/main/resources/messages/messages_de.properties |  3 +++
 src/main/resources/messages/messages_es.properties |  3 +++
 src/main/resources/messages/messages_fa.properties |  3 +++
 src/main/resources/messages/messages_ko.properties |  3 +++
 src/main/resources/messages/messages_pt.properties |  3 +++
 src/main/resources/messages/messages_ru.properties |  3 +++
 src/main/resources/messages/messages_tr.properties |  3 +++
 src/main/resources/templates/error.html            | 12 +++++++++++-
 8 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/messages/messages_de.properties b/src/main/resources/messages/messages_de.properties
index 8d208410c..89a08eaad 100644
--- a/src/main/resources/messages/messages_de.properties
+++ b/src/main/resources/messages/messages_de.properties
@@ -46,3 +46,6 @@ visitDate=Besuchsdatum
 editOwner=Besitzer bearbeiten
 addNewPet=Neues Haustier hinzufügen
 petsAndVisits=Haustiere und Besuche
+error.404=Die angeforderte Seite wurde nicht gefunden.
+error.500=Ein interner Serverfehler ist aufgetreten.
+error.general=Ein unerwarteter Fehler ist aufgetreten.
diff --git a/src/main/resources/messages/messages_es.properties b/src/main/resources/messages/messages_es.properties
index 91d5c9ebd..911d7337f 100644
--- a/src/main/resources/messages/messages_es.properties
+++ b/src/main/resources/messages/messages_es.properties
@@ -46,3 +46,6 @@ visitDate=Fecha de visita
 editOwner=Editar propietario
 addNewPet=Agregar nueva mascota
 petsAndVisits=Mascotas y visitas
+error.404=La página solicitada no fue encontrada.
+error.500=Ocurrió un error interno del servidor.
+error.general=Ocurrió un error inesperado.
diff --git a/src/main/resources/messages/messages_fa.properties b/src/main/resources/messages/messages_fa.properties
index 2566b8949..6d0994a92 100644
--- a/src/main/resources/messages/messages_fa.properties
+++ b/src/main/resources/messages/messages_fa.properties
@@ -46,3 +46,6 @@ visitDate=تاریخ ویزیت
 editOwner=ویرایش مالک
 addNewPet=افزودن حیوان خانگی جدید
 petsAndVisits=حیوانات و ویزیت‌ها
+error.404=صفحه درخواستی پیدا نشد.
+error.500=خطای داخلی سرور رخ داد.
+error.general=خطای غیرمنتظره‌ای رخ داد.
diff --git a/src/main/resources/messages/messages_ko.properties b/src/main/resources/messages/messages_ko.properties
index ca3ae5a05..6e2f4880a 100644
--- a/src/main/resources/messages/messages_ko.properties
+++ b/src/main/resources/messages/messages_ko.properties
@@ -46,3 +46,6 @@ visitDate=방문 날짜
 editOwner=소유자 수정
 addNewPet=새 반려동물 추가
 petsAndVisits=반려동물 및 방문
+error.404=요청하신 페이지를 찾을 수 없습니다.
+error.500=서버 내부 오류가 발생했습니다.
+error.general=알 수 없는 오류가 발생했습니다.
diff --git a/src/main/resources/messages/messages_pt.properties b/src/main/resources/messages/messages_pt.properties
index 03f5cd531..7eea4b9d1 100644
--- a/src/main/resources/messages/messages_pt.properties
+++ b/src/main/resources/messages/messages_pt.properties
@@ -46,3 +46,6 @@ visitDate=Data da visita
 editOwner=Editar proprietário
 addNewPet=Adicionar novo animal
 petsAndVisits=Animais e visitas
+error.404=A página solicitada não foi encontrada.
+error.500=Ocorreu um erro interno no servidor.
+error.general=Ocorreu um erro inesperado.
diff --git a/src/main/resources/messages/messages_ru.properties b/src/main/resources/messages/messages_ru.properties
index b9ed998be..f06d2cb6c 100644
--- a/src/main/resources/messages/messages_ru.properties
+++ b/src/main/resources/messages/messages_ru.properties
@@ -46,3 +46,6 @@ visitDate=Дата визита
 editOwner=Редактировать владельца
 addNewPet=Добавить нового питомца
 petsAndVisits=Питомцы и визиты
+error.404=Запрашиваемая страница не найдена.
+error.500=Произошла внутренняя ошибка сервера.
+error.general=Произошла непредвиденная ошибка.
diff --git a/src/main/resources/messages/messages_tr.properties b/src/main/resources/messages/messages_tr.properties
index ff9ffdabd..2c806f9e6 100644
--- a/src/main/resources/messages/messages_tr.properties
+++ b/src/main/resources/messages/messages_tr.properties
@@ -46,3 +46,6 @@ visitDate=Ziyaret Tarihi
 editOwner=Sahibi Düzenle
 addNewPet=Yeni Evcil Hayvan Ekle
 petsAndVisits=Evcil Hayvanlar ve Ziyaretler
+error.404=İstenen sayfa bulunamadı.
+error.500=Sunucuda dahili bir hata oluştu.
+error.general=Beklenmeyen bir hata oluştu.
diff --git a/src/main/resources/templates/error.html b/src/main/resources/templates/error.html
index 4d76d8d16..5f1d6f3ab 100644
--- a/src/main/resources/templates/error.html
+++ b/src/main/resources/templates/error.html
@@ -4,8 +4,18 @@
 
 <body>
   <img src="../static/resources/images/pets.png" th:src="@{/resources/images/pets.png}" />
+  <!-- Title: Something happened -->
   <h2 th:text="#{somethingHappened}">Something happened...</h2>
+
+  <!-- Status-specific error message -->
+  <p th:switch="${status}">
+    <span th:case="404" th:text="#{error.404}">The requested page was not found.</span>
+    <span th:case="500" th:text="#{error.500}">An internal server error occurred.</span>
+    <span th:case="*" th:text="#{error.general}">An unexpected error occurred.</span>
+  </p>
+
+  <!-- Exception message (for developers) -->
   <p th:text="${message}">Exception message</p>
 </body>
 
-</html>
\ No newline at end of file
+</html>

From 66747e344ec6d4ec5fce2c603c1b61eeeadda8ff Mon Sep 17 00:00:00 2001
From: jang8584 <jang8584@gmail.com>
Date: Thu, 31 Jul 2025 16:08:17 +0900
Subject: [PATCH 06/23] feat: enhance error page with localized messages for
 status codes(1)

Signed-off-by: jang8584 <jang8584@gmail.com>
---
 src/main/resources/messages/messages.properties | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/main/resources/messages/messages.properties b/src/main/resources/messages/messages.properties
index 7b8b5dfd8..193565895 100644
--- a/src/main/resources/messages/messages.properties
+++ b/src/main/resources/messages/messages.properties
@@ -46,3 +46,6 @@ visitDate=Visit Date
 editOwner=Edit Owner
 addNewPet=Add New Pet
 petsAndVisits=Pets and Visits
+error.404=The requested page was not found.
+error.500=An internal server error occurred.
+error.general=An unexpected error occurred.

From 3aa79e3944ab1b626288f5d0629e61643ab8fb4a Mon Sep 17 00:00:00 2001
From: Moritz Halbritter <moritz.halbritter@broadcom.com>
Date: Mon, 1 Sep 2025 17:42:56 +0200
Subject: [PATCH 07/23] Upgrade to Spring Boot 4.0.0-M2

See gh-2016

Signed-off-by: Moritz Halbritter <moritz.halbritter@broadcom.com>
---
 build.gradle                                  |  5 ++-
 pom.xml                                       | 45 +++----------------
 .../petclinic/system/CacheConfiguration.java  |  2 +-
 .../petclinic/MySqlIntegrationTests.java      |  4 +-
 .../petclinic/PetClinicIntegrationTests.java  |  4 +-
 .../petclinic/PostgresIntegrationTests.java   |  4 +-
 .../CrashControllerIntegrationTests.java      |  8 ++--
 7 files changed, 20 insertions(+), 52 deletions(-)

diff --git a/build.gradle b/build.gradle
index 401094108..ea2322320 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,7 +1,7 @@
 plugins {
   id 'java'
   id 'checkstyle'
-  id 'org.springframework.boot' version '3.5.6'
+  id 'org.springframework.boot' version '3.5.0'
   id 'io.spring.dependency-management' version '1.1.7'
   id 'org.graalvm.buildtools.native' version '0.11.1'
   id 'org.cyclonedx.bom' version '3.0.0'
@@ -12,7 +12,7 @@ plugins {
 gradle.startParameter.excludedTaskNames += [ "checkFormatAot", "checkFormatAotTest" ]
 
 group = 'org.springframework.samples'
-version = '3.5.0'
+version = '4.0.0-SNAPSHOT'
 
 java {
   toolchain {
@@ -48,6 +48,7 @@ dependencies {
   runtimeOnly 'org.postgresql:postgresql'
   developmentOnly 'org.springframework.boot:spring-boot-devtools'
   testImplementation 'org.springframework.boot:spring-boot-starter-test'
+  testImplementation 'org.springframework.boot:spring-boot-starter-restclient'
   testImplementation 'org.springframework.boot:spring-boot-testcontainers'
   testImplementation 'org.springframework.boot:spring-boot-docker-compose'
   testImplementation 'org.testcontainers:junit-jupiter'
diff --git a/pom.xml b/pom.xml
index 004709a9b..08367b32e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,13 +5,13 @@
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
-    <version>3.5.6</version>
+    <version>4.0.0-M2</version>
     <relativePath></relativePath>
   </parent>
 
   <groupId>org.springframework.samples</groupId>
   <artifactId>spring-petclinic</artifactId>
-  <version>3.5.0-SNAPSHOT</version>
+  <version>4.0.0-SNAPSHOT</version>
 
   <name>petclinic</name>
 
@@ -69,6 +69,10 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-test</artifactId>
       <scope>test</scope>
+    </dependency>    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-restclient</artifactId>
+      <scope>test</scope>
     </dependency>
 
     <!-- Databases - Uses H2 by default -->
@@ -288,43 +292,6 @@
     </license>
   </licenses>
 
-  <repositories>
-    <repository>
-      <snapshots>
-        <enabled>true</enabled>
-      </snapshots>
-      <id>spring-snapshots</id>
-      <name>Spring Snapshots</name>
-      <url>https://repo.spring.io/snapshot</url>
-    </repository>
-    <repository>
-      <snapshots>
-        <enabled>false</enabled>
-      </snapshots>
-      <id>spring-milestones</id>
-      <name>Spring Milestones</name>
-      <url>https://repo.spring.io/milestone</url>
-    </repository>
-  </repositories>
-  <pluginRepositories>
-    <pluginRepository>
-      <snapshots>
-        <enabled>true</enabled>
-      </snapshots>
-      <id>spring-snapshots</id>
-      <name>Spring Snapshots</name>
-      <url>https://repo.spring.io/snapshot</url>
-    </pluginRepository>
-    <pluginRepository>
-      <snapshots>
-        <enabled>false</enabled>
-      </snapshots>
-      <id>spring-milestones</id>
-      <name>Spring Milestones</name>
-      <url>https://repo.spring.io/milestone</url>
-    </pluginRepository>
-  </pluginRepositories>
-
   <profiles>
     <profile>
       <id>css</id>
diff --git a/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java b/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java
index 1382f3aea..13cb74301 100644
--- a/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java
+++ b/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java
@@ -16,7 +16,7 @@
 
 package org.springframework.samples.petclinic.system;
 
-import org.springframework.boot.autoconfigure.cache.JCacheManagerCustomizer;
+import org.springframework.boot.cache.autoconfigure.JCacheManagerCustomizer;
 import org.springframework.cache.annotation.EnableCaching;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
diff --git a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
index a78e2e6e1..92fbf1d6d 100644
--- a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
@@ -21,11 +21,11 @@ import static org.assertj.core.api.Assertions.assertThat;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
-import org.springframework.boot.test.web.server.LocalServerPort;
 import org.springframework.boot.testcontainers.service.connection.ServiceConnection;
-import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.boot.web.server.test.LocalServerPort;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.RequestEntity;
 import org.springframework.http.ResponseEntity;
diff --git a/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
index 617af9652..002822ee6 100644
--- a/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
@@ -21,10 +21,10 @@ import static org.assertj.core.api.Assertions.assertThat;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.SpringApplication;
+import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
-import org.springframework.boot.test.web.server.LocalServerPort;
-import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.boot.web.server.test.LocalServerPort;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.RequestEntity;
 import org.springframework.http.ResponseEntity;
diff --git a/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
index 709d33e66..a9b51c07b 100644
--- a/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
@@ -32,10 +32,10 @@ import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.builder.SpringApplicationBuilder;
 import org.springframework.boot.context.event.ApplicationPreparedEvent;
+import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
-import org.springframework.boot.test.web.server.LocalServerPort;
-import org.springframework.boot.web.client.RestTemplateBuilder;
+import org.springframework.boot.web.server.test.LocalServerPort;
 import org.springframework.context.ApplicationListener;
 import org.springframework.core.env.ConfigurableEnvironment;
 import org.springframework.core.env.EnumerablePropertySource;
diff --git a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
index ed8b0819a..2d1ac0dd0 100644
--- a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
@@ -26,11 +26,11 @@ import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
-import org.springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration;
-import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration;
+import org.springframework.boot.hibernate.autoconfigure.HibernateJpaAutoConfiguration;
+import org.springframework.boot.jdbc.autoconfigure.DataSourceAutoConfiguration;
+import org.springframework.boot.jdbc.autoconfigure.DataSourceTransactionManagerAutoConfiguration;
 import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.boot.test.web.client.TestRestTemplate;
+import org.springframework.boot.web.server.test.client.TestRestTemplate;
 import org.springframework.core.ParameterizedTypeReference;
 import org.springframework.http.HttpEntity;
 import org.springframework.http.HttpHeaders;

From a0aea8e8f8ccc8ff85e97f418484ca9d0d29012f Mon Sep 17 00:00:00 2001
From: Moritz Halbritter <moritz.halbritter@broadcom.com>
Date: Tue, 2 Sep 2025 13:12:56 +0200
Subject: [PATCH 08/23] Add NullAway and JSpecify annotations

See gh-2016

Signed-off-by: Moritz Halbritter <moritz.halbritter@broadcom.com>
---
 .github/workflows/gradle-build.yml            |  2 +-
 .github/workflows/maven-build.yml             |  2 +-
 .mvn/jvm.config                               | 10 +++++
 build.gradle                                  | 22 ++++++++++-
 pom.xml                                       | 37 ++++++++++++++++++-
 .../petclinic/PetClinicRuntimeHints.java      |  4 +-
 .../samples/petclinic/model/BaseEntity.java   |  7 ++--
 .../samples/petclinic/model/NamedEntity.java  | 10 +++--
 .../samples/petclinic/model/Person.java       | 13 ++++---
 .../samples/petclinic/model/package-info.java |  3 ++
 .../samples/petclinic/owner/Owner.java        | 28 +++++++-------
 .../petclinic/owner/OwnerController.java      | 14 ++++---
 .../petclinic/owner/OwnerRepository.java      |  2 +-
 .../samples/petclinic/owner/Pet.java          | 13 ++++---
 .../petclinic/owner/PetController.java        | 14 +++++--
 .../petclinic/owner/PetTypeFormatter.java     |  6 ++-
 .../samples/petclinic/owner/Visit.java        | 13 ++++---
 .../petclinic/owner/VisitController.java      |  4 ++
 .../samples/petclinic/owner/package-info.java |  4 ++
 .../samples/petclinic/package-info.java       |  4 ++
 .../petclinic/system/package-info.java        |  4 ++
 .../samples/petclinic/vet/Vet.java            |  3 +-
 .../samples/petclinic/vet/Vets.java           |  3 +-
 .../samples/petclinic/vet/package-info.java   |  4 ++
 .../petclinic/service/ClinicServiceTests.java |  2 +-
 .../petclinic/service/EntityUtils.java        |  2 +-
 26 files changed, 171 insertions(+), 59 deletions(-)
 create mode 100644 .mvn/jvm.config
 create mode 100644 src/main/java/org/springframework/samples/petclinic/owner/package-info.java
 create mode 100644 src/main/java/org/springframework/samples/petclinic/package-info.java
 create mode 100644 src/main/java/org/springframework/samples/petclinic/system/package-info.java
 create mode 100644 src/main/java/org/springframework/samples/petclinic/vet/package-info.java

diff --git a/.github/workflows/gradle-build.yml b/.github/workflows/gradle-build.yml
index c24c121b1..fcf8c2d61 100644
--- a/.github/workflows/gradle-build.yml
+++ b/.github/workflows/gradle-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '17' ]
+        java: [ '24' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/maven-build.yml b/.github/workflows/maven-build.yml
index a1ec4dab7..306d9da97 100644
--- a/.github/workflows/maven-build.yml
+++ b/.github/workflows/maven-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '17' ]
+        java: [ '24' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.mvn/jvm.config b/.mvn/jvm.config
new file mode 100644
index 000000000..32599cefe
--- /dev/null
+++ b/.mvn/jvm.config
@@ -0,0 +1,10 @@
+--add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED
+--add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED
+--add-opens jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED
+--add-opens jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED
diff --git a/build.gradle b/build.gradle
index ea2322320..7d2eefdd6 100644
--- a/build.gradle
+++ b/build.gradle
@@ -7,6 +7,7 @@ plugins {
   id 'org.cyclonedx.bom' version '3.0.0'
   id 'io.spring.javaformat' version '0.0.47'
   id "io.spring.nohttp" version "0.0.11"
+  id 'net.ltgt.errorprone' version '4.3.0'
 }
 
 gradle.startParameter.excludedTaskNames += [ "checkFormatAot", "checkFormatAotTest" ]
@@ -16,7 +17,7 @@ version = '4.0.0-SNAPSHOT'
 
 java {
   toolchain {
-    languageVersion = JavaLanguageVersion.of(17)
+    languageVersion = JavaLanguageVersion.of(24)
   }
 }
 
@@ -29,6 +30,8 @@ ext.springJavaformatCheckstyleVersion = "0.0.47"
 ext.webjarsLocatorLiteVersion = "1.1.1"
 ext.webjarsFontawesomeVersion = "4.7.0"
 ext.webjarsBootstrapVersion = "5.3.8"
+ext.errorProneVersion = "2.41.0"
+ext.nullAwayVersion = "0.12.9"
 
 dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
@@ -55,6 +58,8 @@ dependencies {
   testImplementation 'org.testcontainers:mysql'
   checkstyle "io.spring.javaformat:spring-javaformat-checkstyle:${springJavaformatCheckstyleVersion}"
   checkstyle "com.puppycrawl.tools:checkstyle:${checkstyleVersion}"
+  errorprone "com.google.errorprone:error_prone_core:${errorProneVersion}"
+  errorprone "com.uber.nullaway:nullaway:${nullAwayVersion}"
 }
 
 tasks.named('test') {
@@ -71,6 +76,21 @@ checkstyleNohttp {
   configFile = file('src/checkstyle/nohttp-checkstyle.xml')
 }
 
+tasks.withType(JavaCompile).configureEach {
+  options.release = 17
+  options.errorprone {
+    disableAllChecks = true
+  }
+  if (name.equals("compileJava")) {
+    options.errorprone {
+      error("NullAway")
+      option("NullAway:OnlyNullMarked", "true")
+      option("NullAway:CustomContractAnnotations", "org.springframework.lang.Contract")
+      option("NullAway:JSpecifyMode", "true")
+    }
+  }
+}
+
 tasks.named("formatMain").configure { dependsOn("checkstyleMain") }
 tasks.named("formatMain").configure { dependsOn("checkstyleNohttp") }
 
diff --git a/pom.xml b/pom.xml
index 08367b32e..189ea605e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -18,7 +18,8 @@
   <properties>
 
     <!-- Generic properties -->
-    <java.version>17</java.version>
+    <java.version>24</java.version>
+    <maven.compiler.release>17</maven.compiler.release>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <!-- Important for reproducible builds. Update using e.g. ./mvnw versions:set -DnewVersion=... -->
@@ -37,6 +38,8 @@
     <nohttp-checkstyle.version>0.0.11</nohttp-checkstyle.version>
     <spring-format.version>0.0.47</spring-format.version>
 
+    <error-prone.version>2.41.0</error-prone.version>
+    <nullaway.version>0.12.9</nullaway.version>
   </properties>
 
   <dependencies>
@@ -275,6 +278,38 @@
           <failOnUnableToExtractRepoInfo>false</failOnUnableToExtractRepoInfo>
         </configuration>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <executions>
+          <execution>
+            <id>default-compile</id>
+            <phase>compile</phase>
+            <goals>
+              <goal>compile</goal>
+            </goals>
+            <configuration>
+              <compilerArgs>
+                <arg>-XDcompilePolicy=simple</arg>
+                <arg>--should-stop=ifError=FLOW</arg>
+                <arg>-Xplugin:ErrorProne -XepDisableAllChecks -Xep:NullAway:ERROR -XepOpt:NullAway:OnlyNullMarked=true -XepOpt:NullAway:CustomContractAnnotations=org.springframework.lang.Contract -XepOpt:NullAway:JSpecifyMode=true</arg>
+              </compilerArgs>
+              <annotationProcessorPaths>
+                <path>
+                  <groupId>com.google.errorprone</groupId>
+                  <artifactId>error_prone_core</artifactId>
+                  <version>${error-prone.version}</version>
+                </path>
+                <path>
+                  <groupId>com.uber.nullaway</groupId>
+                  <artifactId>nullaway</artifactId>
+                  <version>${nullaway.version}</version>
+                </path>
+              </annotationProcessorPaths>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
       <!-- Spring Boot Actuator displays sbom-related information if a CycloneDX SBOM file is
       present at the classpath -->
       <plugin>
diff --git a/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java b/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
index 4999f4c3c..63b15b49e 100644
--- a/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
+++ b/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
@@ -16,6 +16,8 @@
 
 package org.springframework.samples.petclinic;
 
+import org.jspecify.annotations.Nullable;
+
 import org.springframework.aot.hint.RuntimeHints;
 import org.springframework.aot.hint.RuntimeHintsRegistrar;
 import org.springframework.samples.petclinic.model.BaseEntity;
@@ -25,7 +27,7 @@ import org.springframework.samples.petclinic.vet.Vet;
 public class PetClinicRuntimeHints implements RuntimeHintsRegistrar {
 
 	@Override
-	public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
+	public void registerHints(RuntimeHints hints, @Nullable ClassLoader classLoader) {
 		hints.resources().registerPattern("db/*"); // https://github.com/spring-projects/spring-boot/issues/32654
 		hints.resources().registerPattern("messages/*");
 		hints.resources().registerPattern("mysql-default-conf");
diff --git a/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java b/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
index 6babed56d..45255a40a 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
@@ -21,6 +21,7 @@ import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 import jakarta.persistence.MappedSuperclass;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object with an id property. Used as a base class for objects
@@ -34,13 +35,13 @@ public class BaseEntity implements Serializable {
 
 	@Id
 	@GeneratedValue(strategy = GenerationType.IDENTITY)
-	private Integer id;
+	private @Nullable Integer id;
 
-	public Integer getId() {
+	public @Nullable Integer getId() {
 		return id;
 	}
 
-	public void setId(Integer id) {
+	public void setId(@Nullable Integer id) {
 		this.id = id;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
index d4be03e9e..536271d7f 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
@@ -18,6 +18,7 @@ package org.springframework.samples.petclinic.model;
 import jakarta.persistence.Column;
 import jakarta.persistence.MappedSuperclass;
 import jakarta.validation.constraints.NotBlank;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object adds a name property to <code>BaseEntity</code>. Used as
@@ -32,19 +33,20 @@ public class NamedEntity extends BaseEntity {
 
 	@Column(name = "name")
 	@NotBlank
-	private String name;
+	private @Nullable String name;
 
-	public String getName() {
+	public @Nullable String getName() {
 		return this.name;
 	}
 
-	public void setName(String name) {
+	public void setName(@Nullable String name) {
 		this.name = name;
 	}
 
 	@Override
 	public String toString() {
-		return this.getName();
+		String name = this.getName();
+		return (name != null) ? name : "<null>";
 	}
 
 }
diff --git a/src/main/java/org/springframework/samples/petclinic/model/Person.java b/src/main/java/org/springframework/samples/petclinic/model/Person.java
index 7ee1f0397..6513b0866 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/Person.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/Person.java
@@ -18,6 +18,7 @@ package org.springframework.samples.petclinic.model;
 import jakarta.persistence.Column;
 import jakarta.persistence.MappedSuperclass;
 import jakarta.validation.constraints.NotBlank;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing an person.
@@ -29,25 +30,25 @@ public class Person extends BaseEntity {
 
 	@Column(name = "first_name")
 	@NotBlank
-	private String firstName;
+	private @Nullable String firstName;
 
 	@Column(name = "last_name")
 	@NotBlank
-	private String lastName;
+	private @Nullable String lastName;
 
-	public String getFirstName() {
+	public @Nullable String getFirstName() {
 		return this.firstName;
 	}
 
-	public void setFirstName(String firstName) {
+	public void setFirstName(@Nullable String firstName) {
 		this.firstName = firstName;
 	}
 
-	public String getLastName() {
+	public @Nullable String getLastName() {
 		return this.lastName;
 	}
 
-	public void setLastName(String lastName) {
+	public void setLastName(@Nullable String lastName) {
 		this.lastName = lastName;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/package-info.java b/src/main/java/org/springframework/samples/petclinic/model/package-info.java
index e8982c3d4..f878fe8b7 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/package-info.java
@@ -17,4 +17,7 @@
 /**
  * The classes in this package represent utilities used by the domain.
  */
+@NullMarked
 package org.springframework.samples.petclinic.model;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
index 63e3acc7a..000c06292 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
@@ -17,6 +17,7 @@ package org.springframework.samples.petclinic.owner;
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Objects;
 
 import org.springframework.core.style.ToStringCreator;
 import org.springframework.samples.petclinic.model.Person;
@@ -32,6 +33,7 @@ import jakarta.persistence.OrderBy;
 import jakarta.persistence.Table;
 import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.NotBlank;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing an owner.
@@ -49,43 +51,43 @@ public class Owner extends Person {
 
 	@Column(name = "address")
 	@NotBlank
-	private String address;
+	private @Nullable String address;
 
 	@Column(name = "city")
 	@NotBlank
-	private String city;
+	private @Nullable String city;
 
 	@Column(name = "telephone")
 	@NotBlank
 	@Pattern(regexp = "\\d{10}", message = "{telephone.invalid}")
-	private String telephone;
+	private @Nullable String telephone;
 
 	@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
 	@JoinColumn(name = "owner_id")
 	@OrderBy("name")
 	private final List<Pet> pets = new ArrayList<>();
 
-	public String getAddress() {
+	public @Nullable String getAddress() {
 		return this.address;
 	}
 
-	public void setAddress(String address) {
+	public void setAddress(@Nullable String address) {
 		this.address = address;
 	}
 
-	public String getCity() {
+	public @Nullable String getCity() {
 		return this.city;
 	}
 
-	public void setCity(String city) {
+	public void setCity(@Nullable String city) {
 		this.city = city;
 	}
 
-	public String getTelephone() {
+	public @Nullable String getTelephone() {
 		return this.telephone;
 	}
 
-	public void setTelephone(String telephone) {
+	public void setTelephone(@Nullable String telephone) {
 		this.telephone = telephone;
 	}
 
@@ -104,7 +106,7 @@ public class Owner extends Person {
 	 * @param name to test
 	 * @return the Pet with the given name, or null if no such Pet exists for this Owner
 	 */
-	public Pet getPet(String name) {
+	public @Nullable Pet getPet(String name) {
 		return getPet(name, false);
 	}
 
@@ -113,11 +115,11 @@ public class Owner extends Person {
 	 * @param id to test
 	 * @return the Pet with the given id, or null if no such Pet exists for this Owner
 	 */
-	public Pet getPet(Integer id) {
+	public @Nullable Pet getPet(Integer id) {
 		for (Pet pet : getPets()) {
 			if (!pet.isNew()) {
 				Integer compId = pet.getId();
-				if (compId.equals(id)) {
+				if (Objects.equals(compId, id)) {
 					return pet;
 				}
 			}
@@ -131,7 +133,7 @@ public class Owner extends Person {
 	 * @param ignoreNew whether to ignore new pets (pets that are not saved yet)
 	 * @return the Pet with the given name, or null if no such Pet exists for this Owner
 	 */
-	public Pet getPet(String name, boolean ignoreNew) {
+	public @Nullable Pet getPet(String name, boolean ignoreNew) {
 		for (Pet pet : getPets()) {
 			String compName = pet.getName();
 			if (compName != null && compName.equalsIgnoreCase(name)) {
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java b/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
index 1348457ee..41b99619e 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
@@ -16,6 +16,7 @@
 package org.springframework.samples.petclinic.owner;
 
 import java.util.List;
+import java.util.Objects;
 import java.util.Optional;
 
 import org.springframework.data.domain.Page;
@@ -34,6 +35,8 @@ import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.servlet.ModelAndView;
 
 import jakarta.validation.Valid;
+import org.jspecify.annotations.Nullable;
+
 import org.springframework.web.servlet.mvc.support.RedirectAttributes;
 
 /**
@@ -60,7 +63,7 @@ class OwnerController {
 	}
 
 	@ModelAttribute("owner")
-	public Owner findOwner(@PathVariable(name = "ownerId", required = false) Integer ownerId) {
+	public Owner findOwner(@PathVariable(name = "ownerId", required = false) @Nullable Integer ownerId) {
 		return ownerId == null ? new Owner()
 				: this.owners.findById(ownerId)
 					.orElseThrow(() -> new IllegalArgumentException("Owner not found with id: " + ownerId
@@ -93,12 +96,13 @@ class OwnerController {
 	public String processFindForm(@RequestParam(defaultValue = "1") int page, Owner owner, BindingResult result,
 			Model model) {
 		// allow parameterless GET request for /owners to return all records
-		if (owner.getLastName() == null) {
-			owner.setLastName(""); // empty string signifies broadest possible search
+		String lastName = owner.getLastName();
+		if (lastName == null) {
+			lastName = ""; // empty string signifies broadest possible search
 		}
 
 		// find owners by last name
-		Page<Owner> ownersResults = findPaginatedForOwnersLastName(page, owner.getLastName());
+		Page<Owner> ownersResults = findPaginatedForOwnersLastName(page, lastName);
 		if (ownersResults.isEmpty()) {
 			// no owners found
 			result.rejectValue("lastName", "notFound", "not found");
@@ -143,7 +147,7 @@ class OwnerController {
 			return VIEWS_OWNER_CREATE_OR_UPDATE_FORM;
 		}
 
-		if (owner.getId() != ownerId) {
+		if (!Objects.equals(owner.getId(), ownerId)) {
 			result.rejectValue("id", "mismatch", "The owner ID in the form does not match the URL.");
 			redirectAttributes.addFlashAttribute("error", "Owner ID mismatch. Please try again.");
 			return "redirect:/owners/{ownerId}/edit";
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
index d26bdb62f..e0e9b2f0b 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
@@ -58,6 +58,6 @@ public interface OwnerRepository extends JpaRepository<Owner, Integer> {
 	 * @throws IllegalArgumentException if the id is null (assuming null is not a valid
 	 * input for id)
 	 */
-	Optional<Owner> findById(@Nonnull Integer id);
+	Optional<Owner> findById(Integer id);
 
 }
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
index 1945f9b67..7af9e5b4f 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
@@ -32,6 +32,7 @@ import jakarta.persistence.ManyToOne;
 import jakarta.persistence.OneToMany;
 import jakarta.persistence.OrderBy;
 import jakarta.persistence.Table;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple business object representing a pet.
@@ -47,30 +48,30 @@ public class Pet extends NamedEntity {
 
 	@Column(name = "birth_date")
 	@DateTimeFormat(pattern = "yyyy-MM-dd")
-	private LocalDate birthDate;
+	private @Nullable LocalDate birthDate;
 
 	@ManyToOne
 	@JoinColumn(name = "type_id")
-	private PetType type;
+	private @Nullable PetType type;
 
 	@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
 	@JoinColumn(name = "pet_id")
 	@OrderBy("date ASC")
 	private final Set<Visit> visits = new LinkedHashSet<>();
 
-	public void setBirthDate(LocalDate birthDate) {
+	public void setBirthDate(@Nullable LocalDate birthDate) {
 		this.birthDate = birthDate;
 	}
 
-	public LocalDate getBirthDate() {
+	public @Nullable LocalDate getBirthDate() {
 		return this.birthDate;
 	}
 
-	public PetType getType() {
+	public @Nullable PetType getType() {
 		return this.type;
 	}
 
-	public void setType(PetType type) {
+	public void setType(@Nullable PetType type) {
 		this.type = type;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/PetController.java b/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
index 56707d99f..b7274080e 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
@@ -17,10 +17,12 @@ package org.springframework.samples.petclinic.owner;
 
 import java.time.LocalDate;
 import java.util.Collection;
+import java.util.Objects;
 import java.util.Optional;
 
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.ModelMap;
+import org.springframework.util.Assert;
 import org.springframework.util.StringUtils;
 import org.springframework.validation.BindingResult;
 import org.springframework.web.bind.WebDataBinder;
@@ -32,6 +34,8 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 
 import jakarta.validation.Valid;
+import org.jspecify.annotations.Nullable;
+
 import org.springframework.web.servlet.mvc.support.RedirectAttributes;
 
 /**
@@ -69,8 +73,8 @@ class PetController {
 	}
 
 	@ModelAttribute("pet")
-	public Pet findPet(@PathVariable("ownerId") int ownerId,
-			@PathVariable(name = "petId", required = false) Integer petId) {
+	public @Nullable Pet findPet(@PathVariable("ownerId") int ownerId,
+			@PathVariable(name = "petId", required = false) @Nullable Integer petId) {
 
 		if (petId == null) {
 			return new Pet();
@@ -135,7 +139,7 @@ class PetController {
 		// checking if the pet name already exists for the owner
 		if (StringUtils.hasText(petName)) {
 			Pet existingPet = owner.getPet(petName, false);
-			if (existingPet != null && !existingPet.getId().equals(pet.getId())) {
+			if (existingPet != null && !Objects.equals(existingPet.getId(), pet.getId())) {
 				result.rejectValue("name", "duplicate", "already exists");
 			}
 		}
@@ -160,7 +164,9 @@ class PetController {
 	 * @param pet The pet with updated details
 	 */
 	private void updatePetDetails(Owner owner, Pet pet) {
-		Pet existingPet = owner.getPet(pet.getId());
+		Integer id = pet.getId();
+		Assert.state(id != null, "'pet.getId()' must not be null");
+		Pet existingPet = owner.getPet(id);
 		if (existingPet != null) {
 			// Update existing pet's properties
 			existingPet.setName(pet.getName());
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/PetTypeFormatter.java b/src/main/java/org/springframework/samples/petclinic/owner/PetTypeFormatter.java
index 7ddc6e923..b62751c97 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/PetTypeFormatter.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/PetTypeFormatter.java
@@ -21,6 +21,7 @@ import org.springframework.stereotype.Component;
 import java.text.ParseException;
 import java.util.Collection;
 import java.util.Locale;
+import java.util.Objects;
 
 /**
  * Instructs Spring MVC on how to parse and print elements of type 'PetType'. Starting
@@ -43,14 +44,15 @@ public class PetTypeFormatter implements Formatter<PetType> {
 
 	@Override
 	public String print(PetType petType, Locale locale) {
-		return petType.getName();
+		String name = petType.getName();
+		return (name != null) ? name : "<null>";
 	}
 
 	@Override
 	public PetType parse(String text, Locale locale) throws ParseException {
 		Collection<PetType> findPetTypes = this.types.findPetTypes();
 		for (PetType type : findPetTypes) {
-			if (type.getName().equals(text)) {
+			if (Objects.equals(type.getName(), text)) {
 				return type;
 			}
 		}
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Visit.java b/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
index 085cd2849..7259fab9f 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
@@ -24,6 +24,7 @@ import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.Table;
 import jakarta.validation.constraints.NotBlank;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing a visit.
@@ -37,10 +38,10 @@ public class Visit extends BaseEntity {
 
 	@Column(name = "visit_date")
 	@DateTimeFormat(pattern = "yyyy-MM-dd")
-	private LocalDate date;
+	private @Nullable LocalDate date;
 
 	@NotBlank
-	private String description;
+	private @Nullable String description;
 
 	/**
 	 * Creates a new instance of Visit for the current date
@@ -49,19 +50,19 @@ public class Visit extends BaseEntity {
 		this.date = LocalDate.now();
 	}
 
-	public LocalDate getDate() {
+	public @Nullable LocalDate getDate() {
 		return this.date;
 	}
 
-	public void setDate(LocalDate date) {
+	public void setDate(@Nullable LocalDate date) {
 		this.date = date;
 	}
 
-	public String getDescription() {
+	public @Nullable String getDescription() {
 		return this.description;
 	}
 
-	public void setDescription(String description) {
+	public void setDescription(@Nullable String description) {
 		this.description = description;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java b/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java
index 21c1823a5..cc3e3ce1a 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/VisitController.java
@@ -67,6 +67,10 @@ class VisitController {
 				"Owner not found with id: " + ownerId + ". Please ensure the ID is correct "));
 
 		Pet pet = owner.getPet(petId);
+		if (pet == null) {
+			throw new IllegalArgumentException(
+					"Pet with id " + petId + " not found for owner with id " + ownerId + ".");
+		}
 		model.put("pet", pet);
 		model.put("owner", owner);
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/package-info.java b/src/main/java/org/springframework/samples/petclinic/owner/package-info.java
new file mode 100644
index 000000000..ef080a0d6
--- /dev/null
+++ b/src/main/java/org/springframework/samples/petclinic/owner/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package org.springframework.samples.petclinic.owner;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/package-info.java b/src/main/java/org/springframework/samples/petclinic/package-info.java
new file mode 100644
index 000000000..c8261d8f0
--- /dev/null
+++ b/src/main/java/org/springframework/samples/petclinic/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package org.springframework.samples.petclinic;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/system/package-info.java b/src/main/java/org/springframework/samples/petclinic/system/package-info.java
new file mode 100644
index 000000000..25da176d0
--- /dev/null
+++ b/src/main/java/org/springframework/samples/petclinic/system/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package org.springframework.samples.petclinic.system;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/Vet.java b/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
index fb2bd71ee..c8bd549d5 100644
--- a/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
+++ b/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
@@ -31,6 +31,7 @@ import jakarta.persistence.JoinTable;
 import jakarta.persistence.ManyToMany;
 import jakarta.persistence.Table;
 import jakarta.xml.bind.annotation.XmlElement;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing a veterinarian.
@@ -47,7 +48,7 @@ public class Vet extends Person {
 	@ManyToMany(fetch = FetchType.EAGER)
 	@JoinTable(name = "vet_specialties", joinColumns = @JoinColumn(name = "vet_id"),
 			inverseJoinColumns = @JoinColumn(name = "specialty_id"))
-	private Set<Specialty> specialties;
+	private @Nullable Set<Specialty> specialties;
 
 	protected Set<Specialty> getSpecialtiesInternal() {
 		if (this.specialties == null) {
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/Vets.java b/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
index 634cad773..a3292927a 100644
--- a/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
+++ b/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
@@ -20,6 +20,7 @@ import java.util.List;
 
 import jakarta.xml.bind.annotation.XmlElement;
 import jakarta.xml.bind.annotation.XmlRootElement;
+import org.jspecify.annotations.Nullable;
 
 /**
  * Simple domain object representing a list of veterinarians. Mostly here to be used for
@@ -30,7 +31,7 @@ import jakarta.xml.bind.annotation.XmlRootElement;
 @XmlRootElement
 public class Vets {
 
-	private List<Vet> vets;
+	private @Nullable List<Vet> vets;
 
 	@XmlElement
 	public List<Vet> getVetList() {
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/package-info.java b/src/main/java/org/springframework/samples/petclinic/vet/package-info.java
new file mode 100644
index 000000000..6fbc63698
--- /dev/null
+++ b/src/main/java/org/springframework/samples/petclinic/vet/package-info.java
@@ -0,0 +1,4 @@
+@NullMarked
+package org.springframework.samples.petclinic.vet;
+
+import org.jspecify.annotations.NullMarked;
diff --git a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
index 4c78ab317..f1cabaf3c 100644
--- a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
@@ -82,7 +82,7 @@ class ClinicServiceTests {
 	@Autowired
 	protected VetRepository vets;
 
-	Pageable pageable;
+	private final Pageable pageable = Pageable.unpaged();
 
 	@Test
 	void shouldFindOwnersByLastName() {
diff --git a/src/test/java/org/springframework/samples/petclinic/service/EntityUtils.java b/src/test/java/org/springframework/samples/petclinic/service/EntityUtils.java
index 180ef07f1..d1ce9d74f 100644
--- a/src/test/java/org/springframework/samples/petclinic/service/EntityUtils.java
+++ b/src/test/java/org/springframework/samples/petclinic/service/EntityUtils.java
@@ -43,7 +43,7 @@ public abstract class EntityUtils {
 	public static <T extends BaseEntity> T getById(Collection<T> entities, Class<T> entityClass, int entityId)
 			throws ObjectRetrievalFailureException {
 		for (T entity : entities) {
-			if (entity.getId() == entityId && entityClass.isInstance(entity)) {
+			if (entity.getId() != null && entity.getId() == entityId && entityClass.isInstance(entity)) {
 				return entity;
 			}
 		}

From 47be0ea24f3dc33975d8a68173697a144c59a08c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Tue, 14 Oct 2025 12:14:25 +0200
Subject: [PATCH 09/23] Upgrade to Spring Boot 4.0.0-M3

On the heels of the Spring Boot 4 upgrade, this commit upgrade to the
latest milestone and align the errorprone and NullAway versions.

See gh-2016
---
 README.md    |  5 +++--
 build.gradle |  6 +++---
 pom.xml      | 10 +++++-----
 3 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 1b983ee96..2a756bbf9 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,8 @@ See the presentation here:
 
 ## Run Petclinic locally
 
-Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/). You can build a JAR file and run it from the command line (it should work just as well with Java 17 or newer):
+Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/).
+Java 24 or later is required for the build, but the application can run with Java 17 or newer:
 
 ```bash
 git clone https://github.com/spring-projects/spring-petclinic.git
@@ -97,7 +98,7 @@ There is a `petclinic.css` in `src/main/resources/static/resources/css`. It was
 
 The following items should be installed in your system:
 
-- Java 17 or newer (full JDK, not a JRE)
+- Java 24 or newer (full JDK, not a JRE)
 - [Git command line tool](https://help.github.com/articles/set-up-git)
 - Your preferred IDE
   - Eclipse with the m2e plugin. Note: when m2e is available, there is an m2 icon in `Help -> About` dialog. If m2e is
diff --git a/build.gradle b/build.gradle
index 7d2eefdd6..cf980abe1 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,7 +1,7 @@
 plugins {
   id 'java'
   id 'checkstyle'
-  id 'org.springframework.boot' version '3.5.0'
+  id 'org.springframework.boot' version '4.0.0-M3'
   id 'io.spring.dependency-management' version '1.1.7'
   id 'org.graalvm.buildtools.native' version '0.11.1'
   id 'org.cyclonedx.bom' version '3.0.0'
@@ -30,8 +30,8 @@ ext.springJavaformatCheckstyleVersion = "0.0.47"
 ext.webjarsLocatorLiteVersion = "1.1.1"
 ext.webjarsFontawesomeVersion = "4.7.0"
 ext.webjarsBootstrapVersion = "5.3.8"
-ext.errorProneVersion = "2.41.0"
-ext.nullAwayVersion = "0.12.9"
+ext.errorProneVersion = "2.42.0"
+ext.nullAwayVersion = "0.12.10"
 
 dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
diff --git a/pom.xml b/pom.xml
index 189ea605e..b3b9e3783 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
-    <version>4.0.0-M2</version>
+    <version>4.0.0-M3</version>
     <relativePath></relativePath>
   </parent>
 
@@ -31,15 +31,14 @@
     <webjars-font-awesome.version>4.7.0</webjars-font-awesome.version>
 
     <checkstyle.version>11.1.0</checkstyle.version>
+    <error-prone.version>2.42.0</error-prone.version>
     <jacoco.version>0.8.13</jacoco.version>
     <libsass.version>0.3.4</libsass.version>
     <lifecycle-mapping>1.0.0</lifecycle-mapping>
     <maven-checkstyle.version>3.6.0</maven-checkstyle.version>
     <nohttp-checkstyle.version>0.0.11</nohttp-checkstyle.version>
+    <nullaway.version>0.12.10</nullaway.version>
     <spring-format.version>0.0.47</spring-format.version>
-
-    <error-prone.version>2.41.0</error-prone.version>
-    <nullaway.version>0.12.9</nullaway.version>
   </properties>
 
   <dependencies>
@@ -72,7 +71,8 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-test</artifactId>
       <scope>test</scope>
-    </dependency>    <dependency>
+    </dependency>
+    <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-restclient</artifactId>
       <scope>test</scope>

From 7deaa78575fa9f967256302cc6a5e2487bb31162 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Tue, 14 Oct 2025 12:30:53 +0200
Subject: [PATCH 10/23] Upgrade to Gradle 9.1.0

Closes gh-2100
---
 gradle/wrapper/gradle-wrapper.jar        | Bin 43764 -> 45457 bytes
 gradle/wrapper/gradle-wrapper.properties |   2 +-
 gradlew                                  |   5 +----
 gradlew.bat                              |   3 +--
 4 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index 1b33c55baabb587c669f562ae36f953de2481846..8bdaf60c75ab801e22807dde59e12a8735a34077 100644
GIT binary patch
delta 37256
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

delta 35551
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

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index d4081da47..2e1113280 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
diff --git a/gradlew b/gradlew
index 23d15a936..adff685a0 100755
--- a/gradlew
+++ b/gradlew
@@ -1,7 +1,7 @@
 #!/bin/sh
 
 #
-# Copyright © 2015-2021 the original authors.
+# Copyright © 2015 the original authors.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -114,7 +114,6 @@ case "$( uname )" in                #(
   NONSTOP* )        nonstop=true ;;
 esac
 
-CLASSPATH="\\\"\\\""
 
 
 # Determine the Java command to use to start the JVM.
@@ -172,7 +171,6 @@ fi
 # For Cygwin or MSYS, switch paths to Windows format before running java
 if "$cygwin" || "$msys" ; then
     APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
-    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
 
     JAVACMD=$( cygpath --unix "$JAVACMD" )
 
@@ -212,7 +210,6 @@ DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
 set -- \
         "-Dorg.gradle.appname=$APP_BASE_NAME" \
-        -classpath "$CLASSPATH" \
         -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
         "$@"
 
diff --git a/gradlew.bat b/gradlew.bat
index db3a6ac20..c4bdd3ab8 100644
--- a/gradlew.bat
+++ b/gradlew.bat
@@ -70,11 +70,10 @@ goto fail
 :execute
 @rem Setup the command line
 
-set CLASSPATH=
 
 
 @rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
 
 :end
 @rem End local scope for the variables with windows NT shell

From 6feeae0f13e0e258eedc99832416b42bb13779b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Tue, 14 Oct 2025 12:35:15 +0200
Subject: [PATCH 11/23] Switch to building the project with Java 25

Closes gh-2101
---
 .github/workflows/gradle-build.yml | 2 +-
 .github/workflows/maven-build.yml  | 2 +-
 .gitignore                         | 3 ---
 .sdkmanrc                          | 3 +++
 README.md                          | 4 ++--
 build.gradle                       | 2 +-
 pom.xml                            | 2 +-
 7 files changed, 9 insertions(+), 9 deletions(-)
 create mode 100644 .sdkmanrc

diff --git a/.github/workflows/gradle-build.yml b/.github/workflows/gradle-build.yml
index fcf8c2d61..3c1830015 100644
--- a/.github/workflows/gradle-build.yml
+++ b/.github/workflows/gradle-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '24' ]
+        java: [ '25' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/maven-build.yml b/.github/workflows/maven-build.yml
index 306d9da97..740b1129c 100644
--- a/.github/workflows/maven-build.yml
+++ b/.github/workflows/maven-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '24' ]
+        java: [ '25' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.gitignore b/.gitignore
index d2767ad28..76cb65ff3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,9 +42,6 @@ out/
 ### VS Code ###
 .vscode/
 
-### SDK Man ###
-.sdkmanrc
-
 ### CSS ###
 _site/
 *.css
diff --git a/.sdkmanrc b/.sdkmanrc
new file mode 100644
index 000000000..2b4236b43
--- /dev/null
+++ b/.sdkmanrc
@@ -0,0 +1,3 @@
+# Enable auto-env through the sdkman_auto_env config
+# Add key=value pairs of SDKs to use below
+java=25-librca
diff --git a/README.md b/README.md
index 2a756bbf9..379bd42a6 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ See the presentation here:
 ## Run Petclinic locally
 
 Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/).
-Java 24 or later is required for the build, but the application can run with Java 17 or newer:
+Java 25 or later is required for the build, but the application can run with Java 17 or newer:
 
 ```bash
 git clone https://github.com/spring-projects/spring-petclinic.git
@@ -98,7 +98,7 @@ There is a `petclinic.css` in `src/main/resources/static/resources/css`. It was
 
 The following items should be installed in your system:
 
-- Java 24 or newer (full JDK, not a JRE)
+- Java 25 or newer (full JDK, not a JRE)
 - [Git command line tool](https://help.github.com/articles/set-up-git)
 - Your preferred IDE
   - Eclipse with the m2e plugin. Note: when m2e is available, there is an m2 icon in `Help -> About` dialog. If m2e is
diff --git a/build.gradle b/build.gradle
index cf980abe1..c0b4c0a6f 100644
--- a/build.gradle
+++ b/build.gradle
@@ -17,7 +17,7 @@ version = '4.0.0-SNAPSHOT'
 
 java {
   toolchain {
-    languageVersion = JavaLanguageVersion.of(24)
+    languageVersion = JavaLanguageVersion.of(25)
   }
 }
 
diff --git a/pom.xml b/pom.xml
index b3b9e3783..27bf95607 100644
--- a/pom.xml
+++ b/pom.xml
@@ -18,7 +18,7 @@
   <properties>
 
     <!-- Generic properties -->
-    <java.version>24</java.version>
+    <java.version>25</java.version>
     <maven.compiler.release>17</maven.compiler.release>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

From 645c85278bed6dac6aa2c521cfd07498e7756fb4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 12 Nov 2025 13:50:07 +0100
Subject: [PATCH 12/23] Upgrad to Spring Boot 4.0.0-RC2

---
 build.gradle                                  | 13 +++----
 pom.xml                                       | 34 +++++++++++--------
 .../petclinic/MySqlIntegrationTests.java      |  2 +-
 .../petclinic/PetClinicIntegrationTests.java  |  2 +-
 .../petclinic/PostgresIntegrationTests.java   |  2 +-
 .../petclinic/owner/OwnerControllerTests.java |  2 +-
 .../petclinic/owner/PetControllerTests.java   |  2 +-
 .../petclinic/owner/VisitControllerTests.java |  2 +-
 .../petclinic/service/ClinicServiceTests.java |  6 ++--
 .../CrashControllerIntegrationTests.java      |  6 ++--
 .../petclinic/vet/VetControllerTests.java     |  2 +-
 11 files changed, 41 insertions(+), 32 deletions(-)

diff --git a/build.gradle b/build.gradle
index c0b4c0a6f..66893db07 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,7 +1,7 @@
 plugins {
   id 'java'
   id 'checkstyle'
-  id 'org.springframework.boot' version '4.0.0-M3'
+  id 'org.springframework.boot' version '4.0.0-RC2'
   id 'io.spring.dependency-management' version '1.1.7'
   id 'org.graalvm.buildtools.native' version '0.11.1'
   id 'org.cyclonedx.bom' version '3.0.0'
@@ -37,7 +37,7 @@ dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
   implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
   implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
-  implementation 'org.springframework.boot:spring-boot-starter-web'
+  implementation 'org.springframework.boot:spring-boot-starter-webmvc'
   implementation 'org.springframework.boot:spring-boot-starter-validation'
   implementation 'javax.cache:cache-api'
   implementation 'jakarta.xml.bind:jakarta.xml.bind-api'
@@ -50,12 +50,13 @@ dependencies {
   runtimeOnly 'com.mysql:mysql-connector-j'
   runtimeOnly 'org.postgresql:postgresql'
   developmentOnly 'org.springframework.boot:spring-boot-devtools'
-  testImplementation 'org.springframework.boot:spring-boot-starter-test'
-  testImplementation 'org.springframework.boot:spring-boot-starter-restclient'
+  testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test'
+  testImplementation 'org.springframework.boot:spring-boot-starter-restclient-test'
+  testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
   testImplementation 'org.springframework.boot:spring-boot-testcontainers'
   testImplementation 'org.springframework.boot:spring-boot-docker-compose'
-  testImplementation 'org.testcontainers:junit-jupiter'
-  testImplementation 'org.testcontainers:mysql'
+  testImplementation 'org.testcontainers:testcontainers-junit-jupiter'
+  testImplementation 'org.testcontainers:testcontainers-mysql'
   checkstyle "io.spring.javaformat:spring-javaformat-checkstyle:${springJavaformatCheckstyleVersion}"
   checkstyle "com.puppycrawl.tools:checkstyle:${checkstyleVersion}"
   errorprone "com.google.errorprone:error_prone_core:${errorProneVersion}"
diff --git a/pom.xml b/pom.xml
index 27bf95607..7eddae997 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
-    <version>4.0.0-M3</version>
+    <version>4.0.0-RC2</version>
     <relativePath></relativePath>
   </parent>
 
@@ -57,7 +57,7 @@
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-web</artifactId>
+      <artifactId>spring-boot-starter-webmvc</artifactId>
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
@@ -67,16 +67,6 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-thymeleaf</artifactId>
     </dependency>
-    <dependency>
-      <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-test</artifactId>
-      <scope>test</scope>
-    </dependency>
-    <dependency>
-      <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-restclient</artifactId>
-      <scope>test</scope>
-    </dependency>
 
     <!-- Databases - Uses H2 by default -->
     <dependency>
@@ -125,6 +115,22 @@
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-devtools</artifactId>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-data-jpa-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-restclient-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-webmvc-test</artifactId>
       <scope>test</scope>
     </dependency>
     <dependency>
@@ -139,12 +145,12 @@
     </dependency>
     <dependency>
       <groupId>org.testcontainers</groupId>
-      <artifactId>junit-jupiter</artifactId>
+      <artifactId>testcontainers-junit-jupiter</artifactId>
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>org.testcontainers</groupId>
-      <artifactId>mysql</artifactId>
+      <artifactId>testcontainers-mysql</artifactId>
       <scope>test</scope>
     </dependency>
 
diff --git a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
index 92fbf1d6d..607593aad 100644
--- a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
@@ -24,8 +24,8 @@ import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
+import org.springframework.boot.test.web.server.LocalServerPort;
 import org.springframework.boot.testcontainers.service.connection.ServiceConnection;
-import org.springframework.boot.web.server.test.LocalServerPort;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.RequestEntity;
 import org.springframework.http.ResponseEntity;
diff --git a/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
index 002822ee6..8c0451dfd 100644
--- a/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/PetClinicIntegrationTests.java
@@ -24,7 +24,7 @@ import org.springframework.boot.SpringApplication;
 import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
-import org.springframework.boot.web.server.test.LocalServerPort;
+import org.springframework.boot.test.web.server.LocalServerPort;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.RequestEntity;
 import org.springframework.http.ResponseEntity;
diff --git a/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
index a9b51c07b..f3c5181e7 100644
--- a/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/PostgresIntegrationTests.java
@@ -35,7 +35,7 @@ import org.springframework.boot.context.event.ApplicationPreparedEvent;
 import org.springframework.boot.restclient.RestTemplateBuilder;
 import org.springframework.boot.test.context.SpringBootTest;
 import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
-import org.springframework.boot.web.server.test.LocalServerPort;
+import org.springframework.boot.test.web.server.LocalServerPort;
 import org.springframework.context.ApplicationListener;
 import org.springframework.core.env.ConfigurableEnvironment;
 import org.springframework.core.env.EnumerablePropertySource;
diff --git a/src/test/java/org/springframework/samples/petclinic/owner/OwnerControllerTests.java b/src/test/java/org/springframework/samples/petclinic/owner/OwnerControllerTests.java
index 7570ae132..bcab19749 100644
--- a/src/test/java/org/springframework/samples/petclinic/owner/OwnerControllerTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/owner/OwnerControllerTests.java
@@ -20,7 +20,7 @@ import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.PageImpl;
 import org.springframework.data.domain.Pageable;
diff --git a/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java b/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
index 5a78b2319..391bb3dbb 100644
--- a/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/owner/PetControllerTests.java
@@ -21,7 +21,7 @@ import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest;
 import org.springframework.context.annotation.ComponentScan;
 import org.springframework.context.annotation.FilterType;
 import org.springframework.test.context.aot.DisabledInAotMode;
diff --git a/src/test/java/org/springframework/samples/petclinic/owner/VisitControllerTests.java b/src/test/java/org/springframework/samples/petclinic/owner/VisitControllerTests.java
index e142a8975..781de3894 100644
--- a/src/test/java/org/springframework/samples/petclinic/owner/VisitControllerTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/owner/VisitControllerTests.java
@@ -27,7 +27,7 @@ import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest;
 import org.springframework.test.context.aot.DisabledInAotMode;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;
diff --git a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
index f1cabaf3c..5d1eabc2c 100644
--- a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
@@ -24,9 +24,9 @@ import java.util.Optional;
 
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
-import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase.Replace;
-import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
+import org.springframework.boot.data.jpa.test.autoconfigure.DataJpaTest;
+import org.springframework.boot.jdbc.test.autoconfigure.AutoConfigureTestDatabase;
+import org.springframework.boot.jdbc.test.autoconfigure.AutoConfigureTestDatabase.Replace;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.samples.petclinic.owner.Owner;
diff --git a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
index 2d1ac0dd0..1046fabe4 100644
--- a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
@@ -29,8 +29,9 @@ import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.hibernate.autoconfigure.HibernateJpaAutoConfiguration;
 import org.springframework.boot.jdbc.autoconfigure.DataSourceAutoConfiguration;
 import org.springframework.boot.jdbc.autoconfigure.DataSourceTransactionManagerAutoConfiguration;
+import org.springframework.boot.resttestclient.TestRestTemplate;
+import org.springframework.boot.resttestclient.autoconfigure.AutoConfigureTestRestTemplate;
 import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.boot.web.server.test.client.TestRestTemplate;
 import org.springframework.core.ParameterizedTypeReference;
 import org.springframework.http.HttpEntity;
 import org.springframework.http.HttpHeaders;
@@ -47,7 +48,8 @@ import org.springframework.http.ResponseEntity;
  */
 // NOT Waiting https://github.com/spring-projects/spring-boot/issues/5574
 @SpringBootTest(webEnvironment = RANDOM_PORT,
-		properties = { "server.error.include-message=ALWAYS", "management.endpoints.enabled-by-default=false" })
+		properties = { "server.error.include-message=ALWAYS", "management.endpoints.access.default=none" })
+@AutoConfigureTestRestTemplate
 class CrashControllerIntegrationTests {
 
 	@Value(value = "${local.server.port}")
diff --git a/src/test/java/org/springframework/samples/petclinic/vet/VetControllerTests.java b/src/test/java/org/springframework/samples/petclinic/vet/VetControllerTests.java
index f295cd68a..b8618c35d 100644
--- a/src/test/java/org/springframework/samples/petclinic/vet/VetControllerTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/vet/VetControllerTests.java
@@ -21,7 +21,7 @@ import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledInNativeImage;
 import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest;
 import org.springframework.data.domain.PageImpl;
 import org.springframework.data.domain.Pageable;
 import org.springframework.http.MediaType;

From 9725f6d15450cd7838168209cd04b7d446936821 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 12 Nov 2025 13:57:01 +0100
Subject: [PATCH 13/23] Upgrade to Gradle 9.2.0

---
 gradle/wrapper/gradle-wrapper.jar        | Bin 45457 -> 45633 bytes
 gradle/wrapper/gradle-wrapper.properties |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index 8bdaf60c75ab801e22807dde59e12a8735a34077..f8e1ee3125fe0768e9a76ee977ac089eb657005e 100644
GIT binary patch
delta 36466
zcmXVXQ)4CEwrnG|ZQHhO+qRvo*j}-1c5K_WZL@>Z-@f-{{(%~(8dWpl;8)+_uR3dZ
zfZQ)egq&Z$i11kM_Up+}Q({I9MU9QZb2tR|yWGN*EITsYQsXf^5qA245#ac}VN7sh
zh0J3lJ2M}?KHXivdw;lL^3<*X4-<Bv+XPbY2~(N3kC+<T*a~LTqij-$?(kqE{Yj=p
z!w+$eh?3ZD_hi!ib#p35BYEa`n8AYl06hRXz1)xI87bp%2xr7>B$3ia;m37Kqtw&i
zS44bg*-wcSL!<z!U&gZ;X2q!<m9R{wCVE5TQHusNF|p$5P5s5j87^0<mUF1=)DdsT
z*I<hnIDFy7;V}+WIY~9MXy0e9U{BIlE{;RHyA~hj*=U&!bg?(<v%yzrEO|qDbZiCu
z2Jp=gc7ckCQcbcJ_*6+ho`BQTmz^IR6)MyUpT88O!6E)CkXsV{{PDv9nBb2KoMl4>
z3SdD4tBX;ArwHhPVinq?S0M$-NDOHL41GA}u(Mv5lJs<>n1t_H{9Dx+iP^!|OZQjg
z?r?7~D`^kTzf9h>O*8A}exIMuzXc$pU~b^ya#D9FHgvX-Q%Yzk&SMjmRXXNaWUeur
zlkHbC@;ZrS`g8^HFE*ztUGuNoszWPjE*%z7Ig86rushQM?7yOw$~9=Fm8+HQUTzv?
zfJk=PC+3tWDRvq{9HGU^Zu%T_j*8tp%<Rh3)<*iC8{oqTm20%(sBtjL3^MDndb7AS
z=>>TiVuoXOEUm?=ke1bF@YIBp42=^no_&WYdKw$ss1@Y-se*rkpi&K6u}~U$255Np
z?7GN0p@Jp>xLr#KDJ@^^k}45a;HG1THPWPxvaJ=yARI7bHIW%7`oU5K?Zzz`nW5_D
zr@AaO1KtwBXLQ3AdtS+tV8RsHYw?WXA}~magC2%dki?8d@kw)G7AS~1Mi{5@cB`Re
zhFOH2-A^`}!>EIWt<jZCM&0Or!O;N=!;)An3$6PA$T0g%p}_uG^VbA(ZkWO|nUy?h
z^S8)o?N;0o*-gvBtiN=Gvgh-K9#ndseNB3!qefh@FitF4s72!ItGeEVhnOfI?Hwo0
zZWSfLMEQ=g#uCN!&+jy(n-8Gv@-rgn+gjdz<<2jsRUDln@(KAp$8*;DM^mo)AS4p_
z5q@C+2G1g9&q;KKI;QtAG9S#bX9Y6^VHY}u#xT9$QNEmMyDpyoTlb>oSO%}~`k7X@
z@Qd#Q?2$C1GC6$WnOnF6&3iLUKO?&*=wT=QJA;RTu^aiHh9T1=UUCc}c#wz@jeYns
zvk<0}xrpSWOn(w+ngAey!wL-gr}+QXrU%HlghdPxfNTZ$C0<*Mf_SUTBlzydqQ-|}
zB@;h5SoD)PGJxL9yM-6-`Z=S^IvL}Q@C%IJA~4ZnAO2Pxvy>hrm@LM9Z2EHYVRCYM
z`s?fA0Nvm85Q7gFw~GeAV71AGFwdq2TWN;^Lw$=~GeXQBUxL3Hcq!!(7#5i2&BId7
zYls^x%g+K(yV!&l?X%!0nZYjEh^X(>p-NVRs2nf-@LG5nMYwi+AhZo}(V+}>Di&T&
zQ6M}b^7cHNQ(9{jop|K{8_u%_l{JkpuOY{n6yOvUcicc0op6r22)J>!RHvMWt`W*V
zUO7)t$c%B@%MUdS?H7<zw-Mz*!V<$oTE-0SE7Jo&%m!?n^s8Wq;dji(<S@{ffDJTk
zzzn3HtX+|~khof4$Q!}jafmVW#Xr9p$|`VDo#zA@aw%_}(CR(5x<qO#c9<t$(hYbJ
zeD_^F_dOZv(cC#nxBr}B4V`Xfiht6=8{N(B6j^4NB6we7t5Xk>=G8Z8DQ@60bBMWS
zjK>B9@LWwT`0;-9+`>2qK`lE(5t43;N7ho7o<U=VxB#{mr$(P5t)=b;DzL?pNv?P8
za9S8g7?!~E`V7JyH@X>qWH$L4in9EWoHQ03@#V=2&?;3QW|*ThDm+^W_8PLz=_P?p
z7PHSz5MvfwXE@_RYBaN8kHQF*AamlbM=mnH---W<d}f#YPR64U{R4{?>3jWF;?Q)W
zT?E3Ih|JH}0OS_q`et(vywK<3Y-o&4lySM=>7Bx(T$#uizd|^`c)8!He?5*a1iA-5
za!4*i@&~W#|5sz8{LcJZzkd8^1_2^s;Q&tvNr6#lWB^<F4K)-$Iund&PkYN2S8WH%
z01`4=0~Ul~uqt~hTGa)j5UFarEb0CI)KNEsg~qSACue{Fbv<KD_vJ>>XPN7WTZK@5
z8ojIux!<+(H17=O3EubL9sSy$G6!G-3*_?GXnu;+Iy)$Cs@cj<u&kBmu}cgx*VwVu
znsTZL*8nJG2l-i}Z0`&`^!JjLMjltYpv;`nikJ+uyHK-WzLL_1w+|Y}t$yymF(sBr
zyGw0u5qKfG%r=BN12u^4q&jiWM4b$rteUeGM$(^6$kBpyoU-cZ>afZTlN@%m>du}^
zD4bg?P7|@FjvehnIoA#=$k(Tds}4Fw9Xa||Y5=VZBqW$rV_S9XfbAjM>*n~x8DGNu
zp!|Va?Cn!gFjvxP*@V@HP}^5%n3ds!GkhkY*7i8{EDhz^h#EQ{FwuZ$J4_@mOfQ^F
zB9~7JyU?e*<Po2!6B)Y|CsKY1+dBp(L~JE$#J^4g8I8zVq8$<#CKA~+IZXl!l$gRC
zQ-JvB4Y7XAP(Jd_3GH`Ir+x+$PP_Ne^p5GSciL?Vs#hF+mpz(p6AX?<nmy{!=Zss-
z;b-u6El(Pk+<6xWrCZoUrtaa<dPgzOc!!*V{gN}AofdXm^Nm=CxPWTvR{wf}KPUq>
zHb(HP_@|SQp?06V-{H?Zo3c<$qi%}emH?RjGN>W1aQnQ^YUCw$a$;C6{`9yFy7s0L
zQk(B_`F4w9hMC!KLrfAG=IBPJM4R#z8K?N@cB1t5-C{CsM(5sFU467ukNNOAjwRn`
zh&T9H`w%qgKAcD<GsYQ*cL@4~Q&3Fh*DsR7lVfqH&e2;Mzfc?wuaRW(ecu8kdccH6
ze;iDNDb_1XwuS6YQIK1ldf?g?I>wHj7V2Io1eisR<Rg~R=kGp`LV&HozxS`I7gv<q
z`!A{XtT$ZV^h>&TJ%U%5yxf}bCnQ{n*_(k!ywLHM-^;gfUTzL_f58`f7`3{e;7jHS
zS-!BrUgGH%7EF#6z0gy0ZVW53^gTlCC)hWd=68=Cb6@Sy`8(GJlt#7Y{$TFwdg6(>
z$6QM`b`8n27K;!=+cQQ7qex-G{?sY8j((iIh-z%iPgQ|Q?1M;9Lb1&$V{UAh!$G66
z5&rxAU&9UP-?1tIVX$lg7y39$n0{a>Ff>4sQP@NawoGiA4g(0)Uo5B$Rwe-~2&cm;
zxNh(ahHmD}%+P|?M)vC!U2D|K%X$UnthR+miKDgEx$pTq8-TpeRsP;(D&Of#IvWFJ
zp`OXChn$!D&K2jc`?0?Okl8>{&|2MYpOUAw-Eh2IgmRHOS`2&uY-o@pbvm2O7HgFX
zi6tq>Su;b(H3VMlg&YYV-9EA$*%`=&nCk-Ko`Dxl;^G40z{1@8{N|=lR;Qb_o*#>G
z1_{T3*C9m<5vy5Ia9zwIMmezG%_8b?dDu9nIw3d>hEE+%Gyu>$zUp`vZU_Ymul204
zkXB7DGl#++Q(_08PG3}xpkU2jwiRCm_f}d~so<v#FsJ-oa}9;c2Rd~Dg`TicB+$Tf
z?@wJ%Wf8euoKq#x5h$w(3KjS*%t9@EJ^l(+A0BQ_q(~r<z$6~1I@`+E`0Iq^kL1=Q
zgm_=<DX6cK{djBW+M?ygyUU`3&e*JB5zI?)V5KXzi?=U8edWc*_<9kZ@^&e^0)Jj1
z=E|>ZHQzuRu}9@nNkJ>swCbr4tb=tkr~)d<ur}05Wpv3G>!U2G(jN>q^N6a<5W0DM
zNl>jM`Mhz2Nix9+)n&<)*y6mrzC;J&oINA9*NahEal~uUSq;2&LB>lpV9!q3J<AQ2
zkVPdA&kz)#tp*oHL!4ibAcz&6%~!tXH?|mD2z9Lqt2@MayloQKexO$-XZebPck67z
zGuo9SQD*|hdyU^luy5!6$q73$M<%>}4H}MDBui-h@YN0*Dm+l?*gvBH5EC58CVimf
z@T8=3Vm$AhDx_gS-GbucQvR7B)3FfX1MyqA9a#dfv0RjZ5Yby^3huOp&REVJZ@bx>
zAUvHg?3869Gn%-Vesdst|0$B-Uv)HpOMwSW;Ax@?eXF<||1%OtCxVJ|(fvC|pdU$&
zz_jhBdM?6G-lj|BglERPKgg~dSIDV4!x8~j9OT6}dVJ}nGyBn#3;u!N%Tv;|dmMu)
zv_e*Z3D}W_tWkGfbUS<1vx7Q(;a8meSjZQ~EltZ3i`*xG2?c{`>p?)U!+!Ig;s%cs
zXO2RhwQE`jQ)oIubL7n5I}$hNOEd_oGP;zO()@`UEJMuGGZuSk(1Ze80JyPAf`9z8
z7-w3fN)(ivcANE4ZN`<W=*7t|vLYnlF*^$Ys9JO=Q;3W<Z(TZ-@mATdR>z8MSZd7`
zXQkbz+t(QLa&8&ulu+&;Bnel<IzmNPf1YLv8WtrR(?kM0v#ZHpat9h&6~@euO}}Ht
zT{)(B$3s1dhRz&H`(CAjpG%0<P0|EF)IU~SM}xbdsT|b2*!GWi=#E4$@}~b2=kyaW
zck3!yIU)_kRvR9#J4F3Q1Svue$XQWMt*~mFPNq0^A^*I~epfB!^Lyu5#x2@BI8^;8
zzPity+5y!2VPOL}si(uQ;84JB+zwWH?i9rlKxr7&foIHb6oXk)=elC#=YDKG+2BMa
zUOG~{H-a>NVH4VPLghCuaZ5-s5)}%_-IF2R?wvUkj|^T)?#Noy->*3IRu&vevo)O`
zxYU4M`Q!Mplrev2^k&V!oj@_J$-n(MjIve23po1(>v=jb{D`e@5uML4;n+!bpX2tJ
zsr(@+^>_kg&y+pQ;yKYhx;UmzjyUv*l&>=Ze?olQ-K4sxqzB?4Hj4|Q(vtv^?N69$
zUKMsLr1+3K`SBsQbLBy9X2?TE#vqKad)V8oOI$F&!-VS}PNdQ6oDo^;b3iX4r}nl(
zIWM7S3;`x^;8woQ9FKInmR!-qoNuWVy8Yj6voy~$ME7_ZJ0j8pJX+=osF71jV?11;
zCwH?kqAo+DO|>I0;5;}{DWL$c3Vh4fh!OPJzokUxpKr`o^nJ8`?D>Z~5Z8Twb<_vM
zL86goRFdY!@g1{=BXDX6=TW}kQTNx!rn(+5vI3gJ^EE7f)?*Vw+OC0w{L1;tew5Zy
z@T?0t?Ap9~De!?acVgr6AhWfhZp?qL=~MUe)hwhEROc=7(E21fZc+n`y@;qOOA=FN
z{vcH=vvk0`Iv^Y-*YfRdkr6AE2dj82|EbTNj(%rSHPzx@YK9osl>CXA+|<4P$1@t1
zeXu`a^;&C(C-HZiM5vL>XaL2Kxnq6myf17+8q~}|8@$62S$DsE6}!m#3Q>c{8(Oz=
zpdtLg3zylQ@7FWWRYxRX7-#exzdJ;BrLI=u+U&k<qWu<VF+lqv)CXfVpwm^n`@8W`
z(Ntu4xTzRm!rILncQKJQr;yW-BLV*yGUgp*p+}}{&oR;XxFW$(TQeoTI=`_qL-Uz^
zdvfFzF#aue6sE?s85c?Vm?uLi9utX%8amzqEnP)1WE~Rc@N5jYG!&|#85<{(9m3xH
z`Q7jP9gy1*=Qvx)iBEKS#3~xFwB(UAzMi%uE{SPmAKSn!tJW*(W)9}0Wj{=P=##v~
zIk4@Mje5tXsAFzFZN&W*f%_Wo`ikhbhrC!vXPx}p2Q%x*CfN%v`3wEO#cOR^Jgg7?
z;|CY~j~@!szd?ZLSZM$Ft|~xu7zJ@>7HYjK=}gBZa1LT_&?FEsD8b%+OIO{}KDC*c
zQOqyArw=~kROVy%KV2m+Z9YpQXaV%T=Jm}v$;xrQp3&a{{3shRc&+RCF1VAkc63%B
zZEh||$E_|%&)I0e#aqu|(W#{!y@3|L6__2NgNJFLp4`g20b7>}18@hFS@2Fcc+S)r
z$9Q$ARc;Yi?O@z<`;HKb&mIlaazR<HDM9R{pn1Lo<15hIv!~e8vqv|tE^NyOGMcn>
zcH2jiHxpxAdvvQd`E0w1EV*2sx1Y4@G-nn)X8jGgMbBLm6iCeMqIeSTZbH3RpujLM
z!x`gcfFz!Ze>Or51$aG3TnqLJLsbs;*h_Q!^g5{XM+i7(8tMSFHq{bBGC~3=QGuf-
z3;~v*ofA9FAcCI`%wx`K_T78lo#zggsxAFx&6PvAV4?sFl$fJ?5;^1>{qR7|z*e53
z95AY5h0%SQX+{~(d-}I*#CzgjIaL}>2Ms7XMQ^txg5I$Z082i*^KZmY2OZSZ`uHJI
z9Ysex^a3Jl7*2UR52x1+>%t1JP6o#emKb04QH3E_8c{}j1?K(Bu*s1>Q}Oc$!?g?5
zhH0^z*uE{KAE}*35R(cIsO=rmZY<D^nR&iwoLUnu8NyJ;CeFnx<@Ow^Uy&c?A~P^u
zAs~$c@eoBxO3>zDY2O$Zsur?9(|R^k;-51>qsU8@GwA!@I<)Fwt<RKmI)h5TGG$qq
z5vzFo`GQdt-+xCmB12Giag9a~-5X1Mg8f%uMxwtfWd2F1)c>TEAaH_&4uF=D;zY^*
zQ_&IB)-u&ed0bS2)Iy>TfgtfcOr~YvPhAITgLd%06I^Z|zEvwp#_JEhq&pkv@nT7L
z;9B;L&k1)b=fmHbIQ<`F^}V-mhbFwAic`+M`W&FHVoUCeMHT2*zZdp%G+kIaG!TNN
z4I!_gn691F7u-X-Z&Ga3vjJ;+Db$JQ0r_hm0?ZRwK;Xf_!NOqj8TEH|qAB9;wUcdh
zb3dbuID{n^SbmsLJ4)2;<LID-7InDrlQJ=eut%XrV!MZ}R-j=8MNAT*XCD&f7L#(6
z=*F>}VMx+)t4j!u4)3k=w9oE6(%Nk+ISL47B5St22MYts**7K3IbfVNfT_zt)+{Bz
zZ-aHKZ;tAcd(Y=N>nv@XXCPC<*6Zr_&K)s$4n>Gp3nQ@J6hAzV76x<<0t@k878k~r
zjei=NO2sQVl+k5K?fI2ZUUQRC2|EWs*Kqd&BW2SUV@(_(wn^NxfdbkkQr{;2uq)<(
zzh(HCpR1+r@<;SU3h<%IdY6H!&kt|4EKvQ93d7JCPAq>P%_7z8z>^A98BFI{k~}Uk
z7N;(=k{Kf~1Vq3yj?XWI66{kB{Xvgn=W52<L+%pCg)9hj$B<+AYG>w7r5IntP-&ex
zQMq<yb9^=btYzlxY{@$@>rKl`3F9c@>X{P{SIiNp0)ZuF4`As|3<z`#6%+P|LUS)4
zkJb3lN->QGA-m&=hU_$$wPNFL5LToHKc<pkhS^FVJ4Z(ElfhWXLx!T8S2eeIl3h#8
zMt1_9&<eWO=8z$j2`}Oc<<XwcP!j%RxVJBPBE5P?Bnh4zXw%t;sSbc{B%hgmgZ)Al
zMQ^81kCUj3)#{ci=sLlH@1CU};HidveA=PFLn;^2BUa4i;mG0^J)sOmI+3u+E_mV|
zZk}drdO}`kGi1^=xW3>o=9{l5{YH3W0}7Fot_Y6`aEj&W$nDbqSLm30heN<=az}u~
z0s@7td{-3*3F?H<C?Tjyd5lVvQj!YDQSa1Rwv9~ZcJftBe8s)+D|!~yQ!o5!Tm_e0
z&^&epykE|XS&sSf%1ti(kJ*3~m}@(G`u3epNcfX7qMJqN((M5B5=k<W79v%@L@|j@
zv4~BA2xhwvhtR#v!-zY%QXMRw+dqI+d5`0$V)4=iyOtfrnrpsgd1uN92Igyg<!~xA
zC`D*g<PHJbQ~LdmF!C^6{{D~`Uu2A+bBZa~@Z4Y#uq%}j!75J@Mu=hvFUv#+)TgmC
z>J_l3F9v7cZ&<Mu?J9u;!GjEX4}!MHpuIyZVeJ5>p!+t3{%&&xi{@e0)nGt1l}g@t
z-s;CZmU{l-_LE9NT=VbFdVH73-LkcF{<UF#*sM92@`8CDK~qd0o9C6S=ql~rH30Xr
zabs?qX2(2)`b1nA6VSp^a|n+%r>~hA^KcC0i8NQD$Ti7A#(lhZbJ3-z$RaErF=hM9
z-~2_+o};ZfaR<S!>hMI)?3TppNYLJ?dVq~4RaOqpeQyZq1xH>Jw4FWg7W_Y)F89Ko
z3V_>`R)FN<*41Ct7L{r(OTSDBiQreU@NM>$ZDUwjUyVXdHJZ0-C+U0{p8==;j@rN!
zvW(Z?AByK&A;a(tK$+>RwwFzA^XnIU{qCO@1;e*{hlipU)ysRs2@W0WC1#I}6=oi>
z_G>(iJnHV9H3WK4+W&T(X)bvC9Qv>#gTpV|2EfRbfC}r*BJTBtTGgBl8&*sh3bi)+
zTUUTBGU8*KUv6waE3G<&WgA)jh!B`c)T`Q+V0E$kQ2jF<>~Q?r3)nn@JgqjvX%5Rp
z$)T?HBJ4(my?5-u)-@a@?+FuvlkH5L*ET${E+{k1L)b^!itTmAQ`dApgAgcXC`l@r
zFu?ER<%q&GituO%2?S5G29?iDgI;!6mg(qsB5g9fijElDZ%}oWB1Y~g=`{5O%zPeU
zu17IU80g~rMmVJQoZ+P&tsakARwfdNHkcrFwN-PCta+`srbtp6a|c{@jL7e8eoPHF
zbqUaxFCbpet{WJ2t1y|vPH7v#MQMnf0>Jo=7PV3%isZUNqt_^S855(ca+0Az7P&8e
z3*PcH$MKu=MkJRT-S^<S_Y4A)c{ITgYRWPYfm4zK{SAXT+DpZ9CvSl%vC+Rxs>3(7
zEr$89!koefY#*h9AC84V7{WqTE@1*ato02~TEBk2rgIE^CO^A?VX%u(3SSXtfjXK0
zOy2Q~>PnMD4NxEuPI=fMM<6<1m>fNj*z=DJfkPZ~lwc73+g)bA|91wAq7ej4$sI5t
zjEp2TD^MieAg5Zu(^`c$ZwLpVf+I*spc1t2_fAQcl=szBlUD~L@Icu2L0ZD|{D2R^
z2)id$B~s$S|Gu-oynC4VCjVj4j}`Q{qoZLt=HOu$O7+x+TX3bEJ0SM2(7lSq(J+_D
zICjz~GD-aiGW)5aLo&?%;Mz67DcxY}Ox$krZ_Oyilv&~2YJt{**Uk>Egk(g~$kq-@
zL1eHHi;!p%Zh>SO`jK`ffKA&jT=>Kd3L{8K9A3shOo%9`oh<<!6Hn^#7iFg}?ubr^
zEm5`;Fz@ZjjEhpf9s&qMmFhFfJEnS={hEqVBuc?R@qsE;)B)qPwEhO5k?C`Rj8rgU
z(B!SiP9?Dal$xydB}tN$e|JNIQLDI;*CTHV+bP#&ps;?bzBZECO3S{&uYCafa4N?I
zW7fj8e%iLO-%RiW1Bk0NzAHK931tlO@nQ#gW^&*S@?`)vQzeL}7RoNwf0&VrUqFdM
zn_#Ye3=>cCXmlAJttBvb%DEYlq*hNFxDFEJmN_%PuLU8Ft&3`mSETTBB{igdMa$X6
zE<=uX{m;khOxxco2l~<l0y;D#X$=0^0~R*D;YI{x$8IlwXfDN_-J`IG;rE$eg@J()
z{60VM$2mGsEbAl(a<ki*U$Quv8(v;=b9;W!8073t?CnjAlQ#{=`0k~jCt6*Wi7wr4
zwO`%NKJ!jJ$qG7B;`IF%9Mi?K7_MP>4hqFCljh!p6j7|!&X~B!0N^^)&?HS9iMCTy
zm%e6)9w-p39<B3oLCyT(B`mtqMBznX%F{xrO}b8{%AkZ>obfe)Nr&wrguNSd0~siw
zr`<~2bP2ZOXzo7mpnI95V(i-e*Wu4iEjMpBT~A&lpCrwQ_X<S`CKT==?!8Y;MS-KH
z6sjFaje@C|NIF_DfPp1mzh2ic@04ytF<fP<UXB5#vXgXUyoQ)uf-ZR58902#@Xhb&
zEl4^tzMir8N!|&2DvZG+nE6qvQG+~u%4iA&2g>_ll*fGjdom0#T1391zQ{(bnp+_&
z{?wh4x*Nn|n3cgW2hxlYA3DICpqWox%_1%$6zD?QxWdo{!11+e{Qyq6%^^SC&R9mc
zIHe4AOkNrs#+bYqJOApGTIoJcl^Y@zb#mX0-);|XKq3s<@~{9f$P$sK`{89PkFn?E
zr!Dx?8S_xF$h2yn+Xy34q>6PjBfi#S3UPFvV*W7$`EZVIbVAHKlGZlD2C4`{_>p$b
zGIUz<Phm(kpd|tyBZs@+;tt|q9g(c(H{&%_O|u<*qN#~@qW-@-NSf8rpK6^7hiL2_
ztuxF`8|jxUdHHW)eu5!HuY$U!rNP$+GD@rc>keZJ`;4^cA241tgo0NJCxdKAK}ZP%
zBwzolw<tHscjtctV+7>?sVS5n5D*YQe*7Q=5@5mpe;*Ywu>u|tqpGWpERNwf48lIB
zL0ZOwW|}Dl84wTENc4(ItOi9Qp@2O%Z|E+e#@6BJJ|JGL=i#;G+_^Zh?XjT--JG+o
z_fo=N&{J4^bA7K0k#n4NIo<g%$$Z0eGxBveLvR1%(Kupntxz2J8-Bk*CmlT$3qP9L
z`R=;aNUb7c8g~l7qJ*l9YSI!+*Gg+qKY5j;gf`x(Te*7I$62#cz^zAHOx2k&&lCIg
zwY|OF5ZnaD_B^xXk`3dQUMjbsf<Zck&_5rIq=_DEx}a%-e|mO-DN$}j_{9J+j6j#h
zDvhYls>?81qAHb2Q*%yKeX7M}twyz}FcNMVsNGyg0)h#E+c|*dsdg?*nx5H4jwCkZ
z7k2hDvLeaN95WpbGbdwGRvrLyhOVZ8*KlU!G>b^m6qC0eKulm1;Fh+^X4ODEqfQ++
zv@2k)+J*|7Ej8%r(Q#bELUhEOV6{vfbe=Og=(3~RV?2bmSsZ@y!u*}F3_aE{fFR+r
z7ju9J8;A$Y4$d}42@5%6h|i)3f`DVs`5VLJJG;2%?#?dDHgIuL6AnAbpf;O9vNr7b
z^zF$_J;!$7_IX>t9&pHsAPoOZ{S%YV>Ugrh;$8vI)UH^`leLXgY<5k?E$oq-ZwjAI
z;?qm;b|&;wigdVH=e`N^d{cQJV*Sn#qjVNg5F!Rp!<<bLM^879KIp>R+~wS>p60@z
zmlis}I)H~d0VCeRePliuUnv5`ThnS8X-O5l@GXh+%>wD06wo|CJJMaud4#KjO^3KL
z@=78D>KZy&<`7mfV05|>JC)L=itu9HuONaeIs7S0GNuXBo(Quv=YvbK_i@bV27<oj
zuh$D84Sij9ByOjZ(wWgH))K{-zD*?JaU{_(OPh8YV8BhUthkJ#b#L6jWoj|Cv(Z3t
zw>X`+Z%<)bsWg?-6lAR&h0+b9MiI@lQo5FK^{7pc%|WP9fH;wf`Y`6u7Oy$unp=&D
z+@<1kCGBbsJJmb#K@&qOgbDh75ThH0F6{(J?74iBg^ggY-*2#4HcGaDsHd8$PAck^
zgN!S)u1JbQuI#L*++S3nv;CQXHXr`;%A|S$n;5xaoFS{!ME;C6ym8nsk)r*|6P-zs
z$RCki*-f!vD6<Dw9NsqP=;l@$=#bvsD??1!v$^D9q1jL4iWT!~5*O(7reV}UO?&}x
zBT^*nS6~=H*y^GSkP<7n5tXCiMBEg<_-T=54uNH2z>#>m>3ae}#h{ZVNn5E!yeg3W
z%g-ChR%t8jXqm$jVRGI*e2>6Y*fdA$B57l$JfvN5e2J=||DML8fR1Etg)uyBBgub&
zu|+wtc+9r{(ad8c6Wl^%Dl>;QBl{6>EWo0vBl^f1iz2S>$nu7)<>&twdT&eC2K(7_
z_1IznN)8Oa#~&xAM`#~3k?$3<efBCyGaAQ=V8d!9^C1A5T&rh5eXIt#E2uBkA_7$X
zc8*ym4z#d~8p9*>F;1d=*qM5iNA!UG=d;h%%*rTQP>&E*ESOQBkPF8f6mca0<F9QP
zZ%df3(FC6=O{{xY|CQ>dFJyP%yvEAREN0HWN1~W&=+0a&@rcqEwSyh6{@=>K-cG*w
zXs4c#^E(y>Hn6_iAri-adBvu%w5#O#g8d|Qp=KbR5oC%^^PMrlA?(9Mp96!>w2}{l
z3k<vU;9sEs5h{8rI*Rjuvk~}*O&OrAj;)IF1qUgE@ym98eqN14Rysf@TxZas@|TjO
zWFA{n8XCQ@6A~C1v!hwRRq6y?>UaNFKzFk>VWU~O?|t79{_R}uUeK^F8KkUCN=6u`
z_w(gM%gopFG(Eugo7mqH1tW*Y&xicW)Iogg(wP@K3);-7PlCZ1C9<MqwE~bY4lR}f
z+&;uor;)>VN2ShKJ4*MhRH+Me<`ix4Akml<hn8Zj;9@K(B_}60A6t%I`E(|gB@St-
z6d^xNzVK8%*;IMrv4n56RHU0987Un;n4{r`@H_fx9Iq@kHhGI(F^u^uG(GM}mbCIt
zLrmGY1$AM64Yg1~;n5~=UlQQJoVBeCmy}j=`nGyJjW@H3)Q%yCDXJLT^zo0CSHYMg
z#Tt&OHLYeCU6Cd4^9bwD9ipvVO;vbSYDRAKPac9E_?yd5zP}1@sH9B#lnZPZo!Z}O
zGszw)3N;0ruLM?9KD&lG7upiVZ5cbn#BM$8qxdk9ykh#$a*$>v&jH|j(D7W{3z1K>
zt0>Zfp_%BQs4;o_&td61RnKHADq(pbe`2PFh||9ZZ=r(4Svf1$!zvTtS^N7ml;pk`
zVXTOhAc6rd+#!u&km}8XYDUYiyU`6ryby$v`l`9l8=h8SV+uzZJ4r9ev@&;QpRJHd
zWEge+(nl`Z?xZjh(*e|{A6B}q?WyXvk?Hr-k}dU)Ge%X95`sZ1$~6j*_6w^~8?Dw;
zJaKO#L%T<IKMPD&eI#eLnN+e3|0Iw|bE7%Z7}sKCi1`J#QEH(gC|-W>yH1d*PB@(p
z{$)}VUHV!<lgo5t$;gKHsw4ASMTGQlh)SzKiE2c_C@8Gf)B+%{Br32%l8ENOg0b!Q
z+3v^NE|%7`%`_S4Z3;@YZax`dQZq5e9UD}z{c#R3q(-vHsjaB-gb0}qii7l+W`Krr
zHED*u1^?boL>76u6Bs6Hrqn?N9}wE`eg#AqHn)ab4bHOBSWZOD<U`0^GJs&Wi)PPI
zYklIW;hTBH%mNlm1FR}~N9$OTW?{MGk2rtD<Gv7(k8Xi=HCVWrI+U?QQa4s&dMUGg
z;?8EYQG5KvcNH%9hGv&+w3E1x2-(ltUYES+ug~L+T6o+nZ8<qyk~~@2Q{d|Ijb=7|
zEJYsSK>vdKZK{KEPnrmheVETg2hAyQzeF5O)=$qkeG8yPlT0)52svXin;$dobPo1p
zS`Al&rRoVOV2v8$d?5s*Yb6%fSohL;`{Xn<m_6kLQ3r)SCD1{lMg55I55`2IZhRc9
z)vl`r`^Kgk5jAI08MgBJ#9-fqrgsDqVwM|bw4#)k%J2l>+}Gk8I!8r50Vsm&JXAzi
z`WMD)^8v&@kCz}5r~yOZsllqp{^bU<p1``(&hLPq?{dzH1I+TNXC=&HkZ_EzzqBvH
zTBXGI|D}vbI{f^TwznNZl&&2rm=o_y3+Zpim`fS(`G(A!1gufYf~M;cbddulI}5ON
zzcI7(%}s9`wSzU?LzKUK!aw5bUlt%w_3EHL4v}ODaEn{>;99@_cc(O<8Abuda_a*I
z1W<U5ml~U_@Y`JzLdr0Lnxb9>5c*<3MFkx=$y&}%5Bp@45bE*w^;_cu1MzpoBUS>r
z*;5}foXw9f{(d40z*GOCKe$u9J=`9<4VWM0br=ZfxC+%wq^5;VF4jvF9c(9*okz+P
zw(N3{*bAaXzQBViYHqwbu1_7^R9*nY>eX&sT{|y>08YS*muXh>AKlWGuqu;A%UH}@
zMTYO`mV>gpvU{T}4*ApxLC#k+Erqz0GeDM^k^j~wB#`khj`t)DE4gHlM#vQMz33kH
zsJk&x&vvE~pIN65e+_N%hJ*xp2D~LKl4=GleJ#>M7k?rf9~$eg?Z^KXr&84(suwUd
zekcjxLOXYuML7Kcy4R_UFk!)}C{`N6(FUw3`_XI3;CvbPg?CXR_1N-oPcADMf;6_+
zk!yVP-e0|eOjWZt>IYc1_dA0n|1Yss!0_^<@GnhR^}jS>9x^--qLLBds%-7NAcn$=
zohiY1T%7WlAQVDCf>^JTsE`F-+n&!exzLD9q0e@&g?4J_wgQP6`VsdI|7aZs9~zMV
zIUQ%@MH&hjr^1|~ezNU--PU2g)9L#L?+>bDjA3KDRm1PN>~X75WNSVK$u(VtY$8b?
z*%te!F~!7Iuob0#S4sg;H=#;<8o8T)PCl-Aeyb6oS&F`lv|T9*I?~_2xw%PnH2(hg
zU5-B%QbAXbTQZjjwonBEvzRddLWt^I)MG32<-Dm`!#yX%047;&IW?daV<<2`Wo#Cn
z)PAHtPKnlJ+_*=W@SAL9i#zdzhsW-4KbS?qZ1vl})|vm<@^lBF;Z5+%)*var!bAL!
zb;VPtbEGtL!;&^TN-O6L=RN!i*DSB!K*Wmm>`XRv{&BL4s$x~S&+gLHpgZD|C3s%P
z>dE_`C<k}95>rL%9<A&ys`yJbj48%5Gq?g{7GInpUT&23TGu>x^oJDhNfawQa8Fz2
z5N0PK_OIuaVMQ@OnD$-Gu;+kZNO7hRPTX?u#1aT9Bvo4Wlo)}TL7}WCrER=FI3oNn
z*M#(&HFPU~mfdt2S;<~)&$#LrJb&lR^##Rqre?3Pp+T(KThovMD}M~F`dCQmFhd-E
zgrfPBjqoVgn$2GszRB%9nTj%F#$4+N6?+j&?hOSpHH<94)#8LBjS!xGydghgxt=dh
zxSpNuZ*$Dfa!FQG@o_n3TW4<e&?(c|nB@@JF{g#;qAlXe)wj@Dw`_BaD-))@3`57T
zhL6Ix@*}t9Ph_mN>)Z%CQYm8JXF%1RHY)m^H0X&#ME+*p#$a7(@mas#K^M0VZ4buZ
z443qp7a%Ku5IQ)z2O8`?%n*j`6QgE!g}Gn+6fl8nwDTjt8W&@K_s5IQMWvDBL{m5B
z{_KxJfZ=#kH-0~+!BA5y>TahsE<M6ZQwj88xHaNZK0l+~RCn)~IS23HAJ>xbE2nS2
z5NG#^TEk7-l+6^^y+P<IzL6t<WFJJ$yf@0xSRpbYjI351kj;r;%_F!m#R1zi7*vhw
zUi$mze>|z}0Tv$#*eBo!=(Af8K=9olaRm-H<||zDH7V*=5(?#uN|Xg6qXrf@ZQGDd
zvt2YbS&OTL`$6#cwvmH?$Kt$F7}%gX8o)Pj-*kC0XMDb0Y`Fh0=0SLM@%=QrC(Mv)
zBH@mTC1#C-BT6<8Vf(Y#7SrG(7R}8>!pqne&!+~hB&~1C$CV=uI5;Dqn&$wDR$<58
zd9YydnpJ0hROkLn>FuI3@$DzsRL~|Yu$j7uPCL^NlZU~>lix+F&5gi91Z;ciaf;G6
z5(WS_izUwwClv~8C8wo;lj%}2H7Pd9Jb+r6qo)c=j}jD509m!n7^nrbjsAGDOti^S
z<r!%?Q*V3kJF+dn^-U$OsRb}M0@lt8ataB<<jGpB4D|NWwWOL#?!Dfg7#2B^6do<l
z2Yy1MeS?Fy63;5Su8**_XRh`O7@X`N@X(<?rTo5xXq5L<{k7*g*5gPP)zSnBc6!V5
zq#0BecHoiQ@N*~dX8IPI%^ph--8Z=9u~6H~`t|qTE%h}Ol#kfoE!ZGiw2;=3T3xhY
zjlWYr5q=uOG-s$)^Zy6c)C(bD*1zFK1`MFX1-=Mr1K^ia3v|`2@u^t(!WkI@B+3ll
zIkvX#z)LzZ*DUp;KM(+*@}voa>d1g3uNG8Ri+!>Np!ac>_e~qKevj`vOdgp0?!nxg
z-DlTI${yhmuKfUXhu#o0(66Ggkt*WTZ=P@%)-n<E&QRXWZ?*820sE2JzL45g43$3S
zqg%!oz&fp1sam;II?4LP?CYM#`dd@}J&v=8Ly0j#(Q)uJUS_xnqqde`v-U48mKVMm
zAxPwuiGh$;F$?4(GBRjF0<LUdFBNXtYGOn&+%{%<iHTmtB-Rq%VayF?SNdR9Iwc&`
zuPAUQir=&c6dntFd9z$;h#HXOMb1hA;z!l>00B}#y{`Hv?d?X-otP#_6d>%gn?5_p
zCciPbXh6C-mD+QgK=}v!XE!wZgXpB8;I5HK^O*Bh!`#vR`i={FRBINnHcRz=EhEU3
z?pAtRhEhcr^;*JMw@QXZ9rXHpXSOx}LNv)i*kGN^Cg?<s&wO!+c5_<N9Rw=Vr|Z{)
zmh1$*g?5R(sWvjaHx}G|oUdU@YA<iBUY<YYc9-&Glhy{jyn|(MF}((tX!%nfQ-2fk
zCeGfq<B>;|?$P(JL3gx<Nke?j4D(k1^8f9xi+M%w^?wkL{10MrQ9b~#J+dHzuQcB@
zhVXtc$t)g<+u;M{aEK%VsDz53ghqh?3-IZ+b9!sr(%m+a;*IbF3=1os;`QeT#o+6&
zUnCj0Q<*Q@om-z@2N&!=gg4b+9bBKhTo7{;_{_N@;*5D?yzA+r#t%_sEP(}Cb-S_7
zWHU@z3G$E8Pi^`re0+c$rRz3ybxkFO<g|5T4jdS;xR496o~H%T9Ozy1Bpk^JHs+Ky
z%uL93lM~a_-NLWJFN*YArfwSnN|uqMeoH??C$-ZQI%#HcVAjG*Y(=E*dlgL({Cp>g
z@koG<!OJa0e|!IPR!Y*bNyFpPT9#{gU3r~;VTp`-PD*5Qiv@s)1%)ja!@6HNq)F~Y
z7Fu@GibzNrtcX=za8K~$(f)JnEEo5nu6;`KrMkb*b(EwuB)QZ{^7~d7AXgJ`1u)W;
zCc2~$0R_$X3hA2umeFpF>LPQiudVyi*+#Lok>Ci)yia8>lG5V5kz7fsD6+%x>${Q{
zfZgg_uD$y=sd0+Ly0V|maeS&ED?&|fk^k$%`OEs**nc45{SPEwabrO6I$11XQQzRK
zkZ=NyjPel0s1hmH8g4DS=1u$GJp$FEd2Dbwo!uWJISCmEO-dWe39sZIzvUWlXcXq5
z5IW{NZ+IRiJMm{G7tnjY;0*AjVP5RFw5q=hs+^sbJyPl|(rk@~89wc196b+T_1Z49
z18)Ud|3$>nxOr$YaSZ`>p^oe<Xd9cbL(y{$6S~{f++&yz56;fc<`LK``Zx9?HPQmB
zdq>JFs5w_2LLjl`$m{5W67>+Z(>XcSDYSF!emEfieu4Pmr0xGXfC|mPUq$8KO`)dJ
z{(18xqR@6|?^!cbZJa8SIb!$d^(DKz5dbj|iY(TT91zJO>=p!g@f<qJ(bd%4K`<*a
z@;B^#vegEG0mig|Sdc`qh6+Y$89am|aelMyhnWe9<6eRm+`Kxz(u*r3=neLsC(Uq<
zI2X)d#-eQl6&zy-RVixDFvQe?A{B9iMosbzWWqw@ic%NyjU~LmF`bqxEvCZ79a|Uk
z`5>YMDQW1@SHJ*tjqyG(1NQ4K$>O-E;uI>WJ4uUPT^cJ1BO_R`MpFB+r3b*&2jg!`
z$A3J&f@3=GxeYrinT=Gj3?2LXWYGmhVeyty3MOn@vmp}mJXVB9>aU6645y0BEXvME
zKeMQ<y?+#BW^G4c;ABBTel!rJsO}MOIm;y53_}_tRv%Da>*KnB!uv*`;xp{<I<>sC
z8kJSE+Ta&zXk>4<!WGbyob{<x-GEi0K~ilF?kG1xh_fs~Fwfm3Vjp4{{>aE)d%w-v
z7GYQ<D1UU(+Cdix(nm3;szfD<Cn>jGhQc!!dq~zHUlERoML$au$3obvQT}vge92!Q
z<JcVYyBuIE!y`q4pDfu)#6R%kvseCYatr*m<`Ei>N07SGw7PubZR3lBjQys_?y`S%
z$VJWB-bD*~oL41+JwX|-Kxv%vFzzHtH*2-8{PHpIo_w6s6#QX@a(4!!{T{obdfs^P
zYgB%#D~wQb2awacVp_MH+!IfERO)s+L|oyFG$K0JABaL)Z|=ZZKcOLO0~E7-*&`z5
z4S3v%e@QFX@Cb;8BF)D0l<Rs;>@_@JMWk}hSj9eExRUise*d3QszvFXAPwA=vIB@h
zQ9<a<qPl8ZREBFQAeOlkAkYmDgEQNNxfyn7o3{`!-V6KO&Y81n6_5;*%l>moHR(!d
zN#=_>m`{98vTm~8%mANX@36fDWSHAFHj^cKXHlCvh;nN9%TuIX`s`ambAQ_G+vGZT
z%|O?R>p)*XI3G5nGCd7zJc<KL;Q{pj{ziOyF{0Do8f~smGjeb+FffQ{q_0QmQ?0RK
zcJjpO=T|#8r4R=<X5nb6hdh>{ttm%TMyT*mt39n4GJv^G(@H9Dw%GK=JDAd?19_~Y
z4l@pi3gX8)t}~1~cs96+w^A>RN%`q<c9`03q(Glwa3_3{$#M6{t$ku(5CQgE5267?
zlt6pPxO`V9Z2fy$ZqA`7c1$dL&Df(jhDL1G?o;H@ctqa<!H^Om!KhG%jEq@-wa}WZ
zTl3bF>NX~A#f)_m4to*u?>jCGk!0c|L$yu{$T*0ZT6D`_Vx|VF!d<GPnOL#=8og&6
z!Z(IQC@xGalaq4%Qw%yhHh=^=7xq06IkkjhX5BPWTT!a9#E{!kM>2w?fjm_&lq_Ql
zI50BZ9ai1Uy;Z%sscapmY4{`|$mv4$kXUG#?56FzL{oFn>`PKqFs;+WUm+Ztp{@1&
zOJA2AcPb>I-2|fiWAutJCQZALm|}s1mmS;&u&KYvz-ky8RmOz+Q~`;gPeR63Roq>z
zG%`IE*ENy@tUC53e?5ZC)F!0*5C#%(vAm@qgBAsqI;LhH@G&V{g@I37E;$p7ly6+Z
zU5LIZ%M788r~?uUB=8tB4Ue%kH{}>ZzOc3y@Nn0JA*E+R$_vhXzRYDip4}GE_w4c5
z28{*W0+n1^l@=u@#(;I#+3whFE1HG~V&7cEH~-xgG?VS2PElT=$CP>|F24OmZkiz`
z(=1vb9zWq9P~wFbALKcv{VPeYB*t6NaxR|{2eWhVP@|?iZPvVqTniig^woZgP^rx;
z^39-^dRZQ?o++QeoUO9IK_?KDEE&6T{1!iz%Q}7_u3u9>qQm{SUj`wj^1*)p_#p`T
zKQGu>P5}C+R&IWPOJX{uZ6B~(j)tx=5}K-vf{N<;Z(t;7#K|^0P%g3ldBN}PxZC-f
z_aw)A8Zgb<64&MO9rQzu8Hgb-25_y?>vB38XKh@zqnv<8`=e>ZA?)>NL)4beC^Kz4
zFp1!vwgGn~`jN6)p&`vO6?Rdp*oW~8veKaRRg8E7Q?B7shR68gj3zE_)r)WD>eb77
za8k=lD<ICWkIq*k&fJw5xyQr+UA_&<3e&1VjcmX+@us36Pg<@y!C||Z3Bcx_MK|Es
zMhP-qOQx{xxaP%IhW^Jc{W_bFPKC?(F}n~G$p!YBA#0V?mZnvVZM*u!a?S_XL7dXn
zF*E8|xvQkYg&`-WN#;2uJE=6gsFA;SDzb48^=!6<d7rd0Wkdy$AU(}2GtlLqU*h<-
zOd!`^@B__=aX@m(g_<Ko5O7pt9Y@N6sj;HbhFQNJ$bni4iZFZzLoSo4RF`A|o4V0%
zogj@a54@tdlMDz=of()=m_f+ktu??55*oeOE39dJzbBX;)O?ur7X!<sTq93*RVVOg
z5uYVlW@V<yI{s^lJs5#9IEs&X?RH;JpcdZbm?g{Bq1KQ3npM7X0GYV0s)6et=xhNz
zQXv0n3WQZ80@OWf9D7h~;PjHYfFSnr)LWY)JUAA-o||!GBk)_8K(Ucu6&hPZUn3As
zON>#W43hpT@Owmp!SRiM*$CZK%t=I|*zPGVysTv!L#Qf3ePo<0mLM(jI-*d~7X5gy
zk5NH#Z#ZfdB;nmY!mC~R!`qlJ#qAK1=4omv<{lR40Z4AqdO>io4A=n4Pa2V7o+LgN
z)1EmzB@l%1^66LZc4W(n4O_VDiSX=ZA3W|TgHU@XVKi%hKMkEjnSo}f9%ah%Qt3<i
zB}y<teJm?g5W}T<(0Ht+rPqR6lYocn89G`Yx5RFuP5ds9k_z+Zcbx#J?N|K8v9TxO
zqhHtt6##0%Dx5}>7$qc{g4bM4GONOpDYWv~5Jg>i2=zUC9Ja<V92feE`6tEsjCC0u
z>vY-HHm4qTZ<7bEYBS}?G=lGMU1K<RX-*NuGXJZ_Vx>LoyOJL@1DTTfIdZiNxWufy
z=ol$8y}qPNOLpmGZT@J9TukfSCRHvHGe6nm?*V5YdRvaCNK%y^+`4?s1Fba%CJRJU
zJD9yO`x#}ZLS%wGTBOGfQKphP{Z7c+v?`l2Z`-SWmmxQZ(DtbOCm!V_Ha865)dbrY
z#q)nLKA2jmt_d<<lR?i#G0;>8Ahyu)2eW@R?g_)J*lKqamlm1>mv3fE){ncp^<=%Y
zG6C0CQw7`_3$jxTxH$#$Ma3nZ)VH~Ggkr>mwm_G%l#&b!?BAgEWF=4IHIm_+V7M~W
zGPY^q<*yLJul&n0p!md#$~R00BB+|5j+>~xdOih6J_`hSyLM7!juaDYHHqd*ca-<Z
z?pmmSK>}}(<i21`$LD0%8$cjHUzEHOPY6htM8Q#I6+PB%H5f$|sf~F2f4A1U{2dah
z7_^}GyS4(3D@y|47_*ojbS6rgKan`2qzh^nxyn4E4X2-7p}Msat4j3yRw#)=Ic=^=
z$lPU7AMN<33tnJ-nEglYXvd?zx?|?hQ02YU7up%sA7i5`-(0zye(v<Si(2uh+9ezY
zM*jKs1(TJD9u{+6TlF_AF}`qBcOSX$+_F{)`RylAZI}Z{YR@rW#w@XmD}O~)C9D8w
zQ}DMPq^yrKhBm}rV4-k)Gx{O*^1f0IpdJy?&X-9IbFPQ)!Qm1Y!iqEh`)LOC#-n@f
z5`$<Ty^XOxq}@SD3=nHBd9<kzsKuv)nqG&2RQ^mb#4pJ(pA!UVTG1L6hebu|r~V;l
z%i<pYpnU>Br64mu;i%tv|Dr@x1_B<*T)A0`_Gbzz<4Z9W@6^41RVm!Dw^L$ec?1=*
zvT@kn+j|a`MgkD5z-YNkJD3%eK@U_Fn3qPrki|uA_4D}JvwNjMiTCEc<Lz4c9Cf4E
zp}Us6pxS=gNyD9&AuFFko)yxclb%(|J-Rp*#VP?}7uV)Aq#K~ajb70e+4Dn9{6$QD
zK?Ac7INHKV!5zVb)fWV5%v)itPl?BG8TQ9aUIeR5RFtQ$IKx?C!t(!IcX8xvDh*!8
zieyH$I&5r@i4*;mpdFBY#167YBAisLQ^;@5Ws9W<r?$u>(e}YhrFj3HLyq?J(pqM+
z3&jM`z-XmO+^jdovCf3c>w5daCS#!dr@;~jT^ugYdhF*TisPAIIKa6cG$QeFN(8b+
zha=#tXjWm+G`p%Y{Ax?|vNJC{KusU9b4h<t!P>T{+*5KD{W;8fq~2Tq1f<I3bbOR!
zGps1l^Rat00sZ0-qo0VAu7o`WLw-Ps(~1Ki91E*KDLw-#SSLv|Mhta#F7lwm#3+bp
zz``baJrp{7E7<7;_tqq*<W1rV;fmbKM#*vD@#)*Dm*pI*q8-Iqil2WgH}CH6F(I*}
z$+Emh>rvVA(>qdaX`VyB!Y5PZjbS~JH_=Z#-R=ojNI1=}5ppvv`Wk1XBeK<0&>9iY
z5;7*<g5u~sqgN&?+Sx<yh0*=_=&E`8n>*_D_6j1g=6O~;>eb|QAzP@Mx)Fer3!9)1
zPX?^+o)tmNh4-yL{)t1e?@-DAXetO85_kDS_Sgi%IN&F?AcZK8pe`w9J^d8ctvmRF
z_U1nSh-^Y=+he7@ivFG-?^~jjk}LwCi${_k|K&}NZy(Dd%6kyy;nssbpX*JS9aZVb
zyG1MyEVWBGsBRUGb>Fw+ye97nzf-K(aklVDtf;}r9cFg&L7N$yixS0O{67GzKvcgM
zu;E1k=r+RpA^}?k_efMv;&RkTh~G#o0RqB)4g6Cq`SF05c=`z9lQLrkAtSq(l3V=O
zP=7D&WRuwQ@G%mmDE|VhOE9_>0SVF@1j<EVe^m}_r=WgQrn&_6yE4@+s6Ujc9zp%-
zC?Ev+mnqV}Kowpl^*dT?YeLT@e4)Q5{Lw^h*q2bk{)8GyEU0ZtEKr&gq36T3_u<8T
zG9RgBl6bB8H&9Cl2r+F2I@k#S0Ok?^0Fx6M8k69D7n8eKGk^SC6-vT(W9>slVuDiO
zp$5}h6Q7#P?sU6!zjAlCh8X!F{tIJ*MiYO4Kgu{=G)D2kmwRW<%$Yee_kR2S`73}1
zRs`N1A9tE>^aE*)D6sVn-5TiYx)u77>&e6o1H%t(VqB3&GA0fVWo%eOvPN<0$NI)V
zdNHl*kz@EWGJo8xMx#-$*B^4OYX0I6QqN-`9!ldryA(KXK&0HjVRTF?=3b09YY%Eo
z!=|zRR)Y{IcEeOzwBvdtuo^1Ibd<C`GG8khMWoE#%<aXb_ClZ9VK_>oJf;Qa59L^z
zo(vpw|KO0UB#&8vrR~<vR<He{zuVc`ZnyfqZmZMZ+kb!75~#F)GrGw{*&_jM)AHQF
zO&$y6s%tL=7XMCqlDeKvDvz?j>}Hl*#yOOVn8SI2Ldw!=L)NC@!XK)-M{z=a9v1~l
z4kgc3$nzve0xQ+CO4iOoWn9ALA{Ma7jVH?pYysoHxIZ;>i7U7|5xUHinzhr_YPil`
z5}u|CEL2qg+59GMO_;aK&`>B~26qIepYmh#?q`ta4<@)e$1+Pp5hcFwvA2pTwt(d?
zn0xgR^OedcES=z5<pv)o&_Cerdmy9b_?$xS2T)4~2vkU0YS@#(T4{fVbqpYZWD-DR
z83fG+1SWwJ7KcT+ncO5JGjroCK)P79rM0zoc~~pfZgxp)t+o~>(NwV;+CHkS-D`c_
zm)B>l-R!2M|8wq4l1U~=e~(}E-h0mXedpVkGhe^($YVsbO1Ylt?i+91x%PDx?MCE?
zndqnpRzx~0sw*N^yeEGeGtyBj5r|tICf1W?%rsIaHoJ{fAku9{j-)d2R7J4Uh^5Tx
zik_}O+~^5JC5=_9R<2yR4zS6!dHl{yEQW<tw-H!@PczXKO_*jfn&`snQ8SssSy*3N
zb4AVCK!<s>;td)xlip@!k`Z%LG-fg_vXWi3T}h)OX4W1{8a;nKX0mp({M>7QwHVQa
zN=~M!*BeKT+L)2(s@>jxy%|ZX<YsclvClN4a(`%Kzb!48Sif`+)0C0bhM18`siZTN
zb(!fMNh=K^V6oA%X;f4$wP~cxNG2Ig_tuVuS??haP1329CNs^yIIK!jnI_?&1}Mvx
zm}%~~BSv;X+)ICDI!&YLOtU6}QfUTLDaeMbh%_b?lP8)m)3v*IhCpZ*`E;5|vza`j
zcT}3o<Vst+cQ%hhYX;hUTA<TB@)x2tt5m^Mf-~FTBXNi^J&!tC+a6j(i*;H^m%}QZ
zFs??G1y-}+R9eR5HgCwl$C%11Lu1Xle(63BRZ~ExDyn~ht!z%BR;{2}yTeF#!-&h7
z9AF6kQ&}iPUZ&CTU~MH`q0<Ul#pE5ouhMF;l(uY-9M%g!#0s$2(z;SwLqTv;#LZN?
zD(?+)xz&=M)@XKavNDN|rexAes<bh$)Errru3=JzBZ31D)!Vvj03%mL6Vdd>F}fLc
zX%98gCY^ukXtQmT9Y)ejq&?Iu2-MM5n`o;MH$4=x*IGdIK+W|=a*;;c;XO4yNehvc
zj+!ZrUIV_8W>3rz5t&RurE80vTZEHh9?(X+gxPj8Ex9xzQk=bl$!qOsvBePz^3Xn7
zCwBHT`A21mNGytYh{ugYM+o@_2q_c#JqVAewCR5x(&;)n3}YFwn00J-;z+_eme}4S
zq6IF;aIbcXlmMm!UtJn?!ss^fKnAn|-BujV+YPN*J$8t#DVknF6LV#s28~=#M+7&q
zi^^a_tAvw0MzSjthYEJ}_P`mZg~sGBknEuwO30!ln7=_I7|eA;CTgZNI*OG>jgG^_
zsosB7+KdN;p*4Cf(_~2|la9t}L(vpc=j$O<o0<08fc~6E^!lw%f4bZBZ{5@4uQY4A
zYW#u5c(2&q5br%|#4_g68jWtm2_0rCl8ol`<1OY4H_^?4&s*|IK%QQgOd7oi;5S3N
zMoRF)w75XK`797BWElkCLT}aS1l>Abm(qU;I!0+!rME+QBNVn6scwj?(mPNRY^$c~
zdu>+XD4{~g7NZBpy_4Q0oaEi(2w_{L|AGKgA#kZ#m7}?BuwpU05`f4Z^j@7#(w$7c
z%HlA#&)%ie?Q}{Mvd}oLb0F{6={CBDY4xiG!=ie#(@NUm+?Hw2?W^=brp=WXaaw;H
zd;M65amvl{^I@GnL?6j#RB5~Bw3#&8MRNNnlNJ?UX)7tD8m*w_+&a|rar#6leT@2;
zs$W$q`_Yy*(xCsT{J8}bRr)mYAG(=V^LSb&1O)qM=z&tYpB_Y6O33BH@|E*94}Fdv
z5^$e~zs8N;b`vKh)7x_%UNjkl_!)o7>U1CVGbw?9Mh`OuUR98~POzKHM=A}90Jv10
zKdRFg=rPC`2<*RZ!@(+z9>+)ANTV{RJoF{OO%;6^r6HARPvzXZyt27yw*D%e6VOi}
z^IC}lY4=@X33ydeZGxjLhhx7+Ul%I-Z>E+1IlfBYKsL*<E390XgoMj0FM)rTLN1=B
zZ|d|EeGAkouTCw^>2pKPGL60sl|~aC=JD;Q3{EJo*+bu@?+IOfU-)wKMC$yZ0QnI*
zTq{wROXE!S#XRRf<@U$)oZ$9<P#`3?f?3JyPm#SAp)QDW4tHvdrbPU8c<ASLiTedo
zbq*tNP$2v&-&{(5>hhSmF6DnWI{j9Z&eDjLNTZ8QZ8Lj4^gGdwouvO`nmJaK`b;#|
zA?ok%QG5^pf6(a#(VDnL^PWI~4HOlB0y2>FPxNO&;xEV_Y0KX9&`Y9`d4c{0W1&Yt
zTFk50L;s)$gl7IJwGK7*#LP5$hnH>hz5-5S7);XLG8@2<Lja^I#vFfAY9(5&TwmZ}
zhtTkSECvlpCvT3XM2CmnqNliz)xv&OmQIyRa-GX?Q#H0AjO?uUa4CCq)_IapC=`9w
zrFh4<Y%tPZ@KjU<p2l?frQxVthJ+9rQ;>57_6{yD;psdh-*p!Ps60z&pUBnIi^-<)
z9Js&+jpt2}EkzXZ0-=9=3>c&_h6+bdW^BWmOUDy71O+*p7cm^;BxB@ogH&A%eU^80
z1r?PXnUgDdsm^m5qsQc)q?v-}4EKX$i@zwi9<Js<2^5O~M9YVQhnI^uxSdys{E%vj
z_oRD0d<FcEeT>P%nTo#F^e|=#v9M-b-W@J9D|wxOz&NpBROx?2L(pZ!WWYBakC-`Y
zVYHZIv+74#^T#u>bQCV`w_A@IjW_DNK?K}_98`y8ru+#j4e+C;-$?Y@pn$AHS3cpi
zy&HL83;N!WWgW@%sEk2mR%6qqy4|5&hc@r5YYa6V+TGT)^U#*<ElnP7LTks3ylJ>`
zt`UuMjclBGi#>m!<~*Ypu6ao*07~D=+eB=HKz8hz8n?p6AZsR$dU%Hoh}mUY?)*_B
z4Yx5ZtSp@2CKx?<HwFye!&F&BF(a-mNNhnE#gORuTKoRMj{ea>zhKOnOUL-3hxhS*
zox^+p&0vx9LRMFoIN&-_boSZ&9oG2}8)9HSjtGPcMnr$Qt79bAiXtR(cP358%}7SH
zL);0k7infmQGJZfPWG8moxAvYoC(M8jH0?0<fAc1HAt9D(y$W}$2eXBbo3B&iXb&&
z5Q|wxhsr(0ov|2ImC->?#(;m!N*>u2jhmK88r<yRG-paU#h80$g4d&vV!TzVDkqS&
zSkKSLxmSPZ8yFMQ%F1F=+csKX1h?5%-s=VW8<=JnL2gc@(illqeq-STGwg6ix?2?F
zc)N78o5#D<7zdLlzDeg>7~|Bzi!yu>V-(#i;3ap`TXepO--;HbBPv?U_Ke*uP9AfO
z#Bbxb3$xq?Bh_krJJJCr*L1VpQF-`Xb`ii_#mIk3n4{E`(P{2ZMw#YMaGNts`VM}t
zP%y@+NolLDt)aO&*COy;@&bi1LOEI*uhjVc@W8@Lv=%d!GP=yhXqPF9*$3=2C5@60
zmvbv7PE*BcfS(WXhjsoSV+wNZ-nA*PR%0>vfNXtlT6o`#Vl?;Hd-&u0384fOQ+KAP
z137;m6e{=Ei(2(5zE9BnbiU4_yYH^8k9IXD(xyxhp8-;b<UnK!N$x@Ztibskb}E}C
z8QAOdIzPatMfY@0yk$iTg<LRowE60d6l&JPBA=)D5!hnK&h1;98g^;?g)xxwo{Ar{
zA<qKxwb33M`-}G4m+Ung?ko1%R}l&3@koCxlZqadH@<a|2vpc&B%nov^@h>D7lnYy
zgb}lE=3-Xl2-H>EG$A_l{{%l-0;l{M)7*&zZqW*rF>NF-8cc<rRxBiP)QavE&4#uW
zzM=DZe#-U=d4+@eQ80k!?sfQ^{4JeSeg;OZiA9cR{2f>`exw6qyobMM=Y7l{rBQ!$
z`AKvVRub*U5AAgf9kWL$?#v|8$djYmh#zA{YOpe~4%r$+k|sRP-y`qZ{2h5}{!T0D
z7i#wl1Nb$@xG@D>*R`jtSSD@Smi?)`ROFxO{G8}Jw1kncL{^p!_Er!7l7A&?^RHbb
z{!OXB#zFj@$MaJM)V&jx)Qa1dlsA8&jKN~w@U?8D+ejqLSW23u!TwPB_jv)wfrP-Y
z%74HBo;;@UA9a3S6m(r^+XiF0ta8+~a54JO{$Kd70`(<0aXQ&6h>CPH5uVrw(%<<X
zI={deKGy#~{8;6e(a6X<hlZGyGG8OE^J2Xt*#oD`4KdoucJ=}f>HLa91@nK%u5OsM
zLsb-{l2ptzdqj5F3UI}#xOBy#xbuB|9^5)6FKZMHkP*1HN73maxT{hME#!V3@+gxq
z{P2s)WEeOWZP%2k=m?60K)q$9ku8iK@r#Wd&oRZWP!+GPl!>%c5<@Z(vLgVN7KUQN
zhzqTxMWxw4=JH)BS7yN9l$n3|;WPJJhK!mJ$`|yf_{2T2Klj^4$fL{^zke)L#3V8%
z&hi)wkX?tnxKTUeo^D)l+FRh|GNnRS{K`TPHQR5Cg)I9Ee}0(&TV?}giLT66Dp9^r
zP(<|EMjLx4Wv}AEWlEK>Tr~tqiJy|-S;x}_?9Q&7_&lXXsTJtU;mUuoSWT{1jv1Lm
zq#OOZ-TDiAY064rAz<cG)Z$m^*>g!tS*2Vl^srjPKqr5XXfe~>76iJc2!Z|M2#h9~
zG&{weXst~FwAU#?ol2GU1veIjP^z*4Niv!^Y8^oWT32L{ocL<FU?@|rR<6;NjS7Y&
zS46~`M`?iH!&r?>O(TD)GbVm^Gvyt*tv!EUoBpkJJN?l_etC51^e<VQT2iAan3vqh
zu_)+ccrBuzBE073BxQ@zjOIbvieixKhsC|Uri8>Vj72V|M%}I`t>^-j?M$_PxET2E
z@E<dxX#mOWKU}N*hRjg@v?Yr{5Y#bkxkbSj?-;R4{n3;^WB-4+qA9xza?42NQTBqT
z5%pn)?S_&ttNZQSNoXa^wCv*djl-!b7ett%o>MSIRp-jCe`NZzOPA31$RsRhCme*q
zYGVVEIF>pvNG9Xagz1k6KkPwelk(@1nSZO1^mit$xIbcbnC%ccZ^Fa*wldc#wDl&^
z#_>_|wu{@Ji|~KmA$W(cI>m3g$OFifks}x&b_p2NTX9v>nu)iYNx6a)?;=%}Qp6W&
z_>Yw?qDhDGR!XFmdtF(YlBM!2&B@Yb;ZT;Ac$a3W_LTZ;)c{@jFd=?IedOIcNOj?s
zsw_43)0XPcva0;|HvHG>-QnGtr9J%=&e8$<FEmKkg%5umXzeG%d4^2aqf`|RJG@<O
zPH(g=OL1@28A|0>Ggv()R`=#tda?34u@d&a0f62&o}o7l(Ax&-ws6onNVkUrr|CUe
zdS5@?-A^AFqz{FIu7J<kPxn4dpJWQUeeQ?pvrMP>oX;iRPcuCZ(m^##1E=`oKGpk(
z5R;}2(ieY#D^Sn&4V}mO7qj%0Q{)4h3gtZMQx9e7e3qUGy84Fh$NqQZevR0lx*<zH
zSS<j{0s5>BTJCZlmTymH=_dl|7?6G@k^BP5IRffa-6LQ-9-?2~O|t;}YYFV`qtZe8
zZMdKQ_iO-YfDCGo+NWjd`BOAq&=T)?-lhg}w1a;o0;)tpy~*bqq!+@zl0)7X`{|Ea
z`fHZ{F80nt=q&x~6qV%#wb{7vH6K1M1YNGxTDj&^v#i{E;f&8!t~n12Ny{}UYEYA8
zwF0s>GZ%sY@o7O2=o>l<JDG*dUJ$25CgdvzP%kjD>=N&*eNHgN+5k^(9i)@syq~9d
zd$S|#J<T(-JbT32)LdZeGM=C1%fhR*duW=VSH=soyku|R&@+>*YZ-rpp4hwhG}nrS
zm8Yo92M4SRy1ZRj4+q_nhbx`82%oS&);d2*GlkpX%aP^vU<OgsN9G`J2$%8I{d~<?
z`?X%YKE#{%mT~g{x8SUER4zgbBDsL$b3=X#l=1cf-Z{bU6uII86%m?&u=uPh<6Zr{
zcYqH<2C?9C6|C@~a4Uag^kxuEdFk-7vY*?tY@TwQ8|1EVxO$N1hWoj@pO2hot7VXH
z0C=GKG#`T{2KaS{`uWB|zA4;-$Q$HaK+;v!&nE)?d@JC?t*7}Nf<85Z;WB<_mfsUz
zt==OXd$P}6ZtGmwu8dFS_jJgl_R%Dt+flAc%LKw8Gr;f5^4)(yt&Hy(;CsWt5+7ba
zmgP@o`TjwE0Dk0Lt!4S4at%D4nYt*;{nEWud=9|5#Od_cL$;d*RbfBvG!KFhR4em<
z?sEl8`rsy5c~q<@cT@#S0zS=GA}9p}q0{{MFfBNzBnF)dY9*)n%i*A&r&i)~g@lxP
zp4jEpzLKg@gwB5z63V^0hiRVXuMhJ1aL5Nqea>pA^yw^rTV~;Ki-?m0x$u$lwMr7-
z9md9XxHZc^xSLi4ggt2z9?!~@;veMa!UDJYP#OP3gdYDqkN1nS+{!`c0RLt>|2AI6
zzdK>9adA-fsZY@E-0BS19rw_dL4H0g<Lgh=;NZ_${+oYvq<@85pP>1ObmxG=_?t#g
zo)}PIPkozDZSCW7q^MTdcj&X*`WVr7j=o=&RXlJXXhE3*3~{`|k5gU97PYEOnI;4h
zLM*M8LR3@_DrMo8er0-fR+$xUIY(2gA9H?~^lHb-mOgTEOZ7Qw8&qb84}<_QC#%eF
zaXw1(!j6CHwgF{PR=K=iSvsHuaPo>W<%+Db2D_!<ki)y7txQ>q<*TruVqsYu<Ewse
zR%!a2P@7!d=BNVL=4AuQHleX`ymRZ>yozC)GNnb@=66|TN13uy7`dcC<I4hhWeubG
z^h0IJE;}ohDSJj>hXG0^0N5rV%9MS}`jvxcM{$2#4UP}xIUXa4kzbd{!0bFr)6p<Y
z)=HHK&7nn9Nmn}`be>V4Qm%ClIM2!FdFPMB(>>ii$9<g0z0AErKG(Q|^10EyNj^8Z
zo88@bhTPlbbC>%%`D}N0%jeDR6KWlvC*1Fr@F(4Oil<tqhU9a*x>G)Psh#o}Rc{tg
zQWSq+J4{+N1ojk_HmJ0aSf#6nXmaiwWQXV@q}m_y?>d!kQ|UgH?k9SgR;yICVAbVA
z<P{Cl5E><|C@jDP_#!-qXj2iOr}98UXsb#lqQPRnf%J*??LPrDa{?g9Zv*%*#_13`
zJNNK5*_$@jC|&Sexp7jGeT9|_2LDd;hiHF~P=-E4I=RL`6J0j%Wh%w@5cLgnz&EL!
zg7zh(5b~d-zf99v=%P4`<nk3tXwH|UN+%7AI}T2QNJDNE2NwWQUT1Zht5MSYr{Mcm
zatJ+1q`5X_J}<w;zuZQ-Z6>*)^7AUc;8gj={BAuuWdX}Ci2pqgzfwwu$X$T*qK$v^
zd>%(5mqZb?atMz6>G@?Eb;h0%FMU}!E_B*PN`7~y<X|+KO|lGT8Cf3|rwX=GN=7z>
z^-5{@->}!{<CjQKzV-rnBr$QaU}B-ogxriMQ9NsCo17xnVSfii+ec0^A#)UZ=>^6c
z!SQ=w@_TUz8dv%hDBcg#K8SdHnx=oyGc=WTn#Nx8DxaY;<q?{$oTYN*OEkkVk7hdj
zG|RD=e2%3w+p(JFI2vfKV+YN1bklrCf)+U5On%3$beZGZRN;7u7CIfY$f?p|=M=i!
z>7^ykN~&~L(^BUuTIO6sRn9u9c3w*X=RvA*MyS?#f|ff!Mk}0sw9@$?UEyo|5v_8*
zL{~chMXOy*Yg~(Htt&w5T+1owYNqwB?R1qZP8(cDX``!`u6Er;*SH>}I`?#{cdwxa
z_np+}zMGodKcr3SCfcmNgSMzoQ?vRkZB_paU9oUO=*sbLP)i30w>@zreii@#T`iLl
z8XS|uaY=u%l@VYtItJBJVBIKTgL;?Tws$1CCAry#4^+hA3+3T!h!5~FR8+t&tyG4H
z+XNLvK?PCqfiFZ6Q4x{)KVOnH?b<?rzx3Smedjyx@0{~J^y)qP0jyH(3O8SM)y6e%
zso!SBF1J(h`bd4Ox4x-9<|YT6gylJIDx7rVHrIdCcEYwYHaGjNOgPqW$1cxglbQNR
zua(HyP4xqP;iNSXb~KMwt5&XDc?xOMYl`Q4vxx*3GW}L~1yMWI=cH^q?WFp+y2DOq
zD2wZBnonw86OP+E>fdHUDFnLQY&vFda1yq{LO0#l(wDa43A<%y+8P+J(=F|(jAtbh
zi&uXbC{vid-P&QbB&<|l%lX^3+cD2Tg~Bm<HS0NvmYAE0Wz%Up<+Zf&n6)io8!&lr
zhm}~IaAQ{D5@#SUZDxl)=D00_pQ=zLG;t^6t#{H2HAO7#Y|DzLHm4JZ52b9cW%I^%
z9-1R$l-ld`Wz*WD3QIdCF{C>W+e%4!zQTX&cQT8Y)A-2_6|5J!)0~v!tyM@jjMsZI
ztf<~}EMK>dOD_sy4yr3rj@lpssFJUFK?L((p&({prhFY8#4OB~uVWPa4RWpq#|B`a
zPN9shr~i&>SlTf$hO{nNYJ`Es3N!j_?*dB#nUB`&;=!V&L7adS16YCvg?VEvyF7o%
zxwEoPB5tP*GzPFt#2aMSX(jE68sy2zER1Gh)<RE<4^nZ3aKn*=N1iQ+B8wGRDbh}&
z@y+h#CRQt$o|~r%;$#u93~LmQpEQEwq-fVgL?OvbC&P@SqulhB+Od}eaXQw@?ip0q
z$q1Jq*5#MZQkX?!*KNzViL7T|V0nN2L9EYPcecWUsZ+whIlPcoEM{kzk;|EreGSuQ
z&}&&S&Edrb*d~RBzH7%D0yr0MR5<Z<9x`wqwapWr>n7=d^CclWalyDU(RF3Uvy%ok
z(sOp2_qz75+80nukGk4ck{WEn=1O$oBHr;{%SmL@_IdP!)yI^no-AQ5MpS>KUBXH+
z2}1*0nRElPkYGiqoh+3Y<jc?#z@>N-!x(1)_Grbnd>CU)9)__kVP!HDF)nHKB2}=_
zE4Qm}a;HspnGHBprnIVc^;;`fw{~TdL0m2tZAYSb9Sc>&Kx({4wfY7I=>A?;inr~>
z`W23yG_8xJNUTjGBSH3Pt-XJXI%I;_k+*gywHhnpZEhmLbf<P115Ei!J2~K8*})Tx
zMbQ(QQr75*x8SV-ycusJX@V;vo=%(7uyo7Bn(=nLL*%`amt?}8fp--{sadZ}r!6hh
zz`Fz3Ek(p{#p4rVS*T!gCEtVh3f=pdK;soO@Bs$X@odJxWd_b2XF`8_VV%l-5Fe_-
zb-12Z9=UJeMrIV7bEmz_3*y6ATZNnO5mwfeUicV}mxYhhxe2$g&!(WGC%b?hdXv&_
z#wRKnjaz8-ddWQowJu()Gj%3DB{ir=YSw2ILQ`@wa2q{CkwJV;$UlqEGYt7`){S(|
zguD=6?Zxeq314KYl_q~<5MP#7vK@D@0eJ4ZuD15}V*UK8lrR@xqyIQgIK5Y{cXy@|
zt`%=9%qj}2C%I*>r_|nsyG5I?GoiDoH#-9zGAB%x(1*?7!F|Zd!6BB_v4D|53x|xe
zcg5_1{GIzozW?M)@kri|Z*r|Uqc5L{{Y26>3-%6HoBFBSPVs*-1@SH1FI>J&ZxppU
zE8E*^r|tMg+tRJ?JB(U!uRS%8EmWrB_Q7J?EErTmV&J=zgiZIPhXQyI-%}{xylF#t
zjfo#9G>#FL@R+izJrckn{7_2T;bVD~3j03_-~fKi3qvmP4i1q)JT5LffS*uoEa7Ij
z@-vw$4&aI6jn#i*N<9AaaT}ZZ)9%jvDEJFHrOnMI;&mz4tLv4@RmVHkU&l(uoc|Rs
z%_Ny#Of>_)W~4G!ue~|VLb|A7LXDdkrQhOr0sIEfOqeB#MPu4o;tz83{-~guP5hbe
zpp!CgDncdyB7M*H3hgO~zlwW)iN8@bH`AQrlw;!W92<Wm<<c(o_gF(ucwNH`CI162
z2G|GxS*-c_GA1{I?)$fbZ*$k-j##qClmEfXm3RsNrD)IXaCfrz@I^5ux|DiS(f`A%
z0bGGm8nV+##oe75Q}K;pa=i8|C&iL}bg30>{Z_imz9MU<V!Em*zbfN-RZjnGb5eyM
zn#xd^KX!kLE|CGJI3cP^$*O+7VoX)VLU!`%)ux(3<E8mpDL3U%Uww1cEImZ2*;2u`
zOp)HII-mlohCDf`q&?{trKT2ypBhxPYOYYu<3&4S+fX5Kf#rA`q+f92YY(cU)xv;U
zpg3C3q-rHMjrX`@HZHw_L3OOElS9Xi>uhA2v^;-Lj6Xi07VGJJNoGmPR41@`^y*!O
z(<VunEmJ1(c*d06pq7%iYUC{$JJX)xW;#3I+3~T<s+vkhsP^+qHkw7dHRFa4US*aA
zL#<$gC_MD?OA`nC{3;bWNv#T~m5Rf7rBf6iR4225aFxs($I3y*_Ui0ib}Z{jv8dzC
zNjj5!c@=-ACm3~lu?J}B8?!0TN!lg0oDooGN+Ug{SWE19U1{s9>m@fz;P^hb&dE@p
zI=(EOcpck`-fK41dIqYE&uuEv<?%&-o;9#ZH03ZOg|ai7+-9fs3Lk9coD69*%4g4!
zM;kyGEI>ZkG~{zlLq6{S_()%aqxdY}K&+AHD+qrVHAc5?4VCS~+-3VPziA&9g!f@#
zsC*w54dJ-EAb)dEkK^;_%%zk`?*8i=N3bN?(Kv|tIV>H)vS?$^5Slc)Jcm`)t^Ak6
zDML7I5DRiRa}QQ8%b{%#nt5g}e+!~HY#2sI^t?e_80|cWioO0>%kD-unQY0y$|2s}
z7>$2!B{eDLcMf7<q>RTR<%3uhjZ`${(BD0XWW?~dniZ{;Va?sFHTNLU6b_Z;kPVgR
zu<K@24dbeaxfkt%UmcB@hbU|GxsW-6-O)&32-og!t@5`9YlF2_x8c~3SsPp#jm*$W
zSA_y0e!ai@nxNV{`gAA|F+=7zaDzhr<D-8HdvKC`?NMyoOURG<e^MM03iMQedI-1D
z%)Bph_`)#0)V+7~LF!jAh_B>uXE<aGV^9<urWt$j+wR)Rid*qW$T)<Dnlx23VrX`T
zI5>xU#k=<vIX)0EN3_(C84838p$O+GmzPj74s^%}4n()gi9^v5JV*_P@crtChwy*s
z5FX3nrx7!UCqrh$*o#haSY=2S?rVw`Ei!tlpQc5__<at4s($vcS;c*`r}{Z<@$-kb
zRKzH2HESz<Z;G~7eoCEMYu@~7cQFO{Td0}cS&|5<O17hsG6`_?3&Z%=-FPL(<W;_$
zs@TKW;c;zqdALTIG)#4ls6e#hUR-|>jfTp5qW&5c>?*5KGrP)LD{^X1ZADMlkUA=-
z<}+<_YSA8K#1Wn1hKLd3QhoKqJ@nb5A%l(>QHx18q?XW~KPACIG=wT@)QJ(Z>|Pkr
zNTokybkW_FIkk+ze5!LVX7jf|7%k_=-0-k!%_$oHJTWsYFnkclh02O<D(`=(QKwGG
zjHbqAIkmQ1U!XX_g`MF$N7R{7xeY^V-F@<%k8O==(`Wxwqs}e_m-|?W8~9$h828|l
zoV*3z!EsvPAV*Yz-^L*gAHu^LKFNVdpo}mA|HvUj;LB{wglxD04QH^A36xGFuwI>_
z;pu9lhDkM`p2kz^3iTch-=}}B)9`xr2@P*i!y0~5J*wfO>M`{UpnjsB(D*azS%JRm
zd>`@8R4p0?RM>Zm?=u<~DEO_u&ud(u;J5qsX<VS-!@d!X3lx06?|zL76#N0-L5&L(
z{6XI@G%ir^r+t6WxIn?5^Sz*Pfr7v2dr9L01^=(VLgNC7`>Xx)1lNC%IDG0HmfdSn
z_di@@V2Odwmoamcb6>zfxn4L||9AEO?FNS%1&p$aPf5TUjtavVWsRSb#=teCdKI$`
z>{e>wD0@ZK)ci;!GX2x>GqhUfbR;)vl2fMF{1OBAjN;lUiChv<p{GVsHZ_fb1DfiW
zV%RiPPic+Lm|mk%HqC$6h{oBnn<wbZlgVlvM#<`d!eI_H+&h6GD()e_Lxoki%}_0`
zz)vc1<`@mP3RIB5mTt6+ZIqR6h|BXEFX6aRcIYzp=>j1~O8M^0r_$jKMZNj<ULZck
z8#xYilWq(5FQXr?<}k3EbT?A5FR;bGf`D3wDzzR#)rT1>iJ3UQwV37GgxS7JF~=7}
zwXY8~zN>JQzYDeg%P`j;$2`A-`Thh#{sAq=ug4Dm{{c`-2MAY7nUlqnzkXeR%Sr<=
z6o&s;wOU7Oy=~l$g13%?wTpVejUWn&pdh%6)6;1*b0L}5h1du2EnF1Ag%99EiD#-J
zA_sEL`SYDWA$k9JeFIR(g1}R+chPuoZ)9*sans#(gO*!$gCt6omYGUoFG`xkx*<){
z5^uJp^@279ceWE*cef?ArK+2MhF&C7PYpck^;)gA!>noi%(psPvtZlO+v1kuP{l+>
z#UZO*GM3L`y|KBy+3=dwbsxtd1WK1l#{_hwGzqLECiFuio0|N4Bh!?Oe-hhFYQ6lO
z5A%x^F)T2BE4$LyG7kOon_CL9B1YNoYy3Eg*l+4|z^KH}{r6aCNu@h~hR(=Z88R_*
z`s;F;<+o*ObYI0PI}lh}{cG?aUb_+~tgc--a4=Ou5oHHs7$3(7Dh^7R$g5d_;X{5U
zRJbYf&kS+J6jzm;;Vd{DO!7L<-69GcKzaT8`UTS)eauw*n0p2WXklPc_ykZ(2MBcE
zwK8e}008F!002-+0|XS4nSe)s)p`F;^th6&JZ#5FL;|_7V`58|odgmGg_rFFaI8GA
z^FSmeTuayXC6cbty^3RAgEi~{+d5jdHt7nCj+w2jYc`NWQwVGwP&V3i?{184quryW
zYsc1Yuz~jf&b_i_$A)gpFF&38o%5aVeCPZA-{bhz_rLf&5nV3s5_I~1o_hwj-Pt^>
zrH|?POmm_+J<{CKoHla>BdghlnUCkpjE?!Dp4Bx=$Kse~#nWSY`j}P9S<Q(NEo<o=
z&4tl;PAkL>DdY0XH*em21$c|ws{2Pu*(@fkF)h9cq@Eu&^15C$@}rnNt`{wwh52or
zmvwH7XY}LEcLzua3JsZmrD9sY&dBP5E;5UwU86-UlhwP%i&~+e7rXlNmaS#83V8)B
zyG=W;b!D~uXxHB1+w`=pkYA8LYmScUMM0~R^XyN`#qELu8FM_JHMNYOi|1q9;Vy&q
zBK<@<Te6JfQm>wLTDPp-T3(Z<TvfZ-$lH1`uVuSNz}S^F)5mas;jWzvZijIHl}6sM
zuNL%?whz$v12vp)ai3<7^;njk8_r^T`$0jTw)TTzT0+Z0q)@$}?f(zG6>1F8a;gtg
zm=*`gM=Qb<pdf#(3R8&c`0FCLQ<J;aZ``<1(CEAubRD`qDV=GUU3{2JN!Je9jGFE3
zAFz47JN7Y5*|(#Ay4{!6EK5*hTYHTxIk`Pdm(W_af+{Fnd#pmuaEN}wuxv{j?B+17
zr`8a)(518B=IEqQo1i8+Te6L8SD%^90);@frBGB*P|p?Yi6o>6YN+ZVIe89hbWl7*
zG3o?s7Bj2@&aH22KRnwSVcJNWSc}bqmd;sI5ZKf>Bf6)5Sk&a13T+KhH+#Cyuyz<l
zXl52C!gPgmp#(0dWq|&sw&dJ6+RhihlCI+YK<1L!iYs)jAjPnD^6kRZORaU(Lw$m7
zy<U1p&48(B442pv>V{TpgPJjQOU;|Mnl|&cX5>{ZKLIvJCquV7)tx5_AoPrCo9c*>
z&#3wdEp2CiC)7>Td=s4k+6n)Rn8ln1lU~twAxaL<bC(Ob!gM{|5TbVK7qsC=gq1=A
zf?C=>6s9u9c84fQdjxqc;|^USsXt8n=tefwAVPgXL%H^`U<Omo{a>xLA4eht*th-d
z7g{7t2k8*2aufKn#&CdcW<)^W_IZraYnnFH)C#+Qq1ceE6_F~|Z&K(ZA-aXp)jr!M
zc`e8J!se_q4~%c+lQcoQJ{&82yjJ9^PNPPhXBY097PJC2#Tc2W=EOd?U<ukX4@y4V
zi2(S}4L$MATeb#h6s1J6SbDltH0+74-N<Q3gFB2-ox{OEh{4<vE%`M3y=k5^T|dk(
z1Ex8DM%fVEM$mX=t#<wSLdk{*UCSwCa&nlhyo0yfLsTFXqeX{%6|$@O06ep{9|s`u
zg_!rX9qwgFo}h^kjnf^7s!}1N+0b3VQhz^-y^HQ<jqa(6legJFRy4=8Va}EJLQXns
zT6&m%oU6(>eH3ys@<KQXS*$lq_tQ_Xke{r7UaQ6=y(J@?;ac+3A$ow3R6oPfkAfuY
z%+J8Kwt0ho!r5~Hq^BeL=jdZ0`dRvUZUE42*kfV(INiuW{s~Mmmh!mxnzp_Rce{!}
z$S=?@vM!$#6kphd3+z0_J5Qtd*k)DN<!$q-`b+c~=6!@~&Fv-hQ(=0HlWjZwG8+(o
zotF)pe%8s;zk-wxaP<sZX0~MOT-U?&t1O{~CdDHELB_q2md%@Lj?5P!>WBuYWY)Fj
zTk|ROSM&1Zv<Y=gJFct4x}H~UEr-}gq8T^rvCh_fpP3&qiaFID(`@|c>W13QLt`2u
zWvG<fpcaZIHrf*^!gYera<WO>%_g0H?mDuW%DskaScvW-r!Lfl3~y1jB2;tZ7zUHa
zx!cu|qM1V)u!|*&)1W20#ZJE1j@ru{C}tCCtA$xtj+!(b6FJk<d9>QtCS>ku&G)2j
zIHYD;br%jAmSL-7wq39iU2cl(<ZS6S$}=r;7iTOd8%fot7uY-I2z+JWgj(}|A+h(5
zIMy0wK&d4Q=F!wNE{W^bvUaGJu1lw=hHbI6j~f6Wa^SC_Po2TqU@31KIUOCGUf_KS
zeQr*rpH;7ZBScTp=h22Z;6t}CPo}vUL7kP&Ow)9SG8@>xMZe9kd>R>Jo^^%FVfq4{
z386PUi`-Gl-(eI4t(~`~&g8d$SuGZJblq$eoM!DyA$pFpo}%Y%u8)Euv%0LE`BF|V
zO1DF~^YjAqzc@=?4U0m*i%`RBXSZ3@cV_h*q#`nZkK3Cs(@V%hdHsa#F3gSX>B{;F
zeTCUyMMb(m>zz<@LZLr^#)#-WD3oFPDo65b^fhFh1^aQ1`Ta$WUrm~S(~NLt{5qOf
zOB<0Hfn^E0^he5BQ1XxIPeSxZ^rw6>`apl~7`g}C^)H;1^9|(5suOxkBO{y$_Ll6L
zO7d5NR@J&`_Ud1U=neKuWX7|#3@+yWCPc5(-=e#erE_{!P*+=We$!PiGrO+gK5x>u
z*tOq=SLQoVp??6}#!+^EVeo(As`iic9sc<!??TZENhorP$cE{QbdC}F{n{$Jw<eJO
z1uua<vxG3^CPnU41N5()(Gfvjj{X4syC8v}{7)ER!AG4!?{fcTj)v*KIRgKS-b3{m
zL^k0x6`%?fgKgYKA&l2CpmLvBglV+EcqHp~dTgQi$?JC4fx&)%89$35WgoI?-ge&A
z%i7xKG-kpt6nI_)*!{qwud{$YFCglGu^lz3I3O0I8Tx>?s3MjE-3-eEMYKhiw9V0G
zHW?Q6q9G)fiN-kvcfr=Zrr?Sum|Uz7w0=l0A~w{bZkLLAB=sBi@81W?Dj>BY|C$*c
z<`k={k3IKvMc{#d>a)!QgUK3`IEzWBwnkhW605}}v$rJ`fmh=a6fv%edFQ!@)H`SY
z%o-#$i<XdBC)Oh;;KkLeSw_02gwlW%?G&Y%Cc0{wg@hq=#HC^b+YE2d1^_l)%A#*O
zVClu4QAiAnC}4u+7+}J)aXB3j@oGl8K&T?RAj;D1L3AU3=-u|YB^+;~1$*Z?B}8lz
zn?quwxD2L&{Bg5*Y(L76Swf-|{b8|1Yz;!EZd4VV;~qWD;cer7Q(PeuECcWNB~lqJ
z<8p+>RnF4Y)f&flxB<0z&ONSmdZj_v^?mSsSoER`6g{Gko4<Kl$67?~WJFyD!>I@`
z6~Y-ecqqPq&5^x!`s5)K8MvzcOlA;xAg*j%Fh_~qd<8tRmW@gi*l<hI=~Tr&)^Ve_
zan>Ih&}!=(QA3DeJQ_HDovFFS$C(At4v2#xv0og*2E*bOx>zg~(B_0i3Yi@%H~WbH
zEhEB7XdXrpB^JNw_51~Y%bFY7>v!lQS}AK+>3ws5w&VO;#8Gzht+W5Q^uHCPh+)*|
zY6plHr(Lr8#&A(xzFc<gVz6X{9ujFWf&@F=<Be;UYRufaGa$yG4k7R<AdVro7Uk=7
zzZn)eZbMoGBCozSzsdG8AkdXGxJ`3HwH-gJZ2<ujd2&{JKmfGS4~~uLcal@>#BrcV
zj05X`3`+P1*GeDTtrhk&4`7=#^7@`qZdfnM8LCGKQs62Nz5*1)S3Un-O^#t&j8TCP
zm(WrYVgl3#@Ov??j;4-GQNuY}o*I~<rsy-YGWHBbI-a4`XQc0gw1zHrHi=iT#gDNr
z7A@1dLuJ}<nnGu(YhaSDiIwTH)WFN+pRD|UAbO6vQ^_gX_WaeJt==Z@#gEg)(I)Ta
zRKi!L?WZUdi{Rs$LnpmrvhrqZAo?ur5Oj)E?{lQ220R@@4cA4_(yoDXluRW>bc*&)
z(kH<MXnP;6Wjk;ITOsOsmQsu81!}>3ODdI&HXNR!BT)7fwZ-K5>tg5V7FO^m=;2g<
z@+Ddtd*1sP1!JDgljIdI*B+6%;E2VNhzby~FTg~L#2xs(lNMKCY7bkwou~p!dGOid
zQg!4}XiIf%G5J6#)D0Sinj#hWgW0=X2Epu#!`^yng?gB7ap-ID^$xAAz&DF9lY~d^
zgaT1G+>ed>Fgpfe$KkDyLF^-#odn;1n*he!*i!*tkaQYxy~^thov(JhOx`mMV`nM9
z=NuJM32$tQtomj2r9i?L@v_VAOl|c)LJjeV&(q{D(~nKU-Smkj|Ds3P?{CB--ZGsm
z(@$al1K2-B4|=xxntbu+AE(ZElkc*6s@!vy9!e#!`C%BmF5+Fbu}q&j1o4=E`t+fb
zJ|N=j9W3Y3)SfauehMnZQe}DqXnQiLuvbz?5?)Vq$Qv8-bqx9ALk+(k@j5PgDg_7q
z=6R{bd03!{E`rGk2yT&MJASuJJM7~W^1V+h6uM2Jf<mPVts<H4K$1}Cz6zTc7I&OD
z%?EeALxBpU`)d|U3TgqNGh@<!b+Ee#fe)}xmyow+gLHG(>=UIQmq2qL{P+-#e-+<B
zegwH;dqBd3XlqmgIga5O#_xL1Rcm6f@*0MGG`40l5Pz1QJxxB(QzsX}rr!eR6Hj5M
zkau59p7*Fhp((NI9f%Ba7wf{|NjH-`evY0?rFO%j&zI?UI7VOQ7(I!9kKY#vuh&w0
z_%NU(UZy`hOMfPV?9WfpQnvqJ9-6FtZITXm#Lv;|%=t!&K{Q3*jQFPL@5=P|32(i3
z4zxZ^ORLcO?quaV@sx|FxA1?ma_>MCC%tvPqfFmB!$0Sd%|f_JuQb|nIj$sCj?L66
z$2Qt3$1CV+Iqsxga!k^HUO5iZ5jh^AqcAv;hOppqj7&L}=s`L1Z?6Q+r{w5BD9bol
z!lC(P>DK4ir<XZ7;JIlG`KFf@dX1wPOwA0Q>Dkv68V7`k-lbI)+{!BjU|!02m;5`b
z;0Qrp2H<!QV?F(I)oXM+HgG<_G1hUGesCtWCz^ViA{>UXqYeLmHbp-~_#nU<{sTW9
z?)N+RL7bK8eU~+U6pc0W3eWV?c^pQ7gde%X!47iFbqc6@;T1mTc<;l~5hUK}h^A!L
z9f*}h&^aDipe#ZV*eJq|Sc#M;4!Ngx;M65J^{iN47Ava?t=_}lMv)OgMpL7RB)lTw
z6A8cMTboKKjI2a|fT0DDev?rpT2p`-FvR~;9l(`nFN=;w(Rs8iE`M5VD~l`T?=>%q
zo>R0d;(I~#l*NwJRrU1BW1P&o&(Yf{)@sdBMk`EleWU1y+7ZQ3Zc6MrKM(<IC+Yj{
zSdREoWwAHmuWtjOcbCQBR&TI780@Z#_&X%BeMpd*v*M<IvN(L2_N}N}5p43^f22F8
zb>maR$8vEb7kv0L6kbu+<h}pl)3h?af+zLv;L}3G)QY;Y7>xuvJWYs|@3MsMy6)g)
z<uTT`Q5dXNEE0(L<4=p*8bua1tcDKiULeNyj>0GAp);t~TL!AvgmW6j?bZ7=3Jafc
zX(HUa<hUz;Iwek=ua*1~1vp)wjQIEq3cVFQPwNm3rkE5-Ier#EDbn4N=8@^U>0bIC
zXdb@}`Xqf$(mXQ#c`8eqN2Xt-S0v3N(_g_a(>yZ$Lp*_*=8@_5#3D)a2wHfApJ_QV
zy+kaRG>=TL7V9L<Bh%etyQFz!dQcpYG>=T*Bt|5E%_Gydi@PMvBhyccZ^(Pf+#n2E
zR)Okh#e^c3Ib~p65$iarkpNm`lZF)z^>M1kdIev#3+@JpNXjLdF<RuZA~w#FxQgnW
zRW3$ot7o=*y}X{7vo2<>H&&=|zLTAHq2}0Wb+NLR7P%|3-%;G{PC|3<<3Za|I}N$+
zb<k!#W1PDNNgKKB-Zx7Yv3h<vOV!hZ@&vd0X+ZkB5xMFnnExU2pp1FBiDGw<=YIfD
zO9u%1R>R2>5dZ+wAd?Xq9Fu5~K?cIIP#aUJldq8@f0?!j(N=b{o7s2H^PV#~Gv9uF
z`3j(fHHPD(qi5weYMmSV!fmJ<s<ErCsD|hGmdzu}b2Z0n2+{*#3mytuZ1PYun!?x*
zV<%KMcDWsj71cL2hx?k<@+g&x#o}Fx4a%qdZfx5mgiWrk)30z%%M~K9T$9v85rmYB
z^z!QMf7P<q5Qpm9Auxty&5Hv=JhW`VFzW@TZU($z3;k8VeP0B6)iX^IC`d4j@9{&f
z+uSwvC-psHL<$BOvS;c8BHRYA+d{z*!@xmoiHL#iFbv+aTr0ZIkjU-iw;B3#`Rx=^
z7)wGyI)x-ghB1H)t=OK)FqNyG`PL%2kBa2Zf7MWX9Y(@YFhz_PQ=X|dVtM*gijRmA
z+^M8+2{Xf(#w^2RmjDHG42mxW+f88s*(Bz1g-YhF?J%sJuVu5zgPJ&qg=>gPzS?c`
z6$bqx<ewrJp~}418HzpGt*xF3*Dr>;q+F6IZ&BlOn?0Rp{;YK|C`f~4>gpz)LWa>=
ze?$lU5%-@<m?2%IL-;s$>LO?<$WV_JFbvb1kxi$2GC=bbM(L~3-!%GY0LjA3&lsQk
zgo*c%PX?37c4C$~G3mlbOdKQm0hgCga8(8}thOzGV2qeWT<b8U4wGp!BW>o!i^4k+
z`%bB!NJFRTAW>454mUdvcaWd~Otu|HFQvo$!U=MJd3-18%%i{Mk?&o_+zD3xTLoPp
za*@mZzX4E72M7foSXo;F003G9lMxymlh8H~lka{AlQ5JZe*-ZP#wYf#wTgWLC8t)p
zU93H<RRj?{35r7R)9iFNZ8p0k+j<cDAijks!GjOrLy1$-gA<sK@0V{T<n!zO0{}*_
zC*WnhzK@>d6xD)kEXPvKWM8U0E40B<=Qhaln3y{<gr4{^MIWe?)WR<_FUK=9p8B##
zf((m5|Lhoze}=>1DQ8{uH$Ph%!@#E)9J3{xXiMa@O_;98d47v|G&mVVK};+8+yo(@
z^^h-}qHAqPz+vu^FmV_g3LhO71-bAJ%k<KF%BF@~1F8b{=eWYqpiRQt>6}#AfVzPC
zxwg8z5OC1F`3dMe+-yDj?|Ksfm2Pj+h9<OH(10BQF4Zgk0(79pc2j~+6SleUvg@!`
zSZhab(0=_5Y`_*&z5!562MEf!e_JB~003%}k$@eOnw3p|ra>`;gjkB2LNB&R1sk9e
zET&%YWO9-WOlHQpKv`;6eeg%L5Bk{GK83cdWgmR=-QVDE@Wr^#a7lo;G;2*}&c1y6
za=yKP|NG^y04A`(@Z{mcrObD+0@v1sS&U7_v{Eb?)2ynk8{E?^GgY;Ug5-`c1a}1~
zE8I<K6``$vyMEP;O_sRfie$_#r>fje=>f*X#Q6C56|!|Q`~D^0Fi7B5c<K@zg;~~3
zAspQ-lXOEkF2y2wX6*7<CRG$0u^&QU3~J8u9ZlTU4Z#q%oN~JC@S-8on+~^a;iT_6
z7QH-OxYA~po1}CUbTD+U@eQ6fxLHmw7S@F3Dd=Q>I8zp0Zp-yVwc*KdA)XDabt^4l
zrbc#;zNZ`Md2UZJM4I&qREAF7-A$`KK5{>T2)a~+agw30;X7>^21TaYTm{_>AyKux
zEka~C9X}c*f*zbvaT>i0y$w|(PX%Ww>{Z>=z3V~Pdl8(&fQo*cXXtOvaL%-SFXuUe
zR~5W}A)_5BFmQcS#UL&)bQl&dGMsA|HTeg&7ZH<Th8Rw0hUJO~-j;y}F-+KvTxYpk
zp;8pYRgB1_I@iTkPIyPlB@vZ7ilhWhF?1bLDM(YRbWb?kvmA!AhkWPu<OFaD<6*pu
z%M3lo^$Ol&P>8Jy;(-^z2j~jpePpOwlLXX%;(gR6iV)@`rlj3f%D}Uz1H{myw!2cY
zy^b3y6nw}Kb`Ll;7Q(GV?AtY0@Db73^|<4?E4o)9p2Ux1N+#XL$0}wp%kY}(7u>xR
z`r>mfbNB>zq;-~hZO~LnU}DBx1PfS{io0|!%NrPuA1}9M2bPeN*Ro8GL;{9P3&;O|
z33U%Ek_ewOobpZD1bRv51w#Y_5RD(<|M7Xak1ymrd`V+_K+MIN2b!?uNGbSwUlBxI
zt~l1Fgjetl!}*3{$u~W{Dw-S%`{UBo%Uix~6y@%qNf?@O9LtGrR)iUqvq9>peK3d7
z5{=Nc5K8}Yhrw)BR0!yFD{@bngqiw(kNzLZf{I^<At9>rj~JF{5h>fE_`UG93Ju>9
z*{5m$(tzbWTJhA?Wobj#k)`#!;8zR62_&>HPY{#kk7$PwJq#`##?VO`;Fm-Vr=CE0
zj=pC*=+Eb~+jxBkgZcT<WInNtXbo@G@XiiK@^`jD#$zuq!7!hEfh!D;F-aeP*BJ5(
zHQel(u3_$R{m&GAcZX}3&rf#L@afO>KN15Sqa^)|6gA{mp4NX$JjYkhvQH6868fth
zX!#w8d}6hyyp6RQ%o?oGZ8)ze$zCGu_gKXMqQN_gAv~hghcFzRAK|Cq-3E`OH_;ic
z(+X-=FruJep_#{DxKT$3m_my%oc>npXqWmhb!JcsxYV|hfOG`m({qwc$e2R3;Ya$W
zp&@A-+W!GiO9u#Kvf8dOlMtF+f9p;YK@`W&K%u2BrCUIds>mYt0;N(4mWvl|DhY~d
z1p^@=Lp$9rY<HX8ZAmopAU<VXc_38VAD?7Ib~S0t$WjJFwrm+P_H`m_*2GI>i3vrX
zu`5Dc&oU^cFqY9w>1B<OwXD&idiIocvKCLj+tg2Q-kU$q_jAtqe$To0&N=6P@8=UE
zqD)hye}C-4dxI`N%y_E$`jThQx67W>c{yhq30tg@vc4e2Xkc3J?>A3+(QkN5csrmo
zi{PbXd!IzpqXsXnY#Ukw-n*gipjzDG2*gtNI9Ttqu%V31ZX1=?H*5fFTSqf#3i7ot
z3UJV+q+R-gcd-p@uIPJ#<jFzF2zkVlI@L$q;;;LRh5Ls@sAi#Q@hgguSS+>RWwQ9y
zO7ab?x!PovZ(n-Xzy~(UP<C3x`4Mgx85#ULuld)!Cs@X;-xPTNaRDE;KA8a{9MxVC
z;4@A1hIg6d&$7pcIHHpsJ~nKv?X{Yx2Wu)sb@VivLz5P(t=HonVJt24)^U5E%gP@3
zWXrO>Zu-2ZRm%y{4C@V^n4^GOws+##KRIqFlgl#5PgO?*=HX~VUXGPYG|^p4tWVft
zj#GiPMQ5o6_qHo(>&<k}Fx{2?tPEibzdmFK&~wEI0-{{v>kFKGQ927+q6%(GKFd}g
zTQ{cO&~ea$)LDR)ZK^x04x&eowO8DOlcxu4m8sGQDi2-ydys2$UI}X#omgic^<q-R
zmxcIUwI_MstwEo!MG4cg0>#&`tsS!|Ywo?&C!|o7@uZ8(ddXr{1eeXUHckc4ZKLrd
zk<Xwe8+W*$=y=W6Ml&5s&nz(7_}$Cl3GMF`?&Bd%v{zf1PlxYt-$_v8Zk$yowpXzF
z$%Y051g!`gia#RqCBOA<R$oU|t4X&t<FY@ih^@gkEMnD<<gxP4G;3oo;%hku{lnR;
zPCDy%3(lBC#LNgvYI1tZYknH%)uIOq-d?tAYj@F{xPIOx{0XABc7r5&Vr)FMp3WiI
z8#)fiJ)TUqsNGPixH4*eJAVnS`8e8$hLPK5y%jd9C`e%QajhOaU7xivAHBe!WOb@q
zEnWcE7nW>{C2DLwR>Pg$Ot%{?G@+Y|;<jnJUyU`OR22zety%L>@*n#;&GT}qWLeO1
z<myFoHK!DsY+iotO3H_&m~Z^RcD^9|+wzDA#BR(Y9xzJroz>V6Paiz&+^s)s0La~v
zAOt%&sD#Q|bv#|hi&d(t+EG5u%{iOZ8rs8eA1y=UvRm-s64$|WSfLN`q$#hE3<T;6
z=}Tn_22(o@KOuB{Znwvh<SHp`npX;a{@RS8T-ve88(sT6;+>@e4%5jP|M$Iv24-qU
zuE3|~0i&r{v`<azaN+NoekNYx)=)i30?up<)e`M$RN^Il!QBlXq1BR?m^mAiQeHa4
zAqE&)JHEVcno>x)Jbk5B7|bIGkisJN<7f+KPrrBcxfg--!@xBuewf|aF`*I0>;j(&
zVSvJ4sh+I6+1=K-y;`Fo;nh0fNB1_RI*j{p=oM)2aHv_`3~zLIES?Bch|CQjJP_&T
zL-E+S^w>0WibmH&+{eqb_{MbSY;t(cV7UG$ta(Uzq)QkOfVqk^%~$I|GWUtLQ+B-`
zB~E?D+~bluCV)kdngcO<_O?AdMv0z*dcY8VI_3O1vXp@2H+|N539B@|67dq3z(j$T
z#99M#O7(uAjnbOpr?uajMP`dI(_|W7gStoS;Pa&n9SE-5SFR7UvyRR|PvL^%!>g0d
zMpO<bo@RHW6qLee4|;MCo!fZ%cqxN=d5SZR(`uvsPc;1+zDx&YaUBgdPhwqYG34(m
zmgeB<7^d>BTUcOaS(hSnn_>nVYG$=6hY~t3J{+2)zO4zv-OpYx%sNZx-#-YH?^>x_
zd!$tH_n8c?o~F*j(SYA%S6=^6h}sL`AS)hp+z}PQ1-r#lpCtB=6<7r%W#T=A?s`AC
z@HJ4dv2O2T`lHJNi+J(6jY5-pOnxBUh9v5}e#ysN&G1i|Q1I>ThihxBH(RKErw-Or
zwA|fy8|r&jwZ}{c-LxbP5H9pV%bKXMvWpqE5{I3_yQDdq_&zkki<`I;<Egt0&W2|M
zOy5wq&#j+p-?dBI7+ifsKi?dz9}Ouj=`cTc*6Gv(sb^)Yhq-9}4P?(|qJNyhp1oOb
zT&oA}v^ePXCS?8PFSocf_K`TeXy?@Y;Ki%^wP{(DueqM~i!WwL+d70Wp5DzsE_nt0
zZ&zpiL{wK4L$7^J9BE434BRiTC|j{`T+6Z0i$AkFl;fUFm@$~7-Dm%|delpD`EZ@Y
zk$RoqINiNO>_=@gg=H>|`Dwpz#Y}0uC^Np2TBu0*<lY@2Dwn%XKa1-`4W=#e2REAg
z)%?B@JC+irb$9#8rcLW-OL$9Lgq9|{+~Ck5>x!`@cI{CcMc)Hg96QmP`|PS}S5f$`
z)ooqNs#DZW*t=7X&pp@25Nw@vs)|glv&Fl}p3w@aPmgROyDsp$C>;+>$ODihF~Sph
z@z^94G2emUu#5fD2TRt*Vl9a|Vq6;ejpJ(CsDSHh`f3d|GsQT^m5Nz_bHrek9MrHf
z`AL2{p?d6@sBwY=DXSpi@k|`{j1K)ofMFP>Pb%u#Q|GUZTvYbVCbI{GhejiJXkHhP
zg=StSi@vt^<M}z|-RTCh4+FasHV8_Gl1qxeu?yxl`KdZ?`nJwI7;Gb23UbVPT=jeF
za|ctEb2q_sAk$LBWH+th5W)n3(MwIMF0ZPVTwyi&n4a;F)@%5_4N#Ruc&PH^gQ{g&
z0m@SiT+%~}-WKt<u3L;geWmXD7$0So<hHM8T%ndW1m8m)fv>x@!fla3Z3I2_g&Xqy
zjR)ba%QaB$mnOb9`=t6k;!M=Txs$FvHO`S&nv?L4GRO)LA9{HxDP>|cJNdF-UOjfA
zQ|7K(Qq>0_#YdSvBws((Z9A6wMG@COQu<qfAh8cSL7b64jnp_dv0TosuUC?twQ*b?
zUldp5BxKNB>S{4#Gl0OwKPLE=RJ7AqVY;g7{+ez_`AD}>9VN!`hGFOoWSm*rCfO~;
zPf|C^i`4&4F=!~G3S;aP3rm#a&VR2IwMe=O^<ok1!Hvh3IQ01AwP3Su1XP7f+x7|A
zi191bo=sy8C()X;wmPWre5>Jw{B<<(z}4RNN|Ito#A_4f`=wPY=zhb1)7Nq5ilDbf
zgOz52O~cHOgeAA)hr6Y$rl|vv-p21)CCg`w>k5J2?v_F~EhW9h0f8b9#FZ{%uVnDw
zX9OgRL_t8lq@5oTxLKr&G|;}J?Ficc1a)wZG1+7H0ck}@;PF0jpx_=KwB-z4#R||V
zhOrnQ_-WV!TrE~c{!_DAi>U=}p&j5tu?q5+_AUgX$pjn~+W~TkANk%L;=6w7FzA;l
z6aryx^)^5&ae)5N&EzG+SUyTJD)UH5ey@o9rIPsXfWAuq1abq9$r4D08XvfC?E!mH
zVsa;5cE=s6tPmr5hLjp`suaeOEw^J#Dpf=NUqfgB6joy%-zdeOK(_QU5yW>vj~H-_
zt^R}S05r;Up$t_DAgT<;LdF1?GI5}`Oaj3m-UlbH`ahH71bi*CK<==;gCXcJh42y!
zY?dK_$Z{RT4qrG3I>7{*1>TlBB6g^%LAyMYT?05(VFvv{yjxfSW05lg`0v30Duo?z
zHj-zI_Aee%2t=8wGTn3sENaHMgpmKF>=I)FyPy0CmP9i6p1^6j54v-d36y@C0jfKF
zm@y@cuW$ftC5)xVkzw$yRDk|SXe$H@DS=?2Ffddpiuh-?6?2o_0N*_m<gY_S2t<^r
z%bZBC5hU;|l9v(fucIOeM1%>*lFo2}kOpG_cg{q>K$x$J2N?{YLI#onWbA*y+4TfP
z&*hj}JeJ7-W>A%pzgCd{9+FNX1LQ*6lTMR`{<!}YX)qSVt)Jy`Y>1-ocl`eV0~V3w

delta 36287
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%0Aonjyf`q#Bg+;H(_UceX22V^&|e4K_eG#rJ<}9{
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
TbTtHgKIb=}#OPPBcmMwnM9LS(

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 2e1113280..6954be875 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-all.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

From b5a630b1994b5b2f3f590d1c398612cf6b955a59 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 12 Nov 2025 13:59:58 +0100
Subject: [PATCH 14/23] Remove outdated wrapper

---
 build.gradle                             | 5 -----
 gradle/wrapper/gradle-wrapper.properties | 2 +-
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/build.gradle b/build.gradle
index 66893db07..36463df6b 100644
--- a/build.gradle
+++ b/build.gradle
@@ -106,8 +106,3 @@ checkFormatAotTest.enabled = false
 
 formatAot.enabled = false
 formatAotTest.enabled = false
-
-wrapper {
-  gradleVersion = "8.14.3"
-  distributionType = Wrapper.DistributionType.ALL
-}
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 6954be875..bad7c2462 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

From 37d53152a08a5de9d225c7f25f41b77c5d8b3cae Mon Sep 17 00:00:00 2001
From: Patrick Baumgartner <contact@patbaumgartner.com>
Date: Sat, 22 Nov 2025 17:03:50 +0100
Subject: [PATCH 15/23] Upgrade to Spring Boot 4.0.0

Signed-off-by: Patrick Baumgartner <contact@patbaumgartner.com>
---
 README.md                                           |  4 ++--
 build.gradle                                        |  9 ++++-----
 docker-compose.yml                                  |  4 ++--
 gradle/wrapper/gradle-wrapper.properties            |  2 +-
 k8s/db.yml                                          |  2 +-
 mvnw                                                |  2 +-
 pom.xml                                             | 13 ++++++-------
 .../samples/petclinic/owner/OwnerRepository.java    |  1 -
 .../samples/petclinic/MySqlIntegrationTests.java    |  4 ++--
 .../samples/petclinic/MysqlTestApplication.java     |  6 +++---
 .../petclinic/service/ClinicServiceTests.java       |  2 +-
 .../system/CrashControllerIntegrationTests.java     |  2 +-
 12 files changed, 24 insertions(+), 27 deletions(-)

diff --git a/README.md b/README.md
index 379bd42a6..e792c0dab 100644
--- a/README.md
+++ b/README.md
@@ -60,13 +60,13 @@ A similar setup is provided for MySQL and PostgreSQL if a persistent database co
 You can start MySQL or PostgreSQL locally with whatever installer works for your OS or use docker:
 
 ```bash
-docker run -e MYSQL_USER=petclinic -e MYSQL_PASSWORD=petclinic -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:9.2
+docker run -e MYSQL_USER=petclinic -e MYSQL_PASSWORD=petclinic -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=petclinic -p 3306:3306 mysql:9.5
 ```
 
 or
 
 ```bash
-docker run -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -e POSTGRES_DB=petclinic -p 5432:5432 postgres:18.0
+docker run -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -e POSTGRES_DB=petclinic -p 5432:5432 postgres:18.1
 ```
 
 Further documentation is provided for [MySQL](https://github.com/spring-projects/spring-petclinic/blob/main/src/main/resources/db/mysql/petclinic_db_setup_mysql.txt)
diff --git a/build.gradle b/build.gradle
index 36463df6b..3c3634222 100644
--- a/build.gradle
+++ b/build.gradle
@@ -1,10 +1,10 @@
 plugins {
   id 'java'
   id 'checkstyle'
-  id 'org.springframework.boot' version '4.0.0-RC2'
+  id 'org.springframework.boot' version '4.0.0'
   id 'io.spring.dependency-management' version '1.1.7'
   id 'org.graalvm.buildtools.native' version '0.11.1'
-  id 'org.cyclonedx.bom' version '3.0.0'
+  id 'org.cyclonedx.bom' version '3.0.2'
   id 'io.spring.javaformat' version '0.0.47'
   id "io.spring.nohttp" version "0.0.11"
   id 'net.ltgt.errorprone' version '4.3.0'
@@ -25,9 +25,9 @@ repositories {
   mavenCentral()
 }
 
-ext.checkstyleVersion = "11.1.0"
+ext.checkstyleVersion = "12.1.2"
 ext.springJavaformatCheckstyleVersion = "0.0.47"
-ext.webjarsLocatorLiteVersion = "1.1.1"
+ext.webjarsLocatorLiteVersion = "1.1.2"
 ext.webjarsFontawesomeVersion = "4.7.0"
 ext.webjarsBootstrapVersion = "5.3.8"
 ext.errorProneVersion = "2.42.0"
@@ -78,7 +78,6 @@ checkstyleNohttp {
 }
 
 tasks.withType(JavaCompile).configureEach {
-  options.release = 17
   options.errorprone {
     disableAllChecks = true
   }
diff --git a/docker-compose.yml b/docker-compose.yml
index 50c731a91..b2313a1e6 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,6 +1,6 @@
 services:
   mysql:
-    image: mysql:9.2
+    image: mysql:9.5
     ports:
       - "3306:3306"
     environment:
@@ -12,7 +12,7 @@ services:
     volumes:
       - "./conf.d:/etc/mysql/conf.d:ro"
   postgres:
-    image: postgres:18.0
+    image: postgres:18.1
     ports:
       - "5432:5432"
     environment:
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index bad7c2462..23449a2b5 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.1-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME
diff --git a/k8s/db.yml b/k8s/db.yml
index c2c63037a..5c6e0f9e2 100644
--- a/k8s/db.yml
+++ b/k8s/db.yml
@@ -41,7 +41,7 @@ spec:
         app: demo-db
     spec:
       containers:
-        - image: postgres:18.0
+        - image: postgres:18.1
           name: postgresql
           env:
             - name: POSTGRES_USER
diff --git a/mvnw b/mvnw
index 885f47143..33c353fae 100755
--- a/mvnw
+++ b/mvnw
@@ -185,7 +185,7 @@ fi
 __MVNW_QUIET_WGET=--quiet __MVNW_QUIET_CURL=--silent __MVNW_QUIET_UNZIP=-q __MVNW_QUIET_TAR=''
 [ "${MVNW_VERBOSE-}" != true ] || __MVNW_QUIET_WGET='' __MVNW_QUIET_CURL='' __MVNW_QUIET_UNZIP='' __MVNW_QUIET_TAR=v
 
-# normalize https auth
+# normalize http auth
 case "${MVNW_PASSWORD:+has-password}" in
 '') MVNW_USERNAME='' MVNW_PASSWORD='' ;;
 has-password) [ -n "${MVNW_USERNAME-}" ] || MVNW_USERNAME='' MVNW_PASSWORD='' ;;
diff --git a/pom.xml b/pom.xml
index 7eddae997..9c852088f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
-    <version>4.0.0-RC2</version>
+    <version>4.0.0</version>
     <relativePath></relativePath>
   </parent>
 
@@ -19,20 +19,19 @@
 
     <!-- Generic properties -->
     <java.version>25</java.version>
-    <maven.compiler.release>17</maven.compiler.release>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <!-- Important for reproducible builds. Update using e.g. ./mvnw versions:set -DnewVersion=... -->
-    <project.build.outputTimestamp>2024-11-28T14:37:52Z</project.build.outputTimestamp>
+    <project.build.outputTimestamp>2025-11-22T16:15:42Z</project.build.outputTimestamp>
 
     <!-- Web dependencies -->
-    <webjars-locator.version>1.1.1</webjars-locator.version>
+    <webjars-locator.version>1.1.2</webjars-locator.version>
     <webjars-bootstrap.version>5.3.8</webjars-bootstrap.version>
     <webjars-font-awesome.version>4.7.0</webjars-font-awesome.version>
 
-    <checkstyle.version>11.1.0</checkstyle.version>
+    <checkstyle.version>12.1.2</checkstyle.version>
     <error-prone.version>2.42.0</error-prone.version>
-    <jacoco.version>0.8.13</jacoco.version>
+    <jacoco.version>0.8.14</jacoco.version>
     <libsass.version>0.3.4</libsass.version>
     <lifecycle-mapping>1.0.0</lifecycle-mapping>
     <maven-checkstyle.version>3.6.0</maven-checkstyle.version>
@@ -290,10 +289,10 @@
         <executions>
           <execution>
             <id>default-compile</id>
-            <phase>compile</phase>
             <goals>
               <goal>compile</goal>
             </goals>
+            <phase>compile</phase>
             <configuration>
               <compilerArgs>
                 <arg>-XDcompilePolicy=simple</arg>
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
index e0e9b2f0b..d2b3dde40 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/OwnerRepository.java
@@ -17,7 +17,6 @@ package org.springframework.samples.petclinic.owner;
 
 import java.util.Optional;
 
-import jakarta.annotation.Nonnull;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.jpa.repository.JpaRepository;
diff --git a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
index 607593aad..0cacc580a 100644
--- a/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/MySqlIntegrationTests.java
@@ -33,9 +33,9 @@ import org.springframework.samples.petclinic.vet.VetRepository;
 import org.springframework.test.context.ActiveProfiles;
 import org.springframework.test.context.aot.DisabledInAotMode;
 import org.springframework.web.client.RestTemplate;
-import org.testcontainers.containers.MySQLContainer;
 import org.testcontainers.junit.jupiter.Container;
 import org.testcontainers.junit.jupiter.Testcontainers;
+import org.testcontainers.mysql.MySQLContainer;
 import org.testcontainers.utility.DockerImageName;
 
 @SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
@@ -47,7 +47,7 @@ class MySqlIntegrationTests {
 
 	@ServiceConnection
 	@Container
-	static MySQLContainer<?> container = new MySQLContainer<>(DockerImageName.parse("mysql:9.2"));
+	static MySQLContainer container = new MySQLContainer(DockerImageName.parse("mysql:9.5"));
 
 	@LocalServerPort
 	int port;
diff --git a/src/test/java/org/springframework/samples/petclinic/MysqlTestApplication.java b/src/test/java/org/springframework/samples/petclinic/MysqlTestApplication.java
index 2a4ea8e06..e18b6cbaf 100644
--- a/src/test/java/org/springframework/samples/petclinic/MysqlTestApplication.java
+++ b/src/test/java/org/springframework/samples/petclinic/MysqlTestApplication.java
@@ -21,7 +21,7 @@ import org.springframework.boot.testcontainers.service.connection.ServiceConnect
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Profile;
-import org.testcontainers.containers.MySQLContainer;
+import org.testcontainers.mysql.MySQLContainer;
 import org.testcontainers.utility.DockerImageName;
 
 /**
@@ -35,8 +35,8 @@ public class MysqlTestApplication {
 	@ServiceConnection
 	@Profile("mysql")
 	@Bean
-	static MySQLContainer<?> container() {
-		return new MySQLContainer<>(DockerImageName.parse("mysql:9.2"));
+	static MySQLContainer container() {
+		return new MySQLContainer(DockerImageName.parse("mysql:9.5"));
 	}
 
 	public static void main(String[] args) {
diff --git a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
index 5d1eabc2c..ddc5bab1e 100644
--- a/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/service/ClinicServiceTests.java
@@ -31,9 +31,9 @@ import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.samples.petclinic.owner.Owner;
 import org.springframework.samples.petclinic.owner.OwnerRepository;
-import org.springframework.samples.petclinic.owner.PetTypeRepository;
 import org.springframework.samples.petclinic.owner.Pet;
 import org.springframework.samples.petclinic.owner.PetType;
+import org.springframework.samples.petclinic.owner.PetTypeRepository;
 import org.springframework.samples.petclinic.owner.Visit;
 import org.springframework.samples.petclinic.vet.Vet;
 import org.springframework.samples.petclinic.vet.VetRepository;
diff --git a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
index 1046fabe4..509585129 100644
--- a/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
+++ b/src/test/java/org/springframework/samples/petclinic/system/CrashControllerIntegrationTests.java
@@ -48,7 +48,7 @@ import org.springframework.http.ResponseEntity;
  */
 // NOT Waiting https://github.com/spring-projects/spring-boot/issues/5574
 @SpringBootTest(webEnvironment = RANDOM_PORT,
-		properties = { "server.error.include-message=ALWAYS", "management.endpoints.access.default=none" })
+		properties = { "spring.web.error.include-message=ALWAYS", "management.endpoints.access.default=none" })
 @AutoConfigureTestRestTemplate
 class CrashControllerIntegrationTests {
 

From 8f08b38f2c8412b9298f63e79e5e830ae247cd6e Mon Sep 17 00:00:00 2001
From: henribon <henribonrec@gmail.com>
Date: Wed, 29 Oct 2025 18:55:36 -0300
Subject: [PATCH 16/23] fix: update MySQL user creation for MySQL 8.0+
 compatibility

Signed-off-by: henribon <henribonrec@gmail.com>
---
 src/main/resources/db/mysql/user.sql | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/db/mysql/user.sql b/src/main/resources/db/mysql/user.sql
index d2c7b88a0..4cdf825e3 100644
--- a/src/main/resources/db/mysql/user.sql
+++ b/src/main/resources/db/mysql/user.sql
@@ -4,4 +4,8 @@ ALTER DATABASE petclinic
   DEFAULT CHARACTER SET utf8
   DEFAULT COLLATE utf8_general_ci;
 
-GRANT ALL PRIVILEGES ON petclinic.* TO 'petclinic'@'%' IDENTIFIED BY 'petclinic';
+CREATE USER IF NOT EXISTS 'petclinic'@'%' IDENTIFIED BY 'petclinic';
+
+GRANT ALL PRIVILEGES ON petclinic.* TO 'petclinic'@'%';
+
+FLUSH PRIVILEGES;

From fc1c7490edb484dddcf39d336422d308925c04a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 26 Nov 2025 10:01:16 +0100
Subject: [PATCH 17/23] Revert removal of --release 17

See gh-2133
---
 build.gradle | 1 +
 pom.xml      | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index 3c3634222..f57b21dc1 100644
--- a/build.gradle
+++ b/build.gradle
@@ -78,6 +78,7 @@ checkstyleNohttp {
 }
 
 tasks.withType(JavaCompile).configureEach {
+  options.release = 17
   options.errorprone {
     disableAllChecks = true
   }
diff --git a/pom.xml b/pom.xml
index 9c852088f..d512e01ce 100644
--- a/pom.xml
+++ b/pom.xml
@@ -19,6 +19,7 @@
 
     <!-- Generic properties -->
     <java.version>25</java.version>
+    <maven.compiler.release>17</maven.compiler.release>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <!-- Important for reproducible builds. Update using e.g. ./mvnw versions:set -DnewVersion=... -->
@@ -289,10 +290,10 @@
         <executions>
           <execution>
             <id>default-compile</id>
+            <phase>compile</phase>
             <goals>
               <goal>compile</goal>
             </goals>
-            <phase>compile</phase>
             <configuration>
               <compilerArgs>
                 <arg>-XDcompilePolicy=simple</arg>

From 828940e5a1bc51ce1e49410bc1dcf6c4139ea51f Mon Sep 17 00:00:00 2001
From: Dave Syer <david.syer@broadcom.com>
Date: Wed, 26 Nov 2025 10:38:36 +0000
Subject: [PATCH 18/23] Support building with Java 17

Needed to remove ErrorProne and Nullaway compiler plugins

Fixes #2136
---
 .github/workflows/gradle-build.yml |  2 +-
 .github/workflows/maven-build.yml  |  2 +-
 .mvn/jvm.config                    | 10 ------
 .sdkmanrc                          |  3 --
 README.md                          |  2 +-
 build.gradle                       | 24 ++-----------
 pom.xml                            | 55 ++++++++----------------------
 7 files changed, 20 insertions(+), 78 deletions(-)
 delete mode 100644 .mvn/jvm.config
 delete mode 100644 .sdkmanrc

diff --git a/.github/workflows/gradle-build.yml b/.github/workflows/gradle-build.yml
index 3c1830015..c24c121b1 100644
--- a/.github/workflows/gradle-build.yml
+++ b/.github/workflows/gradle-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '25' ]
+        java: [ '17' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.github/workflows/maven-build.yml b/.github/workflows/maven-build.yml
index 740b1129c..a1ec4dab7 100644
--- a/.github/workflows/maven-build.yml
+++ b/.github/workflows/maven-build.yml
@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        java: [ '25' ]
+        java: [ '17' ]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/.mvn/jvm.config b/.mvn/jvm.config
deleted file mode 100644
index 32599cefe..000000000
--- a/.mvn/jvm.config
+++ /dev/null
@@ -1,10 +0,0 @@
---add-exports jdk.compiler/com.sun.tools.javac.api=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.file=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.main=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.model=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.parser=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.processing=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.tree=ALL-UNNAMED
---add-exports jdk.compiler/com.sun.tools.javac.util=ALL-UNNAMED
---add-opens jdk.compiler/com.sun.tools.javac.code=ALL-UNNAMED
---add-opens jdk.compiler/com.sun.tools.javac.comp=ALL-UNNAMED
diff --git a/.sdkmanrc b/.sdkmanrc
deleted file mode 100644
index 2b4236b43..000000000
--- a/.sdkmanrc
+++ /dev/null
@@ -1,3 +0,0 @@
-# Enable auto-env through the sdkman_auto_env config
-# Add key=value pairs of SDKs to use below
-java=25-librca
diff --git a/README.md b/README.md
index e792c0dab..a1c65baff 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,7 @@ See the presentation here:
 ## Run Petclinic locally
 
 Spring Petclinic is a [Spring Boot](https://spring.io/guides/gs/spring-boot) application built using [Maven](https://spring.io/guides/gs/maven/) or [Gradle](https://spring.io/guides/gs/gradle/).
-Java 25 or later is required for the build, but the application can run with Java 17 or newer:
+Java 17 or later is required for the build, and the application can run with Java 17 or newer:
 
 ```bash
 git clone https://github.com/spring-projects/spring-petclinic.git
diff --git a/build.gradle b/build.gradle
index f57b21dc1..046257d29 100644
--- a/build.gradle
+++ b/build.gradle
@@ -7,7 +7,6 @@ plugins {
   id 'org.cyclonedx.bom' version '3.0.2'
   id 'io.spring.javaformat' version '0.0.47'
   id "io.spring.nohttp" version "0.0.11"
-  id 'net.ltgt.errorprone' version '4.3.0'
 }
 
 gradle.startParameter.excludedTaskNames += [ "checkFormatAot", "checkFormatAotTest" ]
@@ -17,7 +16,7 @@ version = '4.0.0-SNAPSHOT'
 
 java {
   toolchain {
-    languageVersion = JavaLanguageVersion.of(25)
+    languageVersion = JavaLanguageVersion.of(17)
   }
 }
 
@@ -30,14 +29,12 @@ ext.springJavaformatCheckstyleVersion = "0.0.47"
 ext.webjarsLocatorLiteVersion = "1.1.2"
 ext.webjarsFontawesomeVersion = "4.7.0"
 ext.webjarsBootstrapVersion = "5.3.8"
-ext.errorProneVersion = "2.42.0"
-ext.nullAwayVersion = "0.12.10"
 
 dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
   implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
   implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
-  implementation 'org.springframework.boot:spring-boot-starter-webmvc'
+  implementation 'org.springframework.boot:spring-boot-starter-web'
   implementation 'org.springframework.boot:spring-boot-starter-validation'
   implementation 'javax.cache:cache-api'
   implementation 'jakarta.xml.bind:jakarta.xml.bind-api'
@@ -59,8 +56,6 @@ dependencies {
   testImplementation 'org.testcontainers:testcontainers-mysql'
   checkstyle "io.spring.javaformat:spring-javaformat-checkstyle:${springJavaformatCheckstyleVersion}"
   checkstyle "com.puppycrawl.tools:checkstyle:${checkstyleVersion}"
-  errorprone "com.google.errorprone:error_prone_core:${errorProneVersion}"
-  errorprone "com.uber.nullaway:nullaway:${nullAwayVersion}"
 }
 
 tasks.named('test') {
@@ -77,21 +72,6 @@ checkstyleNohttp {
   configFile = file('src/checkstyle/nohttp-checkstyle.xml')
 }
 
-tasks.withType(JavaCompile).configureEach {
-  options.release = 17
-  options.errorprone {
-    disableAllChecks = true
-  }
-  if (name.equals("compileJava")) {
-    options.errorprone {
-      error("NullAway")
-      option("NullAway:OnlyNullMarked", "true")
-      option("NullAway:CustomContractAnnotations", "org.springframework.lang.Contract")
-      option("NullAway:JSpecifyMode", "true")
-    }
-  }
-}
-
 tasks.named("formatMain").configure { dependsOn("checkstyleMain") }
 tasks.named("formatMain").configure { dependsOn("checkstyleNohttp") }
 
diff --git a/pom.xml b/pom.xml
index d512e01ce..fbf2a8993 100644
--- a/pom.xml
+++ b/pom.xml
@@ -18,12 +18,11 @@
   <properties>
 
     <!-- Generic properties -->
-    <java.version>25</java.version>
-    <maven.compiler.release>17</maven.compiler.release>
+    <java.version>17</java.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <!-- Important for reproducible builds. Update using e.g. ./mvnw versions:set -DnewVersion=... -->
-    <project.build.outputTimestamp>2025-11-22T16:15:42Z</project.build.outputTimestamp>
+    <project.build.outputTimestamp>2024-11-28T14:37:52Z</project.build.outputTimestamp>
 
     <!-- Web dependencies -->
     <webjars-locator.version>1.1.2</webjars-locator.version>
@@ -31,14 +30,13 @@
     <webjars-font-awesome.version>4.7.0</webjars-font-awesome.version>
 
     <checkstyle.version>12.1.2</checkstyle.version>
-    <error-prone.version>2.42.0</error-prone.version>
     <jacoco.version>0.8.14</jacoco.version>
     <libsass.version>0.3.4</libsass.version>
     <lifecycle-mapping>1.0.0</lifecycle-mapping>
     <maven-checkstyle.version>3.6.0</maven-checkstyle.version>
     <nohttp-checkstyle.version>0.0.11</nohttp-checkstyle.version>
-    <nullaway.version>0.12.10</nullaway.version>
     <spring-format.version>0.0.47</spring-format.version>
+
   </properties>
 
   <dependencies>
@@ -57,7 +55,7 @@
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-webmvc</artifactId>
+      <artifactId>spring-boot-starter-web</artifactId>
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
@@ -67,6 +65,16 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-thymeleaf</artifactId>
     </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-test</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-starter-restclient</artifactId>
+      <scope>test</scope>
+    </dependency>
 
     <!-- Databases - Uses H2 by default -->
     <dependency>
@@ -115,9 +123,8 @@
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-devtools</artifactId>
-      <optional>true</optional>
+      <scope>test</scope>
     </dependency>
-
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa-test</artifactId>
@@ -284,38 +291,6 @@
           <failOnUnableToExtractRepoInfo>false</failOnUnableToExtractRepoInfo>
         </configuration>
       </plugin>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-compiler-plugin</artifactId>
-        <executions>
-          <execution>
-            <id>default-compile</id>
-            <phase>compile</phase>
-            <goals>
-              <goal>compile</goal>
-            </goals>
-            <configuration>
-              <compilerArgs>
-                <arg>-XDcompilePolicy=simple</arg>
-                <arg>--should-stop=ifError=FLOW</arg>
-                <arg>-Xplugin:ErrorProne -XepDisableAllChecks -Xep:NullAway:ERROR -XepOpt:NullAway:OnlyNullMarked=true -XepOpt:NullAway:CustomContractAnnotations=org.springframework.lang.Contract -XepOpt:NullAway:JSpecifyMode=true</arg>
-              </compilerArgs>
-              <annotationProcessorPaths>
-                <path>
-                  <groupId>com.google.errorprone</groupId>
-                  <artifactId>error_prone_core</artifactId>
-                  <version>${error-prone.version}</version>
-                </path>
-                <path>
-                  <groupId>com.uber.nullaway</groupId>
-                  <artifactId>nullaway</artifactId>
-                  <version>${nullaway.version}</version>
-                </path>
-              </annotationProcessorPaths>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
       <!-- Spring Boot Actuator displays sbom-related information if a CycloneDX SBOM file is
       present at the classpath -->
       <plugin>

From a9b7c6b4cdaae88a385935679672d040b786a71a Mon Sep 17 00:00:00 2001
From: Dave Syer <david.syer@broadcom.com>
Date: Wed, 26 Nov 2025 14:14:27 +0000
Subject: [PATCH 19/23] Use canonical starter name for Boot 4.0

---
 build.gradle | 2 +-
 pom.xml      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/build.gradle b/build.gradle
index 046257d29..e7540a9f5 100644
--- a/build.gradle
+++ b/build.gradle
@@ -34,7 +34,7 @@ dependencies {
   implementation 'org.springframework.boot:spring-boot-starter-cache'
   implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
   implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
-  implementation 'org.springframework.boot:spring-boot-starter-web'
+  implementation 'org.springframework.boot:spring-boot-starter-webmvc'
   implementation 'org.springframework.boot:spring-boot-starter-validation'
   implementation 'javax.cache:cache-api'
   implementation 'jakarta.xml.bind:jakarta.xml.bind-api'
diff --git a/pom.xml b/pom.xml
index fbf2a8993..627e5dd0d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -55,7 +55,7 @@
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-web</artifactId>
+      <artifactId>spring-boot-starter-webmvc</artifactId>
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>

From 44d5f2100b1b829bc9fa10248ee841f5d1b28b2d Mon Sep 17 00:00:00 2001
From: Dave Syer <david.syer@broadcom.com>
Date: Wed, 26 Nov 2025 14:22:44 +0000
Subject: [PATCH 20/23] Remove jspecify annotations

---
 .../petclinic/PetClinicRuntimeHints.java      |  4 +--
 .../samples/petclinic/model/BaseEntity.java   |  7 +++---
 .../samples/petclinic/model/NamedEntity.java  |  7 +++---
 .../samples/petclinic/model/Person.java       | 13 +++++-----
 .../samples/petclinic/model/package-info.java |  3 ---
 .../samples/petclinic/owner/Owner.java        | 25 +++++++++----------
 .../petclinic/owner/OwnerController.java      |  3 +--
 .../samples/petclinic/owner/Pet.java          | 13 +++++-----
 .../petclinic/owner/PetController.java        |  5 ++--
 .../samples/petclinic/owner/Visit.java        | 13 +++++-----
 .../samples/petclinic/owner/package-info.java | 18 ++++++++++---
 .../samples/petclinic/package-info.java       | 18 ++++++++++---
 .../petclinic/system/package-info.java        | 18 ++++++++++---
 .../samples/petclinic/vet/Vet.java            |  3 +--
 .../samples/petclinic/vet/Vets.java           |  3 +--
 .../samples/petclinic/vet/package-info.java   | 18 ++++++++++---
 16 files changed, 102 insertions(+), 69 deletions(-)

diff --git a/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java b/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
index 63b15b49e..4999f4c3c 100644
--- a/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
+++ b/src/main/java/org/springframework/samples/petclinic/PetClinicRuntimeHints.java
@@ -16,8 +16,6 @@
 
 package org.springframework.samples.petclinic;
 
-import org.jspecify.annotations.Nullable;
-
 import org.springframework.aot.hint.RuntimeHints;
 import org.springframework.aot.hint.RuntimeHintsRegistrar;
 import org.springframework.samples.petclinic.model.BaseEntity;
@@ -27,7 +25,7 @@ import org.springframework.samples.petclinic.vet.Vet;
 public class PetClinicRuntimeHints implements RuntimeHintsRegistrar {
 
 	@Override
-	public void registerHints(RuntimeHints hints, @Nullable ClassLoader classLoader) {
+	public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
 		hints.resources().registerPattern("db/*"); // https://github.com/spring-projects/spring-boot/issues/32654
 		hints.resources().registerPattern("messages/*");
 		hints.resources().registerPattern("mysql-default-conf");
diff --git a/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java b/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
index 45255a40a..6babed56d 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/BaseEntity.java
@@ -21,7 +21,6 @@ import jakarta.persistence.GeneratedValue;
 import jakarta.persistence.GenerationType;
 import jakarta.persistence.Id;
 import jakarta.persistence.MappedSuperclass;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object with an id property. Used as a base class for objects
@@ -35,13 +34,13 @@ public class BaseEntity implements Serializable {
 
 	@Id
 	@GeneratedValue(strategy = GenerationType.IDENTITY)
-	private @Nullable Integer id;
+	private Integer id;
 
-	public @Nullable Integer getId() {
+	public Integer getId() {
 		return id;
 	}
 
-	public void setId(@Nullable Integer id) {
+	public void setId(Integer id) {
 		this.id = id;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
index 536271d7f..7149c22ed 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
@@ -18,7 +18,6 @@ package org.springframework.samples.petclinic.model;
 import jakarta.persistence.Column;
 import jakarta.persistence.MappedSuperclass;
 import jakarta.validation.constraints.NotBlank;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object adds a name property to <code>BaseEntity</code>. Used as
@@ -33,13 +32,13 @@ public class NamedEntity extends BaseEntity {
 
 	@Column(name = "name")
 	@NotBlank
-	private @Nullable String name;
+	private String name;
 
-	public @Nullable String getName() {
+	public String getName() {
 		return this.name;
 	}
 
-	public void setName(@Nullable String name) {
+	public void setName(String name) {
 		this.name = name;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/Person.java b/src/main/java/org/springframework/samples/petclinic/model/Person.java
index 6513b0866..7ee1f0397 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/Person.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/Person.java
@@ -18,7 +18,6 @@ package org.springframework.samples.petclinic.model;
 import jakarta.persistence.Column;
 import jakarta.persistence.MappedSuperclass;
 import jakarta.validation.constraints.NotBlank;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing an person.
@@ -30,25 +29,25 @@ public class Person extends BaseEntity {
 
 	@Column(name = "first_name")
 	@NotBlank
-	private @Nullable String firstName;
+	private String firstName;
 
 	@Column(name = "last_name")
 	@NotBlank
-	private @Nullable String lastName;
+	private String lastName;
 
-	public @Nullable String getFirstName() {
+	public String getFirstName() {
 		return this.firstName;
 	}
 
-	public void setFirstName(@Nullable String firstName) {
+	public void setFirstName(String firstName) {
 		this.firstName = firstName;
 	}
 
-	public @Nullable String getLastName() {
+	public String getLastName() {
 		return this.lastName;
 	}
 
-	public void setLastName(@Nullable String lastName) {
+	public void setLastName(String lastName) {
 		this.lastName = lastName;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/package-info.java b/src/main/java/org/springframework/samples/petclinic/model/package-info.java
index f878fe8b7..e8982c3d4 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/package-info.java
@@ -17,7 +17,4 @@
 /**
  * The classes in this package represent utilities used by the domain.
  */
-@NullMarked
 package org.springframework.samples.petclinic.model;
-
-import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
index 000c06292..715863cd2 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
@@ -33,7 +33,6 @@ import jakarta.persistence.OrderBy;
 import jakarta.persistence.Table;
 import jakarta.validation.constraints.Pattern;
 import jakarta.validation.constraints.NotBlank;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing an owner.
@@ -51,43 +50,43 @@ public class Owner extends Person {
 
 	@Column(name = "address")
 	@NotBlank
-	private @Nullable String address;
+	private String address;
 
 	@Column(name = "city")
 	@NotBlank
-	private @Nullable String city;
+	private String city;
 
 	@Column(name = "telephone")
 	@NotBlank
 	@Pattern(regexp = "\\d{10}", message = "{telephone.invalid}")
-	private @Nullable String telephone;
+	private String telephone;
 
 	@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
 	@JoinColumn(name = "owner_id")
 	@OrderBy("name")
 	private final List<Pet> pets = new ArrayList<>();
 
-	public @Nullable String getAddress() {
+	public String getAddress() {
 		return this.address;
 	}
 
-	public void setAddress(@Nullable String address) {
+	public void setAddress(String address) {
 		this.address = address;
 	}
 
-	public @Nullable String getCity() {
+	public String getCity() {
 		return this.city;
 	}
 
-	public void setCity(@Nullable String city) {
+	public void setCity(String city) {
 		this.city = city;
 	}
 
-	public @Nullable String getTelephone() {
+	public String getTelephone() {
 		return this.telephone;
 	}
 
-	public void setTelephone(@Nullable String telephone) {
+	public void setTelephone(String telephone) {
 		this.telephone = telephone;
 	}
 
@@ -106,7 +105,7 @@ public class Owner extends Person {
 	 * @param name to test
 	 * @return the Pet with the given name, or null if no such Pet exists for this Owner
 	 */
-	public @Nullable Pet getPet(String name) {
+	public Pet getPet(String name) {
 		return getPet(name, false);
 	}
 
@@ -115,7 +114,7 @@ public class Owner extends Person {
 	 * @param id to test
 	 * @return the Pet with the given id, or null if no such Pet exists for this Owner
 	 */
-	public @Nullable Pet getPet(Integer id) {
+	public Pet getPet(Integer id) {
 		for (Pet pet : getPets()) {
 			if (!pet.isNew()) {
 				Integer compId = pet.getId();
@@ -133,7 +132,7 @@ public class Owner extends Person {
 	 * @param ignoreNew whether to ignore new pets (pets that are not saved yet)
 	 * @return the Pet with the given name, or null if no such Pet exists for this Owner
 	 */
-	public @Nullable Pet getPet(String name, boolean ignoreNew) {
+	public Pet getPet(String name, boolean ignoreNew) {
 		for (Pet pet : getPets()) {
 			String compName = pet.getName();
 			if (compName != null && compName.equalsIgnoreCase(name)) {
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java b/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
index 41b99619e..199ca3611 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/OwnerController.java
@@ -35,7 +35,6 @@ import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.servlet.ModelAndView;
 
 import jakarta.validation.Valid;
-import org.jspecify.annotations.Nullable;
 
 import org.springframework.web.servlet.mvc.support.RedirectAttributes;
 
@@ -63,7 +62,7 @@ class OwnerController {
 	}
 
 	@ModelAttribute("owner")
-	public Owner findOwner(@PathVariable(name = "ownerId", required = false) @Nullable Integer ownerId) {
+	public Owner findOwner(@PathVariable(name = "ownerId", required = false) Integer ownerId) {
 		return ownerId == null ? new Owner()
 				: this.owners.findById(ownerId)
 					.orElseThrow(() -> new IllegalArgumentException("Owner not found with id: " + ownerId
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
index 7af9e5b4f..1945f9b67 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
@@ -32,7 +32,6 @@ import jakarta.persistence.ManyToOne;
 import jakarta.persistence.OneToMany;
 import jakarta.persistence.OrderBy;
 import jakarta.persistence.Table;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple business object representing a pet.
@@ -48,30 +47,30 @@ public class Pet extends NamedEntity {
 
 	@Column(name = "birth_date")
 	@DateTimeFormat(pattern = "yyyy-MM-dd")
-	private @Nullable LocalDate birthDate;
+	private LocalDate birthDate;
 
 	@ManyToOne
 	@JoinColumn(name = "type_id")
-	private @Nullable PetType type;
+	private PetType type;
 
 	@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
 	@JoinColumn(name = "pet_id")
 	@OrderBy("date ASC")
 	private final Set<Visit> visits = new LinkedHashSet<>();
 
-	public void setBirthDate(@Nullable LocalDate birthDate) {
+	public void setBirthDate(LocalDate birthDate) {
 		this.birthDate = birthDate;
 	}
 
-	public @Nullable LocalDate getBirthDate() {
+	public LocalDate getBirthDate() {
 		return this.birthDate;
 	}
 
-	public @Nullable PetType getType() {
+	public PetType getType() {
 		return this.type;
 	}
 
-	public void setType(@Nullable PetType type) {
+	public void setType(PetType type) {
 		this.type = type;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/PetController.java b/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
index b7274080e..8398e4f13 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/PetController.java
@@ -34,7 +34,6 @@ import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 
 import jakarta.validation.Valid;
-import org.jspecify.annotations.Nullable;
 
 import org.springframework.web.servlet.mvc.support.RedirectAttributes;
 
@@ -73,8 +72,8 @@ class PetController {
 	}
 
 	@ModelAttribute("pet")
-	public @Nullable Pet findPet(@PathVariable("ownerId") int ownerId,
-			@PathVariable(name = "petId", required = false) @Nullable Integer petId) {
+	public Pet findPet(@PathVariable("ownerId") int ownerId,
+			@PathVariable(name = "petId", required = false) Integer petId) {
 
 		if (petId == null) {
 			return new Pet();
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Visit.java b/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
index 7259fab9f..085cd2849 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Visit.java
@@ -24,7 +24,6 @@ import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
 import jakarta.persistence.Table;
 import jakarta.validation.constraints.NotBlank;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing a visit.
@@ -38,10 +37,10 @@ public class Visit extends BaseEntity {
 
 	@Column(name = "visit_date")
 	@DateTimeFormat(pattern = "yyyy-MM-dd")
-	private @Nullable LocalDate date;
+	private LocalDate date;
 
 	@NotBlank
-	private @Nullable String description;
+	private String description;
 
 	/**
 	 * Creates a new instance of Visit for the current date
@@ -50,19 +49,19 @@ public class Visit extends BaseEntity {
 		this.date = LocalDate.now();
 	}
 
-	public @Nullable LocalDate getDate() {
+	public LocalDate getDate() {
 		return this.date;
 	}
 
-	public void setDate(@Nullable LocalDate date) {
+	public void setDate(LocalDate date) {
 		this.date = date;
 	}
 
-	public @Nullable String getDescription() {
+	public String getDescription() {
 		return this.description;
 	}
 
-	public void setDescription(@Nullable String description) {
+	public void setDescription(String description) {
 		this.description = description;
 	}
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/package-info.java b/src/main/java/org/springframework/samples/petclinic/owner/package-info.java
index ef080a0d6..9e2a3a4ec 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/package-info.java
@@ -1,4 +1,16 @@
-@NullMarked
+/*
+ * Copyright 2012-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package org.springframework.samples.petclinic.owner;
-
-import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/package-info.java b/src/main/java/org/springframework/samples/petclinic/package-info.java
index c8261d8f0..8c54417d9 100644
--- a/src/main/java/org/springframework/samples/petclinic/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/package-info.java
@@ -1,4 +1,16 @@
-@NullMarked
+/*
+ * Copyright 2012-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package org.springframework.samples.petclinic;
-
-import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/system/package-info.java b/src/main/java/org/springframework/samples/petclinic/system/package-info.java
index 25da176d0..7d1468177 100644
--- a/src/main/java/org/springframework/samples/petclinic/system/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/system/package-info.java
@@ -1,4 +1,16 @@
-@NullMarked
+/*
+ * Copyright 2012-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package org.springframework.samples.petclinic.system;
-
-import org.jspecify.annotations.NullMarked;
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/Vet.java b/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
index c8bd549d5..fb2bd71ee 100644
--- a/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
+++ b/src/main/java/org/springframework/samples/petclinic/vet/Vet.java
@@ -31,7 +31,6 @@ import jakarta.persistence.JoinTable;
 import jakarta.persistence.ManyToMany;
 import jakarta.persistence.Table;
 import jakarta.xml.bind.annotation.XmlElement;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple JavaBean domain object representing a veterinarian.
@@ -48,7 +47,7 @@ public class Vet extends Person {
 	@ManyToMany(fetch = FetchType.EAGER)
 	@JoinTable(name = "vet_specialties", joinColumns = @JoinColumn(name = "vet_id"),
 			inverseJoinColumns = @JoinColumn(name = "specialty_id"))
-	private @Nullable Set<Specialty> specialties;
+	private Set<Specialty> specialties;
 
 	protected Set<Specialty> getSpecialtiesInternal() {
 		if (this.specialties == null) {
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/Vets.java b/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
index a3292927a..634cad773 100644
--- a/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
+++ b/src/main/java/org/springframework/samples/petclinic/vet/Vets.java
@@ -20,7 +20,6 @@ import java.util.List;
 
 import jakarta.xml.bind.annotation.XmlElement;
 import jakarta.xml.bind.annotation.XmlRootElement;
-import org.jspecify.annotations.Nullable;
 
 /**
  * Simple domain object representing a list of veterinarians. Mostly here to be used for
@@ -31,7 +30,7 @@ import org.jspecify.annotations.Nullable;
 @XmlRootElement
 public class Vets {
 
-	private @Nullable List<Vet> vets;
+	private List<Vet> vets;
 
 	@XmlElement
 	public List<Vet> getVetList() {
diff --git a/src/main/java/org/springframework/samples/petclinic/vet/package-info.java b/src/main/java/org/springframework/samples/petclinic/vet/package-info.java
index 6fbc63698..544db4c7c 100644
--- a/src/main/java/org/springframework/samples/petclinic/vet/package-info.java
+++ b/src/main/java/org/springframework/samples/petclinic/vet/package-info.java
@@ -1,4 +1,16 @@
-@NullMarked
+/*
+ * Copyright 2012-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 package org.springframework.samples.petclinic.vet;
-
-import org.jspecify.annotations.NullMarked;

From 134c5a3f9dae78e4ca3e0ac8c6c236c49695b572 Mon Sep 17 00:00:00 2001
From: Dave Syer <david.syer@broadcom.com>
Date: Wed, 26 Nov 2025 14:55:27 +0000
Subject: [PATCH 21/23] Use more specific test dependencies

---
 pom.xml | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/pom.xml b/pom.xml
index 627e5dd0d..3cac26189 100644
--- a/pom.xml
+++ b/pom.xml
@@ -65,16 +65,6 @@
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-thymeleaf</artifactId>
     </dependency>
-    <dependency>
-      <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-test</artifactId>
-      <scope>test</scope>
-    </dependency>
-    <dependency>
-      <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-restclient</artifactId>
-      <scope>test</scope>
-    </dependency>
 
     <!-- Databases - Uses H2 by default -->
     <dependency>

From 3e1ce239f4488f20abda24441388a515ea55a815 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 26 Nov 2025 19:56:03 +0100
Subject: [PATCH 22/23] Polish

---
 pom.xml | 65 +++++++++++++++++++++++++--------------------------------
 1 file changed, 28 insertions(+), 37 deletions(-)

diff --git a/pom.xml b/pom.xml
index 3cac26189..ae930ae5c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,22 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
-
   <parent>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-parent</artifactId>
     <version>4.0.0</version>
-    <relativePath></relativePath>
   </parent>
-
   <groupId>org.springframework.samples</groupId>
   <artifactId>spring-petclinic</artifactId>
   <version>4.0.0-SNAPSHOT</version>
-
   <name>petclinic</name>
 
   <properties>
-
     <!-- Generic properties -->
     <java.version>17</java.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
@@ -36,9 +31,15 @@
     <maven-checkstyle.version>3.6.0</maven-checkstyle.version>
     <nohttp-checkstyle.version>0.0.11</nohttp-checkstyle.version>
     <spring-format.version>0.0.47</spring-format.version>
-
   </properties>
 
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
+    </license>
+  </licenses>
+
   <dependencies>
     <!-- Spring and Spring Boot dependencies -->
     <dependency>
@@ -55,7 +56,7 @@
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-webmvc</artifactId>
+      <artifactId>spring-boot-starter-thymeleaf</artifactId>
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
@@ -63,15 +64,28 @@
     </dependency>
     <dependency>
       <groupId>org.springframework.boot</groupId>
-      <artifactId>spring-boot-starter-thymeleaf</artifactId>
+      <artifactId>spring-boot-starter-webmvc</artifactId>
+    </dependency>
+
+    <dependency>
+      <groupId>javax.cache</groupId>
+      <artifactId>cache-api</artifactId>
+    </dependency>
+    <dependency>
+      <groupId>jakarta.xml.bind</groupId>
+      <artifactId>jakarta.xml.bind-api</artifactId>
     </dependency>
 
-    <!-- Databases - Uses H2 by default -->
     <dependency>
       <groupId>com.h2database</groupId>
       <artifactId>h2</artifactId>
       <scope>runtime</scope>
     </dependency>
+    <dependency>
+      <groupId>com.github.ben-manes.caffeine</groupId>
+      <artifactId>caffeine</artifactId>
+      <scope>runtime</scope>
+    </dependency>
     <dependency>
       <groupId>com.mysql</groupId>
       <artifactId>mysql-connector-j</artifactId>
@@ -82,39 +96,31 @@
       <artifactId>postgresql</artifactId>
       <scope>runtime</scope>
     </dependency>
-
-    <!-- Caching -->
-    <dependency>
-      <groupId>javax.cache</groupId>
-      <artifactId>cache-api</artifactId>
-    </dependency>
-    <dependency>
-      <groupId>com.github.ben-manes.caffeine</groupId>
-      <artifactId>caffeine</artifactId>
-    </dependency>
-
-    <!-- Webjars -->
     <dependency>
       <groupId>org.webjars</groupId>
       <artifactId>webjars-locator-lite</artifactId>
       <version>${webjars-locator.version}</version>
+      <scope>runtime</scope>
     </dependency>
     <dependency>
       <groupId>org.webjars.npm</groupId>
       <artifactId>bootstrap</artifactId>
       <version>${webjars-bootstrap.version}</version>
+      <scope>runtime</scope>
     </dependency>
     <dependency>
       <groupId>org.webjars.npm</groupId>
       <artifactId>font-awesome</artifactId>
       <version>${webjars-font-awesome.version}</version>
+      <scope>runtime</scope>
     </dependency>
 
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-devtools</artifactId>
-      <scope>test</scope>
+      <optional>true</optional>
     </dependency>
+
     <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa-test</artifactId>
@@ -150,12 +156,6 @@
       <artifactId>testcontainers-mysql</artifactId>
       <scope>test</scope>
     </dependency>
-
-    <dependency>
-      <groupId>jakarta.xml.bind</groupId>
-      <artifactId>jakarta.xml.bind-api</artifactId>
-    </dependency>
-
   </dependencies>
 
   <build>
@@ -288,16 +288,8 @@
         <groupId>org.cyclonedx</groupId>
         <artifactId>cyclonedx-maven-plugin</artifactId>
       </plugin>
-
     </plugins>
   </build>
-  <licenses>
-    <license>
-      <name>Apache License, Version 2.0</name>
-      <url>https://www.apache.org/licenses/LICENSE-2.0</url>
-    </license>
-  </licenses>
-
   <profiles>
     <profile>
       <id>css</id>
@@ -327,7 +319,6 @@
               </execution>
             </executions>
           </plugin>
-
           <plugin>
             <groupId>com.gitlab.haynes</groupId>
             <artifactId>libsass-maven-plugin</artifactId>

From fd4361b118931e07a7a1bde04750ec32a5fdb56e Mon Sep 17 00:00:00 2001
From: Philippe Marschall <philippe.marschall@gmail.com>
Date: Sat, 20 Dec 2025 22:32:00 +0100
Subject: [PATCH 23/23] Use snake case physical naming strategy

Use snake case physical naming strategy to reduce the need to specify
column names.

Signed-off-by: Philippe Marschall <philippe.marschall@gmail.com>
---
 .../samples/petclinic/model/NamedEntity.java                | 2 +-
 .../org/springframework/samples/petclinic/model/Person.java | 4 ++--
 .../org/springframework/samples/petclinic/owner/Owner.java  | 6 +++---
 .../org/springframework/samples/petclinic/owner/Pet.java    | 2 +-
 src/main/resources/application.properties                   | 1 +
 5 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
index 7149c22ed..61e882a95 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/NamedEntity.java
@@ -30,7 +30,7 @@ import jakarta.validation.constraints.NotBlank;
 @MappedSuperclass
 public class NamedEntity extends BaseEntity {
 
-	@Column(name = "name")
+	@Column
 	@NotBlank
 	private String name;
 
diff --git a/src/main/java/org/springframework/samples/petclinic/model/Person.java b/src/main/java/org/springframework/samples/petclinic/model/Person.java
index 7ee1f0397..30b5829d8 100644
--- a/src/main/java/org/springframework/samples/petclinic/model/Person.java
+++ b/src/main/java/org/springframework/samples/petclinic/model/Person.java
@@ -27,11 +27,11 @@ import jakarta.validation.constraints.NotBlank;
 @MappedSuperclass
 public class Person extends BaseEntity {
 
-	@Column(name = "first_name")
+	@Column
 	@NotBlank
 	private String firstName;
 
-	@Column(name = "last_name")
+	@Column
 	@NotBlank
 	private String lastName;
 
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
index 715863cd2..480a7a690 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Owner.java
@@ -48,15 +48,15 @@ import jakarta.validation.constraints.NotBlank;
 @Table(name = "owners")
 public class Owner extends Person {
 
-	@Column(name = "address")
+	@Column
 	@NotBlank
 	private String address;
 
-	@Column(name = "city")
+	@Column
 	@NotBlank
 	private String city;
 
-	@Column(name = "telephone")
+	@Column
 	@NotBlank
 	@Pattern(regexp = "\\d{10}", message = "{telephone.invalid}")
 	private String telephone;
diff --git a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
index 1945f9b67..4f8409ef2 100644
--- a/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
+++ b/src/main/java/org/springframework/samples/petclinic/owner/Pet.java
@@ -45,7 +45,7 @@ import jakarta.persistence.Table;
 @Table(name = "pets")
 public class Pet extends NamedEntity {
 
-	@Column(name = "birth_date")
+	@Column
 	@DateTimeFormat(pattern = "yyyy-MM-dd")
 	private LocalDate birthDate;
 
diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties
index 6ed985654..630c1145a 100644
--- a/src/main/resources/application.properties
+++ b/src/main/resources/application.properties
@@ -9,6 +9,7 @@ spring.thymeleaf.mode=HTML
 # JPA
 spring.jpa.hibernate.ddl-auto=none
 spring.jpa.open-in-view=false
+spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategySnakeCaseImpl
 
 # Internationalization
 spring.messages.basename=messages/messages