From 0f35da597fea28034bc8585e481ca985716f7d2e Mon Sep 17 00:00:00 2001 From: Harkamal Randhawa Date: Mon, 20 Apr 2026 15:18:54 -0600 Subject: [PATCH] comment backend DTOs --- .../petshop/backend/dto/activity/ActivityLogResponse.java | 6 ++++++ .../com/petshop/backend/dto/adoption/AdoptionRequest.java | 6 ++++++ .../com/petshop/backend/dto/adoption/AdoptionResponse.java | 6 ++++++ .../backend/dto/adoption/CustomerAdoptionRequest.java | 6 ++++++ .../main/java/com/petshop/backend/dto/ai/AiChatRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/ai/AiChatResponse.java | 6 ++++++ .../petshop/backend/dto/analytics/DashboardResponse.java | 6 ++++++ .../petshop/backend/dto/appointment/AppointmentRequest.java | 6 ++++++ .../backend/dto/appointment/AppointmentResponse.java | 6 ++++++ .../com/petshop/backend/dto/auth/AvatarUploadResponse.java | 6 ++++++ .../com/petshop/backend/dto/auth/ForgotPasswordRequest.java | 6 ++++++ .../petshop/backend/dto/auth/ForgotPasswordResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/auth/LoginRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/auth/LoginResponse.java | 6 ++++++ .../com/petshop/backend/dto/auth/ProfileUpdateRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/auth/RegisterRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/auth/RegisterResponse.java | 6 ++++++ .../com/petshop/backend/dto/auth/ResetPasswordRequest.java | 6 ++++++ .../com/petshop/backend/dto/auth/ResetPasswordResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/auth/UserInfoResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/cart/AddToCartRequest.java | 6 ++++++ .../com/petshop/backend/dto/cart/ApplyCouponRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/cart/CartItemResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/cart/CartResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/cart/CheckoutRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/cart/CheckoutResponse.java | 6 ++++++ .../com/petshop/backend/dto/cart/UpdateCartItemRequest.java | 6 ++++++ .../com/petshop/backend/dto/category/CategoryRequest.java | 6 ++++++ .../com/petshop/backend/dto/category/CategoryResponse.java | 6 ++++++ .../com/petshop/backend/dto/chat/ConversationRequest.java | 6 ++++++ .../com/petshop/backend/dto/chat/ConversationResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/chat/MessageRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/chat/MessageResponse.java | 6 ++++++ .../petshop/backend/dto/chat/UpdateConversationRequest.java | 6 ++++++ .../com/petshop/backend/dto/common/BulkDeleteRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/common/CouponRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/common/CouponResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/common/DropdownOption.java | 6 ++++++ .../com/petshop/backend/dto/inventory/InventoryRequest.java | 6 ++++++ .../petshop/backend/dto/inventory/InventoryResponse.java | 6 ++++++ .../main/java/com/petshop/backend/dto/pet/MyPetRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/pet/MyPetResponse.java | 6 ++++++ .../main/java/com/petshop/backend/dto/pet/PetRequest.java | 6 ++++++ .../main/java/com/petshop/backend/dto/pet/PetResponse.java | 6 ++++++ .../com/petshop/backend/dto/product/ProductRequest.java | 6 ++++++ .../com/petshop/backend/dto/product/ProductResponse.java | 6 ++++++ .../productsupplier/BulkDeleteProductSupplierRequest.java | 6 ++++++ .../backend/dto/productsupplier/ProductSupplierKey.java | 6 ++++++ .../backend/dto/productsupplier/ProductSupplierRequest.java | 6 ++++++ .../dto/productsupplier/ProductSupplierResponse.java | 6 ++++++ .../backend/dto/purchaseorder/PurchaseOrderResponse.java | 6 ++++++ .../com/petshop/backend/dto/refund/RefundItemResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/refund/RefundRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/refund/RefundResponse.java | 6 ++++++ .../com/petshop/backend/dto/refund/RefundUpdateRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/sale/SaleItemRequest.java | 6 ++++++ .../main/java/com/petshop/backend/dto/sale/SaleRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/sale/SaleResponse.java | 6 ++++++ .../com/petshop/backend/dto/service/ServiceRequest.java | 6 ++++++ .../com/petshop/backend/dto/service/ServiceResponse.java | 6 ++++++ .../java/com/petshop/backend/dto/store/StoreRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/store/StoreResponse.java | 6 ++++++ .../com/petshop/backend/dto/supplier/SupplierRequest.java | 6 ++++++ .../com/petshop/backend/dto/supplier/SupplierResponse.java | 6 ++++++ .../main/java/com/petshop/backend/dto/user/UserRequest.java | 6 ++++++ .../java/com/petshop/backend/dto/user/UserResponse.java | 6 ++++++ 66 files changed, 396 insertions(+) diff --git a/backend/src/main/java/com/petshop/backend/dto/activity/ActivityLogResponse.java b/backend/src/main/java/com/petshop/backend/dto/activity/ActivityLogResponse.java index 3d5bc890..0139a12d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/activity/ActivityLogResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/activity/ActivityLogResponse.java @@ -1,3 +1,9 @@ +/* + * Activity log entry returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.activity; import java.time.LocalDateTime; diff --git a/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionRequest.java b/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionRequest.java index 0a45996f..1a3385f4 100644 --- a/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating an adoption. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.adoption; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionResponse.java b/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionResponse.java index 7b8e821b..cadcc199 100644 --- a/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/adoption/AdoptionResponse.java @@ -1,3 +1,9 @@ +/* + * Adoption record returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.adoption; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/adoption/CustomerAdoptionRequest.java b/backend/src/main/java/com/petshop/backend/dto/adoption/CustomerAdoptionRequest.java index 4272b2db..ef20e1f3 100644 --- a/backend/src/main/java/com/petshop/backend/dto/adoption/CustomerAdoptionRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/adoption/CustomerAdoptionRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a customer requests to adopt a pet. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.adoption; import jakarta.validation.constraints.NotNull; diff --git a/backend/src/main/java/com/petshop/backend/dto/ai/AiChatRequest.java b/backend/src/main/java/com/petshop/backend/dto/ai/AiChatRequest.java index b043b27c..a147b7ba 100644 --- a/backend/src/main/java/com/petshop/backend/dto/ai/AiChatRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/ai/AiChatRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when asking the AI chatbot a question. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.ai; import java.util.List; diff --git a/backend/src/main/java/com/petshop/backend/dto/ai/AiChatResponse.java b/backend/src/main/java/com/petshop/backend/dto/ai/AiChatResponse.java index 05f310b4..93f6a7a9 100644 --- a/backend/src/main/java/com/petshop/backend/dto/ai/AiChatResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/ai/AiChatResponse.java @@ -1,3 +1,9 @@ +/* + * AI chatbot reply returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.ai; public class AiChatResponse { diff --git a/backend/src/main/java/com/petshop/backend/dto/analytics/DashboardResponse.java b/backend/src/main/java/com/petshop/backend/dto/analytics/DashboardResponse.java index 56788f77..49768b4b 100644 --- a/backend/src/main/java/com/petshop/backend/dto/analytics/DashboardResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/analytics/DashboardResponse.java @@ -1,3 +1,9 @@ +/* + * Dashboard analytics data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.analytics; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentRequest.java b/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentRequest.java index d1c3847a..810f4a92 100644 --- a/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when booking or updating an appointment. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.appointment; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentResponse.java b/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentResponse.java index b2e9a9ba..274c7d39 100644 --- a/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/appointment/AppointmentResponse.java @@ -1,3 +1,9 @@ +/* + * Appointment details returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.appointment; import java.time.LocalDate; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/AvatarUploadResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/AvatarUploadResponse.java index 8e75af96..b2e07935 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/AvatarUploadResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/AvatarUploadResponse.java @@ -1,3 +1,9 @@ +/* + * Avatar upload result returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordRequest.java b/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordRequest.java index 529581cc..39539be7 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a user requests a password reset. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordResponse.java index 6062a196..d9d22253 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/ForgotPasswordResponse.java @@ -1,3 +1,9 @@ +/* + * Forgot password result returned with a reset token. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; public class ForgotPasswordResponse { diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/LoginRequest.java b/backend/src/main/java/com/petshop/backend/dto/auth/LoginRequest.java index 970c4719..37f734c9 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/LoginRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/LoginRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a user logs in. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/LoginResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/LoginResponse.java index e3d01c11..c546e002 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/LoginResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/LoginResponse.java @@ -1,3 +1,9 @@ +/* + * Login result returned to the client with a token. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/ProfileUpdateRequest.java b/backend/src/main/java/com/petshop/backend/dto/auth/ProfileUpdateRequest.java index 97b978b0..422a6bd2 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/ProfileUpdateRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/ProfileUpdateRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a user updates their profile. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import jakarta.validation.constraints.Email; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/RegisterRequest.java b/backend/src/main/java/com/petshop/backend/dto/auth/RegisterRequest.java index 4758d923..d4d81a9d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/RegisterRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/RegisterRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a new user registers an account. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import jakarta.validation.constraints.Email; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/RegisterResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/RegisterResponse.java index 7e016985..91c59b72 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/RegisterResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/RegisterResponse.java @@ -1,3 +1,9 @@ +/* + * Registration result returned to the client after signing up. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordRequest.java b/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordRequest.java index 3f20f7f7..5c1ee5a6 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a user sets a new password using a reset token. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordResponse.java index 0edf18a7..0522d527 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/ResetPasswordResponse.java @@ -1,3 +1,9 @@ +/* + * Password reset confirmation returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; public class ResetPasswordResponse { diff --git a/backend/src/main/java/com/petshop/backend/dto/auth/UserInfoResponse.java b/backend/src/main/java/com/petshop/backend/dto/auth/UserInfoResponse.java index 74dbc039..34e980eb 100644 --- a/backend/src/main/java/com/petshop/backend/dto/auth/UserInfoResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/auth/UserInfoResponse.java @@ -1,3 +1,9 @@ +/* + * Logged-in user profile data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.auth; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/AddToCartRequest.java b/backend/src/main/java/com/petshop/backend/dto/cart/AddToCartRequest.java index 6075ad4c..666aabb8 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/AddToCartRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/AddToCartRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when adding a product to the shopping cart. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import jakarta.validation.constraints.Min; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/ApplyCouponRequest.java b/backend/src/main/java/com/petshop/backend/dto/cart/ApplyCouponRequest.java index 290d4434..b7143dbe 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/ApplyCouponRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/ApplyCouponRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when applying a coupon code to the cart. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/CartItemResponse.java b/backend/src/main/java/com/petshop/backend/dto/cart/CartItemResponse.java index 6b13e1bc..e3476652 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/CartItemResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/CartItemResponse.java @@ -1,3 +1,9 @@ +/* + * Single cart item returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/CartResponse.java b/backend/src/main/java/com/petshop/backend/dto/cart/CartResponse.java index 58ff0444..3e3f7d4a 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/CartResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/CartResponse.java @@ -1,3 +1,9 @@ +/* + * Full shopping cart data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutRequest.java b/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutRequest.java index 856582ed..93960872 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a customer checks out their cart. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import jakarta.validation.constraints.NotNull; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutResponse.java b/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutResponse.java index c703fbc0..d5b7a829 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/CheckoutResponse.java @@ -1,3 +1,9 @@ +/* + * Checkout result returned to the client after placing an order. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/cart/UpdateCartItemRequest.java b/backend/src/main/java/com/petshop/backend/dto/cart/UpdateCartItemRequest.java index 205aaa4a..b831939c 100644 --- a/backend/src/main/java/com/petshop/backend/dto/cart/UpdateCartItemRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/cart/UpdateCartItemRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when updating the quantity of a cart item. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.cart; import jakarta.validation.constraints.Min; diff --git a/backend/src/main/java/com/petshop/backend/dto/category/CategoryRequest.java b/backend/src/main/java/com/petshop/backend/dto/category/CategoryRequest.java index b099826f..0ad382cc 100644 --- a/backend/src/main/java/com/petshop/backend/dto/category/CategoryRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/category/CategoryRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a category. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.category; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/category/CategoryResponse.java b/backend/src/main/java/com/petshop/backend/dto/category/CategoryResponse.java index 6d9e1569..93f1e459 100644 --- a/backend/src/main/java/com/petshop/backend/dto/category/CategoryResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/category/CategoryResponse.java @@ -1,3 +1,9 @@ +/* + * Category data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.category; import java.time.LocalDateTime; diff --git a/backend/src/main/java/com/petshop/backend/dto/chat/ConversationRequest.java b/backend/src/main/java/com/petshop/backend/dto/chat/ConversationRequest.java index 8677865a..1c9d833d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/chat/ConversationRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/chat/ConversationRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when starting a new conversation. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.chat; public class ConversationRequest { diff --git a/backend/src/main/java/com/petshop/backend/dto/chat/ConversationResponse.java b/backend/src/main/java/com/petshop/backend/dto/chat/ConversationResponse.java index cef833cd..bd8bec78 100644 --- a/backend/src/main/java/com/petshop/backend/dto/chat/ConversationResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/chat/ConversationResponse.java @@ -1,3 +1,9 @@ +/* + * Conversation details returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.chat; import com.petshop.backend.entity.Conversation; diff --git a/backend/src/main/java/com/petshop/backend/dto/chat/MessageRequest.java b/backend/src/main/java/com/petshop/backend/dto/chat/MessageRequest.java index 0784054b..e7900aab 100644 --- a/backend/src/main/java/com/petshop/backend/dto/chat/MessageRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/chat/MessageRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when sending a chat message. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.chat; public class MessageRequest { diff --git a/backend/src/main/java/com/petshop/backend/dto/chat/MessageResponse.java b/backend/src/main/java/com/petshop/backend/dto/chat/MessageResponse.java index 146f0229..2a602cc2 100644 --- a/backend/src/main/java/com/petshop/backend/dto/chat/MessageResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/chat/MessageResponse.java @@ -1,3 +1,9 @@ +/* + * Chat message returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.chat; import com.petshop.backend.entity.Message; diff --git a/backend/src/main/java/com/petshop/backend/dto/chat/UpdateConversationRequest.java b/backend/src/main/java/com/petshop/backend/dto/chat/UpdateConversationRequest.java index 4c043a79..d3125659 100644 --- a/backend/src/main/java/com/petshop/backend/dto/chat/UpdateConversationRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/chat/UpdateConversationRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when changing the status of a conversation. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.chat; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/common/BulkDeleteRequest.java b/backend/src/main/java/com/petshop/backend/dto/common/BulkDeleteRequest.java index bec920f1..203bf7c6 100644 --- a/backend/src/main/java/com/petshop/backend/dto/common/BulkDeleteRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/common/BulkDeleteRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when deleting multiple records at once. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.common; import jakarta.validation.constraints.NotEmpty; diff --git a/backend/src/main/java/com/petshop/backend/dto/common/CouponRequest.java b/backend/src/main/java/com/petshop/backend/dto/common/CouponRequest.java index ffa7f766..1817cc69 100644 --- a/backend/src/main/java/com/petshop/backend/dto/common/CouponRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/common/CouponRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a coupon. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.common; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/common/CouponResponse.java b/backend/src/main/java/com/petshop/backend/dto/common/CouponResponse.java index 9d763817..2221c92a 100644 --- a/backend/src/main/java/com/petshop/backend/dto/common/CouponResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/common/CouponResponse.java @@ -1,3 +1,9 @@ +/* + * Coupon details returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.common; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/common/DropdownOption.java b/backend/src/main/java/com/petshop/backend/dto/common/DropdownOption.java index 6ea0d058..f655fb5b 100644 --- a/backend/src/main/java/com/petshop/backend/dto/common/DropdownOption.java +++ b/backend/src/main/java/com/petshop/backend/dto/common/DropdownOption.java @@ -1,3 +1,9 @@ +/* + * Simple id and label pair used for dropdown menus. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.common; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryRequest.java b/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryRequest.java index 7ad02d3a..5b3c4ef0 100644 --- a/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when updating inventory for a product. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.inventory; import jakarta.validation.constraints.NotNull; diff --git a/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryResponse.java b/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryResponse.java index 5879a554..d208fde9 100644 --- a/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/inventory/InventoryResponse.java @@ -1,3 +1,9 @@ +/* + * Inventory record returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.inventory; import java.time.LocalDateTime; diff --git a/backend/src/main/java/com/petshop/backend/dto/pet/MyPetRequest.java b/backend/src/main/java/com/petshop/backend/dto/pet/MyPetRequest.java index 37942a47..0daafc98 100644 --- a/backend/src/main/java/com/petshop/backend/dto/pet/MyPetRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/pet/MyPetRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when a customer adds or updates their own pet. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.pet; import jakarta.validation.constraints.Max; diff --git a/backend/src/main/java/com/petshop/backend/dto/pet/MyPetResponse.java b/backend/src/main/java/com/petshop/backend/dto/pet/MyPetResponse.java index 15117334..2c03726f 100644 --- a/backend/src/main/java/com/petshop/backend/dto/pet/MyPetResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/pet/MyPetResponse.java @@ -1,3 +1,9 @@ +/* + * Customer's own pet data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.pet; public class MyPetResponse { diff --git a/backend/src/main/java/com/petshop/backend/dto/pet/PetRequest.java b/backend/src/main/java/com/petshop/backend/dto/pet/PetRequest.java index 4d0986bb..cc7b693a 100644 --- a/backend/src/main/java/com/petshop/backend/dto/pet/PetRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/pet/PetRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a pet listing. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.pet; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/pet/PetResponse.java b/backend/src/main/java/com/petshop/backend/dto/pet/PetResponse.java index b7113bb1..fd6b7cc9 100644 --- a/backend/src/main/java/com/petshop/backend/dto/pet/PetResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/pet/PetResponse.java @@ -1,3 +1,9 @@ +/* + * Pet data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.pet; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/product/ProductRequest.java b/backend/src/main/java/com/petshop/backend/dto/product/ProductRequest.java index e1ca9241..f5bd69f7 100644 --- a/backend/src/main/java/com/petshop/backend/dto/product/ProductRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/product/ProductRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a product. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.product; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/product/ProductResponse.java b/backend/src/main/java/com/petshop/backend/dto/product/ProductResponse.java index c08abf9a..df11c90b 100644 --- a/backend/src/main/java/com/petshop/backend/dto/product/ProductResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/product/ProductResponse.java @@ -1,3 +1,9 @@ +/* + * Product data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.product; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/productsupplier/BulkDeleteProductSupplierRequest.java b/backend/src/main/java/com/petshop/backend/dto/productsupplier/BulkDeleteProductSupplierRequest.java index 7eb8a3cc..c2b488e0 100644 --- a/backend/src/main/java/com/petshop/backend/dto/productsupplier/BulkDeleteProductSupplierRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/productsupplier/BulkDeleteProductSupplierRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when deleting multiple product-supplier links at once. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.productsupplier; import jakarta.validation.constraints.NotEmpty; diff --git a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierKey.java b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierKey.java index 557dbeda..8f819c0b 100644 --- a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierKey.java +++ b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierKey.java @@ -1,3 +1,9 @@ +/* + * Composite key identifying a product-supplier relationship. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.productsupplier; import java.util.Objects; diff --git a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierRequest.java b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierRequest.java index 1bc05210..3d7dd214 100644 --- a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when linking a product to a supplier. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.productsupplier; import jakarta.validation.constraints.NotNull; diff --git a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierResponse.java b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierResponse.java index 4190dabb..0aac04d1 100644 --- a/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/productsupplier/ProductSupplierResponse.java @@ -1,3 +1,9 @@ +/* + * Product-supplier link data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.productsupplier; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/purchaseorder/PurchaseOrderResponse.java b/backend/src/main/java/com/petshop/backend/dto/purchaseorder/PurchaseOrderResponse.java index 98f81914..3a91e113 100644 --- a/backend/src/main/java/com/petshop/backend/dto/purchaseorder/PurchaseOrderResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/purchaseorder/PurchaseOrderResponse.java @@ -1,3 +1,9 @@ +/* + * Purchase order data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.purchaseorder; import java.time.LocalDate; diff --git a/backend/src/main/java/com/petshop/backend/dto/refund/RefundItemResponse.java b/backend/src/main/java/com/petshop/backend/dto/refund/RefundItemResponse.java index 8c33c168..b033202b 100644 --- a/backend/src/main/java/com/petshop/backend/dto/refund/RefundItemResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/refund/RefundItemResponse.java @@ -1,3 +1,9 @@ +/* + * Single refunded item returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.refund; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/refund/RefundRequest.java b/backend/src/main/java/com/petshop/backend/dto/refund/RefundRequest.java index 37121047..216a1be5 100644 --- a/backend/src/main/java/com/petshop/backend/dto/refund/RefundRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/refund/RefundRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when requesting a refund for a sale. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.refund; import com.petshop.backend.dto.sale.SaleItemRequest; diff --git a/backend/src/main/java/com/petshop/backend/dto/refund/RefundResponse.java b/backend/src/main/java/com/petshop/backend/dto/refund/RefundResponse.java index dc469dd4..0c356e63 100644 --- a/backend/src/main/java/com/petshop/backend/dto/refund/RefundResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/refund/RefundResponse.java @@ -1,3 +1,9 @@ +/* + * Refund record returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.refund; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/refund/RefundUpdateRequest.java b/backend/src/main/java/com/petshop/backend/dto/refund/RefundUpdateRequest.java index 22dddf95..dbd458ff 100644 --- a/backend/src/main/java/com/petshop/backend/dto/refund/RefundUpdateRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/refund/RefundUpdateRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when updating the status of a refund. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.refund; import jakarta.validation.constraints.NotBlank; diff --git a/backend/src/main/java/com/petshop/backend/dto/sale/SaleItemRequest.java b/backend/src/main/java/com/petshop/backend/dto/sale/SaleItemRequest.java index dad7011a..ea3cf486 100644 --- a/backend/src/main/java/com/petshop/backend/dto/sale/SaleItemRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/sale/SaleItemRequest.java @@ -1,3 +1,9 @@ +/* + * Single line item included in a sale request. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.sale; import jakarta.validation.constraints.NotNull; diff --git a/backend/src/main/java/com/petshop/backend/dto/sale/SaleRequest.java b/backend/src/main/java/com/petshop/backend/dto/sale/SaleRequest.java index b0e7989f..c81d5fdb 100644 --- a/backend/src/main/java/com/petshop/backend/dto/sale/SaleRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/sale/SaleRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when recording a new sale. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.sale; import jakarta.validation.Valid; diff --git a/backend/src/main/java/com/petshop/backend/dto/sale/SaleResponse.java b/backend/src/main/java/com/petshop/backend/dto/sale/SaleResponse.java index af116212..4fdbe968 100644 --- a/backend/src/main/java/com/petshop/backend/dto/sale/SaleResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/sale/SaleResponse.java @@ -1,3 +1,9 @@ +/* + * Sale record returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.sale; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/service/ServiceRequest.java b/backend/src/main/java/com/petshop/backend/dto/service/ServiceRequest.java index 464fefda..390eece7 100644 --- a/backend/src/main/java/com/petshop/backend/dto/service/ServiceRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/service/ServiceRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a service. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.service; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/service/ServiceResponse.java b/backend/src/main/java/com/petshop/backend/dto/service/ServiceResponse.java index 4f0300ab..b68d186d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/service/ServiceResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/service/ServiceResponse.java @@ -1,3 +1,9 @@ +/* + * Service data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.service; import java.math.BigDecimal; diff --git a/backend/src/main/java/com/petshop/backend/dto/store/StoreRequest.java b/backend/src/main/java/com/petshop/backend/dto/store/StoreRequest.java index fca03db1..b849023a 100644 --- a/backend/src/main/java/com/petshop/backend/dto/store/StoreRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/store/StoreRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a store. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.store; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/store/StoreResponse.java b/backend/src/main/java/com/petshop/backend/dto/store/StoreResponse.java index bf5cafd2..12c8be06 100644 --- a/backend/src/main/java/com/petshop/backend/dto/store/StoreResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/store/StoreResponse.java @@ -1,3 +1,9 @@ +/* + * Store data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.store; import java.time.LocalDateTime; diff --git a/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierRequest.java b/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierRequest.java index a0eb2b6a..5efd27d0 100644 --- a/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a supplier. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.supplier; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierResponse.java b/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierResponse.java index d23b4a2b..d382f61d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/supplier/SupplierResponse.java @@ -1,3 +1,9 @@ +/* + * Supplier data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.supplier; import java.time.LocalDateTime; diff --git a/backend/src/main/java/com/petshop/backend/dto/user/UserRequest.java b/backend/src/main/java/com/petshop/backend/dto/user/UserRequest.java index 04c82e43..491ace3d 100644 --- a/backend/src/main/java/com/petshop/backend/dto/user/UserRequest.java +++ b/backend/src/main/java/com/petshop/backend/dto/user/UserRequest.java @@ -1,3 +1,9 @@ +/* + * Data sent when creating or updating a user account. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.user; import com.petshop.backend.util.SafeContent; diff --git a/backend/src/main/java/com/petshop/backend/dto/user/UserResponse.java b/backend/src/main/java/com/petshop/backend/dto/user/UserResponse.java index 6c8ffd68..9cc8d6f1 100644 --- a/backend/src/main/java/com/petshop/backend/dto/user/UserResponse.java +++ b/backend/src/main/java/com/petshop/backend/dto/user/UserResponse.java @@ -1,3 +1,9 @@ +/* + * User account data returned to the client. + * + * Author: Harkamal + * Date: April 2026 + */ package com.petshop.backend.dto.user; import java.time.LocalDateTime;