av
d33f37249c
- роадмап отвечает «что умеет и чего не умеет»: PLAN.md → ROADMAP.md, четыре канонические секции, достигнутые звенья строками в «Готово», цели переформулированы возможностями приложения - задачи: род работы и «Затрагивает» набору спринта, 34 заголовка в форму действия, «Завершение» целей перечнями со ссылкой из каждой задачи - вычитка проходами task-form и doc-wording, починены протухшие факты в README, паспорте и review.md
3.5 KiB
Не задваивать тренировки при импорте родного экспорта
- Секция: Ядро
- Зачем: В 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.
Двигает строку «Завершения» цели: «Тренировки из экспорта не задваивают приехавшие от HAE».