Release 0.3.0

Author: Gematik-Entwicklung

ReleaseNotes.md

@@ -2,6 +2,24 @@
 
 # Release Notes ZETA Testfachdienst
 
+## Release 0.3.0
+
+TestFachdienst 0.3.0
+
+This release starts the release notes for TestFachdienst beginning with version 0.3.0.
+It includes targeted API behavior updates and model validation adjustments.
+
+#### Release Focus:
+
+- Added `GET /zeta-v1/hello-zeta/proxy-error` endpoint to return a proxy-specific error response.
+- Added `ZETA-Cause: Proxy` response header with `HTTP 400 Bad Request` for the proxy error endpoint.
+- Added controller test coverage for the new proxy error response behavior.
+- Removed `@PastOrPresent` and `@FutureOrPresent` annotations from `Erezept` date fields.
+
+### Known issues:
+
+- None documented for this release.
+
 ## Release 0.2.1
 
 ### added:

build.gradle.kts

@@ -15,7 +15,7 @@ plugins {
 }
 
 group = "de.gematik.zeta"
-version = "0.1.3"
+version = "0.3.0"
 description =
     "achelos Testfachdienst providing a REST API with CRUD operations, secure communication via TLS and Websocket connections."
 

src/main/java/de/gematik/zeta/testfachdienst/controller/HelloZetaController.java

@@ -27,6 +27,7 @@
 import de.gematik.zeta.testfachdienst.model.HelloZetaResource;
 import de.gematik.zeta.testfachdienst.service.HelloZetaService;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -67,4 +68,18 @@ public ResponseEntity<HelloZetaResource> getHelloZetaResponse() {
     log.debug("Got resource: '" + resource + "' from service, returning resource with 200.");
     return ResponseEntity.ok(resource);
   }
+
+  /**
+   * Return a response that signals a proxy error to the caller.
+   *
+   * @return HTTP 400 response with ZETA-Cause header set to Proxy
+   */
+  @GetMapping("/proxy-error")
+  public ResponseEntity<HelloZetaResource> getHelloZetaProxyErrorResponse() {
+    log.debug("Returning proxy error response for HelloZeta.");
+    HelloZetaResource resource = service.getHelloZetaResource();
+    return ResponseEntity.status(HttpStatus.BAD_REQUEST)
+        .header("ZETA-Cause", "Proxy")
+        .body(resource);
+  }
 }

src/main/java/de/gematik/zeta/testfachdienst/model/Erezept.java

@@ -72,13 +72,11 @@ public class Erezept {
   @Schema(description = "Dosage instructions", example = "1 tablet, 3× daily after meals")
   private String dosage;
 
-  @PastOrPresent
   @Column(nullable = false)
   @Schema(description = "When it was issued (ISO-8601)", example = "2025-09-22T10:30:00Z",
       format = "date-time")
   private OffsetDateTime issuedAt;
 
-  @FutureOrPresent
   @Schema(description = "When it expires (ISO-8601)", example = "2025-12-31T23:59:59Z",
       format = "date-time")
   private OffsetDateTime expiresAt;

src/test/java/de/gematik/zeta/testfachdienst/controller/HelloZetaControllerTest.java

@@ -62,4 +62,20 @@ void getHelloZetaResponse_returnsServicePayload() {
     assertThat(response.getStatusCode().value()).isEqualTo(200);
     verify(service).getHelloZetaResource();
   }
+
+  /**
+   * Verifies that the proxy error endpoint sets the ZETA-Cause header.
+   */
+  @Test
+  void getHelloZetaProxyErrorResponse_setsProxyHeader() {
+    var resource = new HelloZetaResource("Hello");
+    when(service.getHelloZetaResource()).thenReturn(resource);
+
+    var response = controller.getHelloZetaProxyErrorResponse();
+
+    assertThat(response.getBody()).isSameAs(resource);
+    assertThat(response.getStatusCode().value()).isEqualTo(400);
+    assertThat(response.getHeaders().getFirst("ZETA-Cause")).isEqualTo("Proxy");
+    verify(service).getHelloZetaResource();
+  }
 }