Add flag to control whether to remind about maturity of rec. transaction

src/main/java/de/financer/controller/RecurringTransactionController.java

@@ -53,7 +53,7 @@ public class RecurringTransactionController {
     public ResponseEntity createRecurringTransaction(String fromAccountKey, String toAccountKey, Long amount,
                                                      String description, String holidayWeekendType,
                                                      String intervalType, String firstOccurrence,
-                                                     String lastOccurrence
+                                                     String lastOccurrence, Boolean remind
     ) {
         final String decodedFrom = ControllerUtil.urlDecode(fromAccountKey);
         final String decodedTo = ControllerUtil.urlDecode(toAccountKey);
@@ -62,13 +62,13 @@ public class RecurringTransactionController {
         if (LOGGER.isDebugEnabled()) {
             LOGGER.debug(String
                     .format("/recurringTransactions/createRecurringTransaction got parameters: %s, %s, %s, %s, %s, " +
-                                    "%s, %s, %s", decodedFrom, decodedTo, amount, decodedDesc, holidayWeekendType,
-                            intervalType, firstOccurrence, lastOccurrence));
+                                    "%s, %s, %s, %s", decodedFrom, decodedTo, amount, decodedDesc, holidayWeekendType,
+                            intervalType, firstOccurrence, lastOccurrence, remind));
         }
 
         final ResponseReason responseReason = this.recurringTransactionService
                 .createRecurringTransaction(decodedFrom, decodedTo, amount, decodedDesc, holidayWeekendType,
-                        intervalType, firstOccurrence, lastOccurrence);
+                        intervalType, firstOccurrence, lastOccurrence, remind);
 
         if (LOGGER.isDebugEnabled()) {
             LOGGER.debug(String

src/main/java/de/financer/model/RecurringTransaction.java

@@ -21,6 +21,7 @@ public class RecurringTransaction {
     @Enumerated(EnumType.STRING)
     private HolidayWeekendType holidayWeekendType;
     private boolean deleted;
+    private boolean remind;
 
     public Long getId() {
         return id;
@@ -97,4 +98,12 @@ public class RecurringTransaction {
     public void setDeleted(boolean deleted) {
         this.deleted = deleted;
     }
+
+    public boolean isRemind() {
+        return remind;
+    }
+
+    public void setRemind(boolean remind) {
+        this.remind = remind;
+    }
 }

src/main/java/de/financer/service/RecurringTransactionService.java

@@ -8,6 +8,7 @@ import de.financer.model.HolidayWeekendType;
 import de.financer.model.IntervalType;
 import de.financer.model.RecurringTransaction;
 import org.apache.commons.collections4.IterableUtils;
+import org.apache.commons.lang3.BooleanUtils;
 import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.math.NumberUtils;
 import org.slf4j.Logger;
@@ -261,16 +262,18 @@ public class RecurringTransactionService {
         return due;
     }
 
+
+
     @Transactional(propagation = Propagation.REQUIRED)
     public ResponseReason createRecurringTransaction(String fromAccountKey, String toAccountKey, Long amount,
                                                      String description, String holidayWeekendType,
                                                      String intervalType, String firstOccurrence,
-                                                     String lastOccurrence
+                                                     String lastOccurrence, Boolean remind
     ) {
         final Account fromAccount = this.accountService.getAccountByKey(fromAccountKey);
         final Account toAccount = this.accountService.getAccountByKey(toAccountKey);
         ResponseReason response = validateParameters(fromAccount, toAccount, amount, holidayWeekendType, intervalType,
-                firstOccurrence, lastOccurrence);
+                firstOccurrence, lastOccurrence); // no validation of 'remind' as it's completely optional
 
         // If we detected an issue with the given parameters return the first error found to the caller
         if (response != null) {
@@ -279,7 +282,7 @@ public class RecurringTransactionService {
 
         try {
             final RecurringTransaction transaction = buildRecurringTransaction(fromAccount, toAccount, amount,
-                    description, holidayWeekendType, intervalType, firstOccurrence, lastOccurrence);
+                    description, holidayWeekendType, intervalType, firstOccurrence, lastOccurrence, remind);
 
             this.recurringTransactionRepository.save(transaction);
 
@@ -303,13 +306,14 @@ public class RecurringTransactionService {
      * @param intervalType the interval type
      * @param firstOccurrence the first occurrence
      * @param lastOccurrence the last occurrence, may be <code>null</code>
+     * @param remind the remind flag
      *
      * @return the build {@link RecurringTransaction} instance
      */
     private RecurringTransaction buildRecurringTransaction(Account fromAccount, Account toAccount, Long amount,
                                                            String description, String holidayWeekendType,
                                                            String intervalType, String firstOccurrence,
-                                                           String lastOccurrence
+                                                           String lastOccurrence, Boolean remind
     ) {
         final RecurringTransaction recurringTransaction = new RecurringTransaction();
 
@@ -321,6 +325,9 @@ public class RecurringTransactionService {
         recurringTransaction.setIntervalType(IntervalType.valueOf(intervalType));
         recurringTransaction.setFirstOccurrence(LocalDate
                 .parse(firstOccurrence, DateTimeFormatter.ofPattern(this.financerConfig.getDateFormat())));
+        // See 'resources/database/postgres/readme_V1_0_0__init.txt'
+        recurringTransaction.setDeleted(false);
+        recurringTransaction.setRemind(BooleanUtils.toBooleanDefaultIfNull(remind, true));
 
         // lastOccurrence is optional
         if (StringUtils.isNotEmpty(lastOccurrence)) {

src/main/java/de/financer/task/SendRecurringTransactionReminderTask.java

@@ -13,6 +13,8 @@ import org.springframework.mail.javamail.JavaMailSender;
 import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Component;
 
+import java.util.stream.Collectors;
+
 @Component
 public class SendRecurringTransactionReminderTask {
 
@@ -33,7 +35,7 @@ public class SendRecurringTransactionReminderTask {
             LOGGER.debug("Enter recurring transaction reminder task");
         }
 
-        final Iterable<RecurringTransaction> recurringTransactions = this.recurringTransactionService.getAllDueToday();
+        Iterable<RecurringTransaction> recurringTransactions = this.recurringTransactionService.getAllDueToday();
 
         // If no recurring transaction is due today we don't need to send a reminder
         if (IterableUtils.isEmpty(recurringTransactions)) {
@@ -42,6 +44,12 @@ public class SendRecurringTransactionReminderTask {
             return; // early return
         }
 
+        // TODO Filtering currently happens in memory but should be done via SQL
+        recurringTransactions = IterableUtils.toList(recurringTransactions)
+                                             .stream()
+                                             .filter((rt) -> rt.isRemind())
+                                             .collect(Collectors.toList());
+
         LOGGER.info(String
                 .format("%s recurring transaction are due today and are about to be included in the reminder email",
                         IterableUtils.size(recurringTransactions)));

src/main/resources/database/hsqldb/V6_0_0__remindFlagRecurringTransaction.sql

@@ -0,0 +1,4 @@
+-- Add a new column to the recurring transaction table that controls whether
+-- a reminder about the maturity should be send
+ALTER TABLE recurring_transaction
+    ADD COLUMN remind BOOLEAN DEFAULT TRUE NOT NULL;

src/main/resources/database/postgres/V6_0_0__remindFlagRecurringTransaction.sql

@@ -0,0 +1,4 @@
+-- Add a new column to the recurring transaction table that controls whether
+-- a reminder about the maturity should be send
+ALTER TABLE recurring_transaction
+    ADD COLUMN remind BOOLEAN DEFAULT 'TRUE' NOT NULL

src/main/resources/database/postgres/readme_V1_0_0__init.txt

@@ -0,0 +1,25 @@
+The recurring transaction table is defined like this (at least for postgres):
+    -- Recurring transaction table
+    CREATE TABLE recurring_transaction (
+        id BIGINT NOT NULL PRIMARY KEY GENERATED ALWAYS AS IDENTITY,
+        from_account_id BIGINT NOT NULL,
+        to_account_id BIGINT NOT NULL,
+        description VARCHAR(1000),
+        amount BIGINT NOT NULL,
+        interval_type VARCHAR(255) NOT NULL,
+        first_occurrence DATE NOT NULL,
+        last_occurrence DATE,
+        holiday_weekend_type VARCHAR(255) NOT NULL,
+        deleted BOOLEAN DEFAULT 'TRUE' NOT NULL,
+
+        CONSTRAINT fk_recurring_transaction_from_account FOREIGN KEY (from_account_id) REFERENCES account (id),
+        CONSTRAINT fk_recurring_transaction_to_account FOREIGN KEY (to_account_id) REFERENCES account (id)
+    );
+
+Note the
+    deleted BOOLEAN DEFAULT 'TRUE' NOT NULL,
+column definition. Not sure why the default is TRUE here is it doesn't make sense.
+It was probably a mistake, however fixing it here _WILL_ break existing installations
+as Flyway uses a checksum for scripts. So there is no easy fix, except for effectively
+overwriting this default in Java code when creating a new recurring transaction.
+See RecurringTransactionService.createRecurringTransaction()