comment backend controllers

backend/src/main/java/com/petshop/backend/controller/ActivityLogController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles requests for viewing user activity logs.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.activity.ActivityLogResponse;

backend/src/main/java/com/petshop/backend/controller/AdoptionController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles pet adoption requests and approvals.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.adoption.AdoptionRequest;

backend/src/main/java/com/petshop/backend/controller/AiChatController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles AI-powered chat for getting pet care advice.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.ai.AiChatRequest;

backend/src/main/java/com/petshop/backend/controller/AnalyticsController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles dashboard analytics and sales reporting for staff and admins.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.analytics.DashboardResponse;

backend/src/main/java/com/petshop/backend/controller/AppointmentController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles booking and managing pet service appointments.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.appointment.AppointmentRequest;

backend/src/main/java/com/petshop/backend/controller/AuthController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles user login, registration, password reset, and profile updates.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.auth.AvatarUploadResponse;

backend/src/main/java/com/petshop/backend/controller/CartController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles shopping cart operations like adding and removing items.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.cart.*;

backend/src/main/java/com/petshop/backend/controller/CategoryController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles managing product and pet categories.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.category.CategoryRequest;

backend/src/main/java/com/petshop/backend/controller/ChatController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles chat conversations and messages between users.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.chat.ConversationRequest;

backend/src/main/java/com/petshop/backend/controller/ChatWebSocketController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles real-time chat messaging over WebSocket connections.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.config.WebSocketAuthChannelInterceptor;

backend/src/main/java/com/petshop/backend/controller/ContactController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles sending contact form messages from customers.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.entity.User;

backend/src/main/java/com/petshop/backend/controller/CouponController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles creating and managing discount coupons.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/CustomerController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles staff and admin operations for managing customer accounts.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/DropdownController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles providing dropdown menu options for forms across the app.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.DropdownOption;

backend/src/main/java/com/petshop/backend/controller/EmployeeController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles admin operations for managing employee accounts.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.user.UserRequest;

backend/src/main/java/com/petshop/backend/controller/HealthController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles health check requests to verify the server is running.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import org.springframework.http.ResponseEntity;

backend/src/main/java/com/petshop/backend/controller/InventoryController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles tracking product stock levels across store locations.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/MyPetController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles customers viewing and managing their own pets.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.pet.MyPetRequest;

backend/src/main/java/com/petshop/backend/controller/PetController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles managing pets available in the shop.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/PetImageController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles uploading, retrieving, and deleting pet images.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.pet.PetResponse;

backend/src/main/java/com/petshop/backend/controller/ProductController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles creating, updating, and browsing products in the shop.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/ProductImageController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles uploading, retrieving, and deleting product images.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.product.ProductResponse;

backend/src/main/java/com/petshop/backend/controller/ProductSupplierController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles linking products to their suppliers.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.productsupplier.BulkDeleteProductSupplierRequest;

backend/src/main/java/com/petshop/backend/controller/PurchaseOrderController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles purchase orders for restocking products from suppliers.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.purchaseorder.PurchaseOrderResponse;

backend/src/main/java/com/petshop/backend/controller/RefundController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles requesting and processing refunds for orders.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.refund.RefundRequest;

backend/src/main/java/com/petshop/backend/controller/SaleController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles creating and viewing sales and customer orders.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.sale.SaleRequest;

backend/src/main/java/com/petshop/backend/controller/ServiceController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles managing pet services like grooming and veterinary care.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/StoreController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles managing store locations for the pet shop.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/SupplierController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles managing suppliers who provide products to the shop.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;

backend/src/main/java/com/petshop/backend/controller/UserAvatarController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles uploading, retrieving, and deleting user profile pictures.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.entity.User;

backend/src/main/java/com/petshop/backend/controller/UserController.java

@@ -1,3 +1,9 @@
+/*
+ * Handles admin operations for managing all user accounts.
+ *
+ * Author: Harkamal
+ * Date: April 2026
+ */
 package com.petshop.backend.controller;
 
 import com.petshop.backend.dto.common.BulkDeleteRequest;