Files
healthlog/docs/tasks/items/schema-annotations.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

1.7 KiB
Raw Blame History

[idea] Человеческие аннотации поверх выведенных схем

  • Секция: ядро
  • Зачем: Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата
  • Теги: goal:self-description

Схема содержимого выводится из данных и говорит форму — какие поля есть, какого типа, с какой заполненностью. Чего она не говорит — что метрика значит, в каких единицах разумны значения и чем apple_stand_hour отличается от apple_exercise_time.

Два пути, и выбор между ними преждевременен:

  • аннотации поверх выведенных схем — человеческое описание рядом с машинным выводом, дописывается по мере надобности;
  • рукописный каталог метрик — полнее, но описывал бы документацию HAE, а не то, что он реально прислал.

Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется формат. Меняться он может только с обновлением Health Auto Export, а это отслеживается — значит ответ придёт сам.

Связано: docs/architecture.md → «Самоописание», задача derived-content-schemas.