Files
healthlog/docs/tasks/items/read-api-records.md
T
av d33f37249c docs: документация переведена на канон av-dev-pm 3
- роадмап отвечает «что умеет и чего не умеет»: PLAN.md → ROADMAP.md, четыре
  канонические секции, достигнутые звенья строками в «Готово», цели
  переформулированы возможностями приложения
- задачи: род работы и «Затрагивает» набору спринта, 34 заголовка в форму
  действия, «Завершение» целей перечнями со ссылкой из каждой задачи
- вычитка проходами task-form и doc-wording, починены протухшие факты в README,
  паспорте и review.md
2026-08-04 20:48:30 +03:00

2.6 KiB

Отдавать записи со своим id за период

  • Секция: Ядро
  • Зачем: stateOfMind разобран и хранится, но наружу не отдаётся — а восстановить его нечем: в экспорте Apple его нет
  • Теги: goal:read-api, sprint:2026-08-04, kind:feature

Записи со своим id — сегодня это stateOfMind — достаются за период через GET /records/{kind}.

Разбор и хранение сделаны тем же изменением, что у тренировок; наружу не отдаётся ничего. У этих данных есть особенность, которой нет больше ни у чего в проекте: stateOfMind нет в экспорте Apple, он не восстанавливается пересборкой из снапшота, и единственный его источник — доставки HAE. Отдача наружу — не удобство, а единственный способ увидеть то, что иначе живёт только внутри базы.

Конверт наследуется от точек; собственной формы у записей нет.

Двигает строку «Завершения» цели: «Тренировки с маршрутом и записи со своим id отдаются за период».

Затрагивает

Новый маршрут GET /api/v1/records/{kind} и код отказа на неизвестном kind. Публичный тип провода в internal/httpapi — конверт записей. Чтение таблицы записей; схемы и формата на диске не трогает.

Критерии приёмки

  • записи stateOfMind за период отдаются одним запросом — оракул: запрос к поднятому сервису на живом архиве
  • неизвестный kind отвечает отказом со списком известных, а не пустым списком: пустота и опечатка обязаны различаться — оракул: тест
  • конверт совпадает с конвертом точек и тренировок — оракул: тест, сравнивающий форму ответа трёх маршрутов

Рамки

Схема не трогается, данные только читаются. Берётся после конверта.