feat(dto): add request DTO classes for admin service module

Added new request DTO classes under com.techtorque.admin_service.dto.request
to support admin-related endpoints with validation annotations and clear
data structures.

Included classes:
- CreateServiceTypeRequest.java
- UpdateServiceTypeRequest.java
- GenerateReportRequest.java
- ScheduleReportRequest.java
- CreateEmployeeRequest.java
- UpdateUserRequest.java

Each class includes:
• Jakarta validation annotations for field-level validation
• Lombok annotations (@DaTa, @builder, @NoArgsConstructor, @AllArgsConstructor)
• Structured documentation for API usage (POST/PUT endpoints)
• Input constraints for improved data integrity

Author: Suweka

admin-service/src/main/java/com/techtorque/admin_service/dto/request/CreateEmployeeRequest.java

@@ -0,0 +1,40 @@
+// ========================================
+// CreateEmployeeRequest.java
+// ========================================
+
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * Request DTO for creating employee accounts
+ * Used by: POST /admin/users/employee
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class CreateEmployeeRequest {
+
+    @NotBlank(message = "Full name is required")
+    @Size(min = 2, max = 100, message = "Full name must be between 2 and 100 characters")
+    private String fullName;
+
+    @NotBlank(message = "Email is required")
+    @Email(message = "Invalid email format")
+    private String email;
+
+    @NotBlank(message = "Role is required")
+    @Pattern(regexp = "EMPLOYEE", message = "Role must be EMPLOYEE")
+    private String role;
+
+    @Size(max = 100, message = "Department must be less than 100 characters")
+    private String department;
+
+    @Pattern(regexp = "^\\+?[1-9]\\d{1,14}$", message = "Invalid phone number format")
+    private String phone;
+}

admin-service/src/main/java/com/techtorque/admin_service/dto/request/CreateServiceTypeRequest.java

@@ -0,0 +1,55 @@
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.math.BigDecimal;
+
+/**
+ * Request DTO for creating a new service type
+ * Used by: POST /admin/service-types
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class CreateServiceTypeRequest {
+
+    @NotBlank(message = "Service name is required")
+    @Size(max = 100, message = "Name must be less than 100 characters")
+    private String name;
+
+    @Size(max = 500, message = "Description must be less than 500 characters")
+    private String description;
+
+    @NotBlank(message = "Category is required")
+    @Pattern(regexp = "MAINTENANCE|REPAIR|MODIFICATION|INSPECTION",
+            message = "Category must be MAINTENANCE, REPAIR, MODIFICATION, or INSPECTION")
+    private String category;
+
+    @NotNull(message = "Price is required")
+    @DecimalMin(value = "0.0", inclusive = false, message = "Price must be greater than 0")
+    @Digits(integer = 8, fraction = 2, message = "Price must have max 8 integer digits and 2 decimal places")
+    private BigDecimal price;
+
+    @NotNull(message = "Duration is required")
+    @Min(value = 15, message = "Duration must be at least 15 minutes")
+    @Max(value = 480, message = "Duration must not exceed 8 hours (480 minutes)")
+    private Integer durationMinutes;
+
+    // Optional fields
+    private Boolean requiresApproval = false;
+
+    @Min(value = 1, message = "Daily capacity must be at least 1")
+    @Max(value = 50, message = "Daily capacity cannot exceed 50")
+    private Integer dailyCapacity;
+
+    @Pattern(regexp = "BASIC|INTERMEDIATE|ADVANCED",
+            message = "Skill level must be BASIC, INTERMEDIATE, or ADVANCED")
+    private String skillLevel;
+
+    @Size(max = 500, message = "Icon URL must be less than 500 characters")
+    private String iconUrl;
+}

admin-service/src/main/java/com/techtorque/admin_service/dto/request/GenerateReportRequest.java

@@ -0,0 +1,56 @@
+// ========================================
+// GenerateReportRequest.java
+// ========================================
+
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.time.LocalDate;
+
+/**
+ * Request DTO for generating reports
+ * Used by: POST /admin/reports/generate
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class GenerateReportRequest {
+
+    @NotBlank(message = "Report type is required")
+    @Pattern(regexp = "SERVICE_PERFORMANCE|REVENUE|EMPLOYEE_PRODUCTIVITY|CUSTOMER_SATISFACTION|INVENTORY|APPOINTMENT_SUMMARY",
+            message = "Invalid report type")
+    private String type;
+
+    @NotNull(message = "Start date is required")
+    @PastOrPresent(message = "Start date cannot be in the future")
+    private LocalDate fromDate;
+
+    @NotNull(message = "End date is required")
+    private LocalDate toDate;
+
+    @NotBlank(message = "Format is required")
+    @Pattern(regexp = "JSON|PDF|EXCEL|CSV", message = "Format must be JSON, PDF, EXCEL, or CSV")
+    private String format;
+
+    // Optional filters for more specific reports
+    private String departmentId;
+    private String employeeId;
+    private String serviceCategory;
+    private String customerId;
+
+    /**
+     * Custom validation to ensure fromDate is before toDate
+     */
+    @AssertTrue(message = "End date must be after start date")
+    public boolean isValidDateRange() {
+        if (fromDate == null || toDate == null) {
+            return true; // Let @NotNull handle null validation
+        }
+        return !toDate.isBefore(fromDate);
+    }
+}

admin-service/src/main/java/com/techtorque/admin_service/dto/request/ScheduleReportRequest.java

@@ -0,0 +1,46 @@
+// ========================================
+// ScheduleReportRequest.java
+// ========================================
+
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.util.List;
+
+/**
+ * Request DTO for scheduling recurring reports
+ * Used by: POST /admin/reports/schedule
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class ScheduleReportRequest {
+
+    @NotBlank(message = "Report type is required")
+    @Pattern(regexp = "SERVICE_PERFORMANCE|REVENUE|EMPLOYEE_PRODUCTIVITY|CUSTOMER_SATISFACTION|INVENTORY",
+            message = "Invalid report type")
+    private String type;
+
+    @NotBlank(message = "Frequency is required")
+    @Pattern(regexp = "DAILY|WEEKLY|MONTHLY", message = "Frequency must be DAILY, WEEKLY, or MONTHLY")
+    private String frequency;
+
+    @NotEmpty(message = "At least one recipient email is required")
+    @Size(max = 10, message = "Maximum 10 recipients allowed")
+    private List<@Email(message = "Invalid email address") String> recipients;
+
+    // Optional: specific day for WEEKLY (1-7, Monday-Sunday) or MONTHLY (1-31)
+    @Min(value = 1, message = "Day must be between 1 and 31")
+    @Max(value = 31, message = "Day must be between 1 and 31")
+    private Integer dayOfSchedule;
+
+    // Optional: specific hour for daily reports (0-23)
+    @Min(value = 0, message = "Hour must be between 0 and 23")
+    @Max(value = 23, message = "Hour must be between 0 and 23")
+    private Integer hourOfDay;
+}

admin-service/src/main/java/com/techtorque/admin_service/dto/request/UpdateServiceTypeRequest.java

@@ -0,0 +1,46 @@
+// ========================================
+// UpdateServiceTypeRequest.java
+// ========================================
+
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.math.BigDecimal;
+
+/**
+ * Request DTO for updating service type
+ * Used by: PUT /admin/service-types/{typeId}
+ * All fields are optional for partial updates
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class UpdateServiceTypeRequest {
+
+    @Size(max = 500, message = "Description must be less than 500 characters")
+    private String description;
+
+    @DecimalMin(value = "0.0", inclusive = false, message = "Price must be greater than 0")
+    @Digits(integer = 8, fraction = 2)
+    private BigDecimal price;
+
+    @Min(value = 15, message = "Duration must be at least 15 minutes")
+    @Max(value = 480, message = "Duration must not exceed 480 minutes")
+    private Integer durationMinutes;
+
+    private Boolean active;
+
+    @Min(value = 1, message = "Daily capacity must be at least 1")
+    private Integer dailyCapacity;
+
+    @Pattern(regexp = "BASIC|INTERMEDIATE|ADVANCED")
+    private String skillLevel;
+
+    @Size(max = 500)
+    private String iconUrl;
+}

admin-service/src/main/java/com/techtorque/admin_service/dto/request/UpdateUserRequest.java

@@ -0,0 +1,34 @@
+// ========================================
+// UpdateUserRequest.java
+// ========================================
+
+package com.techtorque.admin_service.dto.request;
+
+import jakarta.validation.constraints.*;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import java.util.List;
+
+/**
+ * Request DTO for updating user information
+ * Used by: PUT /admin/users/{userId}
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class UpdateUserRequest {
+
+    @Pattern(regexp = "ADMIN|EMPLOYEE|CUSTOMER", message = "Role must be ADMIN, EMPLOYEE, or CUSTOMER")
+    private String role;
+
+    private Boolean active;
+
+    @Size(max = 20, message = "Maximum 20 permissions allowed")
+    private List<String> permissions;
+
+    @Size(max = 100)
+    private String department;
+}