diff --git a/time_capture/custom_fields.py b/time_capture/custom_fields.py index 66ca71c..d35b4c5 100644 --- a/time_capture/custom_fields.py +++ b/time_capture/custom_fields.py @@ -24,6 +24,24 @@ def get_custom_fields(): "precision": "2", "allow_on_submit": 1, }, + { + "fieldname": "custom_absence_plan", + "fieldtype": "Link", + "insert_after": "leave_application", + "label": _("Absence Plan"), + "no_copy": 1, + "options": "Absence Plan", + "read_only": 1, + }, + { + "fieldname": "custom_leave_type_absence_plan", + "fieldtype": "Link", + "insert_after": "custom_absence_plan", + "label": _("Leave Type (Absence Plan)"), + "no_copy": 1, + "options": "Leave Type", + "read_only": 1, + }, { "label": _("Time Capture"), "fieldname": "custom_time_capture", diff --git a/time_capture/locale/de.po b/time_capture/locale/de.po index 02da69c..7e4a085 100644 --- a/time_capture/locale/de.po +++ b/time_capture/locale/de.po @@ -7,8 +7,8 @@ msgid "" msgstr "" "Project-Id-Version: Time Capture VERSION\n" "Report-Msgid-Bugs-To: patrick@alyf.de\n" -"POT-Creation-Date: 2026-01-22 17:02+0053\n" -"PO-Revision-Date: 2025-11-07 14:07+0053\n" +"POT-Creation-Date: 2026-02-03 11:32+0053\n" +"PO-Revision-Date: 2025-02-02 17:08+0053\n" "Last-Translator: patrick@alyf.de\n" "Language-Team: patrick@alyf.de\n" "MIME-Version: 1.0\n" @@ -31,11 +31,54 @@ msgstr "Verwaltung" msgid "Freelancer Time Capture" msgstr "Freelancer Zeiterfassung" +#. Name of a DocType +#: time_capture/custom_fields.py:31 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:102 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:133 +msgid "Absence Plan" +msgstr "Abwesenheitsplan" + +#. Name of a DocType +#: time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json +msgid "Absence Plan Date" +msgstr "Abwesenheitsplan-Datum" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:64 +msgid "Absence Plan has been approved. The Employee will not have to capture any time for these dates." +msgstr "Der Abwesenheitsplan wurde genehmigt. Der Mitarbeiter muss für diese Daten keine Zeiterfassung vornehmen." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:72 +msgid "Absence Plan with dates in the past (or today) cannot be cancelled. Instead you can use the 'Delete Future Dates' button on top of the page. This will delete the future dates from the Absence Plan, but will not affect the past dates." +msgstr "Ein Abwesenheitsplan mit Daten in der Vergangenheit (oder heute) kann nicht storniert werden. Stattdessen können Sie den Knopf 'Zukünftige Daten löschen' oben auf der Seite verwenden. Dadurch werden die zukünftigen Daten aus dem Abwesenheitsplan gelöscht, die vergangenen Daten bleiben unberührt." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:136 +msgid "Absence Plan {0} - {1}" +msgstr "Abwesenheitsplan {0} - {1}" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:105 +msgid "Absence Plan {0} for approval" +msgstr "Abwesenheitsplan {0} zum Freigeben" + #. Label of a Duration field in DocType 'Mandatory Break' #: time_capture/time_capture/doctype/mandatory_break/mandatory_break.json msgid "Additional Break" msgstr "Zusätzliche Pause" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:310 +msgid "All Dates are in the future. Please cancel the Absence Plan instead." +msgstr "Alle Daten liegen in der Zukunft. Bitte stornieren Sie stattdessen den Abwesenheitsplan." + +#. Label of a Section Break field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Approval" +msgstr "Freigabe" + +#. Option for the 'Status' (Select) field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Approved" +msgstr "Genehmigt" + #: time_capture/time_capture/report/working_time/working_time.js:24 msgid "April" msgstr "April" @@ -58,7 +101,13 @@ msgstr "August" msgid "Break" msgstr "Pause" -#: time_capture/custom_fields.py:60 time_capture/public/js/employee.js:29 +#. Label of a Button field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:110 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Bulk Insert" +msgstr "Massen einfügen" + +#: time_capture/custom_fields.py:78 time_capture/public/js/employee.js:29 msgid "Change/Add Expected Hours" msgstr "Erwartete Stunden ändern/hinzufügen" @@ -103,6 +152,10 @@ msgstr "Freelancer-Benutzer wird erstellt" msgid "Current Balance" msgstr "Aktuelles Saldo" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:225 +msgid "Dates cannot be in the past or today." +msgstr "Daten dürfen nicht in der Vergangenheit (oder auf heute) liegen." + #: time_capture/time_capture/report/working_time/working_time.js:32 msgid "December" msgstr "Dezember" @@ -117,6 +170,14 @@ msgstr "Default-Aktivitätstyp" msgid "Default Freelancer Activity Type" msgstr "Standard-Freelancer-Aktivitätstyp" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:23 +msgid "Delete Future Dates" +msgstr "Zukünftige Daten löschen" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:312 +msgid "Deleted {0} future date(s)." +msgstr "{0} zukünftige Datum/Daten gelöscht." + #. Label of a quick_list in the Freelancer Workspace #: time_capture/time_capture/workspace/freelancer/freelancer.json msgid "Drafts" @@ -126,6 +187,11 @@ msgstr "Entwürfe" msgid "Duplicate Entry Found" msgstr "Doppelter Eintrag gefunden" +#. Label of a Data field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Employee Email" +msgstr "Mitarbeiter-E-Mail" + #. Name of a DocType #: time_capture/time_capture/doctype/employee_expected_working_hours/employee_expected_working_hours.json msgid "Employee Expected Working Hours" @@ -140,6 +206,10 @@ msgstr "Mitarbeiterstatus" msgid "Employee {0} has Attendances outside the Holiday List period." msgstr "Mitarbeiter {0} hat Anwesenheiten außerhalb der Periode der Feiertagsliste." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:139 +msgid "Employee {0} has been notified via Email." +msgstr "Mitarbeiter {0} wurde per E-Mail benachrichtigt." + #. Label of a Check field in DocType 'Time Capture Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json msgid "Enable Reminders" @@ -150,7 +220,7 @@ msgstr "Erinnerungen aktivieren" msgid "Enforce Mandatory Breaks" msgstr "Verpflichtende Pausen erzwingen" -#: time_capture/scripts/attendance.py:195 +#: time_capture/scripts/attendance.py:192 msgid "Error creating Attendance" msgstr "Fehler beim Erstellen der Anwesenheit" @@ -170,6 +240,12 @@ msgstr "Alle X Tage" msgid "Example: If you set this field to '3', the system sends Notifications every 3 days." msgstr "Beispiel: Wenn Sie dieses Feld auf '3' setzen, sendet das System alle 3 Tage Benachrichtigungen." +#. Description of the 'Reason' (Text Editor) field in DocType 'Absence Plan +#. Date' +#: time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json +msgid "Examples: School or weekly off, etc." +msgstr "Beispiele: Schule, wöchentlicher freier Tag usw." + #. Label of a Float field in DocType 'Employee Expected Working Hours' #: time_capture/time_capture/doctype/employee_expected_working_hours/employee_expected_working_hours.json msgid "Expected Daily Working Hours" @@ -177,13 +253,13 @@ msgstr "Erwartete tägliche Arbeitsstunden" #: time_capture/scripts/employee.py:49 msgid "Expected Daily Working Hours cannot be greater than 12h." -msgstr "Die Erwartete tägliche Arbeitszeits darf nicht größer als 12h sein." +msgstr "Die erwartete tägliche Arbeitszeit darf nicht größer als 12h sein." #: time_capture/scripts/employee.py:43 msgid "Expected Daily Working Hours cannot be less than 0h." msgstr "Die erwartete tägliche Arbeitszeit darf nicht geringer als 0h sein." -#: time_capture/custom_fields.py:11 time_capture/custom_fields.py:52 +#: time_capture/custom_fields.py:11 time_capture/custom_fields.py:70 #: time_capture/public/js/employee.js:35 #: time_capture/time_capture/report/working_time/working_time.py:30 msgid "Expected Working Hours" @@ -232,7 +308,7 @@ msgid "Freelancer Name" msgstr "Freelancer-Name" #. Name of a DocType -#: time_capture/custom_fields.py:101 +#: time_capture/custom_fields.py:119 #: time_capture/time_capture/doctype/freelancer_time_capture/freelancer_time_capture.json msgid "Freelancer Time Capture" msgstr "Freelancer Zeiterfassung" @@ -241,10 +317,14 @@ msgstr "Freelancer Zeiterfassung" msgid "Freelancer Time Capture can only be created for users with the 'Freelancer' role. Change the user in the field 'User'." msgstr "Freelancer Zeiterfassung kann nur für Benutzer mit der 'Freelancer'-Rolle erstellt werden. Ändern Sie den Benutzer im Feld 'Benutzer'." -#: time_capture/custom_fields.py:109 +#: time_capture/custom_fields.py:127 msgid "Freelancer User" msgstr "Freelancer-Benutzer" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:285 +msgid "From Date is in the future. This means you can just cancel the whole Absence Plan." +msgstr "Das Von-Datum liegt in der Zukunft. Daher kann der komplette Abwesenheitsplan storniert werden." + #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.py:89 msgid "Future Balance" msgstr "Zukünftiges Saldo" @@ -271,6 +351,10 @@ msgstr "Allgemeiner Vorschlag: Verwenden Sie einen Aktivitätstyp mit msgid "Go to list view" msgstr "Zur Listenansicht" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:85 +msgid "Holidays from a Holiday List have priority over leaves with an Absence Plan." +msgstr "Feiertage aus einer Feiertagsliste haben Vorrang vor Abwesenheiten mit einem Abwesenheitsplan." + #. Description of the 'Enable Reminders' (Check) field in DocType 'Time Capture #. Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json @@ -292,6 +376,10 @@ msgstr "Angegebene Pause" msgid "Indicated Break is not in the proper format." msgstr "Angegebene Pause ist nicht im korrekten Format." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:234 +msgid "Invalid mode" +msgstr "Ungültiger Modus" + #. Label of a Check field in DocType 'Time Capture' #: time_capture/time_capture/doctype/time_capture/time_capture.json msgid "Is Of Legal Age" @@ -318,7 +406,13 @@ msgstr "Letzte manuelle Saldo-Korrektur" msgid "Last Notification (Sent On)" msgstr "Letzte Benachrichtigung (gesendet am)" -#: time_capture/custom_fields.py:65 +#. Label of a Link field in DocType 'Absence Plan' +#. Name of a role +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Leave Approver" +msgstr "Urlaubsgenehmiger" + +#: time_capture/custom_fields.py:83 msgid "Leave Policy" msgstr "Urlaubsrichtlinie" @@ -330,15 +424,25 @@ msgstr "Urlaubsrichtlinie wurde geändert. Hinweis: Dies aktualisiert keine best msgid "Leave Summary" msgstr "Urlaubsübersicht" +#. Label of a Link field in DocType 'Absence Plan' #: time_capture/public/js/utils.js:143 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json msgid "Leave Type" msgstr "Urlaubstyp" +#: time_capture/custom_fields.py:40 +msgid "Leave Type (Absence Plan)" +msgstr "Urlaubstyp (Abwesenheitsplan)" + #. Name of a report #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.json msgid "Leave and Working Time Summaries" msgstr "Urlaubs- und Arbeitszeitübersichten" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:108 +msgid "Leave approver {0} has been notified via Email." +msgstr "Urlaubsgenehmiger {0} wurde per E-Mail benachrichtigt." + #. Label of a Section Break field in DocType 'Time Capture Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json msgid "Leaves" @@ -375,7 +479,11 @@ msgstr "Mai" msgid "Minimum Draft Age (Days)" msgstr "Mindestalter für Entwürfe (Tage)" -#: time_capture/custom_fields.py:41 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:115 +msgid "Mode" +msgstr "Modus" + +#: time_capture/custom_fields.py:59 msgid "No Supervisor Required" msgstr "Kein Vorgesetzter Benötigt" @@ -435,6 +543,14 @@ msgstr "November" msgid "October" msgstr "Oktober" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:78 +msgid "Official weekly offs (e.g. 4 day work week set in employee contract) should be handled via Holiday List." +msgstr "Offizielle wöchentliche freie Tage (z. B. 4-Tage-Woche im Arbeitsvertrag) sollten über die Feiertagsliste abgebildet werden." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:60 +msgid "Only Absence Plans with status 'Approved' and 'Rejected' can be submitted" +msgstr "Nur Abwesenheitspläne mit Status 'Genehmigt' und 'Abgelehnt' können gebucht werden." + #: time_capture/public/js/employee.js:11 msgid "Only System Manager are allowed to edit Expected Working Hours." msgstr "Nur System Manager dürfen Erwartete Arbeitsstunden anpassen." @@ -445,6 +561,14 @@ msgstr "Nur System Manager dürfen Erwartete Arbeitsstunden anpassen." msgid "Only send reminders for draft Time Captures that are older than this number of days. Set to 0 to include all drafts regardless of date." msgstr "Nur Erinnerungen für Entwürfe senden, die älter sind als diese Anzahl von Tagen. Setzen Sie auf 0, um alle Entwürfe unabhängig vom Datum zu senden." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:282 +msgid "Only submitted Absence Plans can use this action." +msgstr "Nur gebuchte Abwesenheitspläne können diese Aktion ausführen." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:289 +msgid "Only the Leave Approver and users with the 'Cancel' permission can delete future dates." +msgstr "Nur der Urlaubsgenehmiger und Benutzer mit der Berechtigung „Stornieren“ können zukünftige Daten löschen." + #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.py:96 msgid "Open Time Captures" msgstr "Offene Zeiterfassungen" @@ -457,6 +581,10 @@ msgstr "Andere Abwesenheitstage" msgid "Overdue Time Captures" msgstr "Überfällige Zeiterfassungen" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:211 +msgid "Overlapping Dates are not allowed" +msgstr "Überlappende Daten sind nicht erlaubt" + #: time_capture/time_capture/report/working_time/working_time.py:50 msgid "Paid Holidays" msgstr "Bezahlte Feiertage" @@ -470,6 +598,10 @@ msgstr "Urlaubstyp Bezahlt" msgid "Past time captures, that are not yet submitted. These count as absent and reduce the balance." msgstr "Vergangene Zeiterfassungen, die noch nicht eingereicht wurden. Diese zählen als abwesend und reduzieren das Saldo." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:290 +msgid "Permission Denied" +msgstr "Berechtigung verweigert" + #: time_capture/public/js/utils.js:191 msgid "Planned Overtime Reduction" msgstr "Geplante Überstundenreduzierung" @@ -486,6 +618,10 @@ msgstr "Bitte überprüfen und buchen Sie die ausstehenden Zeiterfassungen." msgid "Please save the Employee first." msgstr "Bitte speichern Sie den Mitarbeiter zuerst." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:229 +msgid "Please select at least one weekday" +msgstr "Bitte wählen Sie mindestens einen Wochentag." + #: time_capture/time_capture/doctype/create_freelancer/create_freelancer.js:18 msgid "Please wait..." msgstr "Bitte warten..." @@ -523,7 +659,7 @@ msgstr "Speichern & Anwesenheiten aktualisieren" msgid "September" msgstr "September" -#: time_capture/custom_fields.py:44 +#: time_capture/custom_fields.py:62 msgid "Should be checked if the employee is a CEO (or has no supervisor for some reason)." msgstr "Sollte aktiviert sein, wenn der Mitarbeiter ein Geschäftsführer ist (oder aus anderem Grund keinen Vorgesetzten hat)." @@ -571,6 +707,10 @@ msgstr "Das Datum {0} liegt nicht innerhalb der Periode der Feiertagsliste des M msgid "The following Time Captures are still in draft status:" msgstr "Die folgenden Zeiterfassungen sind noch im Entwurfsstatus:" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:167 +msgid "The following dates are in the past (or today) and have been removed from the Absence Plan:
{0}" +msgstr "Die folgenden Daten liegen in der Vergangenheit (oder heute) und wurden aus dem Abwesenheitsplan entfernt:
{0}" + #: time_capture/scripts/employee.py:77 msgid "The supervisor cannot be the same as the employee." msgstr "Der Vorgesetzte kann nicht gleich dem Mitarbeiter sein." @@ -579,6 +719,10 @@ msgstr "Der Vorgesetzte kann nicht gleich dem Mitarbeiter sein." msgid "The supervisor has no User linked in his/her Employee record." msgstr "Der Vorgesetzte hat keinen Nutzer in seinem/ihren Mitarbeiter-Eintrag." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:208 +msgid "There are overlapping dates with following Absence Plans:
{0}" +msgstr "Es gibt überlappende Daten mit folgenden Abwesenheitsplänen:
{0}" + #: time_capture/scripts/employee.py:87 msgid "This Employee has no supervisor (Reports To), but has Create User Permission checkbox enabled. Please, make sure that this intended." msgstr "Dieser Mitarbeiter hat keinen Vorgesetzten, aber er hat Benutzerberechtigung Erstellen aktiviert. Bitte prüfen Sie, ob das gewollt ist." @@ -596,7 +740,7 @@ msgid "This is the projected balance, that includes planned overtime reductions" msgstr "Dies ist das prognostizierte Saldo, das geplante Überstundenreduzierungen enthält" #. Name of a DocType -#: time_capture/custom_fields.py:28 time_capture/custom_fields.py:93 +#: time_capture/custom_fields.py:46 time_capture/custom_fields.py:111 #: time_capture/time_capture/doctype/time_capture/time_capture.json msgid "Time Capture" msgstr "Zeiterfassung" @@ -610,7 +754,7 @@ msgstr "Zeiterfassungs- & Urlaubsübersicht" msgid "Time Capture Log" msgstr "Zeiterfassungsprotokoll" -#: time_capture/scripts/attendance.py:157 +#: time_capture/scripts/attendance.py:154 msgid "Time Capture Not Found" msgstr "Zeiterfassung nicht gefunden" @@ -632,6 +776,18 @@ msgstr "Frist für die Zeiterfassung verpasst. Bitte wenden Sie sich an Ihre Fü msgid "Time to Submit (in days)" msgstr "Frist zur Einreichung (in Tagen)" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:81 +msgid "Timespan: adds all dates in the range with an optional reason." +msgstr "Zeitspanne: fügt alle Daten im Bereich mit optionalem Grund hinzu." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:82 +msgid "Typical use case: Employee is on Education Leave (University, School, etc.)." +msgstr "Typischer Anwendungsfall: Mitarbeiter hat Bildungsurlaub (Universität, Schule usw.)." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:75 +msgid "Typical use case: Every Friday is an unofficial weekly off day." +msgstr "Typischer Anwendungsfall: Jeden Freitag ist ein inoffizieller freier Tag." + #: time_capture/public/js/utils.js:120 msgid "Unable to fetch summary data" msgstr "Zusammenfassungsdaten konnten nicht abgerufen werden" @@ -651,6 +807,15 @@ msgstr "Verwendet für Mitarbeiter ohne verknüpften Nutzer (=E-Mail-Adresse)" msgid "User is not a Freelancer" msgstr "Benutzer ist kein Freelancer" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:44 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:88 +msgid "Warning: The Leave Ledgers will not be updated for leaves with an Absence Plan. Therefore, it is not suggested to use Leave Types (such as 'Annual Leave') that have limited Leave Allocation." +msgstr "Hinweis: Die Urlaubskonten werden bei Abwesenheiten mit einem Abwesenheitsplan nicht aktualisiert. Daher wird davon abgeraten, Urlaubstypen mit begrenzter Urlaubszuweisung (z. B. 'Erholungsurlaub') zu verwenden." + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:72 +msgid "Weekly Off: adds all dates in the range that fall on the selected weekday. The Holiday List already defines non-working days; adding e.g. every Sunday as weekly off is often redundant." +msgstr "Wöchentlicher freier Tag: fügt alle Daten im Bereich hinzu, die auf den gewählten Wochentag fallen. Die Feiertagsliste legt bereits arbeitsfreie Tage fest; z. B. jeden Sonntag als wöchentlichen freien Tag hinzuzufügen ist oft überflüssig." + #. Label of a Duration field in DocType 'Time Capture' #. Name of a report #: time_capture/time_capture/doctype/time_capture/time_capture.json @@ -673,6 +838,10 @@ msgstr "Arbeitszeitübersicht" msgid "Working time must be completely booked on projects and tasks." msgstr "Die Arbeitszeit muss vollständig auf Projekte und Aufgaben gebucht werden." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:123 +msgid "Your Absence Plan {0} has been {1}." +msgstr "Ihr Abwesenheitsplan {0} wurde {1}" + #: time_capture/scripts/summary_utils.py:109 msgid "{0} (on {1})" msgstr "{0} (am {1})" @@ -685,3 +854,7 @@ msgstr "{0} Attendances erfolgreich aktualisiert." msgid "{0} already exists for this date and person." msgstr "{0} existiert bereits für dieses Datum und diese Person." +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:90 +msgid "{0} raised a new Absence Plan for approval: {1}" +msgstr "{0} hat einen neuen Abwesenheitsplan zum Freigeben erstellt: {1}" + diff --git a/time_capture/locale/main.pot b/time_capture/locale/main.pot index 0e2f2f5..ac658b9 100644 --- a/time_capture/locale/main.pot +++ b/time_capture/locale/main.pot @@ -7,8 +7,8 @@ msgid "" msgstr "" "Project-Id-Version: Time Capture VERSION\n" "Report-Msgid-Bugs-To: patrick@alyf.de\n" -"POT-Creation-Date: 2026-01-22 17:02+0053\n" -"PO-Revision-Date: 2026-01-22 17:02+0053\n" +"POT-Creation-Date: 2026-02-03 11:32+0053\n" +"PO-Revision-Date: 2026-02-03 11:32+0053\n" "Last-Translator: patrick@alyf.de\n" "Language-Team: patrick@alyf.de\n" "MIME-Version: 1.0\n" @@ -31,11 +31,54 @@ msgstr "" msgid "Freelancer Time Capture" msgstr "" +#. Name of a DocType +#: time_capture/custom_fields.py:31 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:102 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:133 +msgid "Absence Plan" +msgstr "" + +#. Name of a DocType +#: time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json +msgid "Absence Plan Date" +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:64 +msgid "Absence Plan has been approved. The Employee will not have to capture any time for these dates." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:72 +msgid "Absence Plan with dates in the past (or today) cannot be cancelled. Instead you can use the 'Delete Future Dates' button on top of the page. This will delete the future dates from the Absence Plan, but will not affect the past dates." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:136 +msgid "Absence Plan {0} - {1}" +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:105 +msgid "Absence Plan {0} for approval" +msgstr "" + #. Label of a Duration field in DocType 'Mandatory Break' #: time_capture/time_capture/doctype/mandatory_break/mandatory_break.json msgid "Additional Break" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:310 +msgid "All Dates are in the future. Please cancel the Absence Plan instead." +msgstr "" + +#. Label of a Section Break field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Approval" +msgstr "" + +#. Option for the 'Status' (Select) field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Approved" +msgstr "" + #: time_capture/time_capture/report/working_time/working_time.js:24 msgid "April" msgstr "" @@ -58,7 +101,13 @@ msgstr "" msgid "Break" msgstr "" -#: time_capture/custom_fields.py:60 time_capture/public/js/employee.js:29 +#. Label of a Button field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:110 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Bulk Insert" +msgstr "" + +#: time_capture/custom_fields.py:78 time_capture/public/js/employee.js:29 msgid "Change/Add Expected Hours" msgstr "" @@ -103,6 +152,10 @@ msgstr "" msgid "Current Balance" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:225 +msgid "Dates cannot be in the past or today." +msgstr "" + #: time_capture/time_capture/report/working_time/working_time.js:32 msgid "December" msgstr "" @@ -117,6 +170,14 @@ msgstr "" msgid "Default Freelancer Activity Type" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:23 +msgid "Delete Future Dates" +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:312 +msgid "Deleted {0} future date(s)." +msgstr "" + #. Label of a quick_list in the Freelancer Workspace #: time_capture/time_capture/workspace/freelancer/freelancer.json msgid "Drafts" @@ -126,6 +187,11 @@ msgstr "" msgid "Duplicate Entry Found" msgstr "" +#. Label of a Data field in DocType 'Absence Plan' +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Employee Email" +msgstr "" + #. Name of a DocType #: time_capture/time_capture/doctype/employee_expected_working_hours/employee_expected_working_hours.json msgid "Employee Expected Working Hours" @@ -140,6 +206,10 @@ msgstr "" msgid "Employee {0} has Attendances outside the Holiday List period." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:139 +msgid "Employee {0} has been notified via Email." +msgstr "" + #. Label of a Check field in DocType 'Time Capture Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json msgid "Enable Reminders" @@ -150,7 +220,7 @@ msgstr "" msgid "Enforce Mandatory Breaks" msgstr "" -#: time_capture/scripts/attendance.py:195 +#: time_capture/scripts/attendance.py:192 msgid "Error creating Attendance" msgstr "" @@ -170,6 +240,12 @@ msgstr "" msgid "Example: If you set this field to '3', the system sends Notifications every 3 days." msgstr "" +#. Description of the 'Reason' (Text Editor) field in DocType 'Absence Plan +#. Date' +#: time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json +msgid "Examples: School or weekly off, etc." +msgstr "" + #. Label of a Float field in DocType 'Employee Expected Working Hours' #: time_capture/time_capture/doctype/employee_expected_working_hours/employee_expected_working_hours.json msgid "Expected Daily Working Hours" @@ -183,7 +259,7 @@ msgstr "" msgid "Expected Daily Working Hours cannot be less than 0h." msgstr "" -#: time_capture/custom_fields.py:11 time_capture/custom_fields.py:52 +#: time_capture/custom_fields.py:11 time_capture/custom_fields.py:70 #: time_capture/public/js/employee.js:35 #: time_capture/time_capture/report/working_time/working_time.py:30 msgid "Expected Working Hours" @@ -232,7 +308,7 @@ msgid "Freelancer Name" msgstr "" #. Name of a DocType -#: time_capture/custom_fields.py:101 +#: time_capture/custom_fields.py:119 #: time_capture/time_capture/doctype/freelancer_time_capture/freelancer_time_capture.json msgid "Freelancer Time Capture" msgstr "" @@ -241,10 +317,14 @@ msgstr "" msgid "Freelancer Time Capture can only be created for users with the 'Freelancer' role. Change the user in the field 'User'." msgstr "" -#: time_capture/custom_fields.py:109 +#: time_capture/custom_fields.py:127 msgid "Freelancer User" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:285 +msgid "From Date is in the future. This means you can just cancel the whole Absence Plan." +msgstr "" + #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.py:89 msgid "Future Balance" msgstr "" @@ -271,6 +351,10 @@ msgstr "" msgid "Go to list view" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:85 +msgid "Holidays from a Holiday List have priority over leaves with an Absence Plan." +msgstr "" + #. Description of the 'Enable Reminders' (Check) field in DocType 'Time Capture #. Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json @@ -292,6 +376,10 @@ msgstr "" msgid "Indicated Break is not in the proper format." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:234 +msgid "Invalid mode" +msgstr "" + #. Label of a Check field in DocType 'Time Capture' #: time_capture/time_capture/doctype/time_capture/time_capture.json msgid "Is Of Legal Age" @@ -318,7 +406,13 @@ msgstr "" msgid "Last Notification (Sent On)" msgstr "" -#: time_capture/custom_fields.py:65 +#. Label of a Link field in DocType 'Absence Plan' +#. Name of a role +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json +msgid "Leave Approver" +msgstr "" + +#: time_capture/custom_fields.py:83 msgid "Leave Policy" msgstr "" @@ -330,15 +424,25 @@ msgstr "" msgid "Leave Summary" msgstr "" +#. Label of a Link field in DocType 'Absence Plan' #: time_capture/public/js/utils.js:143 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.json msgid "Leave Type" msgstr "" +#: time_capture/custom_fields.py:40 +msgid "Leave Type (Absence Plan)" +msgstr "" + #. Name of a report #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.json msgid "Leave and Working Time Summaries" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:108 +msgid "Leave approver {0} has been notified via Email." +msgstr "" + #. Label of a Section Break field in DocType 'Time Capture Settings' #: time_capture/time_capture/doctype/time_capture_settings/time_capture_settings.json msgid "Leaves" @@ -375,7 +479,11 @@ msgstr "" msgid "Minimum Draft Age (Days)" msgstr "" -#: time_capture/custom_fields.py:41 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:115 +msgid "Mode" +msgstr "" + +#: time_capture/custom_fields.py:59 msgid "No Supervisor Required" msgstr "" @@ -435,6 +543,14 @@ msgstr "" msgid "October" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:78 +msgid "Official weekly offs (e.g. 4 day work week set in employee contract) should be handled via Holiday List." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:60 +msgid "Only Absence Plans with status 'Approved' and 'Rejected' can be submitted" +msgstr "" + #: time_capture/public/js/employee.js:11 msgid "Only System Manager are allowed to edit Expected Working Hours." msgstr "" @@ -445,6 +561,14 @@ msgstr "" msgid "Only send reminders for draft Time Captures that are older than this number of days. Set to 0 to include all drafts regardless of date." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:282 +msgid "Only submitted Absence Plans can use this action." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:289 +msgid "Only the Leave Approver and users with the 'Cancel' permission can delete future dates." +msgstr "" + #: time_capture/time_capture/report/leave_and_working_time_summaries/leave_and_working_time_summaries.py:96 msgid "Open Time Captures" msgstr "" @@ -457,6 +581,10 @@ msgstr "" msgid "Overdue Time Captures" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:211 +msgid "Overlapping Dates are not allowed" +msgstr "" + #: time_capture/time_capture/report/working_time/working_time.py:50 msgid "Paid Holidays" msgstr "" @@ -470,6 +598,10 @@ msgstr "" msgid "Past time captures, that are not yet submitted. These count as absent and reduce the balance." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:290 +msgid "Permission Denied" +msgstr "" + #: time_capture/public/js/utils.js:191 msgid "Planned Overtime Reduction" msgstr "" @@ -486,6 +618,10 @@ msgstr "" msgid "Please save the Employee first." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:229 +msgid "Please select at least one weekday" +msgstr "" + #: time_capture/time_capture/doctype/create_freelancer/create_freelancer.js:18 msgid "Please wait..." msgstr "" @@ -523,7 +659,7 @@ msgstr "" msgid "September" msgstr "" -#: time_capture/custom_fields.py:44 +#: time_capture/custom_fields.py:62 msgid "Should be checked if the employee is a CEO (or has no supervisor for some reason)." msgstr "" @@ -571,6 +707,10 @@ msgstr "" msgid "The following Time Captures are still in draft status:" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:167 +msgid "The following dates are in the past (or today) and have been removed from the Absence Plan:
{0}" +msgstr "" + #: time_capture/scripts/employee.py:77 msgid "The supervisor cannot be the same as the employee." msgstr "" @@ -579,6 +719,10 @@ msgstr "" msgid "The supervisor has no User linked in his/her Employee record." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:208 +msgid "There are overlapping dates with following Absence Plans:
{0}" +msgstr "" + #: time_capture/scripts/employee.py:87 msgid "This Employee has no supervisor (Reports To), but has Create User Permission checkbox enabled. Please, make sure that this intended." msgstr "" @@ -596,7 +740,7 @@ msgid "This is the projected balance, that includes planned overtime reductions" msgstr "" #. Name of a DocType -#: time_capture/custom_fields.py:28 time_capture/custom_fields.py:93 +#: time_capture/custom_fields.py:46 time_capture/custom_fields.py:111 #: time_capture/time_capture/doctype/time_capture/time_capture.json msgid "Time Capture" msgstr "" @@ -610,7 +754,7 @@ msgstr "" msgid "Time Capture Log" msgstr "" -#: time_capture/scripts/attendance.py:157 +#: time_capture/scripts/attendance.py:154 msgid "Time Capture Not Found" msgstr "" @@ -632,6 +776,18 @@ msgstr "" msgid "Time to Submit (in days)" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:81 +msgid "Timespan: adds all dates in the range with an optional reason." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:82 +msgid "Typical use case: Employee is on Education Leave (University, School, etc.)." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:75 +msgid "Typical use case: Every Friday is an unofficial weekly off day." +msgstr "" + #: time_capture/public/js/utils.js:120 msgid "Unable to fetch summary data" msgstr "" @@ -651,6 +807,15 @@ msgstr "" msgid "User is not a Freelancer" msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:44 +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:88 +msgid "Warning: The Leave Ledgers will not be updated for leaves with an Absence Plan. Therefore, it is not suggested to use Leave Types (such as 'Annual Leave') that have limited Leave Allocation." +msgstr "" + +#: time_capture/time_capture/doctype/absence_plan/absence_plan.js:72 +msgid "Weekly Off: adds all dates in the range that fall on the selected weekday. The Holiday List already defines non-working days; adding e.g. every Sunday as weekly off is often redundant." +msgstr "" + #. Label of a Duration field in DocType 'Time Capture' #. Name of a report #: time_capture/time_capture/doctype/time_capture/time_capture.json @@ -673,6 +838,10 @@ msgstr "" msgid "Working time must be completely booked on projects and tasks." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:123 +msgid "Your Absence Plan {0} has been {1}." +msgstr "" + #: time_capture/scripts/summary_utils.py:109 msgid "{0} (on {1})" msgstr "" @@ -685,3 +854,7 @@ msgstr "" msgid "{0} already exists for this date and person." msgstr "" +#: time_capture/time_capture/doctype/absence_plan/absence_plan.py:90 +msgid "{0} raised a new Absence Plan for approval: {1}" +msgstr "" + diff --git a/time_capture/patches.txt b/time_capture/patches.txt index fd3ee43..b633e73 100644 --- a/time_capture/patches.txt +++ b/time_capture/patches.txt @@ -3,7 +3,7 @@ # Read docs to understand patches: https://frappeframework.com/docs/v14/user/en/database-migrations [post_model_sync] -execute:from time_capture.install import _make_custom_fields;_make_custom_fields() # 2026-01-22 #2 +execute:from time_capture.install import _make_custom_fields;_make_custom_fields() # 2026-02-03 #1 execute:from time_capture.install import _make_property_setters;_make_property_setters() # 2026-01-22 #2 time_capture.patches.move_expected_working_time_to_child_table time_capture.patches.create_freelancer_role #7 diff --git a/time_capture/scripts/attendance.py b/time_capture/scripts/attendance.py index ad503d1..4528ee6 100644 --- a/time_capture/scripts/attendance.py +++ b/time_capture/scripts/attendance.py @@ -9,7 +9,7 @@ def on_change(doc, event): set_attendance_metrics(doc) if ( - doc.leave_type + (doc.leave_type or doc.custom_leave_type_absence_plan) and frappe.utils.getdate(doc.attendance_date) <= frappe.utils.getdate() and doc.docstatus != 2 ): @@ -52,9 +52,8 @@ def get_attendance_metrics(doc, get_working_hours=False): Returns: tuple: (status, actual_working_hours, expected_working_hours, flexitime) """ - if doc.leave_type and doc.leave_type == frappe.db.get_single_value( - "Time Capture Settings", "sick_leave_type" - ): + leave_type = doc.leave_type or doc.custom_leave_type_absence_plan + if leave_type and leave_type == frappe.db.get_single_value("Time Capture Settings", "sick_leave_type"): # Special Case: Sick Leaves are not considered for working hours or expected working hours. return "On Leave", 0.0, 0.0, 0.0 @@ -70,14 +69,12 @@ def get_attendance_metrics(doc, get_working_hours=False): working_hours = doc.working_hours or 0.0 # 2: Get Status - status = _get_attendance_status( - is_half_day, expected_working_hours_full_day, working_hours, doc.leave_type - ) + status = _get_attendance_status(is_half_day, expected_working_hours_full_day, working_hours, leave_type) # 3: Get Expected Working Hours - if doc.leave_type and doc.leave_application: + if leave_type: expected_working_hours = _get_expected_working_hours_for_leave_days( - expected_working_hours_full_day, doc.leave_type, is_half_day + expected_working_hours_full_day, leave_type, is_half_day ) else: expected_working_hours = expected_working_hours_full_day diff --git a/time_capture/time_capture/doctype/absence_plan/__init__.py b/time_capture/time_capture/doctype/absence_plan/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/time_capture/time_capture/doctype/absence_plan/absence_plan.js b/time_capture/time_capture/doctype/absence_plan/absence_plan.js new file mode 100644 index 0000000..e7416a4 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan/absence_plan.js @@ -0,0 +1,180 @@ +// Copyright (c) 2025, ALYF GmbH and contributors +// For license information, please see license.txt + +frappe.ui.form.on("Absence Plan", { + setup: function (frm) { + frm.set_query("leave_approver", function () { + return { + query: "hrms.hr.doctype.department_approver.department_approver.get_approvers", + filters: { + employee: frm.doc.employee, + doctype: "Leave Application", + }, + }; + }); + }, + + refresh: function (frm) { + if ( + frm.doc.docstatus === 1 && + frm.doc.from_date && + frm.doc.from_date <= frappe.datetime.get_today() + ) { + frm.add_custom_button(__("Delete Future Dates"), function () { + frappe.call({ + method: "time_capture.time_capture.doctype.absence_plan.absence_plan.delete_future_dates", + args: { name: frm.doc.name }, + callback: function (r) { + if (r && r.message) { + frappe.msgprint(r.message); + } + frm.reload_doc(); + }, + }); + }); + } + }, + + employee: function (frm) { + frm.trigger("set_leave_approver"); + }, + + leave_type: function (frm) { + frappe.msgprint( + __( + "Warning: The Leave Ledgers will not be updated for leaves with an Absence Plan. Therefore, it is not suggested to use Leave Types (such as 'Annual Leave') that have limited Leave Allocation." + ) + ); + }, + + bulk_insert_btn: function (frm) { + open_bulk_insert_dialog(frm); + }, + + set_leave_approver: function (frm) { + if (frm.doc.employee) { + return frappe.call({ + method: "hrms.hr.doctype.leave_application.leave_application.get_leave_approver", + args: { + employee: frm.doc.employee, + }, + callback: function (r) { + if (r && r.message) { + frm.set_value("leave_approver", r.message); + } + }, + }); + } + }, +}); + +function open_bulk_insert_dialog(frm) { + const weekly_off_desc = __( + "Weekly Off: adds all dates in the range that fall on the selected weekday. The Holiday List already defines non-working days; adding e.g. every Sunday as weekly off is often redundant." + ); + const weekly_off_example_desc = __( + "Typical use case: Every Friday is an unofficial weekly off day." + ); + const weekly_off_exempt_desc = __( + "Official weekly offs (e.g. 4 day work week set in employee contract) should be handled via Holiday List." + ); + const timespan_desc = __("Timespan: adds all dates in the range with an optional reason."); + const timespan_example_desc = __( + "Typical use case: Employee is on Education Leave (University, School, etc.)." + ); + const holiday_list_desc = __( + "Holidays from a Holiday List have priority over leaves with an Absence Plan." + ); + const warning_desc = __( + "Warning: The Leave Ledgers will not be updated for leaves with an Absence Plan. Therefore, it is not suggested to use Leave Types (such as 'Annual Leave') that have limited Leave Allocation." + ); + + const descriptionHtml = + "

" + + weekly_off_desc + + "
" + + weekly_off_example_desc + + "
" + + weekly_off_exempt_desc + + "

" + + timespan_desc + + "
" + + timespan_example_desc + + "

" + + holiday_list_desc + + "
" + + warning_desc + + "

"; + + const d = new frappe.ui.Dialog({ + title: __("Bulk Insert"), + fields: [ + { + fieldtype: "Select", + fieldname: "mode", + label: __("Mode"), + options: "Weekly Off\nTimespan", + default: "Weekly Off", + reqd: 1, + }, + { + fieldtype: "HTML", + fieldname: "description", + label: __("Description"), + options: descriptionHtml, + }, + { + fieldtype: "Date", + fieldname: "from_date", + label: __("From Date"), + reqd: 1, + }, + { + fieldtype: "Date", + fieldname: "to_date", + label: __("To Date"), + reqd: 1, + }, + { + fieldtype: "Select", + fieldname: "weekday", + label: __("Weekday"), + options: "Monday\nTuesday\nWednesday\nThursday\nFriday\nSaturday\nSunday", + depends_on: "eval:doc.mode === 'Weekly Off'", + mandatory_depends_on: "eval:doc.mode === 'Weekly Off'", + }, + { + fieldtype: "Small Text", + fieldname: "reason", + label: __("Reason"), + depends_on: "eval:doc.mode === 'Timespan'", + }, + ], + primary_action_label: __("Add"), + primary_action: function (values) { + frappe.call({ + method: "time_capture.time_capture.doctype.absence_plan.absence_plan.bulk_insert_dates", + args: { + mode: values.mode, + weekday: values.weekday, + from_date: values.from_date, + to_date: values.to_date, + reason: values.reason, + }, + callback: function (r) { + if (r && r.message && r.message.length) { + r.message.forEach(function (item) { + const row = frm.add_child("dates"); + row.date = item.date; + row.reason = item.reason || ""; + }); + frm.refresh_field("dates"); + frm.save(); + } + d.hide(); + }, + }); + }, + }); + d.show(); +} diff --git a/time_capture/time_capture/doctype/absence_plan/absence_plan.json b/time_capture/time_capture/doctype/absence_plan/absence_plan.json new file mode 100644 index 0000000..ab0e501 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan/absence_plan.json @@ -0,0 +1,262 @@ +{ + "actions": [], + "allow_rename": 1, + "creation": "2025-02-02 09:00:00", + "doctype": "DocType", + "engine": "InnoDB", + "field_order": [ + "employee", + "employee_name", + "employee_email", + "column_break_ihkc", + "leave_type", + "section_break_ueuf", + "from_date", + "column_break_iiup", + "to_date", + "dates_section", + "bulk_insert_btn", + "dates", + "approval_section", + "leave_approver", + "column_break_lfyt", + "status", + "amended_from" + ], + "fields": [ + { + "fieldname": "employee", + "fieldtype": "Link", + "in_filter": 1, + "in_list_view": 1, + "label": "Employee", + "options": "Employee", + "read_only_depends_on": "eval: !doc.__islocal;", + "reqd": 1 + }, + { + "fetch_from": "employee.employee_name", + "fieldname": "employee_name", + "fieldtype": "Data", + "label": "Employee Name" + }, + { + "fieldname": "column_break_ihkc", + "fieldtype": "Column Break" + }, + { + "fieldname": "leave_type", + "fieldtype": "Link", + "in_list_view": 1, + "label": "Leave Type", + "options": "Leave Type", + "reqd": 1 + }, + { + "fieldname": "dates_section", + "fieldtype": "Section Break", + "label": "Dates" + }, + { + "depends_on": "eval: doc.docstatus == 0", + "fieldname": "bulk_insert_btn", + "fieldtype": "Button", + "label": "Bulk Insert" + }, + { + "fieldname": "dates", + "fieldtype": "Table", + "label": "Dates", + "options": "Absence Plan Date" + }, + { + "fieldname": "approval_section", + "fieldtype": "Section Break", + "label": "Approval" + }, + { + "fieldname": "leave_approver", + "fieldtype": "Link", + "label": "Leave Approver", + "options": "User", + "reqd": 1 + }, + { + "fieldname": "column_break_lfyt", + "fieldtype": "Column Break" + }, + { + "allow_on_submit": 1, + "fieldname": "status", + "fieldtype": "Select", + "in_filter": 1, + "in_standard_filter": 1, + "label": "Status", + "no_copy": 1, + "options": "Open\nApproved\nRejected\nCancelled", + "permlevel": 1, + "read_only_depends_on": "eval: doc.docstatus == 1" + }, + { + "fieldname": "amended_from", + "fieldtype": "Link", + "label": "Amended From", + "no_copy": 1, + "options": "Absence Plan", + "print_hide": 1, + "read_only": 1, + "search_index": 1 + }, + { + "fieldname": "section_break_ueuf", + "fieldtype": "Section Break" + }, + { + "fieldname": "from_date", + "fieldtype": "Date", + "label": "From Date", + "read_only": 1 + }, + { + "fieldname": "column_break_iiup", + "fieldtype": "Column Break" + }, + { + "fieldname": "to_date", + "fieldtype": "Date", + "label": "To Date", + "read_only": 1 + }, + { + "fieldname": "employee_email", + "fieldtype": "Data", + "hidden": 1, + "label": "Employee Email", + "options": "Email" + } + ], + "grid_page_length": 50, + "index_web_pages_for_search": 1, + "is_submittable": 1, + "links": [], + "modified": "2026-02-02 18:18:31.040154", + "modified_by": "Administrator", + "module": "Time Capture", + "name": "Absence Plan", + "owner": "Administrator", + "permissions": [ + { + "amend": 1, + "cancel": 1, + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "System Manager", + "share": 1, + "submit": 1, + "write": 1 + }, + { + "create": 1, + "email": 1, + "export": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "Employee", + "share": 1, + "submit": 1, + "write": 1 + }, + { + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "HR Manager", + "share": 1, + "submit": 1, + "write": 1 + }, + { + "email": 1, + "export": 1, + "permlevel": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "All", + "share": 1 + }, + { + "create": 1, + "delete": 1, + "email": 1, + "export": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "HR User", + "share": 1, + "submit": 1, + "write": 1 + }, + { + "delete": 1, + "email": 1, + "export": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "Leave Approver", + "share": 1, + "submit": 1, + "write": 1 + }, + { + "email": 1, + "export": 1, + "permlevel": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "Leave Approver", + "share": 1, + "write": 1 + }, + { + "email": 1, + "export": 1, + "permlevel": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "HR User", + "share": 1, + "write": 1 + }, + { + "email": 1, + "export": 1, + "permlevel": 1, + "print": 1, + "read": 1, + "report": 1, + "role": "HR Manager", + "share": 1, + "write": 1 + } + ], + "row_format": "Dynamic", + "sort_field": "modified", + "sort_order": "DESC", + "states": [], + "title_field": "employee_name" +} \ No newline at end of file diff --git a/time_capture/time_capture/doctype/absence_plan/absence_plan.py b/time_capture/time_capture/doctype/absence_plan/absence_plan.py new file mode 100644 index 0000000..59d4e76 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan/absence_plan.py @@ -0,0 +1,311 @@ +# Copyright (c) 2025, ALYF GmbH and contributors +# For license information, please see license.txt + + +import frappe +from frappe import _ +from frappe.model.document import Document +from frappe.utils import get_link_to_form, getdate +from frappe.utils.data import add_to_date +from hrms.hr.utils import share_doc_with_approver +from hrms.utils import get_employee_email + + +class AbsencePlan(Document): + # begin: auto-generated types + # This code is auto-generated. Do not modify anything in this block. + + from typing import TYPE_CHECKING + + if TYPE_CHECKING: + from frappe.types import DF + + from time_capture.time_capture.doctype.absence_plan_date.absence_plan_date import ( + AbsencePlanDate, + ) + + amended_from: DF.Link | None + employee: DF.Link + employee_name: DF.Data | None + from_date: DF.Date | None + leave_approver: DF.Link + leave_type: DF.Link + status: DF.Literal["Open", "Approved", "Rejected", "Cancelled"] + dates: DF.Table[AbsencePlanDate] + to_date: DF.Date | None + # end: auto-generated types + + def before_insert(self): + self.employee_email = get_employee_email(self.employee) + + def after_insert(self): + self.notify_leave_approver() + + def before_validate(self): + self.remove_duplicate_dates() + self.remove_past_dates() + if self.dates: + self.from_date = min([row.date for row in self.dates]) + self.to_date = max([row.date for row in self.dates]) + self.order_dates() + + def validate(self): + self.avoid_duplicates_with_other_absence_plans() + + def on_update(self): + share_doc_with_approver(self, self.leave_approver) + + def on_submit(self): + if self.status in ["Open", "Cancelled"]: + frappe.throw(_("Only Absence Plans with status 'Approved' and 'Rejected' can be submitted")) + self.notify_employee() + if self.status == "Approved": + frappe.msgprint( + _( + "Absence Plan has been approved. The Employee will not have to capture any time for these dates." + ) + ) + + def before_cancel(self): + if getdate(self.from_date) <= getdate(): + frappe.throw( + _( + "Absence Plan with dates in the past (or today) cannot be cancelled. Instead you can use the 'Delete Future Dates' button on top of the page. This will delete the future dates from the Absence Plan, but will not affect the past dates." + ) + ) + self.status = "Cancelled" + + def notify_leave_approver(self): + """ + Notify leave approver about new Absence Plan + """ + # Preparation + if not self.leave_approver: + return + from_user = self.employee_email + if from_user == self.leave_approver: + return + + lang = _get_user_lang(self.leave_approver) + message = _("{0} raised a new Absence Plan for approval: {1}", lang=lang).format( + self.employee_name or self.employee, self.name + ) + + # Create Notification + n = frappe.new_doc("PWA Notification") + n.from_user, n.to_user = from_user, self.leave_approver + n.message = message + n.reference_document_type, n.reference_document_name = self.doctype, self.name + n.insert(ignore_permissions=True) + + # Send Email + link = get_link_to_form(self.doctype, self.name, _("Absence Plan", lang=lang)) + frappe.sendmail( + recipients=[self.leave_approver], + subject=_("Absence Plan {0} for approval", lang=lang).format(self.name), + message=message + "

" + link, + ) + frappe.msgprint(_("Leave approver {0} has been notified via Email.").format(self.leave_approver)) + + def notify_employee(self): + """ + Notify employee about Absence Plan approval status + """ + # Preparation + to_user = self.employee_email + if not to_user: + return + from_user = self.leave_approver + if from_user == to_user: + return + + lang = _get_user_lang(to_user) + message = _("Your Absence Plan {0} has been {1}.", lang=lang).format(self.name, self.status) + + # Create Notification + n = frappe.new_doc("PWA Notification") + n.from_user, n.to_user = from_user, to_user + n.message = message + n.reference_document_type, n.reference_document_name = self.doctype, self.name + n.insert(ignore_permissions=True) + + # Send Email + link = get_link_to_form(self.doctype, self.name, _("Absence Plan", lang=lang)) + frappe.sendmail( + recipients=[to_user], + subject=_("Absence Plan {0} - {1}", lang=lang).format(self.name, self.status), + message=message + "

" + link, + ) + frappe.msgprint(_("Employee {0} has been notified via Email.").format(to_user)) + + def remove_duplicate_dates(self): + """Keep only the first occurrence of each date in dates.""" + seen = set() + new_rows = [] + for row in self.dates or []: + key = str(row.date) if row.date else None + if key is None: + new_rows.append(row) + elif key not in seen: + seen.add(key) + new_rows.append(row) + self.dates = new_rows + + def remove_past_dates(self): + """Remove dates that are in the past or today.""" + today = getdate() + past_dates = [] + future_dates = [] + for row in self.dates: + if getdate(row.date) <= today: + past_dates.append(row) + else: + future_dates.append(row) + self.dates = future_dates + if past_dates: + frappe.msgprint( + _( + "The following dates are in the past (or today) and have been removed from the Absence Plan:
{0}" + ).format("
".join([frappe.utils.format_date(row.date) for row in past_dates])) + ) + + def order_dates(self): + self.dates = sorted(self.dates, key=lambda x: x.date) + + def avoid_duplicates_with_other_absence_plans(self): + """ + Check if the Absence Plan dates overlap with other Absence Plans for the same employee. + Dates must be unique per employee; throw if any duplicate is found. + """ + other_plans = frappe.get_all( + "Absence Plan", + filters={"employee": self.employee, "name": ["!=", self.name or ""], "docstatus": ["!=", 2]}, + pluck="name", + ) + if not other_plans: + return + + our_dates = {getdate(row.date) for row in self.dates or [] if row.date} + overlapping_dates = frappe.db.sql( + """ + SELECT apd.date, apd.parent + FROM `tabAbsence Plan Date` apd + WHERE apd.parent IN %(plans)s + AND apd.date IN %(our_dates)s + """, + {"plans": other_plans, "our_dates": our_dates}, + as_dict=True, + ) + + if overlapping_dates: + overlapping_dates_str = "
".join( + [ + f"{frappe.utils.format_date(d.date)} in Absence Plan {frappe.utils.get_link_to_form('Absence Plan', d.parent)}" + for d in overlapping_dates + ] + ) + frappe.throw( + _( + "There are overlapping dates with following Absence Plans:
{0}", + ).format(overlapping_dates_str), + title=_("Overlapping Dates are not allowed"), + ) + + +@frappe.whitelist() +def bulk_insert_dates( + mode: str, from_date: str, to_date: str, weekday: str | None = None, reason: str | None = None +): + """Return list of {date, reason} to add. Called from Bulk Insert dialog.""" + from_date = getdate(from_date) + to_date = getdate(to_date) + if to_date < from_date: + frappe.throw(_("To Date cannot be before From Date.")) + if from_date <= getdate(): + frappe.throw(_("Dates cannot be in the past or today.")) + + if mode == "Weekly Off": + if not weekday: + frappe.throw(_("Please select at least one weekday")) + return _get_weekly_off_dates(from_date, to_date, weekday) + elif mode == "Timespan": + return _get_timespan_days(from_date, to_date, reason) + + frappe.throw(_("Invalid mode")) + + +def _get_weekly_off_dates(from_date, to_date, weekday): + weekdays = { + "Monday": 0, + "Tuesday": 1, + "Wednesday": 2, + "Thursday": 3, + "Friday": 4, + "Saturday": 5, + "Sunday": 6, + } + weekday_index = weekdays[weekday] + dates = [] + dt = from_date + while dt <= to_date: + if dt.weekday() == weekday_index: + dates.append({"date": str(dt), "reason": weekday}) + dt = add_to_date(dt, days=1) + return dates + + +def _get_timespan_days(from_date, to_date, reason=None): + dates = [] + dt = from_date + while dt <= to_date: + dates.append({"date": str(dt), "reason": reason}) + dt = add_to_date(dt, days=1) + return dates + + +def _get_user_lang(user): + user_lang = frappe.db.get_value("User", user, "language", cache=True) + if user_lang: + return user_lang + return frappe.local.lang or "en" + + +@frappe.whitelist() +def delete_future_dates(name: str) -> str: + """ + Delete all dates in the future from the Absence Plan child table and recalculate to_date. + Requires Cancel permission. Only for submitted docs with from_date not in the future. + """ + doc = frappe.get_doc("Absence Plan", name) + # Validations + if doc.docstatus != 1: + frappe.throw(_("Only submitted Absence Plans can use this action.")) + if getdate(doc.from_date) > getdate(): + frappe.throw(_("From Date is in the future. This means you can just cancel the whole Absence Plan.")) + if not doc.has_permission("cancel") and doc.leave_approver != frappe.session.user: + frappe.throw( + _("Only the Leave Approver and users with the 'Cancel' permission can delete future dates."), + title=_("Permission Denied"), + ) + + # Delete future dates + today = getdate() + future_rows = [r for r in (doc.dates or []) if getdate(r.date) > today] + deleted_count = 0 + for row in future_rows: + frappe.delete_doc("Absence Plan Date", row.name) + deleted_count += 1 + + if deleted_count: + doc.reload() + remaining_dates = [getdate(r.date) for r in doc.dates if getdate(r.date) <= today] + if remaining_dates: + frappe.db.set_value( + "Absence Plan", + doc.name, + {"from_date": min(remaining_dates), "to_date": max(remaining_dates)}, + ) + else: + frappe.throw(_("All Dates are in the future. Please cancel the Absence Plan instead.")) + + return _("Deleted {0} future date(s).").format(deleted_count) diff --git a/time_capture/time_capture/doctype/absence_plan/absence_plan_list.js b/time_capture/time_capture/doctype/absence_plan/absence_plan_list.js new file mode 100644 index 0000000..6d05d98 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan/absence_plan_list.js @@ -0,0 +1,16 @@ +frappe.listview_settings["Absence Plan"] = { + has_indicator_for_draft: 1, + get_indicator: function (doc) { + const status_color = { + Approved: "green", + Rejected: "red", + Open: "orange", + Draft: "red", + Cancelled: "red", + Submitted: "blue", + }; + const status = + !doc.docstatus && ["Approved", "Rejected"].includes(doc.status) ? "Draft" : doc.status; + return [__(status), status_color[status], "status,=," + doc.status]; + }, +}; diff --git a/time_capture/time_capture/doctype/absence_plan/test_absence_plan.py b/time_capture/time_capture/doctype/absence_plan/test_absence_plan.py new file mode 100644 index 0000000..b587bb4 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan/test_absence_plan.py @@ -0,0 +1,9 @@ +# Copyright (c) 2026, ALYF GmbH and Contributors +# See license.txt + +# import frappe +from frappe.tests.utils import FrappeTestCase + + +class TestAbsencePlan(FrappeTestCase): + pass diff --git a/time_capture/time_capture/doctype/absence_plan_date/__init__.py b/time_capture/time_capture/doctype/absence_plan_date/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json b/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json new file mode 100644 index 0000000..9128970 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.json @@ -0,0 +1,42 @@ +{ + "actions": [], + "allow_rename": 1, + "creation": "2025-02-02 09:00:00.000000", + "doctype": "DocType", + "editable_grid": 1, + "engine": "InnoDB", + "field_order": [ + "date", + "reason" + ], + "fields": [ + { + "fieldname": "date", + "fieldtype": "Date", + "in_list_view": 1, + "label": "Date", + "reqd": 1 + }, + { + "fieldname": "reason", + "fieldtype": "Text Editor", + "in_list_view": 1, + "label": "Reason", + "description": "Examples: School or weekly off, etc." + } + ], + "grid_page_length": 50, + "index_web_pages_for_search": 1, + "istable": 1, + "links": [], + "modified": "2026-02-02 10:25:00.000000", + "modified_by": "Administrator", + "module": "Time Capture", + "name": "Absence Plan Date", + "owner": "Administrator", + "permissions": [], + "row_format": "Dynamic", + "sort_field": "modified", + "sort_order": "DESC", + "states": [] +} diff --git a/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.py b/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.py new file mode 100644 index 0000000..1c537b7 --- /dev/null +++ b/time_capture/time_capture/doctype/absence_plan_date/absence_plan_date.py @@ -0,0 +1,8 @@ +# Copyright (c) 2025, ALYF GmbH and contributors +# For license information, please see license.txt + +from frappe.model.document import Document + + +class AbsencePlanDate(Document): + pass diff --git a/time_capture/time_capture/doctype/time_capture/time_capture.py b/time_capture/time_capture/doctype/time_capture/time_capture.py index d6fac80..59911a9 100644 --- a/time_capture/time_capture/doctype/time_capture/time_capture.py +++ b/time_capture/time_capture/doctype/time_capture/time_capture.py @@ -308,6 +308,9 @@ def _create_time_capture(employee, date): if is_holiday(employee.holiday_list, date): return + if _create_attendance_for_absence_plan(employee.name, date): + return + time_capture = frappe.new_doc("Time Capture") time_capture.update( { @@ -320,6 +323,50 @@ def _create_time_capture(employee, date): time_capture.insert() +def _create_attendance_for_absence_plan(employee_name, date): + """ + Check if the employee has an approved Absence Plan that includes the given date + and create an Attendance record for it if found. + + Returns: + bool: True if an Attendance record was created, False otherwise. + """ + # Get Absence Plan and Leave Type from Absence Plan + AP = frappe.qb.DocType("Absence Plan") + APD = frappe.qb.DocType("Absence Plan Date") + absence_plans = ( + frappe.qb.from_(AP) + .inner_join(APD) + .on(AP.name == APD.parent) + .select(AP.name, AP.leave_type) + .where( + (AP.employee == employee_name) + & (APD.date == date) + & (AP.status == "Approved") + & (AP.docstatus == 1) + ) + ).run(as_dict=True) + + if not absence_plans: + return False + + # Create Attendance if there is a leave type (= absence is planned) + absence_plan = absence_plans[0] + attendance = frappe.get_doc( + { + "doctype": "Attendance", + "employee": employee_name, + "attendance_date": date, + "custom_absence_plan": absence_plan.name, + "custom_leave_type_absence_plan": absence_plan.leave_type, + } + ) + attendance.insert() + attendance.submit() + + return True + + @frappe.whitelist() @frappe.validate_and_sanitize_search_inputs def task_query(doctype, txt, searchfield, start, page_len, filters):