Files
Django_TasksApp/main/planner/services/deferrals.py
T
2026-09-30 17:25:25 +02:00

133 lines
5.2 KiB
Python

"""Deferral policies, deliberately separate from HTTP views and model saves."""
from datetime import date, timedelta
from typing import Iterable
from planner.models import SickDaySettings, Task
from planner.services.scheduling import is_task_scheduled_on_date
DEFERRAL_SOURCES = frozenset(Task.DeferralSource.values)
def extend_task_deferral(task: Task, deferred_until: date, source: str) -> bool:
"""Set a deferral only when it does not shorten an existing one.
The caller chooses the source when it extends a deferral. This is suitable
for an intentional manual deferral; automatic policies use their narrower
source-owning helpers below.
"""
if source not in DEFERRAL_SOURCES:
raise ValueError(f'Unsupported deferral source: {source}')
if not isinstance(deferred_until, date):
raise ValueError('deferred_until must be a date')
if task.deferred_until is not None and deferred_until <= task.deferred_until:
return False
task.deferred_until = deferred_until
task.deferral_source = source
task.save(update_fields=['deferred_until', 'deferral_source', 'updated_at'])
return True
def defer_task_manually(task: Task, deferred_until: date) -> bool:
"""Apply a user-requested manual deferral without shortening an existing one."""
return extend_task_deferral(task, deferred_until, Task.DeferralSource.MANUAL)
def apply_missed_task_deferrals(tasks: Iterable[Task], selected_date: date) -> list[Task]:
"""Create or extend missed deferrals for overdue one-time tasks.
Existing manual or Sick Day deferrals are left untouched. A missed deferral
can only move later as the user views later dates.
"""
changed = []
for task in tasks:
if task.is_recurring or not task.defer_days or task.scheduled_for >= selected_date:
continue
if task.deferral_source not in ('', Task.DeferralSource.MISSED):
continue
target_date = selected_date + timedelta(days=task.defer_days)
if task.deferred_until is not None and target_date <= task.deferred_until:
continue
task.deferred_until = target_date
task.deferral_source = Task.DeferralSource.MISSED
task.save(update_fields=['deferred_until', 'deferral_source', 'updated_at'])
changed.append(task)
return changed
def sick_day_applies(settings: SickDaySettings | None, selected_date: date) -> bool:
"""Whether a user's Sick Day Mode applies to the selected calendar date."""
return bool(
settings
and settings.enabled
and (settings.recovery_date is None or selected_date <= settings.recovery_date)
)
def sick_day_target_date(settings: SickDaySettings, selected_date: date) -> date:
"""Return the date to which Sick Day work should be deferred."""
base_date = settings.recovery_date or selected_date
return base_date + timedelta(days=1)
def is_sick_day_suppressed(
task: Task, settings: SickDaySettings | None, selected_date: date
) -> bool:
"""Hide normally scheduled non-essential work without touching other sources."""
return (
sick_day_applies(settings, selected_date)
and not task.required_on_sick_day
and task.deferral_source != Task.DeferralSource.SICK_DAY
and is_task_scheduled_on_date(task, selected_date)
)
def sync_sick_day_deferrals(
tasks: Iterable[Task], settings: SickDaySettings | None, selected_date: date
) -> list[Task]:
"""Synchronize only deferrals owned by Sick Day Mode.
Recovery-date changes can move Sick Day deferrals in either direction. When
disabled, only Sick Day deferrals are removed; manual and missed deferrals
are deliberately never changed by this function.
"""
changed = []
task_list = list(tasks)
if settings is None or not settings.enabled:
for task in task_list:
if task.deferral_source == Task.DeferralSource.SICK_DAY:
task.deferred_until = None
task.deferral_source = ''
task.save(update_fields=['deferred_until', 'deferral_source', 'updated_at'])
changed.append(task)
return changed
target_date = sick_day_target_date(settings, selected_date)
applies = sick_day_applies(settings, selected_date)
for task in task_list:
if task.required_on_sick_day:
if task.deferral_source == Task.DeferralSource.SICK_DAY:
task.deferred_until = None
task.deferral_source = ''
task.save(update_fields=['deferred_until', 'deferral_source', 'updated_at'])
changed.append(task)
continue
if task.deferral_source == Task.DeferralSource.SICK_DAY:
if task.deferred_until != target_date:
task.deferred_until = target_date
task.save(update_fields=['deferred_until', 'updated_at'])
changed.append(task)
continue
if applies and task.deferral_source == '' and is_task_scheduled_on_date(task, selected_date):
task.deferred_until = target_date
task.deferral_source = Task.DeferralSource.SICK_DAY
task.save(update_fields=['deferred_until', 'deferral_source', 'updated_at'])
changed.append(task)
return changed