Merge Feat/user into release/v1.0.0

src/main/java/edu/group5/app/model/user/User.java

@@ -1,5 +1,120 @@
 package edu.group5.app.model.user;
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+/**
+ * User class represents a user in the system. It is an abstract class that will be extended by specific user types such as Donor, Recipient, and Admin.
+ * Each user has a unique userId, a role that defines their permissions in the system, and personal information such as first name, last name, email, and password hash.
+ * The constructor validates that all required fields are provided and throws an IllegalArgumentException if any of the fields are null or empty. 
+ * This ensures that the User objects are always in a valid state when created.
+ * The class also includes a method to verify the user's password 
+ * by comparing the provided plaintext password with the stored hashed password using BCrypt.
+ * 
+ */
+public abstract class User {
+  private int userId;
+  private String role;
+  private String firstName;
+  private String lastName;
+  private String email;
+  private String passwordHash;
+
+  /**
+   * Constructor for User class. Validates that all required fields
+   * are provided and throws an IllegalArgumentException if any of the fields are null or empty.
+   * @param userId the unique identifier for the user, must be a positive integer
+   * @param role the role of the user (e.g., "Donor", "Recipient", "Admin")
+   * @param firstName the first name of the user
+   * @param lastName the last name of the user
+   * @param email the email address of the user
+   * @param passwordHash the hashed password of the user, used for authentication purposes
+   */
+  public User(int userId, String role, String firstName, 
+            String lastName, String email, String passwordHash) {
+    if (userId <= 0) {
+        throw new IllegalArgumentException("User ID must be positive");
+    }
+    if (role == null || role.trim().isEmpty()) {
+        throw new IllegalArgumentException("Role cannot be null or empty");
+    }
+    if (firstName == null || firstName.trim().isEmpty()) {
+        throw new IllegalArgumentException("First name cannot be null or empty");
+    }
+    if (lastName == null || lastName.trim().isEmpty()) {
+        throw new IllegalArgumentException("Last name cannot be null or empty");
+    }
+    if (email == null || email.trim().isEmpty()) {
+        throw new IllegalArgumentException("Email cannot be null or empty");
+    }
+    if (passwordHash == null || passwordHash.trim().isEmpty()) {
+        throw new IllegalArgumentException("Password hash cannot be null or empty");
+    }
+    this.userId = userId;
+    this.role = role.trim();
+    this.firstName = firstName.trim();
+    this.lastName = lastName.trim();
+    this.email = email.trim();
+    this.passwordHash = passwordHash;
+}
 
-public class User {
+  /**
+   * Gets the unique identifier for the user.
+   * @return the userId of the user
+   */
+  public int getUserId() {
+    return userId;
+  }
+
+  /**
+   * Gets the role of the user, which defines their permissions in the system.
+   * @return the role of the user
+   */
+  public String getRole() {
+    return role;
+  }
+
+  /**
+   * Gets the first name of the user.
+   * @return the first name of the user
+   */
+  public String getFirstName() {
+    return firstName;
+  }
 
+  /**
+   * Gets the last name of the user.
+   * @return the last name of the user
+   */
+  public String getLastName() {
+    return lastName;
+  }
+
+  /**
+   * Gets the email address of the user.
+   * @return the email of the user
+   */
+  public String getEmail() {
+    return email;
+  }
+
+  /**
+   * Gets the hashed password of the user. 
+   * This is used for authentication purposes and should not be exposed in plaintext.
+   * @return the password hash of the user
+   */
+  public String getPasswordHash() {
+    return passwordHash;
+  }
+
+  /**
+   * Verifies if the provided password matches the stored password hash.
+   * This method uses BCrypt to compare the plaintext password with the hashed password.
+   * @param password the plaintext password to verify
+   * @return true if the password is correct, false otherwise
+   */
+  public boolean verifyPassword(String password) {
+    if (password == null || password.isEmpty()) {
+        return false;
+    }
+    BCryptPasswordEncoder encoder = new BCryptPasswordEncoder();
+    return encoder.matches(password, this.passwordHash);
+  }
 }

src/test/java/edu/group5/app/control/WrapperTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.control;
+
+public class WrapperTest {
+
+}

src/test/java/edu/group5/app/model/donation/DonationTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.model.donation;
+
+public class DonationTest {
+
+}

src/test/java/edu/group5/app/model/organization/OrganizationTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.model.organization;
+
+public class OrganizationTest {
+
+}

src/test/java/edu/group5/app/model/user/UserTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.model.user;
+
+public class UserTest {
+
+}

src/test/java/edu/group5/app/utils/UtilitiesTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.utils;
+
+public class UtilitiesTest {
+
+}

src/test/java/edu/group5/app/view/ViewTest.java

@@ -0,0 +1,5 @@
+package edu.group5.app.view;
+
+public class ViewTest {
+
+}