test: introduce Testcontainers setup and comprehensive integration test suite for controllers and repositories

README.md

@@ -92,7 +92,7 @@ flowchart TB
     Cache[(Redis)]
     Weather[(OpenWeatherMap API)]
     Mail[(SMTP)]
- 
+
     Client --> RL --> Sec --> Web
     Client -. live updates .-> WS
     Web --> Svc
@@ -264,14 +264,14 @@ Every log line is tagged with a request correlation ID, and HTTP request latency
 ./mvnw test
 ```
 
-Tests run against an in-memory H2 database, so no external services are required. The suite includes unit tests, MVC/REST controller tests, repository tests, and full integration tests for auth (including verification, password reset, and remember-me), search, profile, and weather flows. JaCoCo generates a coverage report at `target/site/jacoco/index.html` after running tests.
+Every test that boots a Spring context (`@SpringBootTest`, `@DataJpaTest`) runs against real Postgres and Redis via [Testcontainers](https://testcontainers.com/) — `TestcontainersConfiguration` wires both in via `@ServiceConnection`, so no manual datasource/Redis properties are needed. This needs a running Docker daemon; without one, those tests fail to start. Pure unit tests (model/DTO/enum tests, Mockito-based service tests) don't start a Spring context at all, so they're unaffected either way. The suite includes unit tests, MVC/REST controller tests (`@WebMvcTest`, which slice the web layer and don't touch a real database), repository tests, and full integration tests for auth (including verification, password reset, and remember-me), search, profile, and weather flows. JaCoCo generates a coverage report at `target/site/jacoco/index.html` after running tests.
 
 ## CI/CD
 
 Every push to `main` and every pull request into `main`/`dev` runs through GitHub Actions:
 
-1. **Build & Test** — compiles the project and runs the full test suite against H2, publishing a JUnit test report and a JaCoCo coverage report as workflow artifacts.
-2. **Update coverage badge** — on pushes to `main`, regenerates the `.github/badges/jacoco.svg` badge from that JaCoCo report and commits it back to the repo.
+1. **Build & Test** — compiles the project and runs the full test suite (Spring-context tests against real Postgres/Redis via Testcontainers), publishing a JUnit test report and a JaCoCo coverage report as workflow artifacts.
+2. **Update coverage badge** — on pushes to `main` or `dev`, regenerates that branch's `.github/badges/jacoco.svg` badge from the JaCoCo report and commits it back.
 3. **Docker build & push** — on pushes to `main`, builds the application image and pushes it to Docker Hub as `podllev/weather-viewer`.
 
 See `.github/workflows/ci.yml` for the full pipeline.

pom.xml

@@ -166,8 +166,18 @@
             <version>4.0.0</version>
         </dependency>
         <dependency>
-            <groupId>com.h2database</groupId>
-            <artifactId>h2</artifactId>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-testcontainers</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>postgresql</artifactId>
             <scope>test</scope>
         </dependency>
     </dependencies>

src/test/java/com/weatherviewer/WeatherViewerApplicationTests.java

@@ -1,18 +1,25 @@
 package com.weatherviewer;
 
 import org.junit.jupiter.api.Test;
-import org.springframework.boot.test.context.SpringBootTest;
+import org.mockito.MockedStatic;
+import org.springframework.boot.SpringApplication;
+
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.mockStatic;
 
-@SpringBootTest
 class WeatherViewerApplicationTests {
 
     @Test
-    void contextLoads() {
-    }
+    void mainStartsApplication() {
+        try (MockedStatic<SpringApplication> mocked = mockStatic(SpringApplication.class)) {
 
-    @Test
-    void mainMethodStartsApplication() {
-        WeatherViewerApplication.main(new String[] {});
-    }
+            WeatherViewerApplication.main(new String[0]);
 
+            mocked.verify(() ->
+                    SpringApplication.run(
+                            eq(WeatherViewerApplication.class),
+                            eq(new String[0])
+                    ));
+        }
+    }
 }

src/test/java/com/weatherviewer/controller/HomeControllerTest.java

@@ -8,10 +8,12 @@
 import com.weatherviewer.security.SecUser;
 import com.weatherviewer.service.LocationService;
 import com.weatherviewer.service.WeatherApiService;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.PageImpl;
 import org.springframework.data.domain.PageRequest;
@@ -34,6 +36,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class HomeControllerTest {
 
     @Autowired

src/test/java/com/weatherviewer/controller/ProfileControllerTest.java

@@ -6,13 +6,15 @@
 import com.weatherviewer.model.enums.UserStatus;
 import com.weatherviewer.security.SecUser;
 import com.weatherviewer.service.UserService;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import com.weatherviewer.validation.validator.PasswordMatchesValidator;
 import com.weatherviewer.validation.validator.UniqueEmailValidator;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -30,6 +32,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class ProfileControllerTest {
 
     @Autowired

src/test/java/com/weatherviewer/controller/SearchControllerTest.java

@@ -7,6 +7,7 @@
 import com.weatherviewer.security.SecUser;
 import com.weatherviewer.service.LocationService;
 import com.weatherviewer.service.WeatherApiService;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import com.weatherviewer.validation.validator.PasswordMatchesValidator;
 import com.weatherviewer.validation.validator.UniqueEmailValidator;
 import com.weatherviewer.validation.validator.UniqueLocationValidator;
@@ -15,6 +16,7 @@
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -32,6 +34,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class SearchControllerTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/ForecastIntegrationTest.java

@@ -7,12 +7,14 @@
 import com.weatherviewer.repository.LocationRepository;
 import com.weatherviewer.repository.UserRepository;
 import com.weatherviewer.security.SecUser;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -25,6 +27,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class ForecastIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/LocationIntegrationTest.java

@@ -8,12 +8,14 @@
 import com.weatherviewer.repository.LocationRepository;
 import com.weatherviewer.repository.UserRepository;
 import com.weatherviewer.security.SecUser;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -29,6 +31,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class LocationIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/OpenApiDocumentationIntegrationTest.java

@@ -1,16 +1,19 @@
 package com.weatherviewer.integration;
 
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.test.web.servlet.MockMvc;
 
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class OpenApiDocumentationIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/ProfileIntegrationTest.java

@@ -6,12 +6,14 @@
 import com.weatherviewer.model.enums.UserStatus;
 import com.weatherviewer.repository.UserRepository;
 import com.weatherviewer.security.SecUser;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -26,6 +28,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class ProfileIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/SearchIntegrationTest.java

@@ -10,12 +10,14 @@
 import com.weatherviewer.repository.UserRepository;
 import com.weatherviewer.security.SecUser;
 import com.weatherviewer.service.WeatherApiService;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.test.context.bean.override.mockito.MockitoBean;
 import org.springframework.test.web.servlet.MockMvc;
@@ -33,6 +35,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class SearchIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/SecurityIntegrationTest.java

@@ -1,9 +1,11 @@
 package com.weatherviewer.integration;
 
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.test.context.support.WithMockUser;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -15,6 +17,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class SecurityIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/SignInIntegrationTest.java

@@ -4,12 +4,14 @@
 import com.weatherviewer.model.enums.Role;
 import com.weatherviewer.model.enums.UserStatus;
 import com.weatherviewer.repository.UserRepository;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.security.crypto.password.PasswordEncoder;
 import org.springframework.test.web.servlet.MockMvc;
 
@@ -22,6 +24,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class SignInIntegrationTest {
 
     @Autowired

src/test/java/com/weatherviewer/integration/UserRegistrationIntegrationTest.java

@@ -2,11 +2,13 @@
 
 import com.weatherviewer.model.User;
 import com.weatherviewer.repository.UserRepository;
+import com.weatherviewer.testcontainers.TestcontainersConfiguration;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.Test;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
 import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.context.annotation.Import;
 import org.springframework.test.web.servlet.MockMvc;
 
 import java.util.Optional;
@@ -18,6 +20,7 @@
 
 @SpringBootTest
 @AutoConfigureMockMvc
+@Import(TestcontainersConfiguration.class)
 class UserRegistrationIntegrationTest {
 
     @Autowired