refactor(core): Improve animal management and data handling

Refactor AnimalManager and RescueManager to improve
clarity and correct return types. Modify FeedingSchedule
and FosterHome to use final fields for immutability.

Author: jksalcedo

src/main/java/com/academixxx/AnimalManager.java

@@ -36,9 +36,10 @@ public void addAnimal() {
 
     /**
      * Creates and registers an animal programmatically.
-     * @param type animal type
+     *
+     * @param type      animal type
      * @param condition health/condition description
-     * @param status current status label
+     * @param status    current status label
      * @return the created Animal
      */
     public Animal createAnimal(String type, String condition, String status) {
@@ -49,6 +50,7 @@ public Animal createAnimal(String type, String condition, String status) {
 
     /**
      * Finds an animal by its ID.
+     *
      * @param id the animal identifier
      * @return the Animal if found, otherwise null
      */
@@ -61,19 +63,18 @@ public Animal findById(int id) {
 
     /**
      * Updates the status of an existing animal.
-     * @param id animal ID
+     *
+     * @param id        animal ID
      * @param newStatus new status label
-     * @return true if updated, false if animal not found
      */
-    public boolean updateStatus(int id, String newStatus) {
+    public void updateStatus(int id, String newStatus) {
         for (int i = 0; i < animals.size(); i++) {
             Animal a = animals.get(i);
             if (a.id() == id) {
                 animals.set(i, new Animal(a.id(), a.type(), a.condition(), newStatus));
-                return true;
+                return;
             }
         }
-        return false;
     }
 
     /**
@@ -96,11 +97,9 @@ public void listAnimals() {
         JOptionPane.showMessageDialog(null, sb.toString(), "Animals", JOptionPane.INFORMATION_MESSAGE);
     }
 
-    /**
-     * Returns a copy of the current animals list for reporting/scheduling.
-     */
     /**
      * Returns a shallow copy of the animals list for read-only use.
+     *
      * @return list copy of animals
      */
     public List<Animal> getAnimals() {

src/main/java/com/academixxx/RescueManager.java

@@ -86,9 +86,6 @@ public void registerRescue() {
         );
     }
 
-    /**
-     * Displays the list of rescues recorded.
-     */
     /**
      * Displays all recorded rescue events.
      */
@@ -100,11 +97,11 @@ public void listRescues() {
         StringBuilder sb = new StringBuilder("Rescue Events:\n");
         for (RescueEvent e : events) {
             sb.append("#").append(e.id())
-              .append(" Animal #").append(e.animalId())
-              .append(" - ").append(e.location())
-              .append(" | Rescuer: ").append(e.rescuer())
-              .append(" | When: ").append(e.dateTime())
-              .append('\n');
+                    .append(" Animal #").append(e.animalId())
+                    .append(" - ").append(e.location())
+                    .append(" | Rescuer: ").append(e.rescuer())
+                    .append(" | When: ").append(e.dateTime())
+                    .append('\n');
         }
         JOptionPane.showMessageDialog(null, sb.toString());
     }

src/main/java/com/academixxx/models/FeedingSchedule.java

@@ -9,8 +9,8 @@
  * This project keeps it minimal by design.
  */
 public class FeedingSchedule {
-    private int id;
-    private int animalId;
+    private final int id;
+    private final int animalId;
     private final List<LocalTime> feedingTimes = new ArrayList<>();
     private String notes;
 
@@ -49,6 +49,7 @@ public String getNotes() {
 
     /**
      * Sets optional notes for this schedule.
+     *
      * @param notes free-form notes
      */
     public void setNotes(String notes) {

src/main/java/com/academixxx/models/FosterHome.java

@@ -8,10 +8,10 @@
  * Validation/persistence are out of scope for this in-memory app.
  */
 public class FosterHome {
-    private int id;
-    private String caretakerName;
-    private String address;
-    private int capacity;
+    private final int id;
+    private final String caretakerName;
+    private final String address;
+    private final int capacity;
     private final List<Integer> animalIds = new ArrayList<>();
 
     public FosterHome(int id, String caretakerName, String address, int capacity) {