Added a review launch notification email (and converted the review assignment approval email to MJML).

Author: ocielliottc

server/src/main/java/com/objectcomputing/checkins/services/reviews/ReviewPeriodServicesImpl.java

@@ -10,7 +10,10 @@
 import com.objectcomputing.checkins.services.feedback_request.FeedbackRequest;
 import com.objectcomputing.checkins.services.memberprofile.MemberProfileRepository;
 import com.objectcomputing.checkins.services.memberprofile.MemberProfile;
+import io.micronaut.context.annotation.Value;
 import io.micronaut.context.env.Environment;
+import io.micronaut.core.io.Readable;
+import io.micronaut.core.io.IOUtils;
 import jakarta.inject.Named;
 import jakarta.inject.Singleton;
 import jakarta.validation.constraints.NotNull;
@@ -25,6 +28,7 @@
 import java.util.Set;
 import java.util.UUID;
 import java.util.stream.Collectors;
+import java.io.BufferedReader;
 
 @Singleton
 class ReviewPeriodServicesImpl implements ReviewPeriodServices {
@@ -40,12 +44,17 @@ class ReviewPeriodServicesImpl implements ReviewPeriodServices {
     private final Environment environment;
     private final String webAddress;
 
+    @Value("classpath:mjml/supervisor_review_assignment.mjml")
+    private Readable supervisorReviewAssignmentTemplate;
+    @Value("classpath:mjml/review_period_announcement.mjml")
+    private Readable reviewPeriodAnnouncementTemplate;
+
     ReviewPeriodServicesImpl(ReviewPeriodRepository reviewPeriodRepository,
                                     ReviewAssignmentRepository reviewAssignmentRepository,
                                     MemberProfileRepository memberProfileRepository,
                                     FeedbackRequestServices feedbackRequestServices,
                                     ReviewStatusTransitionValidator reviewStatusTransitionValidator,
-                                    @Named(MailJetFactory.HTML_FORMAT) EmailSender emailSender,
+                                    @Named(MailJetFactory.MJML_FORMAT) EmailSender emailSender,
                                     Environment environment,
                                     CheckInsConfiguration checkInsConfiguration) {
         this.reviewPeriodRepository = reviewPeriodRepository;
@@ -173,8 +182,20 @@ public ReviewPeriod update(@NotNull ReviewPeriod reviewPeriod) {
                          " does not have a self-review template.");
             }
 
+            Set<String> allInvolved = new HashSet<>();
             Set<UUID> selfRevieweeIds = new HashSet<>();
             for (ReviewAssignment assignment : assignments) {
+                Optional<MemberProfile> reviewerProfile =
+                  memberProfileRepository.findById(assignment.getReviewerId());
+                if (!reviewerProfile.isEmpty()) {
+                    allInvolved.add(reviewerProfile.get().getWorkEmail());
+                }
+                Optional<MemberProfile> revieweeProfile =
+                  memberProfileRepository.findById(assignment.getRevieweeId());
+                if (!revieweeProfile.isEmpty()) {
+                    allInvolved.add(revieweeProfile.get().getWorkEmail());
+                }
+
                 // This person is being reviewed and will need a self-review
                 // request.
                 selfRevieweeIds.add(assignment.getRevieweeId());
@@ -197,11 +218,46 @@ period, findCreatorId(assignment.getReviewerId()),
                                         selfReviewCloseDate);
                 }
             }
+
+            String emailContent = constructReviewPeriodAnnouncementEmail(
+                period.getName(), period.getPeriodStartDate(),
+                period.getPeriodEndDate(), period.getLaunchDate(),
+                period.getSelfReviewCloseDate(), period.getCloseDate()
+            );
+            emailSender.sendEmail(null, null, "It's time for performance reviews!", emailContent, allInvolved.toArray(new String[0]));
         }
 
         return period;
     }
 
+    private String dateAsString(LocalDateTime dateTime) {
+        String str = String.format("%s %d, %d",
+                                   dateTime.getMonth(),
+                                   dateTime.getDayOfMonth(),
+                                   dateTime.getYear());
+        return str.substring(0, 1) + str.substring(1).toLowerCase();
+    }
+
+    private String constructReviewPeriodAnnouncementEmail(
+                       String reviewPeriodName, LocalDateTime startDate,
+                       LocalDateTime endDate, LocalDateTime launchDate,
+                       LocalDateTime selfReviewDate, LocalDateTime closeDate
+) {
+        try {
+            return String.format(IOUtils.readText(
+                            new BufferedReader(
+                                reviewPeriodAnnouncementTemplate.asReader())),
+                            reviewPeriodName, reviewPeriodName,
+                            dateAsString(startDate), dateAsString(endDate),
+                            dateAsString(launchDate),
+                            dateAsString(selfReviewDate),
+                            dateAsString(closeDate));
+        } catch(Exception ex) {
+            LOG.error(ex.toString());
+            return "";
+        }
+    }
+
     private void notifyRevieweeSupervisorsByReviewPeriod(UUID reviewPeriodId, String reviewPeriodName) {
         if (environment.getActiveNames().contains(Environments.LOCAL)) return;
         Set<ReviewAssignment> reviewAssignments = reviewAssignmentRepository.findByReviewPeriodId(reviewPeriodId);
@@ -217,14 +273,20 @@ private void notifyRevieweeSupervisorsByReviewPeriod(UUID reviewPeriodId, String
         List<String> supervisorEmails = memberProfileRepository.findWorkEmailByIdIn(supervisorIdsToString);
 
         // send notification to supervisors
-        String emailContent = constructEmailContent(reviewPeriodId, reviewPeriodName);
+        String emailContent = constructSupervisorEmail(reviewPeriodId, reviewPeriodName);
         emailSender.sendEmail(null, null, "Review Assignments Awaiting Approval", emailContent, supervisorEmails.toArray(new String[0]));
     }
 
-    private String constructEmailContent (UUID reviewPeriodId, String reviewPeriodName){
-        return """
-                <h3>Review Assignments for Review Period '%s' are ready for your approval.</h3>\
-                <a href="%s/feedback/reviews?period=%s">Click here</a> to review and approve reviewer assignments in the Check-Ins app.""".formatted(reviewPeriodName, webAddress, reviewPeriodId);
+    private String constructSupervisorEmail(UUID reviewPeriodId, String reviewPeriodName){
+        try {
+            return String.format(IOUtils.readText(
+                            new BufferedReader(
+                                supervisorReviewAssignmentTemplate.asReader())),
+                            reviewPeriodName, webAddress, reviewPeriodId);
+        } catch(Exception ex) {
+            LOG.error(ex.toString());
+            return "";
+        }
     }
 
     private void validateDates(ReviewPeriod period) {

server/src/main/resources/mjml/review_period_announcement.mjml

@@ -0,0 +1,40 @@
+<mjml>
+  <mj-head>
+    <mj-title>%s</mj-title>
+    <mj-preview>It's time for performance reviews!</mj-preview>
+    <mj-attributes>
+      <mj-class name="preheader" color="#000000" font-size="11px" font-family="Ubuntu, Helvetica, Arial, sans-serif" padding="0px"></mj-class>
+      <mj-section background-color="#ffffff" padding="20px 20px">
+    </mj-attributes>
+  </mj-head>
+  <mj-body background-color="#e0f2ff">
+    <mj-section background-color="#2559a7">
+      <mj-column>
+        <mj-image src="https://objectcomputing.com/files/6416/4277/8012/ObjectComputingLogo_version2_white.png" alt="logo" width="150px"></mj-image>
+      </mj-column>
+    </mj-section>
+    <mj-hero mode="fluid-height" background-url="https://lh3.googleusercontent.com/pw/AL9nZEW6o0zSXFq6gKMdO2kpj_KZa8NLCnGq8bPoyiDFKimEuXOeuo1FsE8MhLP7ZTrSIUuf3zG4WuAQE2qLPzyDSqGAYaOhHOuWpWg2ocTjXLTbU5wUe-69JFoWbFU0gW3yDV7X5yfMollI5rq7N24vUs82=w1200-h600-no" background-color="#FFF" padding="100px 0px">
+      <mj-text padding="20px" font-family="Helvetica" align="center" font-size="45px" line-height="45px" font-weight="900">It's Time for Performance Reviews!</mj-text>
+    </mj-hero>
+    <mj-section background-color="#ffffff">
+      <mj-column>
+        <mj-text>
+          <h2>%s Starts Soon!</h2>
+        </mj-text>
+        <mj-text font-size="16px">It's nearly time for our next performance reviews. This review covers the period from %s through %s</mj-text>
+        <mj-text font-size="16px">Here is what to expect:
+          <ul>
+            <li><strong>%s</strong> - Self-reviews begin</li>
+            <li><strong>%s</strong> - Self-reviews must be completed</li>
+            <li><strong>%s</strong> - Reviews must be completed</li>
+          </ul>
+        </mj-text>
+        <mj-text font-size="16px">Help us make this a valuable experience for everyone!</mj-text>
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="#feb672" padding="10px">
+      <mj-column vertical-align="top" width="100%%">
+        <mj-text align="center" color="#FFF" font-size="16px">Thank you for everything you do!</mj-text>
+      </mj-column>
+    </mj-section>
+  </mj-body>

server/src/main/resources/mjml/supervisor_review_assignment.mjml

@@ -0,0 +1,13 @@
+<mjml>
+  <mj-body>
+    <mj-section>
+      <mj-column>
+        <mj-divider border-color="#2559a7"></mj-divider>
+        <mj-text font-size="16px" font-family="'Helvetica Neue', Helvetica, Arial, sans-serif" color="#4d4c4f">
+          <h3>Review Assignments for Review Period '%s' are ready for your approval.</h3></mj-text>
+<mj-text font-size="16px" font-family="'Helvetica Neue', Helvetica, Arial, sans-serif" color="#4d4c4f">
+          Click <a href="%s/feedback/reviews?period=%s">here</a> to review and approve reviewer assignments in the Check-Ins app.</mj-text>
+      </mj-column>
+    </mj-section>
+  </mj-body>
+</mjml>