docs: документация переведена на канон av-dev-pm

- беклог и план переехали в 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 получил настройки с числовым значением
This commit is contained in:
av
2026-08-03 17:14:53 +03:00
parent de7b15d48c
commit d79189be18
94 changed files with 1234 additions and 566 deletions
+21
View File
@@ -0,0 +1,21 @@
# [idea] Человеческие аннотации поверх выведенных схем
**Секция:** ядро · **Хук:** Выведенная схема говорит форму, но не смысл метрики — нужно ли описание сверху, зависит от стабильности формата · **Теги:** goal:self-description
Схема содержимого выводится из данных и говорит **форму** — какие поля есть,
какого типа, с какой заполненностью. Чего она не говорит — что метрика значит,
в каких единицах разумны значения и чем `apple_stand_hour` отличается от
`apple_exercise_time`.
Два пути, и выбор между ними преждевременен:
- **аннотации поверх выведенных схем** — человеческое описание рядом с
машинным выводом, дописывается по мере надобности;
- **рукописный каталог метрик** — полнее, но описывал бы документацию HAE, а не
то, что он реально прислал.
Почему идея, а не задача: выбор зависит от того, насколько стабильным окажется
формат. Меняться он может только с обновлением Health Auto Export, а это
отслеживается — значит ответ придёт сам.
Связано: `docs/architecture.md` → «Самоописание», задача `derived-content-schemas`.