# Аналитика курьеров по будущим дням

Пользователю предоставляется следующая информация:

1. Временной интервал, за который представлены данные;
2. Покрываемое количество заказов для указанного интервала (основывается на списке запланированных сборщиков и их индивидуальной скорости работы; механизм расчета описан в [статье](https://bookstack.ally.software/books/texniceskaia-dokumentaciia/page/rascet-trebuemogo-kolicestva-sborshhikov-i-kurerov), пункты 1 и 2);
3. Прогнозное количество заказов за интервал (ожидаемое значение, сформированное [прогнозной моделью](https://bookstack.ally.software/books/texniceskaia-dokumentaciia/page/opisanie-prognoznoi-modeli) на основе данных, описанных в [статье](https://bookstack.ally.software/books/texniceskaia-dokumentaciia/page/rabota-s-dannymi-dlia-prognozov));
4. Оценка требуемого количества сборщиков (механизм расчета описан в [статье](https://bookstack.ally.software/books/texniceskaia-dokumentaciia/page/rascet-trebuemogo-kolicestva-sborshhikov-i-kurerov)); возможные значения: 
    - "Норма" (сотрудников достаточно для обработки ожидаемого количества заказов)
    - "Избыток" (сотрудников запланировано больше необходимого, возможен простой персонала)
    - "Нехватка" (сотрудников недостаточно для успешной обработки заказов).

[![EErimage.png](https://bookstack.ally.software/uploads/images/gallery/2025-09/scaled-1680-/eerimage.png)](https://bookstack.ally.software/uploads/images/gallery/2025-09/eerimage.png)

---

Прогнозное значение извлекается из таблицы [time\_series](https://bookstack.ally.software/link/733#bkmrk-%D0%A5%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%D0%BE%D0%B2), из записей с типом 6 (обозначающим прогноз по геозонам для доставки заказов). Значение берется из поля value.

[![u9iimage.png](https://bookstack.ally.software/uploads/images/gallery/2025-09/scaled-1680-/v0hu9iimage.png)](https://bookstack.ally.software/uploads/images/gallery/2025-09/v0hu9iimage.png)

---

Покрываемое количество заказов рассчитывается в приложении через настройку dayPlaceTransform на основе данных о запланированных сотрудниках на час и их скорости сборки. При изменении числа сотрудников данные обновляются автоматически.  
После расчета, эта настройка формирует массив $hours, содержащий данные для отображения в интерфейсе. Массив состоит из объектов для каждого часа суток (0–23), включающих поля:

- hour — текущий час;
- stat — прогнозное количество заказов;
- plan — покрываемое количество заказов, рассчитанное на основе сотрудников и скорости сборки;

Код, формирующий массив представлен ниже.

```javascript
$hours := [0..23].(
    $statObj := $lookup($hourStat, $string($));
    $stat := $number($inPast ? $statObj.cnt : $statObj.cnt) * $extraNorm;
    $plan := $number([$lookup($eventsStat, $string($)).sum_qty, 0][0]);
    $delta := $stat
        ? $inPast
            ? $round($plan - $stat, 1)
            : $round(($stat - $plan) / $speed)
        : 0;
    $smape := 2 * ($plan - $stat) / ($plan + $stat);
    $err := ($abs($delta) <= 3 or $abs($smape) < 0.15)
        ? 0
        : $smape > 0
            ? 1
            : -1;
    {
        "hour": $,
        "stat": $round($stat,1),
        "plan": $round($plan,1),
        "delta": $delta,
        "smape": $smape,
        "err": $err
    };
);
```