docs: документация переведена на канон av-dev-pm 3
- роадмап отвечает «что умеет и чего не умеет»: PLAN.md → ROADMAP.md, четыре канонические секции, достигнутые звенья строками в «Готово», цели переформулированы возможностями приложения - задачи: род работы и «Затрагивает» набору спринта, 34 заголовка в форму действия, «Завершение» целей перечнями со ссылкой из каждой задачи - вычитка проходами task-form и doc-wording, починены протухшие факты в README, паспорте и review.md
This commit is contained in:
@@ -1,8 +1,8 @@
|
||||
# Условный запрос по точкам
|
||||
# Отвечать 304 на повторный запрос точек
|
||||
|
||||
- **Секция:** ядро
|
||||
- **Секция:** Ядро
|
||||
- **Зачем:** Агент опрашивает по расписанию, а каждый повтор стоит полного чтения: на каталоге это 693 мс и +153 МиБ
|
||||
- **Теги:** goal:read-api, sprint:2026-08-04
|
||||
- **Теги:** goal:read-api, sprint:2026-08-04, kind:feature
|
||||
|
||||
Повторный опрос точек с той же меткой стоит `304` вместо полного чтения, и метка
|
||||
не может ответить на другой набор данных.
|
||||
@@ -19,6 +19,15 @@
|
||||
враждебном запросе. Агент опрашивает по расписанию, и без условного запроса
|
||||
каждый его повтор стоит полного чтения.
|
||||
|
||||
Двигает строку «Завершения» цели: «Повторный запрос тех же точек стоит `304`, а не полного чтения».
|
||||
|
||||
## Затрагивает
|
||||
|
||||
Маршрут `GET /api/v1/metrics/{name}` — заголовки `ETag` и `If-None-Match`,
|
||||
код ответа `304`. Область действия метки: набор параметров запроса (метрика,
|
||||
окно, слой) и версия витрины, из которых метка считается, и их каноническая
|
||||
форма. Схемы и формата на диске не трогает.
|
||||
|
||||
## Критерии приёмки
|
||||
|
||||
- повторный запрос с `If-None-Match` при неизменной витрине даёт `304` — оракул:
|
||||
|
||||
Reference in New Issue
Block a user