av
3d24248075
- каждая запись каталога задач получила тип вместо тега kind: и префикса заголовка; секция роадмапа «Разработка» стала «Сопровождением», порядок секций канонический - поправлены протухшие факты: нереализованные маршруты Read API, MCP и `healthlog import`, словарь слоёв в инварианте, семантика гейта по покрытию диффа, периметр перестал дублировать security.md - замер слияния переведён с находки 49 на находку 54, заполнены Purpose спек storage и parsing
25 lines
1.7 KiB
Markdown
25 lines
1.7 KiB
Markdown
# 🔬 Человеческие аннотации поверх выведенных схем
|
||
|
||
- **Тип:** research
|
||
- **Категория:** Ядро
|
||
- **Зачем:** Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата
|
||
- **Теги:** goal:self-description
|
||
|
||
Схема содержимого выводится из данных и говорит **форму** — какие поля есть,
|
||
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
|
||
в каких единицах разумны значения и чем `apple_stand_hour` отличается от
|
||
`apple_exercise_time`.
|
||
|
||
Два пути, и выбор между ними преждевременен:
|
||
|
||
- **аннотации поверх выведенных схем** — человеческое описание рядом с
|
||
машинным выводом, дописывается по мере надобности;
|
||
- **рукописный каталог метрик** — полнее, но описывал бы документацию HAE, а не
|
||
то, что он реально прислал.
|
||
|
||
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется
|
||
формат. Меняться он может только с обновлением Health Auto Export, а это
|
||
отслеживается — значит ответ придёт сам.
|
||
|
||
Связано: `docs/architecture.md` → «Самоописание», задача `derived-content-schemas`.
|