133 lines
5.2 KiB
Python
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
|