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

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

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

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

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

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

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