Files
healthlog/docs/backlog/taj-brejk-pri-ravnoj-polnote.md
T
av 03edf1087d Каталог разрезов и измеренный род агрегации
- род метрики выводится сверкой минутного слоя с часовым: часовое значение
  сходится с суммой минутных — накопительная, со средним — мгновенная, иначе
  `unknown` и свёртка не предлагается вовсе. На живом архиве (123 доставки,
  31 метрика) 7 накопительных, 9 мгновенных, противоречащих часов ноль
- `GET /api/v1/metrics` под токеном чтения отдаёт единицы, слои с границами и
  род вместе с основанием измерения; род нигде не хранится — он функция витрины,
  а витрина функция журнала, устаревать в нём нечему
- миграция 00009: покрывающий индекс, чтобы каталог отвечал по учётным колонкам,
  не разжимая содержимое объектов
2026-08-02 19:23:59 +03:00

6.4 KiB
Raw Blame History

Тай-брейк при равной полноте точек

Приоритет: блокеры

Что решить

Какое правило выбирает победителя, когда по одним координатам приехали две точки с равными наборами содержательных полей и разными значениями. Структурная часть правила слияния закрыта (pravilo-sliyaniya-tochek); открыт только этот разряд.

Сегодня это порядок канонических форм, и он измеримо смещён: из 1912 случаев, где сравнение чисел определено, лексикографический порядок берёт меньшее значение в 1847 — 96% (находка 49). Столкновений с равной полнотой 1916 из 444 256 координат, то есть 0.43% координат.

Что стало известно

Задача «Измеренный род агрегации и каталог разрезов» закрыла посылку, ради которой тай-брейк откладывали: род метрик теперь измерен, а не угадан (находка 53). Четыре из шести метрик, где тай-брейк системно берёт меньшее (step_count, walking_running_distance, active_energy, basal_energy_burned), измерены как накопительные — там «меньшее» это систематический недосчёт порядка 0.4% координат, ровно тот, что HAE досчитывает задним числом (находка 10). Самая крупная группа, heart_rate, измерена как мгновенная, и там выбор безразличен: это пересэмплирование, а не досчёт.

И тем же измерением закрылся напрашивавшийся ответ: сделать тай-брейк зависящим от измеренного рода нельзя. Род есть функция витрины, витрина — результат слияния, и правило слияния, читающее собственную выдачу, повторяет ровно тот дефект, на котором свёртка уже переставала быть функцией префикса журнала (docs/review-journal.md, 2026-08-01, наследование слоя «из будущего»).

Варианты и цена

а. Оставить порядок канонических форм. Цена: систематический недосчёт 0.4% координат у накопительных метрик, невидимый до сверки с родным экспортом Apple, то есть месяцами. Плюс: ноль работы, правило остаётся структурным и не знает ничего о значениях.

б. Брать бо́льшее значение точки. Правильно для накопительных (досчёт растёт, находка 10, и набор полей у версий тренировки ни разу не уменьшался) и безвредно для мгновенных (пересэмплирование). Цена: слияние перестаёт быть структурным — оно начинает знать, какое поле точки несёт число (hae.PointValue уже есть). Метрика, у которой «большее» неверно, в потоке не наблюдалась, но и не исключена; правило приходится делать тотальным (нет числа — откат на порядок канонических форм), то есть в нём появляется вторая ветка.

в. Провенанс у точки и тай-брейк по позиции в журнале — как у сущностей. Цена: колонка провенанса на точку (или на объект) и рост объёма нижнего слоя; плюс это не работает для столкновений внутри одной доставки, где received_at общий, а таких четверть (находка 47: 33 столкновения внутри доставки на эпизодах сна). То есть вариант не самодостаточен и всё равно требует второго разряда.

Что заблокировано

Ничего срочного: сегодняшнее правило детерминировано и воспроизводимо, витрина остаётся свёрткой журнала. Блокирован только сам недосчёт — он копится молча. Сверить его величину можно будет после healthlog import: родной экспорт Apple даст независимый эталон по тем же периодам.

Рекомендация

Вариант б. Он чинит измеренное смещение там, где оно есть, и не трогает там, где его нет; цена — одна ветка в правиле слияния и признание, что слияние знает про число точки (а оно уже знает — hae.PointValue живёт в разборе). От варианта «а» отличается тем, что перестаёт систематически терять данные; от «в» — тем, что не требует ни колонки, ни решения для внутридоставочных столкновений.

Проверять на прогоне живого архива: отпечаток витрины обязан измениться (иначе правило не сработало), а число столкновений с равной полнотой — остаться прежним.

Связано: docs/architecture.md → «Разрешение столкновений», находки 10, 47, 49, 53.