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:
@@ -0,0 +1,20 @@
|
||||
# [idea] NDJSON-поток для больших выборок Read API
|
||||
|
||||
**Секция:** ядро · **Хук:** Выборка нижнего слоя за месяц не влезает в один JSON-ответ — либо поток, либо пагинация · **Теги:** goal:read-api
|
||||
|
||||
Read API отдаёт ответ одним JSON. Для выборок нижнего слоя за длинный период
|
||||
это не работает: `heart_rate` в слое `raw` — порядка сотни тысяч координат в
|
||||
сутки, и месяц такого ряда не влезет ни в память клиента, ни в разумный ответ.
|
||||
|
||||
Сейчас проблема закрыта с другой стороны — правилом размера ответа: сервер сам
|
||||
берёт сетку погрубее, когда разбивка не задана, и отвечает ошибкой со списком
|
||||
доступных сеток, когда задана явно. Это защищает агента с ограниченным
|
||||
контекстом, но не помогает клиенту, которому действительно нужен весь ряд —
|
||||
например, разовой выгрузке в другой инструмент.
|
||||
|
||||
Почему идея, а не задача: неизвестно, появится ли такой клиент. Если появится,
|
||||
выбор между NDJSON-потоком и курсорной пагинацией зависит от того, читает он
|
||||
последовательно или с возвратами.
|
||||
|
||||
Связано: `docs/architecture.md` → «Свёртка и размер ответа», задача
|
||||
`read-api-points`.
|
||||
Reference in New Issue
Block a user