Files
healthlog/docs/tasks/items/workout-identity-on-import.md
T
avandClaude Opus 5 a53d0f0f2f задачи: мета переехала в блок, поле «Хук» стало «Зачем»
49 файлов, миграция сделана командой tasks.py check --fix — той самой, ради
которой в скрипте оставлена читаемость старой формы. Побочно тот же прогон
проставил тег decomposed целям, у которых есть задачи: это его штатная работа.

check после миграции зелёный, индексы согласованы.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 17:31:29 +03:00

3.3 KiB
Raw Blame History

Идентичность тренировок при импорте родного экспорта

  • Секция: ядро
  • Зачем: В export.xml у тренировки нет id — импорт снапшота задвоит тренировки, приехавшие от HAE
  • Теги: goal:native-export-import

Тренировка в витрине адресуется своим id из HealthKit — его шлёт HAE. В export.xml этого идентификатора нет вовсе: у элемента Workout только тип, источник, даты и статистика. Значит healthlog import не сможет сопоставить тренировку из снапшота с той же тренировкой, уже приехавшей от HAE, и они задвоятся.

Это ровно та дыра, что была у точек, и там её закрыли ключом start + end (находка 47): HKObject.uuid в выгрузку не попадает, поэтому модель идентичности обязана выражаться через интервал.

Prior art: dogsheep/healthkit-to-sqlite адресует тренировку хешем содержимого (hash_id в sqlite-utils) — ровно потому, что идентификатора в экспорте нет. Нам это не подходит в лоб: у нас половина тренировок уже лежит под настоящим id, и хеш содержимого дал бы третий ключ рядом с двумя.

Варианты, которые надо будет сравнить:

  • Второй уникальный ключ (start_utc, end_utc) у тренировки: импорт ищет по нему, HAE — по id. Цена: индекс и вопрос, что делать при столкновении двух разных тренировок с одним интервалом (бывает ли такое — неизвестно).
  • Сопоставление на стадии импорта, без изменения схемы: импорт читает уже сохранённые тренировки за период и приписывает найденным их id. Цена: логика сопоставления живёт в импорте и не проверяется ничем, кроме него.
  • Считать тренировки из экспорта отдельным родом и не сопоставлять вовсе. Цена: потребитель видит две тренировки вместо одной и обязан схлопывать сам — ровно то, чего проект старается не делать.

Решать до появления формы healthlog import значит угадывать: неизвестно, понадобятся ли тренировки из экспорта вообще (у HAE они полнее — с маршрутом и рядами, а в экспорте маршрут лежит отдельными GPX).

Связано: docs/architecture.md → «Тренировки и прочие секции», задача apple-export-import.