Files
healthlog/docs/backlog/read-api-tochki.md
T
av 91e860cfc8 docs: ссылки на план по названиям шагов вместо номеров
- шесть ссылок уже указывали не туда: самоописание значилось шагом 5 (оно 6), import — шагом 6 (он 8), TLS — шагом 8 (это деплой, 11)
- README, local-research.md и беклог переведены на названия; нумерация остаётся внутренним делом plan.md
2026-08-02 06:54:08 +03:00

1.6 KiB

Read API: точки, выбор слоя, свёртка по сетке

Приоритет: высокий

Сейчас данные достаются только sqlite3 на хосте. Все три сценария — агент-медик, трекер тренировок, фитнес-игра — упираются в отсутствие чтения.

Формы запроса ровно две, и это один запрос с необязательным параметром: ?from&to — все значения за период (вес, лекарства, симптомы), ?from&to&bucket — с разбивкой (шаги, энергия).

Решение по размеру ответа (вариант «б»): разбивка не задана и ответ не влезает — сервер сам берёт сетку погрубее и называет её в ответе; разбивка задана явно и не влезает — ошибка со списком доступных сеток, а не тихая подмена. Различие существенно: иначе агент, попросивший минутную сетку, получит суточные суммы.

Готово, когда «шаги за неделю по дням» и «вес за год» отвечаются одним запросом каждый, а в ответе всегда видно layer, bucket и aggregation.

Связано: docs/architecture.md → «Read API», план → шаг «Read API».