{
  "schema": "qz.energy.datasets/v1",
  "generated_at": "2026-07-28T23:25:00+05:00",
  "release_id": "v0.6.3-20260728T182500Z",
  "datasets": [
    {
      "dataset_id": "energy-indicators",
      "title": "Показатели энергетики",
      "domain": "generation",
      "description": "Проверенные показатели генерации, ВИЭ, потребления, угля, гидро, тепла, мощности, рынка электрической мощности KOREM, макроэнергетического баланса, конечного спроса, потерь и экологических выбросов за 2024–2026 годы.",
      "period_coverage": "2024-2026",
      "granularity": "годовой и полугодовой срез",
      "unit_family": "kWh, MW, Gcal, ktoe, percent, tonnes, count, KZT per MW-month",
      "source_class": "официальный публичный источник",
      "primary_source": "Министерство энергетики РК, БНС, Samruk-Energy, KEGOC и KOREM",
      "freshness_status": "reviewed_static",
      "license_note": "Публичный снимок qz.energy с обязательной ссылкой на первоисточник.",
      "public_url": "https://qz.energy/indicators.html",
      "machine_url": "https://qz.energy/data/energy-indicators.json",
      "schema_hint": "metric_id, label, domain, domain_label, value, unit, period, source_url, methodology_note, freshness_status"
    },
    {
      "dataset_id": "public-energy-map",
      "title": "Публичная энергетическая карта",
      "domain": "infrastructure",
      "description": "Обобщённый GeoJSON-слой 17 опубликованных объектов и направлений без точных чувствительных координат.",
      "period_coverage": "текущий публичный выпуск",
      "granularity": "обобщённая публичная геометрия",
      "unit_family": "GeoJSON FeatureCollection",
      "source_class": "официальные и публичные корпоративные источники",
      "primary_source": "KEGOC, KazTransOil, Министерство энергетики РК, Samruk-Energy",
      "freshness_status": "reviewed_static",
      "license_note": "Использовать как обзорный слой; не применять для навигации, инженерных работ или оперативного управления.",
      "public_url": "https://qz.energy/map.html",
      "machine_url": "https://qz.energy/data/public-energy-map.geojson",
      "schema_hint": "FeatureCollection with public_id, sector, title, source_url, review_status"
    },
    {
      "dataset_id": "energy-map-view",
      "title": "Видимый слой карты",
      "domain": "cartography",
      "description": "Данные для интерфейса карты: фильтры, обобщённые координаты, инспектор и подписи слоёв.",
      "period_coverage": "текущий публичный выпуск",
      "granularity": "слой представления карты",
      "unit_family": "JSON",
      "source_class": "проверенный интерфейсный слой qz.energy",
      "primary_source": "проверенные публичные записи qz.energy",
      "freshness_status": "reviewed_static",
      "license_note": "Производный интерфейсный слой, связанный с публичным GeoJSON.",
      "public_url": "https://qz.energy/map.html",
      "machine_url": "https://qz.energy/data/energy-map-view.json",
      "schema_hint": "layers, features, display coordinates, facts, source pointers"
    },
    {
      "dataset_id": "source-allowlist",
      "title": "Разрешённые источники",
      "domain": "provenance",
      "description": "Реестр 6 организаций, URL-префиксов, допустимых полей, периодичности захвата и статуса условий публикации.",
      "period_coverage": "текущие правила источников",
      "granularity": "организация-источник",
      "unit_family": "JSON",
      "source_class": "редакционная политика qz.energy",
      "primary_source": "редакция qz.energy",
      "freshness_status": "policy_current",
      "license_note": "Служебный публичный контракт источников.",
      "public_url": "https://qz.energy/sources.html",
      "machine_url": "https://qz.energy/data/source-allowlist.json",
      "schema_hint": "source_id, name, class, allowed_url_prefixes, allowed_fields, capture_cadence"
    },
    {
      "dataset_id": "freshness-register",
      "title": "Свежесть источников и наборов",
      "domain": "provenance",
      "description": "Статусы свежести для источников и публичных наборов: что актуально, что является статическим срезом и что относится к правилам публикации.",
      "period_coverage": "текущий публичный выпуск",
      "granularity": "источник и набор данных",
      "unit_family": "JSON",
      "source_class": "редакционная политика qz.energy",
      "primary_source": "релизный контроль qz.energy",
      "freshness_status": "policy_current",
      "license_note": "Публичный контракт статусов; не заменяет первоисточник факта.",
      "public_url": "https://qz.energy/sources.html",
      "machine_url": "https://qz.energy/data/freshness-register.json",
      "schema_hint": "status_definitions, source_freshness, dataset_freshness"
    },
    {
      "dataset_id": "map-layer-completeness",
      "title": "Полнота картографических слоёв",
      "domain": "cartography",
      "description": "Публичная граница каждого слоя карты: опубликованное содержание, допустимая точность и сведения, которые не раскрываются.",
      "period_coverage": "текущий публичный выпуск",
      "granularity": "картографический слой",
      "unit_family": "JSON",
      "source_class": "проверенные правила картографии qz.energy",
      "primary_source": "проверенные публичные записи qz.energy",
      "freshness_status": "reviewed_static",
      "license_note": "Обзорный слой; не применять для навигации, инженерных работ или оперативного управления.",
      "public_url": "https://qz.energy/map.html",
      "machine_url": "https://qz.energy/data/map-layer-completeness.json",
      "schema_hint": "layer, published_count, coverage_status, precision, included, not_included"
    },
    {
      "dataset_id": "object-passports",
      "title": "Паспорта объектов",
      "domain": "infrastructure",
      "description": "Публичные паспорта 17 объектов и направлений: роль, регион, факты, источник и допустимая точность публикации.",
      "period_coverage": "текущий публичный выпуск",
      "granularity": "паспорт объекта",
      "unit_family": "JSON",
      "source_class": "официальные и публичные корпоративные источники",
      "primary_source": "KEGOC, KazTransOil, Министерство энергетики РК, Samruk-Energy",
      "freshness_status": "reviewed_static",
      "license_note": "Публичный фактологический паспорт; не инженерный и не оперативный реестр.",
      "public_url": "https://qz.energy/objects.html",
      "machine_url": "https://qz.energy/data/object-passports.json",
      "schema_hint": "id, title, sector, region, role, facts, source_url, public_url, related_materials, history"
    },
    {
      "dataset_id": "public-snapshot",
      "title": "Публичный снимок выпуска",
      "domain": "release",
      "description": "Сводный набор текущего выпуска: 109 показателей, 17 объектов, 6 материалов, процессы и очередь публикации.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "снимок выпуска",
      "unit_family": "JSON",
      "source_class": "проверенный экспорт qz.energy",
      "primary_source": "закрытые проверенные публичные записи",
      "freshness_status": "reviewed_static",
      "license_note": "Публичный снимок не раскрывает закрытую кандидатную очередь.",
      "public_url": "https://qz.energy/",
      "machine_url": "https://qz.energy/data/qz-energy-public-snapshot.json",
      "schema_hint": "metrics, assets, process, agenda, queue"
    },
    {
      "dataset_id": "global-benchmark",
      "title": "Мировое сравнение продукта",
      "domain": "план развития",
      "description": "Сравнение мировых энергетических платформ и очередь расширений qz.energy.",
      "period_coverage": "2026-07-28",
      "granularity": "сравнение продукта",
      "unit_family": "JSON",
      "source_class": "публичный продуктовый анализ",
      "primary_source": "Global Energy Monitor, IEA, Ember, Electricity Maps, ENTSO-E, EIA, Open Infrastructure Map, Grid Status",
      "freshness_status": "roadmap_current",
      "license_note": "Контракт плана развития, не источник фактов об энергетике Казахстана.",
      "public_url": "https://qz.energy/data/global-benchmark.json",
      "machine_url": "https://qz.energy/data/global-benchmark.json",
      "schema_hint": "benchmarks, priority_extensions, evidence_boundary"
    },
    {
      "dataset_id": "infrastructure-contract",
      "title": "Инфраструктурный контракт qz.energy",
      "domain": "release",
      "description": "Публичная карта связки с QazStack, QazPipe, QazLake, QazGeo, AV DS 4.4 и QazCompute.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "компонент инфраструктуры",
      "unit_family": "JSON",
      "source_class": "контракт выпуска qz.energy",
      "primary_source": "релизный контроль qz.energy",
      "freshness_status": "policy_current",
      "license_note": "Публичный контракт не раскрывает закрытые очереди, сервисные ключи и чувствительные адреса.",
      "public_url": "https://qz.energy/sources.html",
      "machine_url": "https://qz.energy/data/infrastructure-contract.json",
      "schema_hint": "components, public_surface, private_surface, required_gate, publication_rule"
    },
    {
      "dataset_id": "domain-taxonomy",
      "title": "Доменная модель энергетики",
      "domain": "release",
      "description": "Единая рамка доменов qz.energy: активные разделы, пустые домены и причина ожидания источника.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "домен данных",
      "unit_family": "JSON",
      "source_class": "контракт данных qz.energy",
      "primary_source": "релизный контроль qz.energy",
      "freshness_status": "policy_current",
      "license_note": "Рамка данных не создаёт отраслевых фактов без первичных источников.",
      "public_url": "https://qz.energy/indicators.html",
      "machine_url": "https://qz.energy/data/domain-taxonomy.json",
      "schema_hint": "domains, status, current_records, target"
    },
    {
      "dataset_id": "entities",
      "title": "Сущности энергетического графа",
      "domain": "knowledge-graph",
      "description": "138 сущностей: источники, показатели, объекты, материалы, домены и инфраструктурные компоненты qz.energy.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "сущность",
      "unit_family": "JSON",
      "source_class": "проверенный экспорт qz.energy",
      "primary_source": "публичный снимок qz.energy",
      "freshness_status": "reviewed_static",
      "license_note": "Производный граф; факты цитируются по первоисточникам.",
      "public_url": "https://qz.energy/data/entities.json",
      "machine_url": "https://qz.energy/data/entities.json",
      "schema_hint": "entity_id, type, name, domain_ids, public_url"
    },
    {
      "dataset_id": "entity-graph",
      "title": "Граф связей данных",
      "domain": "knowledge-graph",
      "description": "Связи между объектами, источниками, показателями, материалами и наборами данных.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "узел и связь",
      "unit_family": "JSON",
      "source_class": "проверенный экспорт qz.energy",
      "primary_source": "публичный снимок qz.energy",
      "freshness_status": "reviewed_static",
      "license_note": "Граф не раскрывает закрытые очереди QazPipe и QazLake.",
      "public_url": "https://qz.energy/data/entity-graph.json",
      "machine_url": "https://qz.energy/data/entity-graph.json",
      "schema_hint": "nodes, links, boundaries"
    },
    {
      "dataset_id": "facts",
      "title": "Проверенные факты",
      "domain": "knowledge-graph",
      "description": "160 атомарных фактов, извлечённых из показателей, паспортов объектов и редакционных материалов qz.energy.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "факт",
      "unit_family": "NDJSON",
      "source_class": "проверенный экспорт qz.energy",
      "primary_source": "публичный снимок qz.energy",
      "freshness_status": "reviewed_static",
      "license_note": "Каждая строка должна оставаться связанной с первоисточником.",
      "public_url": "https://qz.energy/data/facts.ndjson",
      "machine_url": "https://qz.energy/data/facts.ndjson",
      "schema_hint": "fact_id, entity_id, predicate, value, unit, period, source_url, content_sha256"
    },
    {
      "dataset_id": "claims",
      "title": "Редакционные утверждения",
      "domain": "knowledge-graph",
      "description": "NDJSON-лента редакционного контекста с источником, датой, материалом и статусом проверки.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "утверждение",
      "unit_family": "NDJSON",
      "source_class": "проверенный редакционный экспорт qz.energy",
      "primary_source": "материалы qz.energy и первичные публикации",
      "freshness_status": "reviewed_static",
      "license_note": "Утверждение не заменяет первичный источник.",
      "public_url": "https://qz.energy/data/claims.ndjson",
      "machine_url": "https://qz.energy/data/claims.ndjson",
      "schema_hint": "claim_id, statement, story_url, source_url, review_status, content_sha256"
    },
    {
      "dataset_id": "ui-contract",
      "title": "Контракт публичного интерфейса",
      "domain": "release",
      "description": "Стабильные селекторы страниц для браузерной проверки и регрессионного контроля.",
      "period_coverage": "публичный выпуск v0.6.3",
      "granularity": "страница",
      "unit_family": "JSON",
      "source_class": "контракт выпуска qz.energy",
      "primary_source": "релизный контроль qz.energy",
      "freshness_status": "policy_current",
      "license_note": "Служебный публичный контракт качества интерфейса.",
      "public_url": "https://qz.energy/data/ui-contract.json",
      "machine_url": "https://qz.energy/data/ui-contract.json",
      "schema_hint": "pages, path, required_selectors"
    }
  ]
}