Версия источника: 93129dd470a134cabdf15a353da6633362f2b0fe
Синхронизировано: 2026-11-19T04:53:50.014Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/93129dd470a134cabdf15a353da6633362f2b0fe

<a id="caching-bounded-projection-refresh"></a>

# Ограниченное обновление каталога и индекса

## Коротко

Готовьте поисковую и навигационную проекции вне запроса посетителя. Читайте большие наборы ограниченными пакетами, переключайте только проверенную версию и сохраняйте доступ к разрешённым страницам при сбое.

## Плохо

```text
Каждый SSR-запрос собирает всё меню.
Несколько сканов по 5000 документов.
Защита памяти отклонила запросы.
Резервный запрос вернул черновик.
```

## Хорошо

```text
Меню получает готовую лёгкую проекцию.
Один refresh читает ограниченные пакеты.
Неполная версия не публикуется.
Резерв использует опубликованные данные.
```

## Почему

Фоновая нагрузка от миграции и обхода конкурирует с посетителями за один кластер. Один глубокий запрос может повлиять на многие страницы, даже если отдельный тест прошёл.

## Когда применять

Для больших каталогов, отчётов, sitemap и разогрева поисковых индексов. Размер пакета и параллелизм выбираются по измерениям текущего окружения. Для маленьких наборов можно использовать простой снимок.

### Требования

- Разделите чтение навигации, отдельной карточки и сборку полного реестра. Не делайте тяжёлый полный обход при каждом рендере страницы. Публичный запрос получает готовую проекцию.
- Ограничьте пакет, параллелизм, задержки и время обновления. Обновление одной версии выполняется одним рабочим процессом или координируется. Посетители читают действующий снимок, пока строится следующий.
- Для стабильного обхода определите неизменяемый источник или согласованный снимок, сортировку с уникальным последним ключом и механизм возобновления. В OpenSearch применяйте PIT с `search_after`, если нужен согласованный снимок при обновляемом индексе. Обычный `search_after` сам по себе не фиксирует набор.
- При завершении сверьте версию, полноту, число ключей и применимые ограничения публикации. Переключайте готовую проекцию целиком. Ошибки и частичные ответы оставляют действующий снимок в рамках заданной допустимой давности.
- Резерв отдаёт только разрешённые опубликованные данные, учитывая скрытие, удаление и смену прав. Не используйте устаревший снимок для отозванных данных. Если безопасной версии нет, отдайте понятный отказ.
- Прогоните миграцию и аудит HTTP с ограниченным темпом, измерьте трафик посетителей на фоне обоих процессов. Следите за ограничителями памяти, тайм-аутами, ошибками, частичными ответами и давностью данных.

## Пример применения

В каталоге туров справочники собираются пакетами в фоне. Меню обслуживает готовый компактный снимок. При отказе поиска прямой URL доступной карточки читается из опубликованного представления, а скрытая карточка остаётся недоступной.

## Как проверить

- Остановите индекс в тестовом окружении. Проверьте опубликованную карточку, скрытую запись, пустую выдачу и индикацию отказа.
- Обновляйте данные во время перебора. Проверьте отсутствие дыр и дублей в согласованном снимке и корректную обработку истёкшего курсора.
- Сравните отклик под одновременной загрузкой и обычной нагрузкой. Ошибка сборки не меняет опубликованную версию.

## Человек

Определяет допустимую давность, нагрузочный бюджет и правила резерва.

## Агент

Агент реализует ограниченное чтение, атомарное переключение и проверяет поведение при отказе.

## Источники

- [OpenSearch — постраничное чтение](https://docs.opensearch.org/latest/search-plugins/searching-data/paginate/)
- [OpenSearch — Point in Time](https://docs.opensearch.org/latest/search-plugins/searching-data/point-in-time/)

Уровень: Обязательно. Опубликовано: 2026-11-19. Проверено: 2026-11-19. Изменено: 2026-11-19.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/93129dd470a134cabdf15a353da6633362f2b0fe/registry/standards/backend/worker/rules/bounded-projection-refresh.md)
