Added members for a team and exceptions for assigned personel

Author: point85

README.md

@@ -11,10 +11,22 @@ The diagram below illustrates Business Management Systems' DNO (Day, Night, Off)
 
 A shift is defined with a name, description, starting time of day and duration.  An off-shift period is associated with a shift.  In the example above for Team1, there are two shifts followed by one off-shift period.  Shifts can be overlapped (typically when a handoff of duties is important such as in the nursing profession).  A rotation is a sequence of shifts and off-shift days.  The DNO rotation is Day on, Night on and Night off.  An instance of a shift has a starting date and time of day and has an associated shift definition.
 
+*Break*
+
+A break is a defined working period of time during a shift, for example lunch.  A shift can have zero or more breaks.
+
 *Team*
 
 A team is defined with a name and description.  It has a rotation with a starting date.  The starting date shift will have an instance with that date and a starting time of day as defined by the shift.  The same rotation can be shared between more than one team, but with different starting times.
 
+*Team Member*
+
+A team member is a person assigned to a team.  The member is identified by a member ID (e.g. employee ID), name and description/title.
+
+*Team Member Exception*
+
+A team member exception is an addition and/or removal from the assigned members of a team for a specified shift instance.  The instance is identified by the starting date and time.
+
 *Work Schedule*
 
 A work schedule is defined with a name and description.  It has one or more teams.  Zero or more non-working periods can be defined.  A non-working period has a defined starting date and time of day and duration.  For example, the New Year's Day holiday starting at midnight for 24 hours, or three consecutive days for preventive maintenance of manufacturing equipment starting at the end of the night shift. 
@@ -218,13 +230,39 @@ Working shifts
 [7] Day: 2017-02-07
    (1) Team: Green, Shift: 24 Hour, Start : 2017-02-07T07:00, End : 2017-02-08T07:00
 ```
+
+For a fourth example, for a restaurant shift starting at 7 am on August 8, 2024, team member #1 called in sick and is to be replaced by member #10:
+```java
+// Sunday team
+Team sundayDay = schedule.createTeam("SundayDay", "Sunday day", dayRotation, LocalDate.of(2024, 7, 28);
+		
+// chef members
+TeamMember one = new TeamMember("Chef, One", "Chef", "1");
+TeamMember ten = new TeamMember("Ten", "Ten description", "10");
+
+sundayDay.addMember(one);
+...
+// replace one with ten
+LocalDateTime exceptionShift = LocalDateTime.of(LocalDate.of(2024, 8, 11), LocalTime.of(7, 0, 0));
+TeamMemberException replacement = new TeamMemberException(exceptionShift);
+replacement.setRemoval(one);
+replacement.setAddition(ten);
+sundayDay.addMemberException(replacement);
+
+// #1 is in the assigned list
+List<TeamMember> members = sundayDay.getAssignedMembers();
+
+// but is replaced by #10 for that shift instance:
+members = sundayDay.getMembers(exceptionShift);
+```
+
 ## Maven Central Repository
 Add this dependency to your pom.xml file:
 ```java
 <dependency>
 <groupId>org.point85</groupId>
 <artifactId>workschedule</artifactId>
-<version>1.1.4</version>
+<version>1.2.0</version>
 </dependency>
 ```
 

Release Notes.txt

@@ -2,12 +2,8 @@
 						   RELEASE NOTES
 
 (1)  1.1.4, February 6, 2024:  
-	- Created a Maven repository at org.point85.workschedule:
-	<dependency>
-		<groupId>org.point85</groupId>
-		<artifactId>workschedule</artifactId>
-		<version>1.1.4</version>
-	</dependency>
-
 	- Upgraded hamcrest to 2.2
-	- Removed unused Maven dependencies
+	- Removed unused Maven dependencies
+	
+(1)  1.2.0, December 15, 2024:  
+	- Added members for a team and exceptions for assigned personel 	

javadoc/workschedule-1.1.4-javadoc.zip

@@ -2,7 +2,7 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>org.point85</groupId>
 	<artifactId>workschedule</artifactId>
-	<version>1.1.4</version>
+	<version>1.2.0</version>
 	<packaging>jar</packaging>
 	<name>Work Schedule</name>
 	<description>Work schedule with shifts and teams.</description>

javadoc/workschedule-1.2.0-javadoc.zip

@@ -145,9 +145,16 @@ public String toString() {
 		String s = WorkSchedule.getMessage("shift");
 		String ps = WorkSchedule.getMessage("period.start");
 		String pe = WorkSchedule.getMessage("period.end");
+		String members = WorkSchedule.getMessage("team.members");
 
-		return " " + t + ": " + getTeam().getName() + ", " + s + ": " + getShift().getName() + ", " + ps + ": "
-				+ getStartTime() + ", " + pe + ": " + getEndTime();
+		String text = " " + t + ": " + getTeam().getName() + " (" + team.getDescription() + ")" + ", " + s + ": " + getShift().getName() + ", " + ps + ": "
+				+ getStartTime() + ", " + pe + ": " + getEndTime() + "\n" + members;
+
+		for (TeamMember member : getTeam().getMembers(getStartTime())) {
+			text += "\n\t" + member;
+		}
+
+		return text;
 	}
 
 }