Files
healthlog/docs/tasks/items/data-migration-row-selection.md
T
av d79189be18 docs: документация переведена на канон av-dev-pm
- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги
  переименованы с транслита на английские, 85 ссылок поправлены
- conventions.md разобран в docs/conventions/, local-research.md — в
  docs/research/, review-journal.md — в docs/review.md с разделом настройки
  конвейера; заведены security.md, adr/ и .pm.json
- шаг docs.py check добавлен в task gate; поведение в architecture.md помечено
  девятью маркерами долга, database.md получил настройки с числовым значением
2026-08-03 17:14:53 +03:00

3.2 KiB

Data-миграции не отбирают строки по обрезаемым спискам

Секция: ядро · Хук: Миграция 00007 отбирает по uncovered_sections, который обрезается на 32 — следующая покрытая секция унаследует слепую зону · Теги: goal:journal-and-rebuild

Остаток задачи «Дозакрыть находки ревью по слиянию сущностей» (архивный change dozakryt-nahodki-sushchnostej).

Оракул: механизм доказан, дефект пока пустой

Миграция 00007 переводит в pending доставки, у которых имя ставшей покрытой секции стоит в uncovered_sections:

WHERE EXISTS (SELECT 1 FROM json_each(delivery.uncovered_sections)
              WHERE json_each.value IN ('workouts', 'stateOfMind'))

Список uncovered_sections обрезается на 32 имени в порядке встречи (hae.maxUncovered, счётчик UncoveredDropped). Секция, стоящая в теле после тридцати двух незнакомых ключей, в список не попадает — и отбор миграции её не найдёт. Оракул жил в tmp/adv/uncovered_test.go: тело с 32 ключами junk и секцией ecg за ними даёт список без ecg.

Для 00007 дефект пустой: HAE шлёт одну секцию за доставку (docs/research/apple-health.md, находка 50), секций восемь, тела с 32 незнакомыми ключами в архиве не существует. Но следующая покрытая секция унаследует ту же слепую зону, а к тому времени причину никто не вспомнит.

Что делать

Записать принцип и выбрать форму отбора:

  • Принцип: data-миграция не отбирает строки по списку, который где-то обрезается. Отбирать надо по признаку, который обрезке не подлежит, — например «эту доставку смотрел разбор старше версии N».
  • Практическое следствие для существующего кода: UncoveredDropped > 0 обязан означать безусловное пересворачивание — доставка, у которой список обрезан, про своё покрытие ничего достоверного не говорит.
  • Кандидат в docs/conventions/README.md (раздел про миграции), если форма отбора окажется общей.

Связано