av
d79189be18
- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги переименованы с транслита на английские, 85 ссылок поправлены - conventions.md разобран в docs/conventions/, local-research.md — в docs/research/, review-journal.md — в docs/review.md с разделом настройки конвейера; заведены security.md, adr/ и .pm.json - шаг docs.py check добавлен в task gate; поведение в architecture.md помечено девятью маркерами долга, database.md получил настройки с числовым значением
22 lines
1.7 KiB
Markdown
22 lines
1.7 KiB
Markdown
# [idea] Человеческие аннотации поверх выведенных схем
|
||
|
||
**Секция:** ядро · **Хук:** Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата · **Теги:** goal:self-description
|
||
|
||
Схема содержимого выводится из данных и говорит **форму** — какие поля есть,
|
||
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
|
||
в каких единицах разумны значения и чем `apple_stand_hour` отличается от
|
||
`apple_exercise_time`.
|
||
|
||
Два пути, и выбор между ними преждевременен:
|
||
|
||
- **аннотации поверх выведенных схем** — человеческое описание рядом с
|
||
машинным выводом, дописывается по мере надобности;
|
||
- **рукописный каталог метрик** — полнее, но описывал бы документацию HAE, а не
|
||
то, что он реально прислал.
|
||
|
||
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется
|
||
формат. Меняться он может только с обновлением Health Auto Export, а это
|
||
отслеживается — значит ответ придёт сам.
|
||
|
||
Связано: `docs/architecture.md` → «Самоописание», задача `derived-content-schemas`.
|