Перейти к основному содержимому

ADR-0019: Data Freshness Standard

Статус​

Accepted

Контекст​

Pin использует replicas, Elasticsearch, ClickHouse, Redis cache и materialized views. Пользователь и backend должны понимать, насколько свежие данные используются.

Решение​

Все projection/read-model queries возвращают FreshnessView или documented equivalent:

  • Source;
  • AsOf;
  • LagSeconds;
  • FreshnessStatus;
  • SlaSeconds;
  • PartialData.

High-impact commands fail closed на stale critical projection.

Последствия​

  • UI может честно показывать stale/partial data.
  • Export manifest фиксирует freshness.
  • Нельзя молча принять money/security решение на устаревшей projection.

Ссылки​