contracts

contracts хранит договорённости между сервисами, чтобы API и event-схемы не расходились по репозиториям.

Что хранится

Путь	Назначение
graphql/schema.graphql	GraphQL-контракт для npp-backend и npp-web
events/source-raw.v1.json	схема сырого события
events/source-normalized.v1.json	схема нормализованного события
queue-messages/	примеры сообщений для отладки и тестов

Кто использует

• npp-backend реализует GraphQL-схему.
• npp-web ориентируется на GraphQL-контракт API.
• scrape-helper и processing-worker валидируют события по общим схемам.

Когда менять этот репозиторий

• когда меняется shape GraphQL API;
• когда появляется новое поле в raw- или normalized-событии;
• когда нужно синхронно обновить несколько сервисов без скрытого дрейфа.

Проверка

npm install
npm run validate