Тайм-трекинг в модуле tasks

Документ описывает учёт рабочего времени: таймеры, ручные интервалы, плановые интервалы, дневные сводки, сводку по задаче и диаграмму занятости.

1. Модель данных

Таблица task_time_intervals

Типы интервалов (константы TimeInterval)

Таблица task_daily_time_summary

2. Поток: таймер

sequenceDiagram
    autonumber
    participant U as Пользователь
    participant C as TimeIntervalController
    participant H as StartTimerHandler / StopTimerHandler
    participant R as ITimeIntervalRepository
    participant E as DispatchingEventDecorator
    participant L as TimeTrackingListener

    U->>C: POST /time-interval/start {taskId}
    C->>H: StartTimerCommand
    H->>R: создать TimeInterval (timer, endTime=null)
    H->>E: TimerStartedEvent
    E-->>L: (лог)

    U->>C: POST /time-interval/stop {taskId}
    C->>H: StopTimerCommand
    H->>R: найти активный, stop() → duration
    H->>E: TimerStoppedEvent {duration, stoppedAt}
    E->>L: handleTimerStopped
    L->>R: findOrCreate(DailySummary) → addTime → save

3. Ручное логирование

POST /time-interval с startTime и endTime:

1. LogManualIntervalHandler создаёт интервал типа manual (или timer, см. реализацию).
2. Считает duration.
3. Диспатчит IntervalLoggedEvent.
4. (Уведомления/логи — через слушателей.)

4. Плановые интервалы

Задача имеет поля plannedStart / plannedEnd. PlannedIntervalListener:

• при создании задачи → создаёт интервал типа plan с этими временами;
• при обновлении planned-полей или исполнителя → обновляет планируемый интервал;
• если plannedStart == null → удаляет планируемый интервал.

Плановые интервалы НЕ суммируются в статистику времени (они «планы», не факт).

5. Автотаймер (AutoTimerListener)

Запускается при событиях:

Примечание: при переходе active→non-active таймер удаляется (remove), а не останавливается. При финальной колонке — останавливается (stop).

6. Сводки

6.1. GET /time-interval/daily-summary?date=...

GetDailySummaryHandler → DailySummaryDto[] (по пользователю на дату).

6.2. GET /task/{taskId}/time-summary

GetTaskTimeSummaryHandler → TaskTimeSummaryDto:

• taskId, taskTitle;
• blocks: TimeBlockDto[] (start, end, type, taskIds, duration);
• totalDuration (сек).

6.3. GET /time-interval (список)

ListTimeIntervalsHandler → TimeIntervalDto[] с фильтрами taskId, userId.

7. Диаграмма занятости (BusyChartService)

GET /user/busy-chart?from=&to=&granularity=&mode= (или аналогичный маршрут) → BusySegmentDto[].

Логика BusyChartService::build(intervals, granularity, mode)

1. Округление (roundIntervals): start → floor, end → ceil по гранулярности:
   • minute — до минут;
   • ten_minutes — до 10 минут;
   • hour — до часа (end → +1 час).
2. Режим (mode):
   • merged — объединить пересекающиеся/смежные интервалы (taskIds = уникальные);
   • separate — каждый интервал отдельным сегментом;
   • overlap — найти пересечения (событийная модель «start/end»), каждый сегмент с набором активных taskId.

Формат BusySegmentDto

{
  "start": "2026-03-30 09:00:00",
  "end": "2026-03-30 09:50:00",
  "taskIds": [100, 101],
  "anchorPoints": []
}

granularity и mode поддерживают значения из GetUserBusyChartQuery (default: minute / merged). Неверный mode → InvalidArgumentException.

8. Резюме: где что хранится