analytics/analytics/context/06_DEFICIT_FORECAST.md

Механика расчёта дефицита поверх прогноза

Общая схема

forecast (прогноз)  →  sp_build_deficit_proposal  →  deficit_proposal
                            ↑                              ↓
stock + inbound + minAvail   │              sp_rebuild_stock_plan_by_arrival
                            │                              ↓
                            └──────────────────── stock_plan_by_arrival

Таблицы

Таблица	Назначение
analytics.forecast	Прогноз спроса по месяцам (scenario_id, 1c_id, code, month, value)
analytics.deficit_proposal	Рекомендации к заказу по дефициту (place_month, arrival_month, order_qty)
analytics.stock_plan_by_arrival	План по месяцам: opening, inbound_confirmed, inbound_deficit, forecast_demand, closing

Процедуры

1. sp_build_deficit_proposal

Назначение: Дефицит и рекомендации к заказу с учётом прогноза по сценарию.

Параметры (по умолчанию):

• @scenario_id = 4
• @group_path = '' — path группы ('' = все группы)
• @lead_time_m = 4 — срок поставки (мес.)
• @cover_months = 6 — горизонт покрытия (мес.)
• @from_month = текущий месяц
• @to_month_excl = '2028-01-01'

Шаги логики:

1. Календарь месяцев [from, to)
2. SKU по group_path (pbi.groups.path LIKE @path + '%')
3. Прогноз из analytics.forecast по scenario_id
4. Inbound — подтверждённые заказы (get_orders_by_group): статусы В пути, В производстве, Выгружен на складе (Согласован закомментирован в коде)
5. Stock = остаток склад (get_quantity_by_group) + MP (get_mp_quantity_by_group)
6. Последовательность по месяцам: demand_m, inbound_m, served_m, lost_m, net_stock (рекурсивный flow)
7. Первый месяц дефицита T: net_stock < minAvailable, месяц >= @from + lead_time
8. Якоря: T, T+cover, T+2cover... до to_month_excl
9. order_qty = прогноз окна [T .. T+cover) (demand_window)

Результат: INSERT в deficit_proposal (order_qty > 0).

Источники данных:

• forecast ← analytics.forecast
• inbound ← analytics.get_orders_by_group
• stock ← analytics.get_quantity_by_group, analytics.get_mp_quantity_by_group
• SKU/minAvail ← pbi.nomenclature, pbi.groups

---

2. sp_rebuild_stock_plan_by_arrival

Назначение: План остатков по месяцам прихода (opening, inbound, forecast, closing).

Параметры: @scenario_id, @from_month, @to_month

Источники по CTE:

1. opening_qty — остаток на дату < from_month (pbi.w_ostatok_da_net)
2. inbound_confirmed — подтверждённые заказы по месяцу прихода (get_orders_by_group: В пути, В производстве, Выгружен на складе, Согласован)
3. inbound_deficit — SUM(order_qty) по deficit_proposal
4. forecast_demand — SUM(value) по forecast

Формула closing:

closing = opening + inbound_confirmed + inbound_deficit - forecast_demand

Rolling: opening для месяца M = LAG(closing) по SKU и arrival_month.

Зависимость: НЕ вызывает sp_build_deficit_proposal. Только читает deficit_proposal. Перед вызовом должен быть выполнен sp_build_deficit_proposal или sp_run_deficit_all_skus.

---

3. sp_run_deficit_all_skus

Назначение: Пересчёт дефицита по всем SKU (group_path = '').

Вызывает sp_build_deficit_proposal с @group_path = N''.

---

4. sp_загрузка_прогноза_закупки

Назначение: Загрузка прогноза из Excel/внешних источников.

Записывает в forecast (scenario_id = 8), при отсутствии кода — подтягивает из scenario_id = 5. В конце может вызывать sp_build_deficit_proposal (закомментировано для scenario 8).

---

5. create_forecast_loop

Назначение: Цикл по группам (path из pbi.groups, lvl=2).

Для каждого path вызывает sp_build_forecast_s4_by_group — наполняет forecast, не вызывает sp_build_deficit_proposal.

---

6. sp_build_forecast_s4_by_group

Назначение: Построение прогноза по группе (rate_per_day × дни × seasonal_koef).

Вставляет в analytics.forecast. Источник сезонности — analytics.seasonality_groups.

---

Представления

View	Источник	Назначение
analytics.deficit_orders	deficit_proposal + nomenclature	Заказы по дефициту с ценой и суммой (status='Дефицит')

---

Порядок выполнения (рекомендуемый)

1. Прогноз: create_forecast_loop или sp_build_forecast_s4_by_group или sp_загрузка_прогноза_закупки
2. Дефицит: sp_build_deficit_proposal или sp_run_deficit_all_skus
3. План: sp_rebuild_stock_plan_by_arrival (читает deficit_proposal; сперва должен быть вызван п.2)

---

Правила данных (дефицит)

• Дефицит определяется как net_stock < minAvailable (nomenclature.minAvailableQty).
• order_qty = прогноз спроса на окно [T .. T+cover_months).
• Статусы заказов «входящих»: см. 01_DATA_RULES. Фактически: sp_build_deficit_proposal — 3 статуса (Согласован закомментирован); sp_rebuild_stock_plan_by_arrival — 4 статуса.
• Интервалы дат — [start, end) (полуоткрытые).