Метрика прибыли

Полный перечень полей — в глоссарии. Эта страница описывает, как модуль «Мастерская» переносит доход от завершённых ремонтных задач в общую денежную модель компании — витрину «Прибыль (по дням)». Сама модель прибыли и правила распределения денег описаны отдельно; здесь речь только о фоновом пересчёте по одной задаче и о том, как он аккуратно синхронизирует строки прибыли, не создавая дублей.

​

Что делает пересчёт

Пересчёт прибыли по задаче — это фоновая задача (очередь по умолчанию), которая получает на вход идентификатор одной ремонтной задачи и приводит строки витрины прибыли по этой задаче в соответствие с её текущим содержимым: расходниками и услугами. Сама фоновая задача — тонкая обёртка: она лишь передаёт идентификатор в метод агрегации прибыли, где и находится вся логика. Разделение сделано намеренно — тот же метод можно вызвать напрямую из кода (например, при сохранении или удалении задачи), не обязательно через очередь.

​

Условия, при которых прибыль вообще считается

Прежде чем что-либо менять, пересчёт проверяет две вещи:

1. Задача существует. Если задачи с таким идентификатором нет, пересчёт молча завершается, ничего не трогая.
2. Задача завершена. У задачи должна быть проставлена дата завершения. Если её нет (задача ещё в работе), пересчёт также молча выходит без изменений.

Дата, к которой относится вся прибыль по задаче, берётся из даты завершения задачи. Для строк мастерской начало периода, конец периода и дата строки совпадают — это всегда один день, а порядковый день и общая длина периода равны единице. Прибыль мастерской не размазывается по дням, в отличие от аренды.

​

Из чего складываются строки

После проверок пересчёт собирает две группы источников по задаче:

• Расходники задачи — каждый даёт отдельную строку прибыли, где заполнена ссылка на расходник, а ссылка на услугу пустая.
• Услуги задачи — каждая даёт отдельную строку прибыли, где заполнена ссылка на услугу, а ссылка на расходник пустая.

В каждой строке плановая сумма, ожидаемая сумма и фактическая прибыль равны цене соответствующей позиции (расходника или услуги). Скидки и ограничение по оплате к строкам мастерской не применяются — подробнее в разделе «Прибыль по задаче мастерской» на странице «Прибыль и окупаемость».

​

Как работает синхронизация (diff)

Пересчёт не удаляет всё и не создаёт заново. Вместо этого он сравнивает то, что должно быть, с тем, что уже есть, и применяет только необходимые изменения. Это защищает от лишней нагрузки на базу и сохраняет стабильные идентификаторы строк.

​

Ключ строки

Каждая строка прибыли по задаче однозначно определяется тройкой: расходник + услуга + дата строки. Поскольку у строки расходника пустая услуга, а у строки услуги пустой расходник, эти тройки не пересекаются. Дата у всех строк одной завершённой задачи одинакова (дата завершения), поэтому фактически ключ разводит строки по конкретным расходникам и услугам.

​

Три множества изменений

Пересчёт строит по ключу два набора — «что нужно» (по текущим расходникам и услугам) и «что есть» (существующие строки прибыли этой задачи) — и делит работу на три части: Строка попадает в обновление только если реально изменилось хотя бы одно из значимых полей: ожидаемая сумма, фактическая прибыль или дата строки. Если ничего из этого не поменялось, строка не трогается вовсе — даже когда она формально присутствует в обоих наборах. Все три операции выполняются пакетно: пакетное обновление, пакетное удаление и пакетная вставка. При обновлении переписываются все поля строки, кроме связей-«якорей» (ссылок на задачу, расходник и услугу) — их менять не нужно, ведь именно они образуют ключ и остаются постоянными.

​

Как это используется

Пересчёт по задаче — это точечная операция «пересобрать прибыль одной ремонтной задачи». Он вызывается в момент, когда состав или стоимость завершённой задачи мог измениться. Именно поэтому строки прибыли по мастерской появляются только после завершения задачи и держатся в актуальном состоянии по мере правок её расходников и услуг. Дальше эти строки живут в общей витрине прибыли наравне с доходом от аренды, продаж, доставки и штрафов и попадают во все сводные отчёты и метрики, которые строятся поверх неё. Подробнее о самой витрине и о том, что происходит при удалении задачи, — на странице «Прибыль и окупаемость».

​

Связанные страницы