Files
healthlog/docs/plan.md
T
av 5ae0c5ff81 reindex: пересборка витрины проигрыванием журнала
- `healthlog reindex` собирает витрину из журнала (тела архива + учёт
  доставок) в ОТДЕЛЬНЫЙ файл базы, строго по `(received_at, id)`; рабочую
  базу читает без наката миграций и не трогает вовсе. Подмену делает
  человек при остановленном сервисе: переименование поверх открытого
  дескриптора портит базу молча.
- Журналом считается архив, а не таблица доставок: тело без учётной записи
  заводится заново (метка из ULID, размер и хеш по распакованному телу),
  запись без тела переносится, но не сворачивается. Оракул сходимости
  встроен — два отпечатка и «объектов было/стало»; пустой журнал успехом не
  считается.
- Прогон живого архива переехал на новый пакет: второго проигрывателя
  журнала в проекте не осталось, а его утверждение о ключе сна перестало
  быть константой, протухающей с каждой доставкой.
2026-08-02 09:07:46 +03:00

4.4 KiB
Raw Blame History

План

Это порядок и его обоснование, а не список работ. Единицы работы живут в беклоге — одна задача, один файл, свой приоритет. План отвечает «почему в таком порядке», беклог — «что брать следующим».

Отсюда правило: содержимое шага здесь не перечисляется. Шаг — это название и статус; что именно в нём делается, знает задача. Иначе список работ живёт в двух местах и расходится с каждой закрытой задачей. Меняется этот файл, когда меняется порядок, а не когда закрывается задача.

Ближайшая цель

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

reindex сделан: журнал проигрывается в свежую витрину, отпечатки сравниваются, повторный прогон ничего не меняет. Доставки, числящиеся pending после миграции 00005, подбираются им же — но применяется результат подменой базы, а её делает человек при остановленном сервисе. Тем же кодом закрывается половина задачи «разнести ответ и свёртку»: проигрывание журнала теперь готовая операция.

Дальше — остаток разбора: тренировки и записи со своими id (это половина потока: workouts и stateOfMind принимаются и хранятся, но не разбираются), словарь категориальных значений.

Разведка закончена: правило вывода слоя, модель идентичности и формы точки проверены на живом потоке, выводы — в local-research.md.

Шаги

  • 1. Каркас.
  • 2. Приём без разбора.подключаем телефон по локальной сети
  • [~] 3. Разбор и хранилище. Метрики и reindex — сделано; тренировки и записи со своими id, словарь категориальных значений — нет.
  • 4. Каталог и род агрегации.
  • 5. Read API.
  • 6. Самоописание.
  • 7. MCP.
  • 8. healthlog import.
  • 9. Устаревание нижнего слоя.
  • 10. Наблюдаемость.
  • 11. Деплой.

Порядок неслучаен, и это единственное, чего нет в беклоге:

  • Каталог и род агрегации — перед Read API. Без измеренного рода свёртка в ответе неотличима от угадывания, а ошибиться здесь дорого: просуммировать нижний слой значит завысить втрое.
  • healthlog import — перед устареванием нижнего слоя. Пока импорт экспорта не написан, помечать что-либо устаревшим не на основании чего.
  • Read API — перед MCP. Адаптер собственной логики не несёт, он переводит вызовы в те же обработчики; переводить пока нечего.

Отложенное

Отложенных идей в плане нет: их место — беклог с пометкой [idea]. Два дома для одной идеи расходятся, и тогда полного списка не даёт ни один; вопрос «что мы решили отложить» задаётся беклогу.