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 получил настройки с числовым значением
1.7 KiB
1.7 KiB
[idea] Человеческие аннотации поверх выведенных схем
Секция: ядро · Хук: Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата · Теги: goal:self-description
Схема содержимого выводится из данных и говорит форму — какие поля есть,
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
в каких единицах разумны значения и чем apple_stand_hour отличается от
apple_exercise_time.
Два пути, и выбор между ними преждевременен:
- аннотации поверх выведенных схем — человеческое описание рядом с машинным выводом, дописывается по мере надобности;
- рукописный каталог метрик — полнее, но описывал бы документацию HAE, а не то, что он реально прислал.
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется формат. Меняться он может только с обновлением Health Auto Export, а это отслеживается — значит ответ придёт сам.
Связано: docs/architecture.md → «Самоописание», задача derived-content-schemas.