[17.0][ADD]mail_notify_employee_leave

mail_notify_employee_leave/README.rst

@@ -0,0 +1,104 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+==========================
+Mail Notify Employee Leave
+==========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:5f7b7a7481f72c60524273bb94fd697a975d3547b0b94c1f823902dfdaf99387
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmail-lightgray.png?logo=github
+    :target: https://github.com/OCA/mail/tree/17.0/mail_notify_employee_leave
+    :alt: OCA/mail
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/mail-17-0/mail-17-0-mail_notify_employee_leave
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/mail&target_branch=17.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module automatically notifies users when they mention or assign a
+colleague who is out of office. The notification includes the expected
+return date of the absent user and is sent only once per day per user.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+To trigger the out-of-office notification:
+
+1. An employee must have an approved leave covering today's date. This
+   sets the employee's **Is Absent** field automatically.
+2. The employee must be linked to an Odoo user.
+3. Send any message that includes employee's partner in the recipients,
+   for example, by mentioning them with ``@name``.
+
+When these conditions are met, the sender receives an internal note with
+the expected return date of the absent employee, calculated as the first
+working day after the leave ends based on the employee's working
+schedule and public holidays.
+
+The notification is sent at most once per user per day per employee.
+Sending further messages to the same absent employee on the same day
+will not produce additional notifications.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/mail/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/mail/issues/new?body=module:%20mail_notify_employee_leave%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+-------
+
+* ForgeFlow
+
+Contributors
+------------
+
+- `ForgeFlow <https://www.forgeflow.com>`__:
+
+  - Guillermo Navas <guillermo.navas@forgeflow.com>
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+This module is part of the `OCA/mail <https://github.com/OCA/mail/tree/17.0/mail_notify_employee_leave>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

mail_notify_employee_leave/__init__.py

@@ -0,0 +1 @@
+from . import models

mail_notify_employee_leave/__manifest__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 ForgeFlow S.L.
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Mail Notify Employee Leave",
+    "summary": """
+        Notifies users when they mention or assign someone who is out of office.
+    """,
+    "version": "17.0.1.0.0",
+    "license": "AGPL-3",
+    "author": "ForgeFlow, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/mail",
+    "depends": ["mail", "hr_holidays"],
+}

mail_notify_employee_leave/i18n/es.po

@@ -0,0 +1,65 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# 	* mail_notify_employee_leave
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 17.0+e\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-03-05 10:44+0000\n"
+"PO-Revision-Date: 2026-03-05 10:44+0000\n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "%(name)s is out of office, expected back on %(date)s."
+msgstr "%(name)s estará fuera de la oficina hasta el %(date)s."
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of Last Absence Notification"
+msgstr "Fecha de la última notificación"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of the last notification record"
+msgstr "Fecha del último registro de notificaciones"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_mail_thread
+msgid "Email Thread"
+msgstr "Hilo de correo electrónico"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_employee
+msgid "Employee"
+msgstr "Empleado"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_leave
+msgid "Time Off"
+msgstr "Ausencias"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users Notified Today"
+msgstr "Usuarios notificados hoy"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users who have already been notified today about this absence"
+msgstr "Usuarios que ya fueron notificados hoy sobre esta ausencia"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "User out of office"
+msgstr "Usuario fuera de la oficina"

mail_notify_employee_leave/models/__init__.py

@@ -0,0 +1,3 @@
+from . import mail_thread
+from . import hr_leave
+from . import hr_employee

mail_notify_employee_leave/models/hr_employee.py

@@ -0,0 +1,19 @@
+from odoo import fields, models
+
+
+class HrEmployee(models.Model):
+    _inherit = "hr.employee"
+
+    absence_notified_user_ids = fields.Many2many(
+        "res.users",
+        string="Users Notified Today",
+        readonly=True,
+        copy=False,
+        help="Users who have already been notified today about this absence",
+    )
+    absence_notified_date = fields.Date(
+        string="Date of Last Absence Notification",
+        readonly=True,
+        copy=False,
+        help="Date of the last notification record",
+    )

mail_notify_employee_leave/models/hr_leave.py

@@ -0,0 +1,15 @@
+from odoo import models
+
+
+class HrLeave(models.Model):
+    _inherit = "hr.leave"
+
+    def _validate_leave_request(self):
+        """
+        Override _validate_leave_request to skip absence notifications when
+        approving leaves. The context flag 'skip_absence_notification' prevents
+        _notify_thread from sending messages,
+        """
+        return super(
+            HrLeave, self.with_context(skip_absence_notification=True)
+        )._validate_leave_request()

mail_notify_employee_leave/models/mail_thread.py

@@ -0,0 +1,84 @@
+from datetime import timedelta
+
+from odoo import _, fields, models
+
+
+class MailThread(models.AbstractModel):
+    _inherit = "mail.thread"
+
+    def _notify_thread(self, message, msg_vals=False, **kwargs):
+        recipients_data = super()._notify_thread(message, msg_vals=msg_vals, **kwargs)
+        if self.env.context.get("skip_absence_notification"):
+            return recipients_data
+
+        affected_partner_ids = message.partner_ids.ids
+
+        today = fields.Date.today()
+
+        for partner_id in affected_partner_ids:
+            partner = self.env["res.partner"].browse(partner_id)
+            employee = self.env["hr.employee"].search(
+                [("user_id.partner_id", "=", partner.id)], limit=1
+            )
+            if employee and employee.is_absent:
+                if employee.absence_notified_date != today:
+                    employee.absence_notified_user_ids = [(5, 0, 0)]
+                    employee.absence_notified_date = today
+
+                if self.env.user not in employee.absence_notified_user_ids:
+                    leave_date = fields.Date.from_string(employee.leave_date_to)
+                    back_date = self.add_working_day(leave_date, employee)
+                    body = _(
+                        "%(name)s is out of office, expected back on %(date)s."
+                    ) % {
+                        "name": employee.name,
+                        "date": fields.Date.to_string(back_date),
+                    }
+                    self.message_notify(
+                        partner_ids=[self.env.user.partner_id.id],
+                        body=body,
+                        subject=_("User out of office"),
+                        subtype_xmlid="mail.mt_note",
+                        notify_author=True,
+                    )
+                    employee.absence_notified_user_ids = [(4, self.env.user.id)]
+
+        return recipients_data
+
+    def add_working_day(self, date_obj, employee):
+        """
+        Returns the next working day after `date_obj` considering
+        the employee's calendar.
+        """
+        if not employee.resource_calendar_id:
+            return date_obj + timedelta(days=1)
+
+        calendar = employee.resource_calendar_id
+        working_days = set(int(a.dayofweek) for a in calendar.attendance_ids)
+        next_day = date_obj + timedelta(days=1)
+
+        while True:
+            if not working_days:
+                break
+
+            if next_day.weekday() not in working_days:
+                next_day += timedelta(days=1)
+                continue
+
+            holiday = self.env["resource.calendar.leaves"].search(
+                [
+                    ("calendar_id", "in", [calendar.id, False]),
+                    ("resource_id", "=", False),
+                    ("date_from", "<=", next_day),
+                    ("date_to", ">=", next_day),
+                ],
+                limit=1,
+            )
+
+            if holiday:
+                next_day += timedelta(days=1)
+                continue
+
+            break
+
+        return next_day

mail_notify_employee_leave/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["whool"]
+build-backend = "whool.buildapi"

mail_notify_employee_leave/readme/CONTRIBUTORS.md

@@ -0,0 +1,2 @@
+- [ForgeFlow](https://www.forgeflow.com):
+  - Guillermo Navas \<<guillermo.navas@forgeflow.com>\>

mail_notify_employee_leave/readme/DESCRIPTION.md

@@ -0,0 +1,3 @@
+This module automatically notifies users when they mention or assign 
+a colleague who is out of office. The notification includes the expected 
+return date of the absent user and is sent only once per day per user.

mail_notify_employee_leave/readme/USAGE.md

@@ -0,0 +1,16 @@
+To trigger the out-of-office notification:
+
+1. An employee must have an approved leave covering today's date. This sets
+   the employee's **Is Absent** field automatically.
+2. The employee must be linked to an Odoo user.
+3. Send any message that includes employee's partner in the recipients,
+   for example, by mentioning them with `@name`.
+
+When these conditions are met, the sender receives an internal note with the
+expected return date of the absent employee, calculated as the first working
+day after the leave ends based on the employee's working schedule and public
+holidays.
+
+The notification is sent at most once per user per day per employee. Sending
+further messages to the same absent employee on the same day will not produce
+additional notifications.