Сущности, события и листенеры модуля tasks

Документ описывает доменные события и реакцию на них (листенеры), а также карту подписок из DI.

1. События модуля

Все события — в modules/tasks/domain/event/:

2. Листенеры

2.1. AutoTimerListener — автотаймер

• handleTaskMovedToColumn(TaskMovedToColumnEvent):
  • финальная колонка (isFinal) → остановить активный таймер задачи (stop(..., 'Task completed (final column)'));
  • переход неактивная → активная (по isActive колонок) → создать таймер auto-started;
  • переход активная → неактивная → удалить (не остановить!) активный таймер.
• handleTaskAssigned(TaskAssignedEvent):
  • при смене исполнителя — перенести активный таймер на нового исполнителя.
• handleTaskSoftDeleted(TaskSoftDeletedEvent):
  • остановить активный таймер ('Task deleted').

Активные системные статусы (по имени isActive колонки): в коде захардкожен массив ['in_progress', 'review', 'testing', 'blocked'] как комментарий; фактически решение принимается по флагу isActive колонки.

2.2. PlannedIntervalListener — плановые интервалы

• handleTaskCreated(TaskCreatedEvent) → создать planned-интервал из plannedStart/plannedEnd.
• handleTaskUpdated(TaskUpdatedEvent) → если изменились plannedStart/plannedEnd/assignedTo — синхронизировать planned-интервал (создать/обновить/удалить).
• Planned-интервалы — тип plan в time_intervals.

2.3. TimeTrackingListener — дневная сводка

• handleTimerStopped(TimerStoppedEvent):
  • findOrCreate(DailySummary) по (taskId, userId, date);
  • addTime(duration); сохранить.

2.4. TaskLoggerListener — логирование

• Слушает большинство событий; пишет логи в категорию tasks (Yii::info).

2.5. TaskNotificationListener — уведомления

• Заготовка: handleTaskAssigned, handleTaskMovedToColumn — TODO: not implemented (см. known-issues-and-roadmap).

3. Карта подписок (из modules/tasks/config/di.php)

4. Forward-события (в глобальную шину)

Через DispatchingEventDecorator в глобальный IEventDispatcher ядра пробрасываются:

TaskCreatedEvent, TaskAssignedEvent, TaskMovedToColumnEvent, TaskUpdatedEvent,
TaskSoftDeletedEvent, TaskRestoredEvent, CommentAddedEvent, CommentUpdatedEvent,
StickerAttachedToTaskEvent, TimerStartedEvent, TimerStoppedEvent, IntervalLoggedEvent

5. Миграции модуля