av
91e860cfc8
- шесть ссылок уже указывали не туда: самоописание значилось шагом 5 (оно 6), import — шагом 6 (он 8), TLS — шагом 8 (это деплой, 11) - README, local-research.md и беклог переведены на названия; нумерация остаётся внутренним делом plan.md
22 lines
1.6 KiB
Markdown
22 lines
1.6 KiB
Markdown
# Read API: точки, выбор слоя, свёртка по сетке
|
|
|
|
**Приоритет:** высокий
|
|
|
|
Сейчас данные достаются только `sqlite3` на хосте. Все три сценария —
|
|
агент-медик, трекер тренировок, фитнес-игра — упираются в отсутствие чтения.
|
|
|
|
Формы запроса ровно две, и это один запрос с необязательным параметром:
|
|
`?from&to` — все значения за период (вес, лекарства, симптомы), `?from&to&bucket`
|
|
— с разбивкой (шаги, энергия).
|
|
|
|
Решение по размеру ответа (вариант «б»): разбивка не задана и ответ не влезает —
|
|
сервер сам берёт сетку погрубее и **называет её в ответе**; разбивка задана явно
|
|
и не влезает — ошибка со списком доступных сеток, а не тихая подмена. Различие
|
|
существенно: иначе агент, попросивший минутную сетку, получит суточные суммы.
|
|
|
|
Готово, когда «шаги за неделю по дням» и «вес за год» отвечаются одним запросом
|
|
каждый, а в ответе всегда видно `layer`, `bucket` и `aggregation`.
|
|
|
|
Связано: `docs/architecture.md` → «Read API», план → шаг «Read API».
|
|
|