NPPWEB Docs

NPPWEB DocsТехническая и аналитическая карта платформы

Единая документация по сбору данных, нормализации, GraphQL-контракту, аналитике закупок и эксплуатации всей экосистемы NPPWEB.

Открыть быстрый старт
Перейти к аналитике

Технический контур

Архитектура сервисов, очередей, артефактов, ingest и deploy-процесса без разрывов между репозиториями.

Аналитический контур

Дашборды, отчёты, покрытие по АЭС, контур поставщиков, метрики качества и сигналы по источникам.

Репозитории по ролям

Для каждого репозитория описаны ответственность, точки входа, зависимости, env-переменные и рабочие сценарии.

Документация собрана по текущему состоянию экосистемы nppweb и предназначена одновременно для разработчиков, аналитиков и администраторов платформы.
6 репозиториев Сервисы и инфраструктура разделены по зонам ответственности, чтобы сбор, обработка и UI не смешивались.
3 слоя данных Raw-события, normalized ingest и аналитические витрины живут как отдельные этапы единого конвейера.
2 контура чтения Бизнес-аналитика и операционное наблюдение сосуществуют, но не конфликтуют в одной модели данных.

Что здесь можно быстро понять ​

Как устроен поток данных

От внешних источников и proxy-контура до raw-событий, нормализации, ingest, закупок, отчётов и интерфейса.

Кто за что отвечает

Границы между scrape-helper, processing-worker, npp-backend, npp-web, infra и contracts.

Как читать аналитику

Какие показатели считаются атомным контуром, как строятся отчёты, где смотреть здоровье источников и как интерпретировать покрытие.

Как обслуживать платформу

Локальный запуск, деплой документации, технические smoke-checks и эксплуатационные сценарии.

Основной сценарий платформы ​

  1. scrape-helper запускает сбор по расписанию, работает с внешними источниками и публикует source.raw.v1.
  2. RabbitMQ отделяет нестабильный внешний сбор от внутреннего контура нормализации.
  3. processing-worker валидирует raw-события, обогащает их, нормализует и отправляет ingest в npp-backend.
  4. npp-backend хранит доменные сущности, считает аналитику, формирует отчёты и отдаёт GraphQL API.
  5. npp-web показывает защищённые представления: дашборд, аналитику, отчёты, список закупок и административные экраны.

Два уровня документации ​

Технический уровень

Архитектура, очереди, env-переменные, S3-артефакты, auth-сессии, GraphQL, Docker Compose и GitHub Pages.

Аналитический уровень

Покрытие по АЭС, динамика закупок, концентрация по поставщикам и заказчикам, добросовестность и операционные сигналы по источникам.

Куда идти дальше ​

Техническая и аналитическая документация платформы NPPWEB.

NPPWEB