From 41fd7a23b94a145a54c7befb87ceaf9ede83dd3c Mon Sep 17 00:00:00 2001 From: Harkamal Randhawa Date: Mon, 20 Apr 2026 17:06:27 -0600 Subject: [PATCH] comment desktop api layer --- .../example/petshopdesktop/api/ApiClient.java | 44 +++++++++++++ .../example/petshopdesktop/api/ApiConfig.java | 6 ++ .../api/ChatRealtimeClient.java | 62 +++++++++++++++++++ .../api/dto/activity/ActivityLogResponse.java | 6 ++ .../api/dto/adoption/AdoptionRequest.java | 6 ++ .../api/dto/adoption/AdoptionResponse.java | 6 ++ .../api/dto/analytics/DailySales.java | 6 ++ .../api/dto/analytics/DashboardResponse.java | 6 ++ .../api/dto/analytics/TopProduct.java | 6 ++ .../dto/appointment/AppointmentRequest.java | 6 ++ .../dto/appointment/AppointmentResponse.java | 6 ++ .../api/dto/auth/AvatarUploadResponse.java | 6 ++ .../api/dto/auth/LoginRequest.java | 6 ++ .../api/dto/auth/LoginResponse.java | 6 ++ .../api/dto/auth/UserInfoResponse.java | 6 ++ .../api/dto/chat/ConversationRequest.java | 6 ++ .../api/dto/chat/ConversationResponse.java | 6 ++ .../api/dto/chat/MessageRequest.java | 6 ++ .../api/dto/chat/MessageResponse.java | 6 ++ .../dto/chat/UpdateConversationRequest.java | 6 ++ .../api/dto/common/BulkDeleteRequest.java | 6 ++ .../api/dto/common/DropdownOption.java | 6 ++ .../api/dto/common/PageResponse.java | 6 ++ .../api/dto/coupon/CouponRequest.java | 6 ++ .../api/dto/coupon/CouponResponse.java | 6 ++ .../api/dto/employee/EmployeeRequest.java | 6 ++ .../api/dto/employee/EmployeeResponse.java | 6 ++ .../api/dto/inventory/InventoryRequest.java | 6 ++ .../api/dto/inventory/InventoryResponse.java | 6 ++ .../api/dto/pet/PetRequest.java | 6 ++ .../api/dto/pet/PetResponse.java | 6 ++ .../api/dto/product/ProductRequest.java | 6 ++ .../api/dto/product/ProductResponse.java | 6 ++ .../ProductSupplierRequest.java | 6 ++ .../ProductSupplierResponse.java | 6 ++ .../purchaseorder/PurchaseOrderResponse.java | 6 ++ .../api/dto/sale/SaleItemRequest.java | 6 ++ .../api/dto/sale/SaleItemResponse.java | 6 ++ .../api/dto/sale/SaleRequest.java | 6 ++ .../api/dto/sale/SaleResponse.java | 6 ++ .../api/dto/service/ServiceRequest.java | 6 ++ .../api/dto/service/ServiceResponse.java | 6 ++ .../api/dto/supplier/SupplierRequest.java | 6 ++ .../api/dto/supplier/SupplierResponse.java | 6 ++ .../api/dto/user/UserRequest.java | 6 ++ .../api/dto/user/UserResponse.java | 6 ++ .../api/endpoints/ActivityLogApi.java | 6 ++ .../api/endpoints/AdoptionApi.java | 6 ++ .../api/endpoints/AnalyticsApi.java | 6 ++ .../api/endpoints/AppointmentApi.java | 6 ++ .../petshopdesktop/api/endpoints/AuthApi.java | 6 ++ .../petshopdesktop/api/endpoints/ChatApi.java | 6 ++ .../api/endpoints/CouponApi.java | 6 ++ .../api/endpoints/CustomerApi.java | 6 ++ .../api/endpoints/DropdownApi.java | 6 ++ .../api/endpoints/EmployeeApi.java | 6 ++ .../api/endpoints/InventoryApi.java | 6 ++ .../petshopdesktop/api/endpoints/PetApi.java | 6 ++ .../api/endpoints/ProductApi.java | 6 ++ .../api/endpoints/ProductSupplierApi.java | 6 ++ .../api/endpoints/PurchaseOrderApi.java | 6 ++ .../petshopdesktop/api/endpoints/SaleApi.java | 6 ++ .../api/endpoints/ServiceApi.java | 6 ++ .../api/endpoints/SupplierApi.java | 6 ++ .../petshopdesktop/api/endpoints/UserApi.java | 6 ++ 65 files changed, 484 insertions(+) diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/ApiClient.java b/desktop/src/main/java/org/example/petshopdesktop/api/ApiClient.java index baf1b99a..7317709c 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/ApiClient.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/ApiClient.java @@ -1,3 +1,9 @@ +/* + * Handles sending HTTP requests to the backend server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api; import com.fasterxml.jackson.databind.ObjectMapper; @@ -116,6 +122,15 @@ public class ApiClient { return handleResponse(response, responseClass); } + /** + * Uploads a single file as a multipart/form-data POST. + * Manually builds the multipart body since Java's HttpClient doesn't have built-in support. + * @param path API endpoint path + * @param partName the form field name for the file + * @param filePath local file to upload + * @param responseClass type to deserialize the response into + * @return the parsed response + */ public T postMultipart(String path, String partName, Path filePath, Class responseClass) throws Exception { String boundary = "----PetShopDesktop" + UUID.randomUUID(); String mimeType = Files.probeContentType(filePath); @@ -146,6 +161,17 @@ public class ApiClient { return handleResponse(response, responseClass); } + /** + * Uploads a file along with an optional text field in a single multipart POST. + * Uses SequenceInputStream to stream the file instead of loading everything into one byte array. + * @param path API endpoint path + * @param filePartName form field name for the file + * @param filePath local file to upload + * @param textPartName form field name for the text + * @param textContent the text value to send alongside the file + * @param responseClass type to deserialize the response into + * @return the parsed response + */ public T postMultipartWithText(String path, String filePartName, Path filePath, String textPartName, String textContent, Class responseClass) throws Exception { @@ -218,6 +244,11 @@ public class ApiClient { } } + /** + * Sends a DELETE with a JSON body (used for batch deletes). + * @param path API endpoint path + * @param requestBody object to serialize as the request body + */ public void deleteWithBody(String path, Object requestBody) throws Exception { String jsonBody = objectMapper.writeValueAsString(requestBody); @@ -244,6 +275,12 @@ public class ApiClient { } } + /** + * Checks the HTTP status and either deserializes the body or throws a readable error. + * @param response the raw HTTP response + * @param responseClass type to deserialize into + * @return the parsed response body, or null for 204/empty + */ private T handleResponse(HttpResponse response, Class responseClass) throws Exception { int statusCode = response.statusCode(); @@ -263,6 +300,13 @@ public class ApiClient { } } + /** + * Tries to extract a human-readable error from the JSON response body. + * Looks for an "errors" map first (field validation), then a "message" field, + * and falls back to the raw status code. + * @param response the failed HTTP response + * @return a user-facing error string + */ private String parseErrorMessage(HttpResponse response) { try { if (response.body() != null && !response.body().isEmpty()) { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/ApiConfig.java b/desktop/src/main/java/org/example/petshopdesktop/api/ApiConfig.java index 3394c653..8e6fd90d 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/ApiConfig.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/ApiConfig.java @@ -1,3 +1,9 @@ +/* + * Stores the base URL and connection settings for the API. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api; import java.io.IOException; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/ChatRealtimeClient.java b/desktop/src/main/java/org/example/petshopdesktop/api/ChatRealtimeClient.java index a505c514..1042a0f3 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/ChatRealtimeClient.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/ChatRealtimeClient.java @@ -1,3 +1,9 @@ +/* + * Manages a real-time WebSocket connection for the chat feature. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api; import org.example.petshopdesktop.api.dto.chat.ConversationResponse; @@ -59,6 +65,10 @@ public class ChatRealtimeClient implements WebSocket.Listener { return INSTANCE; } + /** + * Registers a listener that gets called when chat notification state changes. + * @param listener receives true if there are chats needing attention + */ public void addNotificationListener(Consumer listener) { synchronized (lock) { notificationListeners.add(listener); @@ -66,6 +76,11 @@ public class ChatRealtimeClient implements WebSocket.Listener { } } + /** + * Seeds the global conversation map from a full list fetch. + * Called on first load and on refresh to sync local state with server. + * @param conversations the full list from the REST API + */ public void initializeState(List conversations) { synchronized (lock) { globalConversations.clear(); @@ -76,6 +91,12 @@ public class ChatRealtimeClient implements WebSocket.Listener { updateNotificationState(); } + /** + * Marks a conversation as replied to by updating the last sender and read state. + * Used after the current user sends a message so the badge clears. + * @param conversationId the conversation that was replied to + * @param senderId the user who sent the reply + */ public void markConversationReplied(Long conversationId, Long senderId) { synchronized (lock) { ConversationResponse conv = globalConversations.get(conversationId); @@ -100,6 +121,12 @@ public class ChatRealtimeClient implements WebSocket.Listener { } } + /** + * Checks if any open conversation needs staff attention. + * Two cases count: unassigned chats waiting for pickup, + * and chats assigned to me where the customer sent the last message. + * @return true if there's at least one chat needing action + */ public boolean hasActionableChats() { synchronized (lock) { UserSession session = UserSession.getInstance(); @@ -125,6 +152,9 @@ public class ChatRealtimeClient implements WebSocket.Listener { } } + /** + * Recalculates the badge state and notifies listeners only if it changed. + */ private void updateNotificationState() { boolean currentState = hasActionableChats(); List> listeners; @@ -153,6 +183,10 @@ public class ChatRealtimeClient implements WebSocket.Listener { } } + /** + * Opens the WebSocket and sends a STOMP CONNECT frame with the JWT. + * No-ops if already connected or mid-handshake. + */ public void connect() { String token = UserSession.getInstance().getJwtToken(); if (token == null || token.isBlank()) { @@ -167,6 +201,7 @@ public class ChatRealtimeClient implements WebSocket.Listener { connecting = true; } + // Convert the REST base URL to a WebSocket URL String wsUrl = ApiConfig.getInstance().getBaseUrl() .replaceFirst("^http://", "ws://") .replaceFirst("^https://", "wss://") + "/ws/chat"; @@ -236,6 +271,13 @@ public class ChatRealtimeClient implements WebSocket.Listener { } } + /** + * Sends a chat message over the WebSocket using a STOMP SEND frame. + * Falls back to reconnecting if the socket isn't ready. + * @param conversationId target conversation + * @param content the message text + * @return true if the frame was sent, false if not connected + */ public boolean sendMessage(Long conversationId, String content) { String token = UserSession.getInstance().getJwtToken(); if (token == null || token.isBlank()) { @@ -287,6 +329,10 @@ public class ChatRealtimeClient implements WebSocket.Listener { applySelectedConversationSubscriptionLocked(); } + /** + * Subscribes to the currently selected conversation's message topic. + * Unsubscribes from the previous one first if it changed. + */ private void applySelectedConversationSubscriptionLocked() { if (webSocket == null || !connected) { return; @@ -324,6 +370,12 @@ public class ChatRealtimeClient implements WebSocket.Listener { updateNotificationState(); } + /** + * Parses a single STOMP frame and dispatches it. + * Handles CONNECTED (finish handshake), MESSAGE (deliver to listeners), + * and ERROR frames. + * @param frame the raw STOMP frame text without the null terminator + */ private void handleFrame(String frame) { String normalized = frame.replace("\r\n", "\n"); int separator = normalized.indexOf("\n\n"); @@ -354,11 +406,14 @@ public class ChatRealtimeClient implements WebSocket.Listener { } if ("MESSAGE".equals(command)) { + // Look up which topic this subscription maps to String destination; synchronized (lock) { destination = destinationBySubscription.get(headers.get("subscription")); } try { + // Messages on a specific conversation topic are chat messages; + // messages on the general conversations topic are conversation updates if (destination != null && destination.startsWith("/topic/chat/conversations/")) { MessageResponse message = ApiClient.getInstance().getObjectMapper().readValue(bodyPart, MessageResponse.class); if (messageListener != null) { @@ -371,12 +426,14 @@ public class ChatRealtimeClient implements WebSocket.Listener { .notifyNewMessage(message.getSenderDisplayName(), message.getContent()); } + // Keep the global map in sync for badge calculations synchronized (lock) { ConversationResponse conv = globalConversations.get(message.getConversationId()); if (conv != null) { conv.setLastMessage(message.getContent()); conv.setLastSenderId(message.getSenderId()); } + // Incoming message from someone else marks it unread again if (message.getSenderId() != null && !message.getSenderId().equals(currentUserId)) { readConversationIds.remove(message.getConversationId()); } @@ -416,6 +473,11 @@ public class ChatRealtimeClient implements WebSocket.Listener { } @Override + /** + * Accumulates WebSocket text fragments and splits on the STOMP null delimiter. + * A single WebSocket message can contain partial frames, so we buffer until + * we see the \0 that marks the end of a STOMP frame. + */ public CompletionStage onText(WebSocket webSocket, CharSequence data, boolean last) { synchronized (lock) { frameBuffer.append(data); diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/activity/ActivityLogResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/activity/ActivityLogResponse.java index 482476eb..8930c012 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/activity/ActivityLogResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/activity/ActivityLogResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for an activity log entry. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.activity; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionRequest.java index b1d56eab..2df613b0 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating an adoption. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.adoption; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionResponse.java index 56134bff..7e3e6469 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/adoption/AdoptionResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for an adoption record. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.adoption; import java.time.LocalDate; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DailySales.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DailySales.java index 320a8266..4647a4ca 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DailySales.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DailySales.java @@ -1,3 +1,9 @@ +/* + * Holds daily sales total data returned from the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.analytics; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DashboardResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DashboardResponse.java index 38b17b81..bd5cc464 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DashboardResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/DashboardResponse.java @@ -1,3 +1,9 @@ +/* + * Holds all the summary data shown on the dashboard. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.analytics; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/TopProduct.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/TopProduct.java index a62ccce9..d6b82da8 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/TopProduct.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/analytics/TopProduct.java @@ -1,3 +1,9 @@ +/* + * Holds data for a top-selling product from the analytics endpoint. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.analytics; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentRequest.java index e8166411..3d610486 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating an appointment. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.appointment; import java.time.LocalDate; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentResponse.java index dd74554b..84c5dfc9 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/appointment/AppointmentResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for an appointment. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.appointment; import java.time.LocalDate; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/AvatarUploadResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/AvatarUploadResponse.java index 24dadcca..7eae590c 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/AvatarUploadResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/AvatarUploadResponse.java @@ -1,3 +1,9 @@ +/* + * Holds the URL returned after uploading a user avatar. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.auth; public class AvatarUploadResponse { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginRequest.java index 89d6a98f..57e03da5 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginRequest.java @@ -1,3 +1,9 @@ +/* + * Holds the username and password sent when logging in. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.auth; public class LoginRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginResponse.java index 50354d48..abb0e6f7 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/LoginResponse.java @@ -1,3 +1,9 @@ +/* + * Holds the token and user info returned after logging in. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.auth; public class LoginResponse { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/UserInfoResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/UserInfoResponse.java index fe83893c..0a62318b 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/UserInfoResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/auth/UserInfoResponse.java @@ -1,3 +1,9 @@ +/* + * Holds the current user's profile information from the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.auth; public class UserInfoResponse { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationRequest.java index cd5ef6ee..a5946bad 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when starting a new conversation. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.chat; public class ConversationRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationResponse.java index 30a24fbb..ee0887de 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/ConversationResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a conversation. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.chat; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageRequest.java index a5c17ca4..9adfe551 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when sending a chat message. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.chat; public class MessageRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageResponse.java index 7aecada0..b8026f96 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/MessageResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a chat message. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.chat; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/UpdateConversationRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/UpdateConversationRequest.java index 3bacbca9..17cd18fa 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/UpdateConversationRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/chat/UpdateConversationRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when updating a conversation. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.chat; public class UpdateConversationRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/BulkDeleteRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/BulkDeleteRequest.java index d95798ef..cc5f29b3 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/BulkDeleteRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/BulkDeleteRequest.java @@ -1,3 +1,9 @@ +/* + * Holds a list of IDs to delete multiple records at once. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.common; import java.util.List; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/DropdownOption.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/DropdownOption.java index bacbad0b..d453fe0e 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/DropdownOption.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/DropdownOption.java @@ -1,3 +1,9 @@ +/* + * Holds an ID and label pair used to fill dropdown menus. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.common; public class DropdownOption { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/PageResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/PageResponse.java index 5a27e2e9..9c4b8df1 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/PageResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/common/PageResponse.java @@ -1,3 +1,9 @@ +/* + * Holds a page of results along with pagination details. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.common; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponRequest.java index dc11d55c..f8708c5d 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a coupon. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.coupon; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponResponse.java index e1c23f0d..0acf2698 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/coupon/CouponResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a coupon. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.coupon; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeRequest.java index dd2a7271..9d4a0c29 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating an employee. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.employee; public class EmployeeRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeResponse.java index c6a32d23..a3a59e63 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/employee/EmployeeResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for an employee. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.employee; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryRequest.java index 935a713e..4182b455 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when updating inventory. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.inventory; public class InventoryRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryResponse.java index 176228b9..536d058a 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/inventory/InventoryResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for an inventory record. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.inventory; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetRequest.java index 4bb56185..c6e793dc 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a pet. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.pet; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetResponse.java index f0961a18..d850111c 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/pet/PetResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a pet. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.pet; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductRequest.java index 020afca6..9e4c4461 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a product. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.product; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductResponse.java index 18f9b678..65901061 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/product/ProductResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a product. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.product; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierRequest.java index 69f4ad61..ee862426 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when linking a product to a supplier. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.productsupplier; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierResponse.java index b601efe3..cb31d536 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/productsupplier/ProductSupplierResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a product-supplier link. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.productsupplier; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/purchaseorder/PurchaseOrderResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/purchaseorder/PurchaseOrderResponse.java index c928e649..a8aeb8a5 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/purchaseorder/PurchaseOrderResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/purchaseorder/PurchaseOrderResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a purchase order. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.purchaseorder; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemRequest.java index 03401958..3e5de272 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data for a single item in a sale request. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.sale; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemResponse.java index 8bed99b1..759a7f26 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleItemResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a single sale item. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.sale; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleRequest.java index fe324bb5..fe9ff428 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating a sale. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.sale; import java.util.List; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleResponse.java index f814cc17..aaf4facf 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/sale/SaleResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a sale. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.sale; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceRequest.java index 8fd68a1b..2e68d972 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a service. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.service; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceResponse.java index caf2e3ff..374fc1fc 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/service/ServiceResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a service. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.service; import java.math.BigDecimal; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierRequest.java index fb3dcd92..d437877f 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a supplier. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.supplier; public class SupplierRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierResponse.java index 64db982f..7325b69e 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/supplier/SupplierResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a supplier. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.supplier; public class SupplierResponse { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserRequest.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserRequest.java index e4dd940d..080ed678 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserRequest.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserRequest.java @@ -1,3 +1,9 @@ +/* + * Holds data sent to the server when creating or updating a user. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.user; public class UserRequest { diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserResponse.java b/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserResponse.java index 2e1daa0e..3df18650 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserResponse.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/dto/user/UserResponse.java @@ -1,3 +1,9 @@ +/* + * Holds data returned from the server for a user. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.dto.user; import java.time.LocalDateTime; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ActivityLogApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ActivityLogApi.java index 6c092b78..2bcf5c64 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ActivityLogApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ActivityLogApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to fetch activity logs from the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AdoptionApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AdoptionApi.java index e9291e8f..a46cbad6 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AdoptionApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AdoptionApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage adoptions through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AnalyticsApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AnalyticsApi.java index ebecd9c2..975d8725 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AnalyticsApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AnalyticsApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to fetch analytics and dashboard data from the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import org.example.petshopdesktop.api.ApiClient; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AppointmentApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AppointmentApi.java index 0fe56661..25381423 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AppointmentApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AppointmentApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage appointments through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AuthApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AuthApi.java index e45ead94..476d213c 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AuthApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/AuthApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods for logging in and managing authentication. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import org.example.petshopdesktop.api.ApiClient; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ChatApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ChatApi.java index 3d58547e..f40a5998 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ChatApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ChatApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage chat conversations and messages. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CouponApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CouponApi.java index a08e0016..652be9f3 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CouponApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CouponApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage coupons through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CustomerApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CustomerApi.java index 54f89f66..0abd05e4 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CustomerApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/CustomerApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage customers through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/DropdownApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/DropdownApi.java index 4f0d34b9..1ef3dcf8 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/DropdownApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/DropdownApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to fetch dropdown option lists from the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/EmployeeApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/EmployeeApi.java index e3a8ad52..7505cc87 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/EmployeeApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/EmployeeApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage employees through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/InventoryApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/InventoryApi.java index bf34cf22..0660c816 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/InventoryApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/InventoryApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage inventory through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PetApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PetApi.java index 865bb1ea..79221563 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PetApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PetApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage pets through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductApi.java index c5ec100d..d3a61f5f 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage products through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductSupplierApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductSupplierApi.java index 74143c0f..4f95923a 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductSupplierApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ProductSupplierApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage product-supplier links through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PurchaseOrderApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PurchaseOrderApi.java index 5ce083f9..5465ed64 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PurchaseOrderApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/PurchaseOrderApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage purchase orders through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SaleApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SaleApi.java index ab1c4fa1..bb7b704b 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SaleApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SaleApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage sales through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ServiceApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ServiceApi.java index 66b348dc..91008473 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ServiceApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/ServiceApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage services through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SupplierApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SupplierApi.java index bcfb8acb..e8f3ea42 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SupplierApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/SupplierApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage suppliers through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference; diff --git a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/UserApi.java b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/UserApi.java index 27439ee9..0d2da6d4 100644 --- a/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/UserApi.java +++ b/desktop/src/main/java/org/example/petshopdesktop/api/endpoints/UserApi.java @@ -1,3 +1,9 @@ +/* + * Provides methods to manage user accounts through the server. + * + * Author: Harkamal + * Date: April 2026 + */ package org.example.petshopdesktop.api.endpoints; import com.fasterxml.jackson.core.type.TypeReference;