Files
healthlog/docs/tasks/items/schema-annotations.md
av 3d24248075 docs: документация приведена к канону av-dev-pm 4
- каждая запись каталога задач получила тип вместо тега kind: и префикса
  заголовка; секция роадмапа «Разработка» стала «Сопровождением», порядок
  секций канонический
- поправлены протухшие факты: нереализованные маршруты Read API, MCP и
  `healthlog import`, словарь слоёв в инварианте, семантика гейта по покрытию
  диффа, периметр перестал дублировать security.md
- замер слияния переведён с находки 49 на находку 54, заполнены Purpose спек
  storage и parsing
2026-08-05 19:09:35 +03:00

1.7 KiB
Raw Permalink Blame History

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

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

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

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

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

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

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