Feature/ogc 1896 mark invalid email addresses

src/onegov/directory/collections/directory.py

@@ -89,6 +89,16 @@
             return self.query().filter(EntryRecipient.id == id).first()
         return None
 
+    def by_address(
+            self,
+            address: str,
+    ) -> EntryRecipient | None:
+
+        query = self.query()
+        query = query.filter(EntryRecipient.address == address)
+
+        return query.first()
+
     def add(
         self,
         address: str,

src/onegov/directory/models/directory.py

@@ -590,7 +590,7 @@
         return DirectoryEntryForm
 
 
-class EntryRecipient(Base, TimestampMixin):
+class EntryRecipient(Base, TimestampMixin, ContentMixin):
     """ Represents a single recipient.
     """
 
@@ -628,6 +628,28 @@
         nullable=False
     )
 
+    @property
+    def is_inactive(self) -> bool:
+        """
+        Checks if the directory entry recipient's email address is marked as
+        inactive.
+
+        Returns:
+            bool: True if the email address is marked as inactive, False
+            otherwise.
+        """
+        return self.meta.get('inactive', False)
+
+    def mark_inactive(self) -> None:
+        """
+        Marks the recipient's email address as inactive.
+
+        This method sets the 'inactive' flag in the recipient's metadata to
+        True. It is typically used when a bounce event causes the email
+        address to be deactivated by Postmark.
+        """
+        self.meta['inactive'] = True
+
 
 class EntrySubscription:
     """ Adds subscription management to a recipient. """

src/onegov/town6/templates/directory_entry_recipients.pt

@@ -26,6 +26,9 @@
                        i18n:attributes="data-confirm-extra;data-confirm-yes;data-confirm-no">
                         unsubscribe
                     </a>
+                    <span tal:condition="recipient.is_inactive|nothing" class="small-text info-text" title="This recipient has delivery failures, including hard bounces, invalid email addresses, spam complaints, manual deactivations, or being blocked. We recommend unsubscribing it from the list." i18n:attributes="title">
+                        <i class="fa fa-exclamation-triangle"></i>
+                    </span>
                 </li>
             </ul>
         </tal:b>