added information about nullable fields in response

domain/pom.xml

@@ -16,5 +16,13 @@
         <maven.compiler.target>21</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
+    <dependencies>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-annotations-jakarta</artifactId>
+            <version>2.2.25</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
 
 </project>

domain/src/main/java/com/opencu/bookit/domain/model/statistics/FullStats.java

@@ -1,9 +1,10 @@
 package com.opencu.bookit.domain.model.statistics;
 
-
+import io.swagger.v3.oas.annotations.media.Schema;
 import java.util.List;
 
 public record FullStats(
         List<BookingStats> stats,
+        @Schema(nullable = true)
         StatsSummary summary
 ) {}

security-adapter/src/main/java/com/opencu/bookit/adapter/out/security/spring/payload/response/JwtResponse.java

@@ -1,5 +1,6 @@
 package com.opencu.bookit.adapter.out.security.spring.payload.response;
 
+import io.swagger.v3.oas.annotations.media.Schema;
 import lombok.Data;
 
 import java.util.UUID;
@@ -10,6 +11,7 @@ public class JwtResponse {
     private final String type = "Bearer";
     private final UUID id;
     private final String username;
+    @Schema(nullable = true, description = "Email may be null")
     private final String email;
     private final String firstName;
     private final String lastName;

web-adapter/src/main/java/com/opencu/bookit/adapter/in/web/dto/response/AreaResponse.java

@@ -3,6 +3,7 @@
 import com.opencu.bookit.domain.model.area.AreaFeature;
 import com.opencu.bookit.domain.model.area.AreaType;
 import com.opencu.bookit.domain.model.image.ImageModel;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 import java.util.List;
 import java.util.Set;

web-adapter/src/main/java/com/opencu/bookit/adapter/in/web/dto/response/MeResponse.java

@@ -2,6 +2,7 @@
 
 import com.opencu.bookit.domain.model.user.Role;
 import com.opencu.bookit.domain.model.user.UserStatus;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 import java.time.LocalDateTime;
 import java.util.Set;
@@ -12,12 +13,17 @@ public record MeResponse(
         Long tgId,
         String firstName,
         String lastName,
+        @Schema(nullable = true)
         String photoUrl,
+        @Schema(nullable = true)
         String email,
+        @Schema(nullable = true)
         String phone,
         UserStatus status,
         LocalDateTime createdAt,
+        @Schema(nullable = true)
         LocalDateTime updatedAt,
+        @Schema(nullable = true)
         String username,
         Set<Role> roles
 ) {}

web-adapter/src/main/java/com/opencu/bookit/adapter/in/web/dto/response/TicketResponse.java

@@ -1,6 +1,7 @@
 package com.opencu.bookit.adapter.in.web.dto.response;
 
 import com.opencu.bookit.domain.model.ticket.TicketType;
+import io.swagger.v3.oas.annotations.media.Schema;
 
 import java.util.UUID;