gendesign/backend/app/services/forecasting
bot-backend 988c4c83c9
All checks were successful
CI Trade-In / changes (pull_request) Successful in 8s
CI Trade-In / backend-tests (pull_request) Has been skipped
CI / changes (pull_request) Successful in 10s
CI Trade-In / browser-tests (pull_request) Has been skipped
CI Trade-In / frontend-checks (pull_request) Has been skipped
CI / frontend-tests (pull_request) Has been skipped
CI / openapi-codegen-check (pull_request) Successful in 2m4s
CI / backend-tests (pull_request) Successful in 17m16s
docs(ptica): три комментария, утверждавших не то, что делает код (#2464 кластер H)
Ложное утверждение в комментарии живёт дольше кода и распространяется на соседние
решения. Сегодня такие фразы трижды вводили в заблуждение меня самого, поэтому
правлю их отдельной пачкой — по каждому пункту решено, КАКАЯ сторона неверна.

1. special_indices._timing_overlap. Докстринг обещал `exp(−|Δмес| / half_life)` и
   тут же — «расхождение в half_life мес → 0.5». Утверждения несовместимы:
   exp(−1) ≈ 0.368. Верен КОД: он считает `0.5 ** (Δ/half_life)` и даёт ровно 0.5
   на половинном периоде (у самой строки есть пояснение об этом). Исправлен
   докстринг.

   Свойство закреплено тестом, а не текстом: на Δ = half_life значение равно 0.5 И
   НЕ равно exp(−1). Второе утверждение существенно — без него тест прошёл бы и на
   экспоненциальной формуле, если бы кто-то «починил» код по старому докстрингу.
   Фальсифицировано подстановкой: с экспонентой тест краснеет
   (`assert 0.132 < 1e-09`).

2. domrf_catalog: комментарий обещал «BFS по вложенному dict/list», а обход идёт
   через stack.pop() — это LIFO, то есть DFS. Не косметика: функция возвращает
   ПЕРВОЕ совпадение, а при упоре в cap (20 000 узлов) обход успевает посмотреть
   разные подмножества дерева. Порядок влияет и на то, какой план найдётся, и на
   то, найдётся ли.

3. confidence_engine ссылался на «§9.6 _CONF_HIGH_MIN_OBS=24 / _MIN_OBS=8» в
   четырёх местах. Значения верны, неверен АДРЕС: обе константы живут в
   rate_sensitivity.py, а §9.6 (forecasting/regression.py) держит свой _MIN_OBS=30
   (gate-порог для claim) и _MIN_FIT_OBS=8 (можно ли вообще фитить). Совпадение
   цифры 8 в двух модулях и сбило ссылку.

   Здесь же поправлена и сама находка эпика: она утверждала «actual constant is
   12», перепутав _HISTORY_MONTHS_LOW=12 с константой, на которую ссылается
   комментарий. Дрейф реальный, но не тот, что описан.

pytest tests/services: 3077 passed, 14 skipped, rc=0
2026-08-19 21:50:57 +05:00
..
__init__.py feat(forecasting): §13 report assembler (#988, 955-A2) (#1021) 2026-06-03 08:51:23 +00:00
affordability.py fix(week-review): backend-аудит v2 — 82 фиксов (#1660) 2026-06-17 17:13:38 +00:00
confidence_engine.py docs(ptica): три комментария, утверждавших не то, что делает код (#2464 кластер H) 2026-08-19 21:50:57 +05:00
demand_normalization.py perf(forecast): per-request memoization cache for §22 cold build (#1129) 2026-06-08 05:26:27 +00:00
demand_supply_forecast.py fix(forecast): посегментный+дедуплицированный индекс дефицита (#1959) 2026-06-27 22:50:58 +05:00
macro_coefficient.py feat(macro): CBR inflation (ИПЦ YoY) -> macro_indicator + activate §9.5 channel (#946) 2026-06-08 11:41:14 +05:00
macro_series.py fix(forecasting): SAVEPOINT-isolate §22 db.execute failures + close RELEASE-trap (#2464) (#2466) 2026-07-08 05:41:35 +00:00
normalize.py fix(forecasting): count non-zero observations in normalize guard, not zero-filled buckets (#1638) 2026-06-17 20:39:00 +03:00
orchestrator.py fix(forecasting): SAVEPOINT-isolate §22 db.execute failures + close RELEASE-trap (#2464) (#2466) 2026-07-08 05:41:35 +00:00
product_scoring.py fix(site_finder): SAVEPOINT-isolate gate-lookup db.execute swallows (#2464 Wave 2) (#2468) 2026-07-08 06:46:03 +00:00
rate_sensitivity.py feat(forecasting): seasonal (month-of-year) demand normalization (#979) 2026-06-04 11:19:50 +05:00
recommendation.py docs(forecast): исправить устаревшие комментарии #1959 (deep-review follow-up) 2026-06-27 23:02:09 +05:00
regression.py fix(week-review): backend-аудит v2 — 82 фиксов (#1660) 2026-06-17 17:13:38 +00:00
report.py fix(forecasting): honest scenarios collapse when β rate-sensitivity gate fails (audit #1871 P1) 2026-06-22 19:06:22 +05:00
report_assembler.py docs(ptica): фактор уверенности называл не ту величину (#2464-H) (#2878) 2026-08-13 21:21:38 +00:00
sales_series.py fix(forecasting): SAVEPOINT-isolate §22 db.execute failures + close RELEASE-trap (#2464) (#2466) 2026-07-08 05:41:35 +00:00
scenarios.py fix(report): human RU microcopy in Site Finder Section 6 (#1963) 2026-06-27 17:42:27 +05:00
special_indices.py docs(ptica): три комментария, утверждавших не то, что делает код (#2464 кластер H) 2026-08-19 21:50:57 +05:00
what_to_build.py fix(forecast): посегментный+дедуплицированный индекс дефицита (#1959) 2026-06-27 22:50:58 +05:00