healthlog/docs/backlog/README.md

Беклог

Одна задача = один файл <slug>.md + строка в этом индексе. Приоритет — грубая оценка «ценность / стоимость». Спекулятивные задачи помечены [idea] в заголовке. Ведётся скиллом backlog.

Блокеры — вопросы, вынутые из задач. Работа над задачей идёт автономно; если внутри обнаружился вопрос, который решать не мне, он вынимается отдельным пунктом сюда, а сама задача переформулируется на остаток и продолжается. Пункт блокера отвечает на три вопроса: что именно решить, какие есть варианты с ценой каждого, и что заблокировано, пока решения нет. Разбираются пачками, а не по одному — прерывать поток ради каждого дороже, чем накопить.

блокеры

высокий

• Тренировки и секции с собственными id — Тренировки с геотреком и состояние разума приходят, но не разбираются — без них не закрыть ни трекер, ни агента-медика
• Пересборка хранилища из сырого архива — Ошибка разбора без пересборки становится потерей данных — исправленный код не применится к уже разобранному
• Измеренный род агрегации и каталог разрезов — Без рода метрики свёртка в ответе неотличима от угадывания — а суммировать нижний слой значит завысить втрое
• Read API: точки, выбор слоя, свёртка по сетке — Данные видны только через sqlite на хосте — ни один из трёх потребителей ничего прочитать не может
• OpenAPI-спека и Swagger UI — Потребителей три и один из них агент — контракт должен читаться машиной, а не пересказываться в чате
• MCP-сервер поверх Read API — Агент-медик — первый заказчик проекта, а подключить его сейчас нечем
• Разнести ответ приёма и свёртку доставки — синхронная свёртка не помещается в write_timeout: широкие проходы получают обрыв вместо 200

средний

• Словарь категориальных значений → коды HealthKit — Фазы сна и типы тренировок приходят строками русской локали — с экспортом Apple их не сверить
• Выведенные из данных схемы содержимого — Метрик больше сотни и формы точек разные — клиент вынужден угадывать структуру по выборке
• Импорт родного экспорта Apple Health — Слой sample пуст: полная история и точные сэмплы лежат в zip-архиве и никуда не едут
• Проверка секций, которых поток ещё не приносил — Симптомы, ЭКГ, лекарства, цикл и вес не виденны живьём — разбор писался вслепую
• Наблюдаемость: /stats — Тихо сломавшаяся автоматизация — главный эксплуатационный риск, а сейчас факт виден только в логах
• Деплой на rivendell — Сервис живёт на рабочей машине — телефон достаёт до него только дома
• Управление токенами и секретами — Проверка токенов выключена, config.docker.toml коммитится — так нельзя выезжать наружу
• [idea] Что считать сутками при смене часового пояса — Шаги за день — базовый запрос трекера и игры, но чей это день при перелёте, не решено
• [idea] Пересекающиеся источники одной метрики — Сон пишут и часы, и стороннее приложение — сумма по обоим задвоит ночь
• Умолчания конфига указывают на прежнюю раскладку — Запуск без конфига заведёт пустую базу в корне рядом с настоящей — тихая ловушка
• Счётчики слияния переживают ротацию логов — единственный след несравнимых наборов — строка WARN в docker-логе с ротацией 3×10 МБ: событие может произойти и не оставить ничего
• Цена слияния на широкой доставке — 63 МБ на одной координате держат транзакцию 5.15 с при busy_timeout 5 с — соседние доставки уходят в failed

низкий

• Устаревание нижнего слоя после экспорта — Нижний слой растёт на ~100 тысяч координат в сутки, а после экспорта Apple он избыточен
• Ретеншен сырого архива — Архив не подчищается вовсе — 14-дневный срок объявлен, но не работает
• Активный алерт «данных нет N часов» — Пропажу потока сейчас замечает человек, а не сервис
• [idea] Порог sealed: с какого возраста час считается запечатанным — WARN на изменение старого часа уже пишется, но порог не выбран — ставим по факту, когда накопится статистика досчёта
• [idea] Месячный проход по ручным секциям — Симптомы и лекарства заводятся задним числом на недели — недельного глубокого прохода им не хватит
• [idea] Человеческие аннотации поверх выведенных схем — Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата
• [idea] Отказ от heartbeatSeries — 93% объёма HRV ради данных, которых нет ни в одном планируемом запросе
• [idea] Выгрузка в parquet отдельной командой — Дверь для тяжёлой аналитики снаружи: DuckDB читает и parquet, и файл SQLite — спешить некуда, но и закрывать не нужно
• [idea] NDJSON-поток для больших выборок Read API — Выборка нижнего слоя за месяц не влезает в один JSON-ответ — либо поток, либо пагинация
• [idea] Разворачивание маршрутов тренировок в отдельную таблицу — Маршрут лежит блобом внутри тренировки — понадобится, только если появится клиент, которому мало отдачи одним пакетом