# Digital Kazakhstan Experience / KazResource OS — расширенное техническое задание на демо-версию

**Проект:** KazResource OS (KUT Resources) — национальная интеллектуальная операционная система промышленности Республики Казахстан.  
**Статус:** рабочее техническое задание для демо-версии на планшете.  
**Целевая аудитория:** Министр искусственного интеллекта и цифрового развития РК, Минэнерго, Нацбанк, NPC, инвесторы, операторы, инженеры.

**Цель:** подготовить демо-версию для планшета, которую можно показать Министру и международным инвесторам: от 3D-модели страны до отдельного датчика, с AI-агентами-казахстанскими дипломатами, цифровым тенге и инвестиционным кабинетом.  
**Пилотный объект:** нефтегазовый кластер Казахстана (Узенское месторождение → ЦПСН/НПС → магистральный трубопровод Узень–Атырау–Самара → Атырауский НПЗ) в 7D-цифровом двойнике.  
**Ключевые технологии KUT:** HMI/SCADA KUT, Edge AI, цифровой двойник, KUT-RGP, MONOLITHAR (суверенный блокчейн-нотариус), ARKHETHOR (токенизированные активы Казахстана), цифровой банк KUT + цифровой тенге, Национальная шина событий (NEB), Программируемый фискальный движок (PFE), National Resource Mathematics (NRM) / мировой энергетический эталон (WEU), Joint Engineering Center (JEC) с Газпромом.  
**Формат поставки:** набор технических томов + детальный сценарий демо + чек-листы приёмки.

---

## 1. Общее заключение по исходному документу

Исходный мастер-ТЗ (`Digital Kazakhstan Experience`) уже содержит сильное стратегическое видение: страна как единый цифровой организм, «от страны до датчика», AI-агенты, инвестиционный кабинет, Unreal-визуализация.  
**Что сделано хорошо:**
- Понятная целевая аудитория (Президент, министерства, инвесторы, инженеры, общество).
- Правильные принципы: не игра, не презентация, а цифровой двойник.
- Корректная идеология «страна → область → кластер → предприятие → установка → оборудование → датчик».
- Важные запреты: не выдавать прогноз за факт, не управлять реальным оборудованием из демо, разделять источники данных.

**Чего не хватает для реализации демо-версии (и что добавлено в настоящем ТЗ):**
1. **Конкретный пилотный объект** с реальными названиями, маршрутом, цифрами и допусками.  
   Решение: выбран Узенский кластер → Атырауский НПЗ как эталонный пилот.
2. **Чёткое определение 7D-цифрового двойника**: какие именно 7 измерений, как они визуализируются и считаются.  
   Решение: прописаны 7D-слои (3D-геометрия + 4D-время/график + 5D-стоимость + 6D-энерго/экология + 7D-эксплуатация/жизненный цикл).
3. **Сценарий демо «от начала до конца»** с таймингом, репликами AI-аватаров, камерой, данными и точками взаимодействия.
4. **Образы AI-агентов** в национальной одежде — не общее описание, а имена, внешность, костюм, манера речи, зона ответственности, двухвариантные советы.
5. **Финансовый AI «гений»** с конкретной моделью распределения стоимости: налоги, пенсии, соцпакет, бюджет, инвесторы, цифровой тенге, связь с Halyk / Kaspi / Bank CenterCredit / Eurasian / Altyn.
6. **Реалистичная интеграция цифрового тенге**: ретейл-пилот НБК, участники, сценарии voucher/government/retail, кошельки, смарт-контракты.
7. **Промышленная автоматизация до мельчайших узлов**: скважина → клапан → датчик → НПС → трубопровод → НПЗ; каждый узел с цифровым паспортом, телеметрией, двумя AI-вариантами реакции.
8. **DevOps и инфраструктура для планшета**: Pixel Streaming, WebRTC, React-оболочка, бэкенд, тестовые стенды, сетевая изоляция, резервирование.
9. **Кибербезопасность OT/IT/AI** в объёме демо: read-only, DMZ, шлюзы, secrets, zero trust для планшета, аудит.
10. **Чёткие критерии приёмки демо**: функциональные, 3D, AI, UX, безопасность, министерский показ.
11. **Граф знаний**: онтология, сущности, отношения, запросы, примеры SPARQL/Cypher.
12. **Реальные интеграции**: KazMunayGas / KazTransOil / NPC Digital Tenge / Государственный кадастр недр (Minerals.gov.kz) / KazSubsoil / ЕНПФ / ФСМС / ГКД / банки. Все данные в демо помечены как synthetic/historical / read-only.  
14. **KUT-специфика**: MONOLITHAR, ARKHETHOR, PFE, NRM, WEU, KUT-RGP, 10 технологических циклов (C1–C10), JEC, Газпром-инженерный центр.
13. **Правовые дисклеймеры**: демо не является официальным государственным расчётным механизмом; цифры — модельные; AI не заменяет эксперта; нет реального управления оборудованием.

---

## 2. Структура технических томов

| Том | Название | Содержание |
|-----|----------|------------|
| 00 | README и заключение | Этот файл: цели, что добавлено, структура, дисклеймеры |
| 01 | Архитектура платформы | Enterprise / Solution / Data / Integration / OT / AI / Security-архитектуры, сервисы, API, event bus |
| 02 | Unreal Engine / 3D | 7D-геометрия, Cesium/Nanite/Lumen, Pixel Streaming, LOD, ассеты, персонажи, оптимизация |
| 03 | UX/UI | Дизайн-система, экраны планшета, джерни министра/инвестора/инженера, голос, accessibility |
| 04 | Промышленная автоматизация | OT, SCADA/ASU ТП, протоколы, цифровой двойник пилотного кластера, датчики, отказы, две опции |
| 05 | AI | Мультиагентная система, LLM/RAG, граф знаний, аватары-казахстанские дипломаты, confidence, hallucination control |
| 06 | Данные и граф знаний | Data mesh, источники, ETL, качество, онтология, графовая БД, lineage |
| 07 | Инвестиционный кабинет и финансовый AI | Investor journey, data room, NPV/IRR, цифровой тенге, распределение стоимости, банковская интеграция |
| 08 | Кибербезопасность | Zero Trust, OT/IT, IAM, PAM, WAF, DLP, SIEM, AI-редтиминг, отчётность |
| 09 | DevOps | CI/CD, IaC, мониторинг, Pixel Streaming, резервирование, стенды |
| 10 | Критерии приёмки | Чек-листы функциональных, 3D, AI, UX, безопасности, приёмки министерской демо |
| 11 | Пилотный проект и сценарий демо | 7D-описание Узен→Атырау НПЗ, сценарий 12–20 минут, реплики аватаров, тайминг |
| 12 | KUT-специфика KazResource OS | MONOLITHAR, ARKHETHOR, PFE, NRM/WEU, KUT-RGP, 10 циклов, JEC, совместный инженерный центр с Газпромом |  
| 13 | Приложения | Глоссарий, data dictionary, API-примеры, AI-персонажи, эталонные цифры, источники |

---

## 3. Дисклеймеры и ограничения демо-версии

Демонстрационная версия не является:
- реальным SCADA/АСУ ТП и не может управлять оборудованием;
- официальной государственной финансовой системой;
- источником официальных запасов, балансов или налоговых расчётов;
- заменой экспертного решения инженера/геолога/финансиста.

**Все данные демо должны иметь маркер происхождения:**
- `fact` — официально подтверждённые данные (лицензии, ёмкости НПЗ, протяжённость трубопроводов и т.д.).
- `operational` — оперативные телеметрические данные (только при read-only интеграции).
- `historical` — исторические данные.
- `model` — расчётная модель.
- `forecast` — прогноз.
- `expert` — экспертная оценка.
- `ai_recommendation` — предложение AI.
- `demo` — специально сгенерированные демонстрационные данные.

**Ключевое требование к UI:** каждая цифра и каждый совет AI должны иметь иконку/тултип происхождения и уровень уверенности.

---

## 4. Целевые устройства и стенд

| Параметр | Требование |
|----------|------------|
| Основное устройство | планшет 12–13" (iPad Pro M4 / Microsoft Surface Pro / Samsung Galaxy Tab S9 Ultra) |
| Резервное устройство | второй планшет с синхронизированным сценарием |
| Презентационный экран | 4K, 55–85", сенсорный, подключённый к Pixel Streaming или к планшету |
| Сеть | изолированный Wi-Fi/5G-контур, VPN, без доступа к реальному OT |
| Сервер демо | NVIDIA RTX 4090 / A6000, 64 GB RAM, NVMe, Unreal Pixel Streaming, FastAPI + PostgreSQL |
| Резервирование | hot-standby сервер, UPS, автоматическое переключение |
| Аудио | беспроводная гарнитура AI-ассистента или встроенные динамики планшета |